[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
The graPHIGS Programming Interface : Subroutine Reference
GPMG2 - Marker Grid 2
GPMG2
(point,
refv1,
refv2,
imin,
imax,
jmin,
jmax) |
Purpose
Use
GPMG2 to insert a Marker Grid 2 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 2 structure element depending on
the current edit mode.
When encountered during structure traversal, this element
generates a grid of markers in the
z=0 plane of
modelling coordinates.
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
+ jV2
imin
<= i <= imax
jmin
<= j <= jmax
Polymarker attributes are applied to this primitive.
GPMG2 is identified as GDP 1021.
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,
2 short floating-point numbers (MC)
origin of grid
(P0
)
refv1 -- specified by user,
2 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,
2 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
201344258
(X'0C004502')
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]