# plsurf3d.3plplot man page

**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.p…) have contributed to PLplot over its long history.

## See Also

PLplot documentation at http://plplot.sourceforge.net/documenta….