PARTIAL_POLYGON(3G)

NAME

partial_polygon − defines a group of polygon vertices that begins as a subpolygon or a non-edged boundary.

SYNOPSIS

C SYNTAX

void partial_polygon2d(fildes,clist,numverts,flags,closure);
int fildes,numverts,flags,closure;
float clist[];
void partial_polygon3d(fildes,clist,numverts,flags,closure);
int fildes, numverts,flags,closure;
float clist[];
void dcpartial_polygon(fildes,clist,numverts,flags,closure);
int fildes,numverts,flags,closure,clist[];

FORTRAN77 SYNTAX

        subroutine partial_polygon2d(fildes,clist,numverts,
        flags,closure)
        integer*4 fildes,numverts,flags,closure
        real clist(numverts*(2+flags))
         subroutine partial_polygon3d(fildes,clist,numverts,
        flags,closure)
        integer*4 fildes,numverts,flags,closure
        real clist(numverts*(2+flags))
         subroutine dcpartial_polygon(fildes,clist,numverts,
        flags,closure)
        integer*4 fildes,numverts,flags,closure
        integer*4 clist(numverts*(2+flags))

PASCAL SYNTAX

procedure partial_polygon2d(fildes:integer;var clist:
array[lo..hi:integer] of real;numverts,flags,
closure:integer);
procedure partial_polygon3d(fildes:integer;var clist:
array[lo..hi:integer] of real;numverts,flags,
closure:integer);
procedure dcpartial_polygon(fildes:integer;var clist:
array[lo..hi:integer] of integer;numverts,flags,
closure:integer);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by when an I/O path to a graphics device is opened.
flags
If FALSE (0), the first vertex represents a nondrawn boundary, and the remaining represent drawn boundaries if interior_style is set to be edged.

If TRUE (1), each polygon edge can either be a drawn boundary or a non-drawn boundary depending on the value of the corresponding move-draw indicator and whether interior style is set to be edged. If the indicator (found after each x, y [,z] vertex) is non-zero (draw) and interior style is set to be edged, then the boundary is drawn, otherwise it is not drawn. Non-drawn boundaries simply define an edge to be filled to.

Move-draw indicators occupy the same space as one coordinate (one 32-bit value), and are interspersed with the coordinate data. All bits of an indicator must be zero to indicate a move (integer 0 or real 0.0). For partial_polygon2d and partial_dcpolygon, each (x,y) pair of coordinates is followed by a move draw indicator. For partial_polygon3d, each (x,y,z) triplet is followed by a move-draw indicator.
closure
If TRUE (1), and the polygon vertex list is non-empty, and the last subpolygon was not yet closed, then a boundary is added which closes that subpolygon with a boundary that is drawn if the first polygon vertex in this partial polygon had a draw indicator else the closing boundary is not drawn. partial_polygon then adds the vertices in clist to the polygon vertex list.
clist
is an array of integer (for dcpartial_polygon) or real (for partial_polygon) endpoint values with or without move/draw indicators embedded after each endpoint
numverts
number of polygon vertices in the clist array

DISCUSSION

Partial_polygon is filled and/or outlined according to the current interior style. It uses the current fill color and perimeter attributes. As with all output primitives it is affected by the current drawing mode and write enable.

NOTE

Doing any other Starbase call besides partial_polygon2d, partial_polygon3d, or dcpartial_polygon, in the middle of a list of these procedure calls produces unpredictable, device dependent results.

Hewlett-Packard — last mod. May 11, 2021

Museum

Related Articles