PFAS3D(3g) — Subroutines

Name

PFAS3D − Creates a structure element that specifies values for data and data flags, defining the 3D form of the output primitive.

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

Old Syntax

DFASD3 (SHPFLG, FAFLAG, VTXFLG, EDFLAG, CLRTYP, FICOL, FCOL, FNX,
FNY, FNZ, NPL, IXA, EDGVIS, PXA, PYA, PZA, IVCOL, VCOL, VNXA, VNYA, VNZA)

Argument         Data Type      Access   Description
---------------------------------------------------------------------------
SHPFLG           Integer        Read     Shape of the facet
FAFLAG           Integer        Read     Data per facet flag
VTXFLG           Integer        Read     Data per vertex flag
EDFLAG           Integer        Read     Data per edge flag
CLRTYP           Integer        Read     Type of color data
FICOL            Integer        Read     Facet indexed color
FCOL(∗)          Array of       Read     Facet direct color (r,g,b,r,g,b)
                 reals
FNX, FNY,        Real           Read     Facet normal
FNZ
NPL              Integer        Read     Number of fill areas
IXA(NPL)         Array of       Read     Array of end indexes for the vertex
                 integers                lists
EDGVIS           Array of       Read     Array of edge visibility flags
                 integers
PXA(∗),          Array of       Read     Vertex list
PYA(∗),          reals
PZA(∗)
IVCOL(∗)         Array of       Read     Vertex indexed color list
                 integers
VCOL(∗)          Array of       Read     Vertex direct color list
                 reals                   (r,g,b,r,g,b)
VNXA(IXA(NPL)), Array of       Read     Vertex normal list
VNYA(IXA(NPL)), reals
VNZA(IXA(NPL))
---------------------------------------------------------------------------

New Syntax

PFAS3D (FFLAG, EFLAG, VFLAG, CTYPE, NCC, FCOLI, FCOLR, FNXA,
FNYA, FNZA, FDLEN, FDATA, NPL, IXA, EDATA, PXA, PYA, PZA, VCOLI, VCOLR,
VNXA, VNYA, VNZA, VDLEN, VDATA)

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
FCOLI           Integer        Read     Facet color index
FCOLR(NCC)      Real           Read     Facet color values
FNXA, FNYA,     Real           Read     Facet normal data, in modeling
FNZA                                    coordinates
FDLEN           Integer        Read     Length of the data list per facet
FDATA(FDLEN)    Real           Read     Facet data
NPL             Integer        Read     Number of point lists
IXA(NPL)        Array of       Read     Array of end indexes for the point
                integers                lists
EDATA(IXA       Integer        Read     Edge data
(NPL))
PXA(IXA(NPL)), Real           Read     Coordinates of the points, in
PYA(IXA(NPL)),                          modeling coordinates
PZA(IXA(NPL))
VCOLI(IXA(NPL)) Integer        Read     Vertex color indexes
VCOLR(NCC∗      Real           Read     Vertex color values
IXA(NPL))
VNXA(IXA(NPL)), Real           Read     Vertex normal data, in modeling
VNYA(IXA(NPL)),                         coordinates
VNZA(IXA(NPL))
VDLEN           Integer        Read     Length of the data list per vertex
VDATA(VDLEN∗    Real           Read     Vertex data
IXA(NPL))
---------------------------------------------------------------------------

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

PFAS3D creates a structure element that specifies values for the following:

•Data per fill area set flag

•Data per edge flag

•Data per vertex flag

•Fill area set data

•Edge data flag

•Vertex data

It fully specifies the three-dimensional form of the output primitive.

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 fill area set 3 with data element.

The edge visibility data consists of an ON/OFF flag for each edge of the fill area set. The following restrictions apply:

•The first entry of the first list in the edge visibility data corresponds to the edge between the first two vertices of the first contour.

•One visibility flag must exist for each vertex.

•The last entry of the list for each contour controls the visibility of the edge, from the last to the first vertex of the contour.

•If the edge visibility data is specified, an edge will be displayed only when both the edge flag attribute is ON and the edge visibility flag is ON.

If the data per vertex flag indicates that a color per vertex is specified, a direct color model value must also be specified for the output primitive.

If the data per vertex flag specifies coordinates and color, or coordinates, colors, and normals, you must specify a list of colors (one for each vertex). If the data per vertex flag specifies coordinates and normals, or is coordinates, colors, and normals, you must specify a list of normals (one for each vertex).

If the data per vertex flag indicates that you have specified a color per vertex, you must also have specified a direct color model value.

During structure traversal, the following occurs:

•Digital PHIGS draws a fill area set 3 with data primitive.

•Digital PHIGS generates an implicitly closed polygonal area. An area with less than three vertices is considered degenerate and its appearance is indeterminate. The appearance of a nonplanar fill area may vary with orientation.

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

The new function syntax conforms to the ISO Fortran standard. Digital recommends that you code using the new function syntax.