PQPLP(3g) — Subroutines
Name
PQPLP − Returns extended polyline representation information.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS PLUS function
Old Syntax
DQPLRP (WKID, PLI, TYPE, MLDR, ERRIND, LTYPE, LWIDTH, CLRTYP, ICOLR,
COLR, SHDMD, APRXTP, LDR, DATREC)
Argument Data Type Access Description
---------------------------------------------------------------------------
WKID Integer Read Workstation identifier
PLI Integer Read Polyline index
TYPE Integer Read Type of the returned values
MLDR Integer Read Maximum length of output data
record
ERRIND Integer Write Error indicator
LTYPE Integer Write Polyline type
LWIDTH Real Write Line width scale factor
CLRTYP Integer Write Polyline color type
ICOLR Integer Write Indexed color value
COLR(3) Array of Write Direct color value
reals
SHDMD Integer Write Polyline shading method
APRXTP Integer Write Curve approximation criteria type
LDR Integer Write Length of the curve approximation
data record
DATREC(MLDR) Array of Write Curve approximation data record
character ∗80
---------------------------------------------------------------------------
New Syntax
PQPLP (WKID, PLI, CCSBSZ, TYPE, MLDR, ERRIND, LTYPE, LWIDTH,
CTYPE, COLI, NCC, COLR, PLSM, ACRI, LDR, DATREC)
Argument Data Type Access Description
---------------------------------------------------------------------------
WKID Integer Read Workstation identifier
PLI Integer Read Polyline index
CCSBSZ Integer Read Buffer size of the color component
specification
TYPE Integer Read Type of the returned values
MLDR Integer Read Maximum length of output data
record
ERRIND Integer Write Error indicator
LTYPE Integer Write Polyline type
LWIDTH Real Write Line width scale factor
CTYPE Integer Write Polyline color type
COLI Integer Write Color index
NCC Integer Write Number of color value components
COLR(CCSBSZ) Array of Write Color values
reals
PLSM Integer Write Polyline shading method
ACRI Integer Write Curve approximation criteria type
LDR Integer Write Length of the curve approximation
data record array
DATREC(MLDR) Array of Write Curve approximation data record
character ∗80
---------------------------------------------------------------------------
Constants
Defined Argument Constant Description
---------------------------------------------------------------------------
TYPE PSET Use the exact state list values.
PREALI Use the values approximated by the
graphics handler.
LTYPE PLSOLI Solid edge.
PLDASH Dashed edge.
PLDOT Dotted edge.
PLDASD Dashed-dotted edge.
PLDS2D Dash-2-dots edge.
PLDS3D Dash-3-dots edge.
PLLDS Long dashed edge.
PLLSDS Long-short dashed edge.
PLSPDS Spaced dashed edge.
PLSPD Spaced dotted edge.
PL2D Double-dotted edge.
PL3D Triple-dotted edge.
CTYPE PINDIR Indirect (indexed) color.
PRGB Direct specification of red, green, and
blue.
PCIE Direct specification in the format of the
Commission Internationale de l’Eclairage.
PHSV Direct specification of hue, saturation,
and value.
PHLS Direct specification of hue, lightness,
and saturation.
PLSM PNOIS No interpolation, constant shading.
PCIS Linear interpolation of color.
PDDIS Interpolation of color based on dot
products.
PDNIS Interpolation of color based on normals.
ACRI PWDCA Workstation-dependent method.
PCBKCA Constant parametric subdivision between
knots.
PCSWCA Chordal size, in world coordinates.
PCSNCA Chordal size, in normalized projection
coordinates.
PCSDCA Chordal size, in device coordinates.
PPDWCA Planar deviation, in world coordinates.
PPDNCA Planar deviation, in normalized projection
coordinates.
PPDDCA Planar deviation, in device coordinates
PRWCA Relative, in world coordinates.
PRNCA Relative, in normalized projection
coordinates.
PRDCA Relative, in device coordinates.
DCSDCA Constant subdivision (non-PEX only).
DIDCA Implementation-dependent method (PEX only).
---------------------------------------------------------------------------
Description
PQPLP returns information on the extended polyline representation, including the line type, line width, line color, and shading method.
Data Record Information
If ACRI is PWDCA, there is no data record.
If ACRI is PCBKCA or DCSDCA, the data record has the following format:
INTEGER IL = 1 Number of integer values
INTEGER IA(1) = Count
RL = 0
RA = ()
SL = 0
LSTR = ()
STR = ()
If ACRI is PCSWCA, PCSNCA, PCSDCA, PCDWCA, PCDNCA, PCDDCA, PRWCA, PRNCA, or PRDCA, the data record has the following format:
IL = 0
IA = ()
RL = 1
INTEGER RA(1) = Approximation value
SL = 0
LSTR = ()
STR = 0
If ACRI is DIDCA, the data record has the following format:
IL = 0
IA = 0
RL = 1 Number of reals
RA(1) = Approximation value
SL = 0
LSTR = ()
STR = ()
See Also
PQEPLI
PQPLR
PQPPLR
PQPPLP
PSPLR
PSPLP