plfsurf3d
( | x , |
| y , | |
| zops , | |
| zp , | |
| 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 data contained in the 2D
const PLFLT * const * matrix or the PLfGrid2 structure
. How the data in
zp
is rendered is determined by the
zp
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:
zops
plf2ops_c() (use when
is of type
zp
const PLFLT * const *),
plf2ops_grid_c() (use when
is a pointer to a row-major zp
PLfGrid2 structure),
plf2ops_grid_row_major()
(same as plf2ops_grid_c()?) and
plf2ops_grid_col_major()
(use when
is a pointer to a
column-major zp
PLfGrid2 structure).
,
nx
ny
opt
and
clevel
are the same as in
for example nlevel
plsurf3d.
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
values at
which function is evaluated.
x
ny
(PLINT, input)
Number of
values at
which function is evaluated.
y
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
: Network
of lines is drawn connecting points at which function is
defined.
opt=FACETED
: A contour
plot is drawn at the base XY plane using parameters
opt=BASE_CONT
nlevel and clevel.
: A contour
plot is drawn at the surface plane using parameters
opt=SURF_CONT
nlevel and clevel.
: draws a curtain
between the base XY plane and the borders of the plotted function.
opt=DRAW_SIDES
:
the surface is colored according to the value of Z; if
opt=MAG_COLOR
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.
clevel
(const PLFLT *, input)
Pointer to the array that defines the contour level spacing.
nlevel
(PLINT, input)
Number of elements in the clevel array.
Redacted form? plfsurf3d(x, y, zops, zp, opt, clevel)
This function is used in example 8.