NAME

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

SYNOPSIS

C Syntax

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

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 ∗/
Pintcolr_ind;/∗ colour index ∗/
} Pmarker_bundle;

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

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

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->colr_ind is the 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 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 (that is, 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

SEE ALSO

SET POLYMARKER INDEX (3P)
SET INDIVIDUAL ASF (3P)
INQUIRE POLYMARKER FACILITIES (3P)
INQUIRE POLYMARKER REPRESENTATION (3P)
SET MARKERTYPE (3P)
SET MARKER SIZE SCALE FACTOR (3P)
SET POLYMARKER COLOUR INDEX (3P)
SET POLYMARKER COLOUR (3P+)
SET POLYMARKER REPRESENTATION PLUS (3P+)

September 02, 1992