SET PATTERN REFERENCE POINT AND VECTORS(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pset_pat_ref_point_vecs ( ref_pt, pat_ref_vec )
Ppoint3∗ref_pt;pattern reference point
Pvec3pat_ref_vec[2];direction vectors; 1=X axis of pattern,
2=Y axis of pattern

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• NON-UNIFORM B-SPLINE SURFACE
• FILL AREA 3• SET OF FILL AREA SET 3 WITH DATA
• FILL AREA SET• TRIANGLE STRIP 3 WITH DATA
• FILL AREA SET 3• QUADRILATERAL MESH 3 WITH DATA
• FILL AREA SET 3 WITH DATA

Note: This function places the appropriate data in the Central Structure Store and in PEX-SI 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;

pat_ref_vec
A pointer to an array of two elements of type Pvec3. Array element 1 is the X axis of pattern in MC. Array element 2 is the Y axis. The Pvec3 structure is defined in phigs.h as:

typedef struct {
Pfloatdelta_x;/∗ x magnitude ∗/
Pfloatdelta_y;/∗ y magnitude ∗/
Pfloatdelta_z;/∗ z magnitude ∗/
} Pvec3;

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 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 size for the area-defining primitives that follow in the structure network.

ERRORS

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

Museum