NAME

       plsurf3dl - Plot shaded 3-d surface plot for z[x][y] with y index limits

SYNOPSIS

       plsurf3dl(x, y, z, nx, ny, opt, clevel, nlevel, indexxmin, indexxmax, indexymin, indexymax)

DESCRIPTION

       This variant of plsurf3d(3plplot) (see that function's documentation for more details) should be suitable
       for  the  case where the area of the x, y coordinate grid where z is defined can be non-rectangular.  The
       limits of that grid are provided by the parameters indexxmin, indexxmax, indexymin, and indexymax.

       Redacted form: plsurf3dl(x, y, z, opt, clevel, indexxmin, indexymin, indexymax)

       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.

       indexxmin (PLINT, input)
              The index value (which must be ≥ 0) that corresponds to the first x index where z is defined.

       indexxmax (PLINT, input)
              The index value (which must be ≤ nx) which corresponds (by convention) to one more than the last x
              index value where z is defined.

       indexymin (const PLINT *, input)
              Array  of  y  index  values  which all must be ≥ 0.  These values are the first y index where z is
              defined for a particular x index in the range from indexxmin to indexxmax - 1.  The  dimension  of
              indexymin is indexxmax.

       indexymax (const PLINT *, input)
              Array  of  y  index values which all must be ≤ ny.  These values correspond (by convention) to one
              more than the last y index where z is defined for a particular x index in the range from indexxmin
              to indexxmax - 1.  The dimension of indexymax is indexxmax.

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, 2016                               PLSURF3DL(3plplot)