SET PATTERN SIZE(3P) — SUNPHIGS LIBRARY

NAME

SET PATTERN SIZE − create structure element to set the current pattern size

SYNOPSIS

C Syntax

void
psetpatsize ( size )
Ppoint∗size;pattern size

FORTRAN Syntax

SUBROUTINE pspa ( SZX, SZY )
REALSZX, SZYpattern size (MC)

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET PATTERN SIZE creates a structure element containing a value for the current pattern width vector and current pattern height vector attributes. When the interior style is PATTERN, these attributes apply to the following output primitives:

• FILL AREA

• FILL AREA 3

• FILL AREA SET

• FILL AREA SET 3

Note: This function places the appropriate data in the Central Structure Store and in SunPHIGS archives, but the structure element is currently ignored during traversal.

If the current edit mode is INSERT when SET PATTERN SIZE is called, the SET PATTERN SIZE 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 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

sizeThe pattern size, specified in Modelling Coordinates (MC). Ppoint is defined in phigs.h as:

typedef struct {
Pfloatx; /∗ x coordinate ∗/
Pfloaty; /∗ y coordinate ∗/
} Ppoint;

FORTRAN Input Parameters

SZXThe x coordinate of the pattern size, specified in Modelling Coordinates (MC).

SZYThe y coordinate of the pattern size, specified in MC.

Execution

When the SET PATTERN SIZE element is traversed, the ‘current pattern width vector’ entry in the PHIGS traversal state list is set to the x coordinate in the element’s pattern size, and the ‘current pattern height vector’ entry in the PHIGS traversal state list is set to the y coordinate in the element’s pattern size.

When the interior style (either individual or bundled, as selected by the ‘current interior style ASF’) is set to PATTERN, these attributes are used in conjunction with the current pattern reference point and vectors for the area-defining primitives which follow in the structure network.

ERRORS

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

Museum