SET PATTERN REFERENCE POINT AND VECTORS(3P) — SUNPHIGS LIBRARY

NAME

SET PATTERN REFERENCE POINT AND VECTORS − create structure element to set the current pattern reference point and vectors

SYNOPSIS

C Syntax

void
psetpatrefptvectors ( ref_pt, dx, dy )
Ppoint3∗ref_pt;pattern reference point
Pvector3∗dx;direction vector 1; X axis of pattern
Pvector3∗dy;direction vector 2; Y axis of pattern

FORTRAN Syntax

SUBROUTINE psprpv ( RFX, RFY, RFZ, RFVX, RFVY, RFVZ )
REALRFX, RFY, RFZreference point (MC)
REALRFVX(2), RFVY(2), RFVZ(2) reference vectors (MC)

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET PATTERN REFERENCE POINT AND VECTORS creates a structure element containing a value for the ‘current pattern reference point’ and ‘current pattern reference vectors’ 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, a SET PATTERN REFERENCE POINT AND VECTORS 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 Parameters

ref_ptThe pattern reference point, in Modelling Coordinates (MC).. The Ppoint3 structure is defined in phigs.h as:

typedef struct {
Pfloatx; /∗ x coordinate ∗/
Pfloaty; /∗ y coordinate ∗/
Pfloatz; /∗ z coordinate ∗/
} Ppoint3;

dxA pointer to the direction vector giving the x axis of pattern in MC. The Pvector3 structure is defined in phigs.h as:

typedef struct {
Pfloatx; /∗ x magnitude ∗/
Pfloaty; /∗ y magnitude ∗/
Pfloatz; /∗ z magnitude ∗/
} Pvector3;

dxA pointer to the direction vector giving the y axis of pattern.

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.

RFZ"The z coordinate of the pattern reference point, in MC.

RFVXThe x coordinates of the two pattern reference vectors, in MC.

RFVY"
The y coordinates of the two pattern reference vectors, in MC.

RFVZ"
The z coordinates of the two pattern reference vectors, in MC.

Execution

When the SET PATTERN REFERENCE POINT AND VECTORS element is traversed, the ‘current pattern reference point’ and ‘current pattern reference vectors’ entries in the PHIGS traversal state list are set to the values contained in this element. 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