trusty (3) plfsurf3d.3plplot.gz

Provided by: plplot-doc_5.10.0-0ubuntu5_all bug

NAME
       plfsurf3d - Plot shaded 3-d surface plot


SYNOPSIS
       plfsurf3d(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   const  PLFLT  *  const  *  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  const PLFLT * const *),
       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 (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.

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

       zp (PLPointer, input)
              Pointer to the data to be plotted, either  as  a  vectored   two-dimensional  array  with  set  of
              function values or as a 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 (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                               PLFSURF3D(3plplot)