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 clist entry following the coordinate is skipped.

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