[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
The graPHIGS Programming Interface : Subroutine Reference
GPQPMF - Inquire Polymarker Facilities
GPQPMF
(wstype,
start,
number,
errind,
ntype,
mtype,
nsize,
size,
minms,
maxms,
npred) |
Note:
This subroutine is a Workstation Description Table (WDT)
inquiry.
For an overview, see
"WDT Inquiries"
Purpose
Use
GPQPMF to inquire the polymarker facilities
for the specified workstation type.
The graPHIGS API returns data indicating the total number of
available marker types and their identifiers
(ntype[default] the nominal
(size), minimum
(minms), and maximum
(maxms) marker sizes; and the number of
predefined polymarker bundle table indexes for the specified
workstation type
(npred)
If the number of available marker sizes is returned as
zero, then the workstation supports a continuous range of
marker sizes.
If the information is available, then the graPHIGS API sets the
error indicator to zero and returns the values in the output
parameter.
If the error indicator is
543
(the start value exceeds
the extent of the available data), then only the total
number
(totnum) parameter is set.
If the inquired information is unavailable, then the error
indicator
(errind) contains the error
number indicating the reason, and the values returned in the
output parameter are unpredictable.
Parameters
wstype -- specified by user,
8-byte character string
Workstation type.
start -- specified by user, fullword integer
Starting member of the list of marker types
(>=1)
number -- specified by user, fullword integer
Number of polymarker types requested
(>=0)
errind -- returned by the graPHIGS API, fullword integer
Error indicator. If the error indicator is zero, the request has been
completed. Otherwise, one of the following errors exists:
- 23
- SPECIFIED WORKSTATION TYPE DOES NOT EXIST
- 35
- WORKSTATION HAS ONLY INPUT CAPABILITIES
- 538
- START VALUE < ONE
- 539
- REQUESTED NUMBER < ZERO
- 543
- START EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED
- 548
- SPECIFIED WORKSTATION TYPE CANNOT BE LOADED
ntype -- returned by the graPHIGS API, fullword integer
Total number of available marker types.
mtype -- returned by the graPHIGS API, array of fullword
integers.
List of available maker types in the workstation's
available marker type table.
The table size and specific entries supported are
workstation dependent.
The default marker type table for supported entries is
defined with the following marker types:
(1=DOT, 2=PLUS_SIGN, 3=ASTERISK, 4=CIRCLE,
5=DIAGONAL_CROSS, 6-n=ASTERISK
)
nsize -- returned by the graPHIGS API, fullword integer
Number of available marker sizes.
Zero means that the workstation supports a continuous range
of marker sizes.
size -- returned by the graPHIGS API, short floating-point number (DC)
Nominal marker size.
minms -- returned by the graPHIGS API, short floating-point number (DC)
Minimum marker size.
maxms -- returned by the graPHIGS API, short floating-point number (DC)
Maximum marker size.
npred -- returned by the graPHIGS API, fullword integer
Number of predefined polymarker bundle table entries.
Error Codes
None
Related Subroutines
- GPQRCT
- Inquire Realized Connection Type
RCP code
201339655
(X'0C003307')
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]