POLYMARKER(3G)

NAME

polymarker − draw current marker symbol centered at each endpoint specified in 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);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphic device is opened.

clist Array of world (for polymarker2d and polymarker3d) or device (for dcpolymarker) coordinate data with or without extra coordinates and move/draw indicators embedded after each endpoint.

numpts Number of points in the clist array. If less than zero, zero is used.

flags If set to TRUE (1), move/draw data is included in the clist after x,y,z and any extra coordinates.

If set to FALSE (0), move/draw data is not included in the clist. Move/draw indicators occupy the same amount of space as a single 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-dimensions	3-dimensions
x1	x1
y1	y1
m/d1	z1
x2	m/d1
y2	x2
m/d2	y2
.	z2
.	m/d2
.	.
.	.

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 move/draw flag following the position coordinates is ignored.

Each entry in the clist may contain any number of coordinates. The actual number depends on the coord parameter specified in vertex_format. The coord parameter can be used to skip over any extra coordinates following the usual 2, 3, or 4 that can be specified with this procedure. Vertex move/draw flags follow the skipped extra coordinates.

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, polymarker is affected by the current drawing_mode and write_protect.

Museum

Related Articles