SET POLYMARKER INDEX(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SET POLYMARKER INDEX − create a structure element containing a polymarker representation index attribute

SYNOPSIS

C Syntax

void
pset_marker_ind ( index )
Pintindex;polymarker index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET POLYMARKER INDEX creates a structure element containing a polymarker index number, which selects an entry from the workstation’s polymarker bundle table. This attribute applies to the output primitives:

• POLYMARKER
• POLYMARKER 3

If the current edit mode is INSERT, a SET POLYMARKER INDEX 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 POLYMARKER INDEX element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

C Input Parameter

indexA polymarker index for a polymarker representation on the workstation.

Execution

When the SET POLYMARKER INDEX element is traversed, the ‘current polymarker index’ value is set to the polymarker index, which specifies an entry from the workstation’s polymarker bundle table. The default polymarker index is 1, and if the polymarker index specified is not available on the workstation, 1 will be used. When the ASFs are INDIVIDUAL, the attributes come from the appropriate SET attribute elements.

A polymarker representation contains values for the following attributes:

• marker type
• marker size scale factor
• polymarker colour index

Polymarker output primitives which follow in the structure network will be drawn using the values from the specified representation for those attributes whose Aspect Source Flag (ASF) is set to BUNDLED.

Polymarker representations are defined with SET POLYMARKER REPRESENTATION.

ERRORS

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

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

Museum