NAME

clippnt - clip an array of points

SYNOPSIS

C
clippnt(mask, n, pretrans, postrans, index)
String mask;
long n;
Coord pretrans[][3], postrans[][4];
Boolean index[];

FORTRAN
subroutine clippn(mask, n, pretra, postra, index)
character∗(∗) mask
integer n
real pretra(3,n), postra(4,n)
logical index(n)

Pascal
procedure clippnt(mask: String; n: integer;
var pretrans: Coord3array;
var postrans: Coord4array;
var index: Boolarray);

DESCRIPTION

Clippnt selectively enables a subset of the six clipping planes. Mask is a string of characters specifying which clipping planes are enabled.  This string is chosen from ‘l’, ‘r’, ‘b’, ‘t’, ‘n’, and ‘f’, which represent the left, right, bottom, top, near, and far clipping planes.  Mask can name from one to six planes, in any order. 

Clippnt takes an array of n points in pretrans.  The transformed and partially clipped points are returned in postrans such that if pretrans[i] was not clipped out, postrans[i] is the transformed value. 

Index is an array of boolean values that show which entries in postrans contain valid data.  If index[i]=FALSE, pretrans[i] was clipped out and postrans[i] is undefined. 

SEE ALSO

clipline, clippoly, screenpnt, transform
 

NOTE

This command can only be used in immediate mode. 

Silicon Graphics  —  R1c