SET INDIVIDUAL ASF(3P) — SUNPHIGS LIBRARY

NAME

SET INDIVIDUAL ASF − create structure element to set the current Aspect Source Flag (ASF) for an attribute

SYNOPSIS

C Syntax

void
psetindivasf ( att_id, att_source )
Pattridatt_id;attribute identifier
Pasfatt_source;attribute source

FORTRAN Syntax

SUBROUTINE psiasf ( ATTRID, ASFVAL )
INTEGERATTRIDattribute identifier
INTEGERASFVALaspect source flag value

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET INDIVIDUAL ASF creates a structure element containing the Aspect Source Flag (ASF) value for a specified output primitive attribute. The ASF setting for each attribute determines whether the value used for that attribute is taken from a defined attribute bundle (e.g., the polymarker representation selected by the current polymarker index) or from an attribute value defined individually (e.g., the current polymarker colour set by SET POLYMARKER COLOUR INDEX (3P)).

If the current edit mode is INSERT, then the structure element created is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, then the new SET INDIVIDUAL ASF 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 Parameters

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

att_idAn enumerated attribute identifier value specifying the attribute for which the ASF is to be set. Possible values are:

typedef enum {
PLINETYPE,
PLINEWIDTH_SCALE_FACTOR,
PPOLYLINE_COLOUR_INDEX,
PMARKERTYPE,
PMARKERSIZE_SCALE_FACTOR,
PPOLYMARKER_COLOUR_INDEX,
PTEXT_FONT,
PTEXT_PRECISION,
PCHARACTER_EXPANSION_FACTOR,
PCHARACTER_SPACING,
PTEXT_COLOUR_INDEX,
PINTERIOR_STYLE,
PINTERIOR_STYLE_INDEX,
PINTERIOR_COLOUR_INDEX,
PEDGE_FLAG,
PEDGETYPE,
PEDGEWIDTH_SCALE_FACTOR,
PEDGE_COLOUR_INDEX,
PCURVE_APPROXIMATION_CRITERIA,†
PSURFACE_APPROXIMATION_CRITERIA,†
PTRIMMING_CURVE_APPROXIMATION_CRITERIA,†
PPOLYLINE_SHADING_METHOD,†
PAREA_PROPERTIES,†
PINTERIOR_REFLECTANCE_EQUATION,†
PINTERIOR_SHADING_METHOD,†
PBACK_INTERIOR_STYLE,†
PBACK_INTERIOR_STYLE_INDEX,†
PBACK_INTERIOR_COLOUR,†
PBACK_AREA_PROPERTIES,†
PBACK_INTERIOR_REFLECTANCE_EQUATION,†
PBACK_INTERIOR_SHADING_METHOD†
} Pattrid;

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

att_source
An enumerated ASF value specifying the source that should be used for the attribute identifier or att_id. Values defined are:

typedef enum {
PBUNDLED,
PINDIVIDUAL
} Pasf;

FORTRAN Input Parameters

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

ATTRID
An enumerated attribute identifier value specifying the attribute for which the ASF is to be set. Valid values defined are:

0PLNLinetype
1PLWSCLinewidth Scale Factor
2PPLCIPolyline Colour Index
3PMK Markertype
4PMKSCMarkersize Scale Factor
5PPMCIPolymarker Colour Index
6PTXFNText Font
7PTXPRText Precision
8PCHXPCharacter Expansion Factor
9PCHSPCharacter Spacing
10PTXCIText Colour Index
11PISInterior Style
12PISIInterior Style Index
13PICIInterior Colour Index
14PEDFGEdge Flag
15PEDTYEdgetype
16PEWSCEdgewidth Scale Factor
17PEDCIEdge Colour Index
18PCAMCurve Approximation Criteria†
19PSAMSurface Approximation Criteria†
20PTCAMTrimming Curve Approximation Criteria†
21PPLSMPolyline Shading Method†
22PAPArea Properties†
23PIREQInterior Reflectance Equation†
24PISMInterior Shading Method†
25PBISBack Interior Style†
26PBISIBack Interior Style Index†
27PICBack Interior Colour†
28PBAPBack Area Properties†
29PBIREQBack Interior Reflectance Equation†
30PBISMBack Interior Shading Method†

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

ASFVAL
An enumerated ASF value specifying the source that should be used for the attribute ATTRID. Valid values defined are:

0PBUNDLBundled
1PINDIVIndividual

Execution

When the SET INDIVIDUAL ASF element is encountered during traversal, the ASF entry in the PHIGS traversal state list for the attribute identifier is set to the ASF value.

The current setting of the ASF for an attribute determines whether the current value of that attribute is taken from an attribute bundle or from an individually specified value set by the appropriate SET INDIVIDUAL ASF attribute function.

For example, when the current text font ASF is set to INDIVIDUAL, the value of the current text font (as set by SET TEXT FONT) is used for text output primitives. When the current text font ASF is set to BUNDLED, the text font from the workstation’s text representation indicated by the current text index is used instead.

ERRORS

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

Museum

Related Articles