.\" @(#)PEXMapWCToDC.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXMapWCToDC 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXMapWCToDC - Map World Coordinate Points to Device Coordinate Points
.SH SYNTAX
.HP
Status PEXMapWCToDC\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, unsigned long \fIwc_count\fP\^, PEXCoord *\fIwc_points\fP\^, unsigned int
\fIview_index\fP\^, unsigned long *\fIdc_count_return\fP\^, PEXDeviceCoord **\fIdc_points_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIworkstation\fP 1i
The resource identifier of the workstation.
.IP \fIwc_count\fP 1i
The number of world coordinate points.
.IP \fIwc_points\fP 1i
An array of world coordinate points.
.IP \fIview_index\fP 1i
The view index to use in transforming the world coordinate points.
.IP \fIdc_count_return\fP 1i
Returns the number of device coordinate points.
.IP \fIdc_points_return\fP 1i
Returns an array of device coordinate points.
.SH RETURNS
.LP
Zero if unsuccessful, non-zero otherwise.
.SH DESCRIPTION
.\" indexing
.IX PEXMapWCToDC
.IX "Coordinates" "PEXMapWCToDC"
.LP
This function maps the world coordinate points to device coordinate points
using the specified workstation and view index.  The points are transformed
to device coordinates by passing them through the view transform associated
with the view index.  Points that are clipped will not be returned, so the
number of points returned may be less than the number sent.
.LP
PEXlib allocates memory for the return value.
.B XFree
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
.sp
typedef struct {
	short	x;
	short	y;
	float	z;
.br
} PEXDeviceCoord;
.sp
typedef struct {
	float	x;
	float	y;
	float	z;
.br
} PEXCoord;
.fi
.SH ERRORS
.TP
.SB BadPEXWorkstation
The specified
.I workstation
resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXMapDCToWC (3)
.BR PEXSetWorkstationViewPriority (3)
.fi