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_CONTnlevel
and clevel
.
: A contour
plot is drawn at the surface plane using parameters
opt
=SURF_CONTnlevel
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_COLORMAG_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.