SET INDIVIDUAL ASF(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pset_indiv_asf ( att_id, att_source )
Paspectatt_id;attribute identifier
Pasfatt_source;attribute source

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 if the value used for that attribute is taken from a defined attribute bundle (for example, from the polymarker representation selected by the current polymarker index) or from an attribute value defined individually (for example, from the current marker type set by SET MARKER TYPE (3P)).

If the current edit mode is INSERT, 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, 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

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

typedef enum {
PASPECT_LINETYPE,
PASPECT_LINEWIDTH,
PASPECT_LINE_COLR_IND,
PASPECT_MARKER_TYPE,
PASPECT_MARKER_SIZE,
PASPECT_MARKER_COLR_IND,
PASPECT_TEXT_FONT,
PASPECT_TEXT_PREC,
PASPECT_CHAR_EXPAN,
PASPECT_CHAR_SPACE,
PASPECT_TEXT_COLR_IND,
PASPECT_INT_STYLE,
PASPECT_INT_STYLE_IND,
PASPECT_INT_COLR_IND,
PASPECT_EDGE_FLAG,
PASPECT_EDGETYPE,
PASPECT_EDGEWIDTH,
PASPECT_EDGE_COLR_IND,
PASPECT_LINE_SHAD_METH,
PASPECT_INT_SHAD_METH,
PASPECT_REFL_PROPS,
PASPECT_INT_REFL_EQN,
PASPECT_BACK_INT_STYLE,
PASPECT_BACK_INT_STYLE_IND,
PASPECT_BACK_INT_COLR,
PASPECT_BACK_INT_SHAD_METH,
PASPECT_BACK_REFL_PROPS,
PASPECT_BACK_INT_REFL_EQN,
PASPECT_CURVE_APPROX_CRIT,
PASPECT_SURF_APPROX_CRIT
} Paspect;

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 {
PASF_BUNDLED,
PASF_INDIV
} Pasf;

Execution

When the SET INDIVIDUAL ASF element is encountered during traversal, the ASF entry in the 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