PTSD(3g) — Subroutines

Name

PTSD − Specifies the 2D, shorthand form of the triangle set with data primitive.

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

Syntax

PTSD (FFLAG, EFLAG, VFLAG, CTYPE, NCC, NTRI, FCOLI, FCOLR,
FNXA, FNYA, FNZA, FDLEN, FDATA, NP, 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
NTRI            Integer        Read     Number of triangles
FCOLI(NTRI)     Integer        Read     Facet color indexes
FCOLR(NCC∗NTRI) Real           Read     Facet color values
FNXA(NTRI),     Real           Read     Facet normal data, in modeling
FNYA(NTRI),                             coordinates
FNZA(NTRI)
FDLEN           Integer        Read     Length of the data list per facet
FDATA(FDLEN∗    Real           Read     Facet data
NTRI)
NP              Integer        Read     Number of points
EDATA(3∗NTRI)   Integer        Read     Edge data
PXA(NP),        Real           Read     Coordinates of the points, in
PYA(NP)                                 modeling coordinates
VCOLI(NP)       Integer        Read     Vertex color indexes
NFS             Integer        Read     Number of fill area sets
VCOLR(NCC∗NP)   Real           Read     Vertex color values
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     Real           Read     Vertex data
∗NP)
VIND(NTRI∗3)    Integer        Read     Vertex indexes
---------------------------------------------------------------------------

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

PTSD specifies the two-dimensional shorthand form of the triangle set with data primitive. Digital PHIGS assumes the z-value of the vertices is the value 0.

Depending on the 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 triangle set 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 set of triangles. 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 triples of indexes. Each triple defines a triangle. If a triangle set with data element contains a list of vertex data with less than three elements, the function will not display a triangle.

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

PTSD(3g) — Subroutines

Name

Syntax

Constants

Description

See Also