GINO Graphics Suite - GINO v9.0  

gSetPointMode

Syntax

[C/C++:]
void gSetPointMode(int switch);
[F90:]
subroutine gSetPointMode(switch)
integer, intent(in) ::switch

Arguments

switch
Point storage mode

= GOFF, Switch point storing off
= GSPACE, Store points in space coordinates
= GPICTURE, Store points in picture coordinates
= GCLEAR, Clear current point storage workspace

Description

The routine gSetPointMode() sets the current point storage mode. When set to either GSPACE or GPICTURE, the vertices of all subsequent 2D and 3D drawing routines are stored in the point storage workspace. These include all internal vertices generated from the drawing of arcs, curves and software characters according to the respective tolerance and/or tension. Points are stored in either space (untransformed) or picture (transformed) mode according to the setting of switch. Note that all arcs are drawn in software when point storage is switched on.

The point storage workspace is emptied if  GCLEAR is used or a different mode is set.

Before using this routine, both the global workspace and point storage workspace must be defined using the routines gSetWorkspaceLimit() and gDefinePointWorkspace().

Points can be returned to the application in either 2D or 3D using the functions gReturnInternalPoints2D() or gReturnInternalPoints3D(). In the former case all Z-coordinates are ignored.

See Also

gSetPointMode Usage
gDefinePointWorkspace
gReturnInternalPoints2D
gReturnInternalPoints3D
gSetWorkspaceLimit