/usr/share/doc/plplot-doc/html/plsurf3d.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>&#13;      plsurf3d: Plot shaded 3-d surface plot
    </TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="The PLplot Plotting Library"
HREF="index.html"><LINK
REL="UP"
TITLE="The Common API for PLplot"
HREF="api.html"><LINK
REL="PREVIOUS"
TITLE="
      plstyl: Set line style
    "
HREF="plstyl.html"><LINK
REL="NEXT"
TITLE="
      plfsurf3d: Plot shaded 3-d surface plot
    "
HREF="plfsurf3d.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="stylesheet.css"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The PLplot Plotting Library: Programmer's Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="plstyl.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 19. The Common API for PLplot</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="plfsurf3d.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H3
CLASS="sect1"
><A
NAME="plsurf3d"
><CODE
CLASS="function"
>plsurf3d</CODE
>: Plot shaded 3-d surface plot</A
></H3
><P
>&#13;      <DIV
CLASS="funcsynopsis"
><P
></P
><A
NAME="AEN12415"
></A
><TABLE
CLASS="funcprototype"
><TR
><TD
><CODE
CLASS="FUNCDEF"
>&#13;	    plsurf3d
	  </CODE
>(x, y, z, nx, ny, opt, clevel, nlevel);</TD
></TR
></TABLE
><P
></P
></DIV
>
    </P
><P
>&#13;      Plots a three dimensional shaded surface plot within the environment set up
      by <A
HREF="plw3d.html"
><CODE
CLASS="function"
>plw3d</CODE
></A
>.  The surface is defined by the two-dimensional array
      <TT
CLASS="literal"
><CODE
CLASS="parameter"
>z</CODE
>[<CODE
CLASS="parameter"
>nx</CODE
>][<CODE
CLASS="parameter"
>ny</CODE
>]</TT
>,
      the point <TT
CLASS="literal"
><CODE
CLASS="parameter"
>z</CODE
>[i][j]</TT
> being the
      value of the function at <TT
CLASS="literal"
>(<CODE
CLASS="parameter"
>x</CODE
>[i],
      <CODE
CLASS="parameter"
>y</CODE
>[j])</TT
>.  Note that the points in
      arrays <TT
CLASS="literal"
><CODE
CLASS="parameter"
>x</CODE
></TT
> and
      <TT
CLASS="literal"
><CODE
CLASS="parameter"
>y</CODE
></TT
> do not need to be equally
      spaced, but must be stored in ascending order.
      For further details see <A
HREF="tri-d-plots.html"
>the Section called <I
>Three Dimensional Surface Plots</I
> in Chapter 3</A
>.
    </P
><TABLE
CLASS="variablelist"
><TR
><TD
><DL
><DT
><CODE
CLASS="parameter"
>x</CODE
>
	  (<TT
CLASS="literal"
>PLFLT *</TT
>, input)</DT
><DD
><P
>&#13;	    Pointer to set of x coordinate values at which the function is
	    evaluated.
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>y</CODE
>
	  (<TT
CLASS="literal"
>PLFLT *</TT
>, input)</DT
><DD
><P
>&#13;	    Pointer to set of y coordinate values at which the function is
	    evaluated.
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>z</CODE
>
	  (<TT
CLASS="literal"
>PLFLT **</TT
>, input)</DT
><DD
><P
>&#13;	    Pointer to a vectored two-dimensional array with set of
	    function values.
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>nx</CODE
>
	  (<TT
CLASS="literal"
>PLINT</TT
>, input)</DT
><DD
><P
>&#13;	    Number of <TT
CLASS="literal"
><CODE
CLASS="parameter"
>x</CODE
></TT
> values at
	    which function is evaluated.
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>ny</CODE
>
	  (<TT
CLASS="literal"
>PLINT</TT
>, input)</DT
><DD
><P
>&#13;	    Number of <TT
CLASS="literal"
><CODE
CLASS="parameter"
>y</CODE
></TT
> values at
	    which function is evaluated.
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>opt</CODE
>
	  (<TT
CLASS="literal"
>PLINT</TT
>, input)</DT
><DD
><P
>&#13;	    Determines the way in which the surface is represented. To specify
	    more than one option just add the options, e.g. FACETED + SURF_CONT
	    <P
></P
><UL
><LI
><P
>&#13;		  <TT
CLASS="literal"
><CODE
CLASS="parameter"
>opt</CODE
>=FACETED</TT
>: Network
		  of lines is drawn connecting points at which function is
		  defined.
		</P
></LI
><LI
><P
>&#13;		  <TT
CLASS="literal"
><CODE
CLASS="parameter"
>opt</CODE
>=BASE_CONT</TT
>: A contour
		  plot is drawn at the base XY plane using parameters
		  <CODE
CLASS="parameter"
>nlevel</CODE
> and <CODE
CLASS="parameter"
>clevel</CODE
>.
		</P
></LI
><LI
><P
>&#13;		  <TT
CLASS="literal"
><CODE
CLASS="parameter"
>opt</CODE
>=SURF_CONT</TT
>: A contour
		  plot is drawn at the surface plane using parameters
		  <CODE
CLASS="parameter"
>nlevel</CODE
> and <CODE
CLASS="parameter"
>clevel</CODE
>.
		</P
></LI
><LI
><P
>&#13;		  <TT
CLASS="literal"
><CODE
CLASS="parameter"
>opt</CODE
>=DRAW_SIDES</TT
>: draws a curtain
		  between the base XY plane and the borders of the plotted function.
		</P
></LI
><LI
><P
>&#13;		  <TT
CLASS="literal"
><CODE
CLASS="parameter"
>opt</CODE
>=MAG_COLOR</TT
>:
		  the surface is colored according to the value of Z; if
		  <TT
CLASS="literal"
>MAG_COLOR</TT
> is not used, then the default
		  the surface is colored according to the intensity of the
		  reflected light in the surface from a light source whose
		  position is set using <A
HREF="pllightsource.html"
><CODE
CLASS="function"
>pllightsource</CODE
></A
>.
		</P
></LI
></UL
>
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>clevel</CODE
>
	  (<TT
CLASS="literal"
>PLFLT *</TT
>, input)</DT
><DD
><P
>&#13;	    Pointer to the array that defines the contour level spacing.
	  </P
></DD
><DT
><CODE
CLASS="parameter"
>nlevel</CODE
>
	  (<TT
CLASS="literal"
>PLINT</TT
>, input)</DT
><DD
><P
>&#13;	    Number of elements in the <TT
CLASS="literal"
>clevel</TT
> array.
	  </P
></DD
></DL
></TD
></TR
></TABLE
><P
>&#13;      Redacted form: <CODE
CLASS="function"
>plsurf3d(x, y, z, opt, clevel)</CODE
>
    </P
><P
>&#13;      This function is not used in any examples.
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="plstyl.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="plfsurf3d.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><CODE
CLASS="function"
>plstyl</CODE
>: Set line style</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="api.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><CODE
CLASS="function"
>plfsurf3d</CODE
>: Plot shaded 3-d surface plot</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
plplot-doc 5.9.9-5 / usr / share / doc / plplot-doc / html / plsurf3d.html
