1PLPOLY3(3plplot)                  PLplot API                  PLPOLY3(3plplot)
2
3
4

NAME

6       plpoly3 - Draw a polygon in 3 space
7

SYNOPSIS

9       plpoly3(n, x, y, z, draw, ifcc)
10

DESCRIPTION

12       Draws  a  polygon  in 3 space defined by n points in x, y, and z. Setup
13       like  plline3(3plplot),  but  differs  from  that  function   in   that
14       plpoly3(3plplot)  attempts  to  determine  if  the  polygon is viewable
15       depending on the order of the points within the arrays and the value of
16       ifcc.   If  the  back  of  polygon  is facing the viewer, then it isn't
17       drawn.  If this isn't what you want, then use plline3(3plplot) instead.
18
19       The points are assumed to be in a plane, and the directionality of  the
20       plane  is determined from the first three points.  Additional points do
21       not have to lie on the plane defined by the first three, but if they do
22       not, then the determination of visibility obviously can't be 100% accu‐
23       rate... So if you're 3 space polygons are too far from planar, consider
24       breaking them into smaller polygons.  3 points define a plane :-).
25
26       Bugs:   If  one of the first two segments is of zero length, or if they
27       are co-linear, the calculation of visibility  has  a  50/50  chance  of
28       being  correct.   Avoid such situations :-).  See x18c.c for an example
29       of this problem. (Search for 20.1).
30
31       Redacted form: plpoly3(x, y, z, code)
32
33       This function is used in example 18.
34

ARGUMENTS

36       n (PLINT, input)
37              Number of points defining line.
38
39       x (PLFLT *, input)
40              Pointer to array with x coordinates of points.
41
42       y (PLFLT *, input)
43              Pointer to array with y coordinates of points.
44
45       z (PLFLT *, input)
46              Pointer to array with z coordinates of points.
47
48       draw (PLBOOL *, input)
49              Pointer to array which controls  drawing  the  segments  of  the
50              polygon.   If  draw[i]  is  true,  then the polygon segment from
51              index [i] to [i+1] is drawn, otherwise, not.
52
53       ifcc (PLBOOL, input)
54              If ifcc is true the directionality of the polygon is  determined
55              by  assuming  the  points  are  laid  out in a counter-clockwise
56              order.  Otherwise, the directionality of the polygon  is  deter‐
57              mined by assuming the points are laid out in a clockwise order.
58
59

AUTHORS

61       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
62       man page was automatically generated from the  DocBook  source  of  the
63       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
64       Laboissiere.
65

SEE ALSO

67       PLplot documentation at http://plplot.sourceforge.net/resources.
68
69
70
71                                  July, 2010                  PLPOLY3(3plplot)
Impressum