Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

plpoly3(3plplot) [debian man page]

PLPOLY3(3plplot)						    PLplot API							  PLPOLY3(3plplot)

NAME

       plpoly3 - Draw a polygon in 3 space

SYNOPSIS

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

DESCRIPTION

       Draws  a  polygon  in  3  space	defined  by  n	points in x, y, and z. Setup like plline3(3plplot), but differs from that function in that
       plpoly3(3plplot) attempts to determine if the polygon is viewable depending on the order of the points within the arrays and the  value	of
       ifcc.  If the back of polygon is facing the viewer, then it isn't drawn.  If this isn't what you want, then use plline3(3plplot) instead.

       The  points are assumed to be in a plane, and the directionality of the plane is determined from the first three points.  Additional points
       do not have to lie on the plane defined by the first three, but if they do not, then the determination of  visibility  obviously  can't	be
       100%  accurate...  So  if you're 3 space polygons are too far from planar, consider breaking them into smaller polygons.  3 points define a
       plane :-).

       Bugs:  If one of the first two segments is of zero length, or if they are co-linear, the calculation of visibility has a  50/50	chance	of
       being correct.  Avoid such situations :-).  See x18c.c for an example of this problem. (Search for 20.1).

       Redacted form: plpoly3(x, y, z, code)

       This function is used in example 18.

ARGUMENTS

       n (PLINT, input)
	      Number of points defining line.

       x (PLFLT *, input)
	      Pointer to array with x coordinates of points.

       y (PLFLT *, input)
	      Pointer to array with y coordinates of points.

       z (PLFLT *, input)
	      Pointer to array with z coordinates of points.

       draw (PLBOOL *, input)
	      Pointer to array which controls drawing the segments of the polygon.  If draw[i] is true, then the polygon segment from index [i] to
	      [i+1] is drawn, otherwise, not.

       ifcc (PLBOOL, input)
	      If ifcc is true the directionality of the polygon is determined by assuming the points are laid out in  a  counter-clockwise  order.
	      Otherwise, the directionality of the polygon is determined by assuming the points are laid out in a clockwise order.

AUTHORS

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

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/resources.

								   August, 2012 						  PLPOLY3(3plplot)

Check Out this Related Man Page

PLOT3D(3plplot) 						    PLplot API							   PLOT3D(3plplot)

NAME

       plot3d - Plot 3-d surface plot

SYNOPSIS

       plot3d(x, y, z, nx, ny, opt, side)

DESCRIPTION

       Plots  a  three	dimensional  surface  plot within the environment set up by plw3d(3plplot).  The surface is defined by the two-dimensional
       array z[nx][ny], the point z[i][j] being the value of the function at (x[i], y[j]).  Note that the points in arrays x and y do not need	to
       be  equally spaced, but must be stored in ascending order.  The parameter opt controls the way in which the surface is displayed.  For fur-
       ther details see the PLplot documentation. The only difference between plmesh(3plplot) and plot3d(3plplot) is  that  plmesh(3plplot)  draws
       the bottom side of the surface, while plot3d(3plplot) only draws the surface as viewed from the top.

       Redacted form: plot3d(x, y, z, opt, side)

       This function is used in examples 11,21.

ARGUMENTS

       x (PLFLT *, input)
	      Pointer to set of x coordinate values at which the function is evaluated.

       y (PLFLT *, input)
	      Pointer to set of y coordinate values at which the function is evaluated.

       z (PLFLT **, input)
	      Pointer to a vectored two-dimensional array with set of function values.

       nx (PLINT, input)
	      Number of x values at which function is evaluated.

       ny (PLINT, input)
	      Number of y values at which function is evaluated.

       opt (PLINT, input)
	      Determines  the way in which the surface is represented: opt=DRAW_LINEX: Lines are drawn showing z as a function of x for each value
	      of y[j].	opt=DRAW_LINEY: Lines are drawn showing z as a function of y for each value of x[i].  opt=DRAW_LINEXY: Network of lines is
	      drawn connecting points at which function is defined.

       side (PLBOOL, input)
	      Flag  to	indicate  whether  or not ``sides'' should be draw on the figure.  If side is true sides are drawn, otherwise no sides are
	      drawn.

AUTHORS

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

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/resources.

								   August, 2012 						   PLOT3D(3plplot)
Man Page