graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPMT - Set Marker Type

GPMT (mtype)

Purpose

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

This structure element specifies an index into a workstation markertype table that contains marker types that the graPHIGS API uses to render all subsequent polymarker primitives. At structure traversal time, the graPHIGS API uses this marker type to render the polymarker primitives when the marker type aspect source flag is set to 2=INDIVIDUAL

The traversal default for marker type is 3=ASTERISK

If your workstation does not support the specified entry or the entry is outside the allowable range, then the marker type index defaults to 3=ASTERISK

Parameters

mtype -- specified by user, fullword integer

Specifies an index into the marker type table of the workstation. The table size and specific entries supported are workstation dependent. Use the Inquire Polymarker Facilities (GPQPMF) subroutine to determine the supported marker types on your workstation. 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 ) Use the Set Marker Type Representation (GPMTR) subroutine to change any entry except entry 3.

Error Codes

5: FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
69: MARKER TYPE VALUE < ONE

Related Subroutines

GPASF: Attribute Source Flag Setting
GPQPMF: Inquire Polymarker Facilities
GPQPMR: Inquire Predefined Polymarker Representation
GPQXMR: Inquire Extended Polymarker Representation
GPXPMR: Set Extended Polymarker Representation

RCP code

201328644 (X'0C000804')