PEXMapWCToDC - Map World Coordinate Points to Device Coordinate Points

Synopsis

 
   Status PEXMapWCToDC(
          Display *display,
          PEXWorkstation workstation,
          unsigned long wc_count,
          PEXCoord *wc_points,
          unsigned int view_index,
          unsigned long *dc_count_return,
          PEXDeviceCoord **dc_points_return
   )

Arguments

display: A pointer to a display structure returned by a successful XOpenDisplay call.
workstation: The resource identifier of the workstation.
wc_count: The number of world coordinate points.
wc_points: An array of world coordinate points.
view_index: The view index to use in transforming the world coordinate points.
dc_count_return: Returns the number of device coordinate points.
dc_points_return: Returns an array of device coordinate points.

Returns

Zero if unsuccessful; non-zero otherwise.

Description

Invoke PEXMapWCToDC to map the world coordinate points to device coordinate points using the specified workstation and view index.

This function transforms the points to device coordinates by passing them through the view transform associated with the view index. Points that are clipped (outside the viewport) are not returned, so the number of points returned may be less than the number sent.

PEXlib allocates memory for the return value. Invoke XFree to deallocate the memory.

Errors