[ 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 ]