SET EXTENDED POLYMARKER REPRESENTATION(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

SET EXTENDED POLYMARKER REPRESENTATION − use to define an extended polymarker attribute bundle on a workstation

SYNOPSIS

C Syntax

void
psetextmarkerrep ( wsid, index, rep )
Pintwsid;workstation identifier
Pintindex;polymarker bundle index number
Pextmkbundl∗rep;pointer to extended marker representation

FORTRAN Syntax

SUBROUTINE psepmr ( WKID, INDEX, MTYPE, MSIZE, COLMOD, IMCOLR, MCOLR )
INTEGERWKIDworkstation identifier
INTEGERINDEXpolymarker bundle index
INTEGERMTYPEpolymarker type
REALMSIZEpolymarker size scale factor
INTEGERCOLMODcolour model
INTEGERIMCOLRindirect colour index
REALMCOLR(3)direct colour value

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET EXTENDED POLYMARKER REPRESENTATION defines an extended polymarker attribute bundle on a workstation.

This is a SunPHIGS Extension function based on PHIGS+ and is not part of the PHIGS standard.

C Input Parameters

All of the following data types are predefined in phigs.h.

wsidThe identifier of the workstation.

indexThis is an index to the workstation marker bundle table.

repA pointer to a Pextmkbundl structure. Pextmkbundl is defined as:

typedef struct {
Pinttype;/∗ marker type ∗/
Pfloatsize;/∗ marker size scale factor ∗/
Pgcolrcolour;/∗ marker colour ∗/
} Pextmkbundl;

Pgcolr is defined as:

typedef struct {
Pint type;/∗ indirect, RGB, CIE, HSV, HLS ∗/
union {
   Pintindex;/∗ colour table index ∗/
   struct {
Pfloatx;/∗ red, hue, etc. ∗/
Pfloaty;/∗ green, saturation, lightness, etc. ∗/
Pfloatz;/∗ blue, value, saturation, etc. ∗/
   } general;
} val;
} Pgcolr;

FORTRAN Input Parameters

All of the following data types are predefined in phigs77.h.

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

INDEX
The index into the specified workstation polymarker bundle table.

MTYPE
The polymarker type. Predefined values are:

1PPOINTPoint (.)
2PPLUSPlus Sign (+)
3PASTAsterisk (∗)
4POMARKCircle ( O )
5PXMARKX-mark ( x )
0PSQUARESquare ( □ )
-1PBOWTIENEBowtie -1 ( □□ )
-2PBOWTIENWBowtie -2 ( □□ )

MSIZE
The polymarker size scale factor.

COLMOD
The colour model. The predefined values are:

0PINDIRColour Index Specified
1PRGBRed, Green, and Blue
2PCIECIE Colour Model
3PHSVHue, Saturation, and Value
4PHLSHue, Lightness, and Saturation

IMCOLR
An integer index into the workstation colour table for determining the polymarker colour. This value is only used if COLMOD is equal to PINDIR.

MCOLR(3)
An array of reals containing the polymarker colour. This array is unused if COLMOD is equal to PINDIR.

MCOLR(1) = Red, Hue, etc.
MCOLR(2) = Green, Saturation, Lightness, etc.
MCOLR(3) = Blue, Value, Saturation, etc.

Execution

In the polymarker bundle table of the workstation state list, the given index is associated with the specified parameters.

The marker size scale factor is a scale factor applied to the nominal marker size. During structure traversal, the scale factor is multiplied by the nominal marker size on a workstation. The result is mapped by the workstation to the nearest available marker size.

Polymarker colour is a general colour, either an indirect or a direct colour in a specified colour model. If an indirect colour is specified and the specified colour index is not available during structure traversal, then colour index one is used.

The extended polymarker bundle table in the workstation state list has predefined entries taken from the workstation description table. A number of these entries are predefined for every workstation of category OUTPUT or OUTIN. Any table entry, including the predefined entries, may be redefined with this function.

When polymarkers are displayed during structure traversal, the current polymarker index in the PHIGS traversal state list refers to an entry in the extended polymarker bundle table. If the current polymarker index is not present in the extended polymarker bundle table, then polymarker index one is used. The setting of the corresponding Aspect Source Flags(ASFs) determines which aspects in the entry are used.

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

110Ignoring function, the specified colour model is not available on the workstation

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

Museum