[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPMG3 - Marker Grid 3

GPMG3 (point, refv1, refv2, imin, imax, jmin, jmax)

Purpose

Use GPMG3 to insert a Marker Grid 3 structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Marker Grid 3 structure element depending on the current edit mode.

When encountered during structure traversal, this element generates a grid of markers in the plane defined by point, refv1, refv2 Each grid location is defined by the following parametric equation and is subject to all transformations and clipping.

Each position on the grid is defined by the following parametric vector equation:

P(i,j) = P0 + iV1 + jV 2

imin <= i <= imax
imin <= j <= jmax

Polymarker attributes are applied to this primitive.

GPMG3 is identified as GDP 1020.

Note:

Not all GDPs are supported on all workstations. Use the Inquire List of Generalized Drawing Primitives (GPQGD) subroutine to determine the GDPs supported by an opened workstation. See also the workstation description in The graPHIGS Programming Interface: Technical Reference

Parameters

point -- specified by user, 3 short floating-point numbers (MC)

origin of grid (P0 )

refv1 -- specified by user, 3 short floating-point numbers (MC)

i reference vector (V1 ) This vector defines the relative location of the next grid location that is obtained by incrementing the i parameter.

refv2 -- specified by user, 3 short floating-point numbers (MC)

j reference vector (V2 ) This vector defines the relative location of the next grid location that is obtained by incrementing the j parameter.

imin -- specified by user, fullword integer

Minimum i parameter limit (imin ) This parameter specifies the smallest value of the i parameter at which markers are generated (<=imax)

imax -- specified by user, fullword integer

Maximum i parameter limit (imax ) This parameter specifies the largest value of the i parameter at which markers are generated (>=imin)

jmin -- specified by user, fullword integer

Minimum j parameter limit (jmin ) This parameter specifies the smallest value of the j parameter at which markers are generated (<=jmax)

jmax -- specified by user, fullword integer

Maximum j parameter limit (jmax ) This parameter specifies the largest value of the j parameter at which markers are generated (>=jmin)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
107
REFERENCE VECTORS ARE COLINEAR
340
MINIMUM GRID LIMIT > MAXIMUM

Related Subroutines

GPMSSC
Set Marker Size Scale Factor
GPMT
Set Marker Type
GPPMCD
Set Polymarker Color Direct
GPPMCI
Set Polymarker Color Index
GPPMI
Set Polymarker Index

RCP code

201344257 (X'0C004501')


[ Previous | Next | Contents | Glossary | Home | Search ]