SET MARKER TYPE(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SET MARKER TYPE − create structure element to set the current marker type attribute

SYNOPSIS

C Syntax

void
pset_marker_type ( markertype )
Pintmarkertype;marker type

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET MARKER TYPE creates a structure element containing a value for the current marker type attribute.

When the current marker type Aspect Source Flag (ASF) is set to INDIVIDUAL, the current value of this attribute defines the marker type to be applied to the output primitives:

• POLYMARKER

• POLYMARKER 3

C Input Parameter

markertype
An integer value specifying a marker type; the following marker types are defined:

1PMARKER_DOTPoint (.)
2PMARKER_PLUSPlus sign (+)
3PMARKER_ASTERISK Asterisk (∗)
4PMARKER_CIRCLECircle (○)
5PMARKER_CROSSX-mark (×)

Support for marker types is workstation dependent.

Execution

If the current edit mode is INSERT, a SET MARKER TYPE element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET MARKER TYPE element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

When the SET MARKER TYPE element is traversed, the current marker type entry in the PHIGS traversal state list is set to marker type.

When the current marker type ASF is set to INDIVIDUAL, POLYMARKER and POLYMARKER 3 output primitives which follow in the structure network are then drawn using the marker type specified.

The default marker type is 3, Asterisk (∗). If the marker type specified is not available on the workstation, the default will be used.

When the current marker type ASF is set to BUNDLED, the effective marker type is the marker type attribute in the polymarker representation selected by the current polymarker index. In this case, the marker type set with SET MARKER TYPE has no effect.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum