PSFASD(3g) — Subroutines

Name

PSFASD − Specifies the 2D shorthand form of the set of fill area sets with data primitive.

Operating States: PHOP, ∗, STOP, ∗
PHIGS PLUS function
Creates a structure element

Syntax

PSFASD (FFLAG, EFLAG, VFLAG, CTYPE, NCC, NFS, FCOLI, FCOLR, FNXA,
FNYA, FNZA, FDLEN, FDATA, NF, NP, IXA, EDATA, PXA, PYA, VCOLI, VCOLR,
VNXA, VNYA, VNZA, VDLEN, VDATA, VIND)

Argument        Data Type      Access   Description
---------------------------------------------------------------------------
FFLAG           Integer        Read     Data per facet flag
EFLAG           Integer        Read     Data per edge flag
VFLAG           Integer        Read     Data per vertex flag
CTYPE           Integer        Read     Color type
NCC             Integer        Read     Number of color value components
NFS             Integer        Read     Number of fill area sets
FCOLI(NFS)      Array of       Read     Facet color indexes
                integers
FCOLR(NCC∗NFS) Array of       Read     Facet color values
                reals
FNXA(NFS),      Real           Read     Facet normal data, in modeling
FNYA(NFS),                              coordinates
FNZA(NFS)
FDLEN           Integer        Read     Length of the data list per facet
FDATA(FDLEN∗    Array of       Read     Facet data
NFS)            reals
NF(NFS)         Array of       Read     Array of end indexes in IXA for
                integers                each fill area set
NP              Integer        Read     Number of points
IXA(NF(NFS))    Array of       Read     Array of end vertex indexes
                integers                in VIND for each fill area
EDATA(IXA       Array of       Read     Edge data
(NF(NFS))       integers
PXA(NP),        Real           Read     Coordinates of the points, in
PYA(NP)                                 modeling coordinates
VCOLI(NP)       Array of       Read     Vertex color indexes
                integers
VCOLR(NCC∗NP)   Array of       Read     Vertex color values
                reals
VNXA(NP),       Real           Read     Vertex normal data, in modeling
VNYA(NP),                               coordinates
VNZA(NP)
VDLEN           Integer        Read     Length of the data list per vertex
VDATA(VDLEN     Array of       Read     Vertex data
∗NP)            reals
VIND(IXA        Array of       Read     Vertex indexes for each fill area
(NF(NFS)))      integers
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
FFLAG                PFNO         No facet data
                     PFC          Color per facet
                     PFN          Geometric normal per facet
                     PFD          Data per facet
                     PFCN         Color and geometric normal per facet
                     PFCD         Color and data per facet
                     PFND         Geometric normal and data per facet
                     PFCND        Color, geometric normal, and data per
                                  facet
EFLAG                PENO         No edge data
                     PEVF         Edge visibility flag
VFLAG                PCD          Coordinate only
                     PCDC         Color per vertex
                     PCDN         Normal per vertex
                     PCDD         Data per vertex
                     PCDCN        Color and geometric normal per vertex
                     PCDCD        Color and data per vertex
                     PCDND        Geometric normal and data per vertex
                     PCDCND       Color, geometric normal, and data per
                                  vertex
CTYPE                PINDIR       Indirect (indexed) color
                     PRGB         Direct specification of red, green, and
                                  blue
                     PCIE         Direct specification in the format of the
                                  Commission Internationale de l’Eclairage
                     PHSV         Direct specification of hue, saturation,
                                  and value
                     PHLS         Direct specification of hue, lightness,
                                  and saturation
EDATA                POFF         Edges off
                     PON          Edges on
---------------------------------------------------------------------------

Description

PSFASD specifies the two-dimensional shorthand form of the set of fill area sets with data primitive. Digital PHIGS assumes that all the vertices of the primitive have a z-coordinate value of 0.

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new set of fill area sets with data element.

You can supply data for the facet color, facet normal, and facet application-specific information for each facet (each fill area set). If you specify information for one facet, it is required for all the facets.

You supply the vertex coordinates for each vertex data and can supply data for the vertex color, vertex normal, and vertex application-specific information for each vertex. If you specify information for one vertex, it is required for all the vertices.

If you specify facet or vertex colors, you must also specify a color type.

When Digital PHIGS interprets this element, it generates a number of fill area sets. An index value of 1 selects the first vertex in the vertex data list, a value of 2 selects the second vertex, and so on. The function selects the vertices that define each fill area using a list of lists of indexes. Each list of indexes specifies a polygon boundary, which is implicitly closed (to define an area). Digital PHIGS binds the current values of the set of fill area sets with data attributes to the primitive.

If a set of fill area sets with data element contains a polygon boundary with less than three points, the function will not display the polygon.

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element.

Digital PHIGS Version 3.1 does not support this function.

Museum

PSFASD(3g) — Subroutines

Name

Syntax

Constants

Description

See Also