`plsurf3d`: Plot shaded 3-d surface plot
Prev | Chapter 17. The Common API for PLplot | Next

#### `plsurf3d`: Plot shaded 3-d surface plot

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

Plots a three-dimensional shaded surface plot within the environment set up by `plw3d`. The surface is defined by the two-dimensional matrix ``z`[`nx`][`ny`]`, the point ``z`[i][j]` being the value of the function at `(`x`[i],`y`[j])`. Note that the points in vectors ``x`` and ``y`` do not need to be equally spaced, but must be stored in ascending order. For further details see the section called “Three-dimensional Plots”.

`x` (``PLFLT_VECTOR``, input)

  A vector containing the x coordinates at which the function is evaluated.

`y` (``PLFLT_VECTOR``, input)

  A vector containing the y coordinates at which the function is evaluated.

`z` (``PLFLT_MATRIX``, input)

  A matrix containing function values to plot. Should have dimensions of `nx` by `ny`.

`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 surface is colored according to the intensity of the reflected light in the surface from a light source whose position is set using `pllightsource`.

`clevel` (``PLFLT_VECTOR``, input)

  A vector containing the contour levels.

`nlevel` (``PLINT``, input)

  Number of elements in the `clevel` vector.

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

This function is not used in any examples.

Prev | Up | Next
`plstyl`: Set line style | Home | `plsurf3dl`: Plot shaded 3-d surface plot for z[x][y] with y index limits