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 matrix 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 vectors 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 not used in any examples.
22

ARGUMENTS

24       x (PLFLT_VECTOR(3plplot), input)
25              A vector containing the x coordinates at which the  function  is
26              evaluated.
27
28       y (PLFLT_VECTOR(3plplot), input)
29              A  vector  containing the y coordinates at which the function is
30              evaluated.
31
32       z (PLFLT_MATRIX(3plplot), input)
33              A matrix containing function values to plot.  Should have dimen‐
34              sions of nx by ny.
35
36       nx (PLINT(3plplot), input)
37              Number of x values at which function is evaluated.
38
39       ny (PLINT(3plplot), input)
40              Number of y values at which function is evaluated.
41
42       opt (PLINT(3plplot), 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 :
50              draws a curtain between the base XY plane and the borders of the
51              plotted  function.   opt=MAG_COLOR  : the surface is colored ac‐
52              cording to the value of Z; if MAG_COLOR is not  used,  then  the
53              surface  is  colored according to the intensity of the reflected
54              light in the surface from a light source whose position  is  set
55              using pllightsource(3plplot).
56
57
58       clevel (PLFLT_VECTOR(3plplot), input)
59              A vector containing the contour levels.
60
61       nlevel (PLINT(3plplot), input)
62              Number of elements in the clevel vector.
63
64

AUTHORS

66       Many  developers  (who  are  credited at http://plplot.org/credits.php)
67       have contributed to PLplot over its long history.
68

SEE ALSO

70       PLplot documentation at http://plplot.org/documentation.php.
71
72
73
74                                 January, 2023               PLSURF3D(3plplot)
Impressum