Provided by: plplot-doc_5.9.9-2ubuntu2_all bug

NAME

       plfsurf3d - Plot shaded 3-d surface plot

SYNOPSIS

       plsurf3d(x, y, zops, zp, 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 data contained in the 2D  PLFLT ** matrix or
       the  PLfGrid2  structure  zp.  How  the data in  zp is rendered is determined by the  zops
       parameter. zops is a pointer to a function that reads the data out of the grid  structure.
       The  following  functions  in  PLplot  core  will  return an appropriate function pointer:
       plf2ops_c() (use when  zp is of type  PLFLT **),  plf2ops_grid_c()  (use  when   zp  is  a
       pointer   to   a   row-major   PLfGrid2  structure),   plf2ops_grid_row_major()  (same  as
       plf2ops_grid_c()?) and  plf2ops_grid_col_major() (use when zp is a pointer to  a   column-
       major  PLfGrid2  structure).   nx,  nyoptclevel  and nlevel are the same as in for example
       plsurf3d(3plplot).

       Redacted form? plfsurf3d(x, y, zops, zp, opt, clevel)

       This function is used in example 8.

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.

       zops (void (*) (?), input)
              Pointer to a function for processing the data contained in zp.

       zp (PLFLT ** or PLfGrid2 *, input)
              Pointer to the data to be plotted, either as a vectored  two-dimensional array with
              set of function values, or as PLfGrid2 structure.

       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 (PLFLT *, input)
              Pointer to the array that defines the contour level spacing.

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

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.

                                          February, 2012                       PLFSURF3D(3plplot)