Syntax

[C/C++:]
void gTransformPoint2D(float xs, float ys, GPOINT *point2);
void gTransformPoint3D(float xs, float ys, float zs, GPOINT3 *point3);

[F90:]
subroutine gTransformPoint2D(xs, ys, point2)
subroutine gTransformPoint3D(xs, ys, zs, point3)

real, intent(in) :: xs,ys,zs
type (GPOINT), intent(out) :: point2
type (GPOINT3), intent(out) :: point3

Arguments

xs,ys,zs
2D or 3D position in space coordinates

point2,point3
Transformed position in picture coordinates

Description

The routines gTransformPoint2D() and gTransformPoint3D() transform the specified point into picture coordinates according to the current global transformation matrix (modelling and viewing). If transforming is switched off, the returned point is the same as the input point.

If the global transformation contains 3-D (in the case of gTransformPoint2D()) or perspective terms (either routine), warning messages are output. In addition to this, (in the case of gTransformPoint3D()) if the point lies behind the eye plane, which means that it does not project into picture coordinates, point3 is returned set to zero and a warning message is output.

See Also

gTransformPoint2D Usage

---