1PLSURF3D(3plplot)                 PLplot API                 PLSURF3D(3plplot)
2
3
4

NAME

6       plsurf3d - Plot shaded 3-d surface plot
7

SYNOPSIS

9       plsurf3d(x, y, z, nx, ny, opt, clevel, nlevel)
10

DESCRIPTION

12       Plots  a  three  dimensional shaded surface plot within the environment
13       set up by plw3d(3plplot).  The surface is  defined  by  the  two-dimen‐
14       sional  array z[nx][ny], the point z[i][j] being the value of the func‐
15       tion at (x[i], y[j]).  Note that the points in arrays x and  y  do  not
16       need  to  be equally spaced, but must be stored in ascending order. For
17       further details see the PLplot documentation.
18
19       Redacted form: plsurf3d(x, y, z, opt, clevel)
20
21       This function is used in example 8.
22

ARGUMENTS

24       x (PLFLT *, input)
25              Pointer to set of x coordinate values at which the  function  is
26              evaluated.
27
28       y (PLFLT *, input)
29              Pointer  to  set of y coordinate values at which the function is
30              evaluated.
31
32       z (PLFLT **, input)
33              Pointer to a vectored two-dimensional array with set of function
34              values.
35
36       nx (PLINT, input)
37              Number of x values at which function is evaluated.
38
39       ny (PLINT, input)
40              Number of y values at which function is evaluated.
41
42       opt (PLINT, input)
43              Determines the way in which the surface is represented. To spec‐
44              ify more than one option just add the options,  e.g.  FACETED  +
45              SURF_CONT  opt=FACETED:  Network  of  lines  is drawn connecting
46              points at which function is defined.  opt=BASE_CONT:  A  contour
47              plot  is  drawn at the base XY plane using parameters nlevel and
48              clevel.  opt=SURF_CONT: A contour plot is drawn at  the  surface
49              plane using parameters nlevel and clevel.  opt=DRAW_SIDES: draws
50              a curtain between the base XY plane and the borders of the plot‐
51              ted  function.   opt=MAG_COLOR: the surface is colored according
52              to the value of Z; if MAG_COLOR is not used,  then  the  default
53              the  surface  is  colored  according  to  the  intensity  of the
54              reflected light in the surface from a light source  whose  posi‐
55              tion is set using pllightsource(3plplot).
56
57
58       clevel (PLFLT *, input)
59              Pointer to the array that defines the contour level spacing.
60
61       nlevel (PLINT, input)
62              Number of elements in the clevel array.
63
64

AUTHORS

66       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
67       man page was automatically generated from the  DocBook  source  of  the
68       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
69       Laboissiere.
70

SEE ALSO

72       PLplot documentation at http://plplot.sourceforge.net/resources.
73
74
75
76                                  March, 2007                PLSURF3D(3plplot)
Impressum