SET POLYMARKER REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

SET POLYMARKER REPRESENTATION − define a polymarker attribute bundle on a workstation

SYNOPSIS

C Syntax

void
psetmarkerrep ( ws, index, rep )
Pintws;workstation identifier
Pintindex;polymarker bundle index
Pmkbundl∗rep;polymarker representation pointer

FORTRAN Syntax

SUBROUTINE pspmr ( WKID, PMI, MTYPE, MSZSF, COLI )
INTEGERWKIDworkstation identifier
INTEGERPMIpolymarker index
INTEGERMTYPEmarker type
REALMSZSFmarker size scale factor
INTEGERCOLIcolour index

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET POLYMARKER REPRESENTATION defines a bundle of polymarker attributes for a specified entry in the workstation’s polymarker bundle table.

Depending on the ASF for each of the polymarker attributes, the bundled attributes may apply to the following primitives:

• POLYMARKER
• POLYMARKER 3

C Input Parameters

wsThe identifier of the workstation for which the polymarker representation is being defined.

indexThe polymarker index of the entry being defined.

repA pointer to a structure containing the attribute values defining the polymarker representation, defined as follows:

typedef struct {
Pinttype;/∗ marker type ∗/
Pfloatsize;/∗ marker size scale factor ∗/
Pintcolour;/∗ colour index ∗/
} Pmkbundl;

rep->type is an integer value specifying a marker type; the following marker types are defined:

ValueMarker TypeMeaning
1PMK_POINTPoint (.)
2PMK_PLUSPlus sign (+)
3PMK_STARAsterisk (∗)
4PMK_OCircle (○)
5PMK_XX-mark (×)
0PMK_SQUARESquare (□)
-1PMK_BOWTIE_NEBowtie -1 ( □□ )
-2PMK_BOWTIE_NWBowtie -2 ( □□ )

Support for marker types is workstation dependent. The Point (.) marker type is always the smallest dot possible, regardless of the marker size scale factor value applicable. rep->size is the marker size scale factor. rep->colour is the polymarker colour index, which selects a colour value from the workstation’s colour table.

FORTRAN Input Parameters

WKIDThe identifier of the workstation for which the polymarker representation is being defined.

PMIThe polymarker index of the entry being defined.

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

ValueMarker TypeMeaning
1PPOINTPoint (.)
2PPLUSPlus sign (+)
3PASTAsterisk (∗)
4POMARKCircle (○)
5PXMARKX-mark (×)
0PSQUARESquare (□)
-1PBOWTIENEBowtie -1 ( □□ )
-2PBOWTIENWBowtie -2 ( □□ )

Support for marker types is workstation dependent. The Point (.) marker type is always the smallest dot possible, regardless of the marker size scale factor value applicable.

MSZSF
The marker size scale factor.

COLIThe polymarker colour index, which selects a colour value from the workstation’s colour table.

Execution

When SET POLYMARKER REPRESENTATION is called, the polymarker index entry in the table of defined polymarker representations on the workstation is set to the marker type, marker size scale factor, and polymarker colour index values.

When polymarker output primitives are displayed, the polymarker representation specified by the current polymarker index entry in the PHIGS traversal state list provides the polymarker attributes for which the Aspect Source Flag (ASF) is BUNDLED. For example, 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. The current polymarker index is set by SET POLYMARKER INDEX elements.

The polymarker bundle table is numbered from 1.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

100Ignoring function, the bundle index value is less than one

103Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation bundle table

105Ignoring function, the specified marker type is not available on the specified workstation

113Ignoring function, the colour index value is less than zero

Museum