SET PATTERN REFERENCE POINT(3P) — SUNPHIGS LIBRARY

NAME

SET PATTERN REFERENCE POINT − create structure element to set the current pattern reference point

SYNOPSIS

C Syntax

void
psetpatrefpt ( ref_pt )
Ppoint∗ref_pt;pattern reference point

FORTRAN Syntax

SUBROUTINE psparf ( RFX, RFY )
REALRFX, RFYpattern reference point (MC)

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET PATTERN REFERENCE POINT creates a structure element containing a value for the ‘current pattern reference point’ attribute. The structure implicitly resets the ‘current pattern reference vectors’ attribute as well. 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, a SET PATTERN REFERENCE POINT 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

ref_ptThe pattern reference point is given in Modelling Coordinates (MC), using a 2-D shorthand; 0 is used as the z coordinate. The Ppoint type is defined in phigs.h as:

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

FORTRAN Input Parameters

RFXThe x coordinate of the pattern reference point, in Modelling Coordinates (MC).

RFY"The y coordinate of the pattern reference point, in MC.

Execution

When the SET PATTERN REFERENCE POINT element is traversed, the ‘current pattern reference point’ entry in the PHIGS traversal state list is set to the x and y values contained in this element, and the z value 0. The ‘current pattern reference vectors’ are set to (1,0,0) and (0,1,0). 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 width and height vectors for the area-defining primitives which follow in the structure network.

ERRORS

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

Museum