← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/plplot/intrepid

« back to all changes in this revision

Viewing changes to doc/docbook/src/plsurf3d.html

  • Committer: Bazaar Package Importer
  • Author(s): Rafael Laboissiere
  • Date: 2006-11-04 10:19:34 UTC
  • mfrom: (2.1.8 edgy)
  • Revision ID: james.westby@ubuntu.com-20061104101934-mlirvdg4gpwi6i5q
Tags: 5.6.1-10
* Orphaning the package
* debian/control: Changed the maintainer to the Debian QA Group

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/docbook/src/plsurf3d.html
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2
2
<HTML
3
3
><HEAD
4
4
><TITLE
6
6
    </TITLE
7
7
><META
8
8
NAME="GENERATOR"
9
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 
9
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
10
10
REL="HOME"
11
11
TITLE="The PLplot Plotting Library"
12
12
HREF="index.html"><LINK
61
61
WIDTH="80%"
62
62
ALIGN="center"
63
63
VALIGN="bottom"
64
 
>Chapter 16. The Common API for PLplot</TD
 
64
>Chapter 17. The Common API for PLplot</TD
65
65
><TD
66
66
WIDTH="10%"
67
67
ALIGN="right"
93
93
><P
94
94
></P
95
95
><A
96
 
NAME="AEN8682"
 
96
NAME="AEN9547"
97
97
></A
98
98
><TABLE
99
99
CLASS="funcprototype"
120
120
>plw3d</CODE
121
121
></A
122
122
>.  The surface is defined by the two-dimensional array
123
 
      <VAR
 
123
      <TT
124
124
CLASS="literal"
125
 
><VAR
126
 
CLASS="parameter"
127
 
>z</VAR
128
 
>[<VAR
129
 
CLASS="parameter"
130
 
>nx</VAR
131
 
>][<VAR
132
 
CLASS="parameter"
133
 
>ny</VAR
134
 
>]</VAR
 
125
><CODE
 
126
CLASS="parameter"
 
127
>z</CODE
 
128
>[<CODE
 
129
CLASS="parameter"
 
130
>nx</CODE
 
131
>][<CODE
 
132
CLASS="parameter"
 
133
>ny</CODE
 
134
>]</TT
135
135
>,
136
 
      the point <VAR
 
136
      the point <TT
137
137
CLASS="literal"
138
 
><VAR
 
138
><CODE
139
139
CLASS="parameter"
140
 
>z</VAR
141
 
>[i][j]</VAR
 
140
>z</CODE
 
141
>[i][j]</TT
142
142
> being the
143
 
      value of the function at <VAR
 
143
      value of the function at <TT
144
144
CLASS="literal"
145
 
>(<VAR
 
145
>(<CODE
146
146
CLASS="parameter"
147
 
>x</VAR
 
147
>x</CODE
148
148
>[i],
149
 
      <VAR
 
149
      <CODE
150
150
CLASS="parameter"
151
 
>y</VAR
152
 
>[j])</VAR
 
151
>y</CODE
 
152
>[j])</TT
153
153
>.  Note that the points in
154
 
      arrays <VAR
 
154
      arrays <TT
155
155
CLASS="literal"
156
 
><VAR
 
156
><CODE
157
157
CLASS="parameter"
158
 
>x</VAR
159
 
></VAR
 
158
>x</CODE
 
159
></TT
160
160
> and
161
 
      <VAR
 
161
      <TT
162
162
CLASS="literal"
163
 
><VAR
 
163
><CODE
164
164
CLASS="parameter"
165
 
>y</VAR
166
 
></VAR
 
165
>y</CODE
 
166
></TT
167
167
> do not need to be equally
168
168
      spaced, but must be stored in ascending order.
169
169
      For further details see <A
179
179
><TD
180
180
><DL
181
181
><DT
182
 
><VAR
 
182
><CODE
183
183
CLASS="parameter"
184
 
>x</VAR
 
184
>x</CODE
185
185
>
186
 
          (<VAR
 
186
          (<TT
187
187
CLASS="literal"
188
 
>PLFLT *</VAR
 
188
>PLFLT *</TT
189
189
>, input)</DT
190
190
><DD
191
191
><P
194
194
          </P
195
195
></DD
196
196
><DT
197
 
><VAR
 
197
><CODE
198
198
CLASS="parameter"
199
 
>y</VAR
 
199
>y</CODE
200
200
>
201
 
          (<VAR
 
201
          (<TT
202
202
CLASS="literal"
203
 
>PLFLT *</VAR
 
203
>PLFLT *</TT
204
204
>, input)</DT
205
205
><DD
206
206
><P
209
209
          </P
210
210
></DD
211
211
><DT
212
 
><VAR
 
212
><CODE
213
213
CLASS="parameter"
214
 
>z</VAR
 
214
>z</CODE
215
215
>
216
 
          (<VAR
 
216
          (<TT
217
217
CLASS="literal"
218
 
>PLFLT **</VAR
 
218
>PLFLT **</TT
219
219
>, input)</DT
220
220
><DD
221
221
><P
224
224
          </P
225
225
></DD
226
226
><DT
227
 
><VAR
228
 
CLASS="parameter"
229
 
>nx</VAR
230
 
>
231
 
          (<VAR
232
 
CLASS="literal"
233
 
>PLINT</VAR
234
 
>, input)</DT
235
 
><DD
236
 
><P
237
 
>           Number of <VAR
238
 
CLASS="literal"
239
 
><VAR
240
 
CLASS="parameter"
241
 
>x</VAR
242
 
></VAR
243
 
> values at
244
 
            which function is evaluated.
245
 
          </P
246
 
></DD
247
 
><DT
248
 
><VAR
249
 
CLASS="parameter"
250
 
>ny</VAR
251
 
>
252
 
          (<VAR
253
 
CLASS="literal"
254
 
>PLINT</VAR
255
 
>, input)</DT
256
 
><DD
257
 
><P
258
 
>           Number of <VAR
259
 
CLASS="literal"
260
 
><VAR
261
 
CLASS="parameter"
262
 
>y</VAR
263
 
></VAR
264
 
> values at
265
 
            which function is evaluated.
266
 
          </P
267
 
></DD
268
 
><DT
269
 
><VAR
270
 
CLASS="parameter"
271
 
>opt</VAR
272
 
>
273
 
          (<VAR
274
 
CLASS="literal"
275
 
>PLINT</VAR
 
227
><CODE
 
228
CLASS="parameter"
 
229
>nx</CODE
 
230
>
 
231
          (<TT
 
232
CLASS="literal"
 
233
>PLINT</TT
 
234
>, input)</DT
 
235
><DD
 
236
><P
 
237
>           Number of <TT
 
238
CLASS="literal"
 
239
><CODE
 
240
CLASS="parameter"
 
241
>x</CODE
 
242
></TT
 
243
> values at
 
244
            which function is evaluated.
 
245
          </P
 
246
></DD
 
247
><DT
 
248
><CODE
 
249
CLASS="parameter"
 
250
>ny</CODE
 
251
>
 
252
          (<TT
 
253
CLASS="literal"
 
254
>PLINT</TT
 
255
>, input)</DT
 
256
><DD
 
257
><P
 
258
>           Number of <TT
 
259
CLASS="literal"
 
260
><CODE
 
261
CLASS="parameter"
 
262
>y</CODE
 
263
></TT
 
264
> values at
 
265
            which function is evaluated.
 
266
          </P
 
267
></DD
 
268
><DT
 
269
><CODE
 
270
CLASS="parameter"
 
271
>opt</CODE
 
272
>
 
273
          (<TT
 
274
CLASS="literal"
 
275
>PLINT</TT
276
276
>, input)</DT
277
277
><DD
278
278
><P
283
283
><UL
284
284
><LI
285
285
><P
286
 
>                 <VAR
 
286
>                 <TT
287
287
CLASS="literal"
288
 
><VAR
 
288
><CODE
289
289
CLASS="parameter"
290
 
>opt</VAR
291
 
>=FACETED</VAR
 
290
>opt</CODE
 
291
>=FACETED</TT
292
292
>: Network
293
293
                  of lines is drawn connecting points at which function is
294
294
                  defined.
296
296
></LI
297
297
><LI
298
298
><P
299
 
>                 <VAR
 
299
>                 <TT
300
300
CLASS="literal"
301
 
><VAR
 
301
><CODE
302
302
CLASS="parameter"
303
 
>opt</VAR
304
 
>=BASE_CONT</VAR
 
303
>opt</CODE
 
304
>=BASE_CONT</TT
305
305
>: A contour
306
306
                  plot is drawn at the base XY plane using parameters
307
 
                  <VAR
308
 
CLASS="parameter"
309
 
>nlevel</VAR
310
 
> and <VAR
311
 
CLASS="parameter"
312
 
>clevel</VAR
 
307
                  <CODE
 
308
CLASS="parameter"
 
309
>nlevel</CODE
 
310
> and <CODE
 
311
CLASS="parameter"
 
312
>clevel</CODE
313
313
>.
314
314
                </P
315
315
></LI
316
316
><LI
317
317
><P
318
 
>                 <VAR
 
318
>                 <TT
319
319
CLASS="literal"
320
 
><VAR
 
320
><CODE
321
321
CLASS="parameter"
322
 
>opt</VAR
323
 
>=SURF_CONT</VAR
 
322
>opt</CODE
 
323
>=SURF_CONT</TT
324
324
>: A contour
325
325
                  plot is drawn at the surface plane using parameters
326
 
                  <VAR
327
 
CLASS="parameter"
328
 
>nlevel</VAR
329
 
> and <VAR
330
 
CLASS="parameter"
331
 
>clevel</VAR
 
326
                  <CODE
 
327
CLASS="parameter"
 
328
>nlevel</CODE
 
329
> and <CODE
 
330
CLASS="parameter"
 
331
>clevel</CODE
332
332
>.
333
333
                </P
334
334
></LI
335
335
><LI
336
336
><P
337
 
>                 <VAR
 
337
>                 <TT
338
338
CLASS="literal"
339
 
><VAR
 
339
><CODE
340
340
CLASS="parameter"
341
 
>opt</VAR
342
 
>=DRAW_SIDES</VAR
 
341
>opt</CODE
 
342
>=DRAW_SIDES</TT
343
343
>: draws a curtain
344
344
                  between the base XY plane and the borders of the plotted function.
345
345
                </P
346
346
></LI
347
347
><LI
348
348
><P
349
 
>                 <VAR
 
349
>                 <TT
350
350
CLASS="literal"
351
 
><VAR
 
351
><CODE
352
352
CLASS="parameter"
353
 
>opt</VAR
354
 
>=MAG_COLOR</VAR
 
353
>opt</CODE
 
354
>=MAG_COLOR</TT
355
355
>:
356
356
                  the surface is colored according to the value of Z; if
357
 
                  <VAR
 
357
                  <TT
358
358
CLASS="literal"
359
 
>MAG_COLOR</VAR
 
359
>MAG_COLOR</TT
360
360
> is not used, then the default
361
361
                  the surface is colored according to the intensity of the
362
362
                  reflected light in the surface from a light source whose
374
374
          </P
375
375
></DD
376
376
><DT
377
 
><VAR
 
377
><CODE
378
378
CLASS="parameter"
379
 
>clevel</VAR
 
379
>clevel</CODE
380
380
>
381
 
          (<VAR
 
381
          (<TT
382
382
CLASS="literal"
383
 
>PLFLT *</VAR
 
383
>PLFLT *</TT
384
384
>, input)</DT
385
385
><DD
386
386
><P
388
388
          </P
389
389
></DD
390
390
><DT
391
 
><VAR
 
391
><CODE
392
392
CLASS="parameter"
393
 
>nlevel</VAR
 
393
>nlevel</CODE
394
394
>
395
 
          (<VAR
 
395
          (<TT
396
396
CLASS="literal"
397
 
>PLINT</VAR
 
397
>PLINT</TT
398
398
>, input)</DT
399
399
><DD
400
400
><P
401
 
>          Number of elements in the <VAR
 
401
>          Number of elements in the <TT
402
402
CLASS="literal"
403
 
>clevel</VAR
 
403
>clevel</TT
404
404
> array.
405
405
          </P
406
406
></DD