NAME

       plsurf3d - Plot shaded 3-d surface plot

SYNOPSIS

       plsurf3d(x, y, z, nx, ny, opt, clevel, nlevel)

DESCRIPTION

       Plots  a  three  dimensional  shaded  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. For further
       details see the PLplot documentation.

       Redacted form: plsurf3d(x, y, z, opt, clevel)

       This function is not used in any examples.

ARGUMENTS

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

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

       z (const PLFLT * const *, 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. To specify more than one
              option just add the options, e.g. FACETED + SURF_CONT opt=FACETED: Network of lines
              is  drawn connecting points at which function is defined.  opt=BASE_CONT: A contour
              plot  is  drawn  at  the  base  XY  plane  using  parameters  nlevel  and   clevel.
              opt=SURF_CONT: A contour plot is drawn at the surface plane using parameters nlevel
              and clevel.  opt=DRAW_SIDES: draws a curtain between the  base  XY  plane  and  the
              borders  of  the plotted function.  opt=MAG_COLOR: the surface is colored according
              to the value of Z; if MAG_COLOR 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 pllightsource(3plplot).

       clevel (const PLFLT *, input)
              Pointer to the array that defines the contour level spacing.

       nlevel (PLINT, input)
              Number of elements in the clevel array.

AUTHORS

       Many developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php)  have
       contributed to PLplot over its long history.

SEE ALSO

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

                                          February, 2014                        PLSURF3D(3plplot)