POLYMARKER(3G)

NAME

polymarker − draw the current marker symbol centered at each endpoint specified in the clist array.

SYNOPSIS

C SYNTAX

void polymarker2d(fildes,clist,numpts,flags);
int fildes,flags,numpts;
float clist[];
void polymarker3d(fildes,clist,numpts,flags);
int fildes,flags,numpts;
float clist[];
void dcpolymarker(fildes, clist, numpts, flags);
int fildes,flags,numpts,clist[];

FORTRAN77 SYNTAX

        subroutine polymarker2d(fildes,clist,numpts,flags)
        integer*4 fildes,flags,numpts
        real clist(numpts*(2+flags))
         subroutine polymarker3d(fildes,clist,numpts,flags)
        integer*4 fildes,flags,numpts
        real clist(numpts*(3+flags))
         subroutine dcpolymarker(fildes,clist,numpts,flags)
        integer*4 fildes,flags,numpts
        integer*4 clist(numpts*(2+flags))

PASCAL SYNTAX

procedure polymarker2d(fildes:integer;
var clist:array[lo..hi:integer] of real;
numpts,flags:integer);
procedure polymarker3d(fildes:integer;
var clist:array[lo..hi:integer] of real;
numpts,flags:integer);
procedure dcpolymarker(fildes:integer;
var clist:array[lo..hi:integer] of integer;
numpts,flags:integer);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphic device is opened.
flags
If set to TRUE (1), move/draw data is included in the clist. If set to FALSE (0), move/draw data is not included in the clist.
Move-draw indicators occupy the same space as one coordinate and are interspersed with the coordinate data. All bits of the indicator must be zero to indicate a move (integer 0 or real 0.0). If the data is 2d, each (x,y) pair of coordinates is followed by a move draw indicator. If the data is 3d, each (x,y,z) triplet is followed by a move-draw indicator. For example:

2-dimensions3_dimensions
x1x1
y1y1
m/d1z1
x2m/d1
y2x2
m/d2y2
.z2
.m/d2
..
..

clist
is an array of real endpoint data with or without move/draw indicators embedded after each endpoint.
numpts
is the number of points in the clist array. If a value smaller than the total number of points in the array is specified, the smaller number of markers is drawn.

DISCUSSION

A marker is centered at each coordinate specified in the clist array regardless of whether that coordinate is a move or a draw. If flags is TRUE (1), the clist entry following the coordinate is skipped.

The current marker symbol is drawn at each endpoint independent of the move-draw indicators. Lines are not drawn between marker symbols. To draw lines between marker symbols, use the corresponding polyline procedure.

The marker is drawn with the current marker_color. As with all output primitives it is affected by the current drawing_mode and write_protect.

Move-draw indicators occupy the same space as one coordinate and are interspersed with the coordinate data.

Museum

Related Articles