← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/docbook/src/plw3d.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/plw3d.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="AEN9309"
 
96
NAME="AEN10174"
97
97
></A
98
98
><TABLE
99
99
CLASS="funcprototype"
115
115
>      Sets up a window for a three-dimensional surface plot within the
116
116
      currently defined two-dimensional window.  The enclosing box for the
117
117
      surface plot defined by
118
 
      <VAR
119
 
CLASS="literal"
120
 
><VAR
121
 
CLASS="parameter"
122
 
>xmin</VAR
123
 
></VAR
124
 
>,
125
 
      <VAR
126
 
CLASS="literal"
127
 
><VAR
128
 
CLASS="parameter"
129
 
>xmax</VAR
130
 
></VAR
131
 
>,
132
 
      <VAR
133
 
CLASS="literal"
134
 
><VAR
135
 
CLASS="parameter"
136
 
>ymin</VAR
137
 
></VAR
138
 
>,
139
 
      <VAR
140
 
CLASS="literal"
141
 
><VAR
142
 
CLASS="parameter"
143
 
>ymax</VAR
144
 
></VAR
145
 
>,
146
 
      <VAR
147
 
CLASS="literal"
148
 
><VAR
149
 
CLASS="parameter"
150
 
>zmin</VAR
151
 
></VAR
 
118
      <TT
 
119
CLASS="literal"
 
120
><CODE
 
121
CLASS="parameter"
 
122
>xmin</CODE
 
123
></TT
 
124
>,
 
125
      <TT
 
126
CLASS="literal"
 
127
><CODE
 
128
CLASS="parameter"
 
129
>xmax</CODE
 
130
></TT
 
131
>,
 
132
      <TT
 
133
CLASS="literal"
 
134
><CODE
 
135
CLASS="parameter"
 
136
>ymin</CODE
 
137
></TT
 
138
>,
 
139
      <TT
 
140
CLASS="literal"
 
141
><CODE
 
142
CLASS="parameter"
 
143
>ymax</CODE
 
144
></TT
 
145
>,
 
146
      <TT
 
147
CLASS="literal"
 
148
><CODE
 
149
CLASS="parameter"
 
150
>zmin</CODE
 
151
></TT
152
152
> and
153
 
      <VAR
 
153
      <TT
154
154
CLASS="literal"
155
 
><VAR
 
155
><CODE
156
156
CLASS="parameter"
157
 
>zmax</VAR
158
 
></VAR
 
157
>zmax</CODE
 
158
></TT
159
159
> in user-coordinate
160
160
      space is mapped into a box of world coordinate size
161
 
      <VAR
162
 
CLASS="literal"
163
 
><VAR
164
 
CLASS="parameter"
165
 
>basex</VAR
166
 
></VAR
167
 
> by
168
 
      <VAR
169
 
CLASS="literal"
170
 
><VAR
171
 
CLASS="parameter"
172
 
>basey</VAR
173
 
></VAR
174
 
> by
175
 
      <VAR
176
 
CLASS="literal"
177
 
><VAR
178
 
CLASS="parameter"
179
 
>height</VAR
180
 
></VAR
 
161
      <TT
 
162
CLASS="literal"
 
163
><CODE
 
164
CLASS="parameter"
 
165
>basex</CODE
 
166
></TT
 
167
> by
 
168
      <TT
 
169
CLASS="literal"
 
170
><CODE
 
171
CLASS="parameter"
 
172
>basey</CODE
 
173
></TT
 
174
> by
 
175
      <TT
 
176
CLASS="literal"
 
177
><CODE
 
178
CLASS="parameter"
 
179
>height</CODE
 
180
></TT
181
181
> so that
182
 
      <VAR
183
 
CLASS="literal"
184
 
><VAR
185
 
CLASS="parameter"
186
 
>xmin</VAR
187
 
></VAR
188
 
> maps to
189
 
      <VAR
190
 
CLASS="literal"
191
 
>-<VAR
192
 
CLASS="parameter"
193
 
>basex</VAR
194
 
>/2</VAR
195
 
>,
196
 
      <VAR
197
 
CLASS="literal"
198
 
><VAR
199
 
CLASS="parameter"
200
 
>xmax</VAR
201
 
></VAR
202
 
> maps to
203
 
      <VAR
204
 
CLASS="literal"
205
 
><VAR
206
 
CLASS="parameter"
207
 
>basex</VAR
208
 
>/2</VAR
209
 
>,
210
 
      <VAR
211
 
CLASS="literal"
212
 
><VAR
213
 
CLASS="parameter"
214
 
>ymin</VAR
215
 
></VAR
216
 
> maps to
217
 
      <VAR
218
 
CLASS="literal"
219
 
>-<VAR
220
 
CLASS="parameter"
221
 
>basey</VAR
222
 
>/2</VAR
223
 
>,
224
 
      <VAR
225
 
CLASS="literal"
226
 
><VAR
227
 
CLASS="parameter"
228
 
>ymax</VAR
229
 
></VAR
230
 
> maps to
231
 
      <VAR
232
 
CLASS="literal"
233
 
><VAR
234
 
CLASS="parameter"
235
 
>basey</VAR
236
 
>/2</VAR
237
 
>,
238
 
      <VAR
239
 
CLASS="literal"
240
 
><VAR
241
 
CLASS="parameter"
242
 
>zmin</VAR
243
 
></VAR
244
 
> maps to
245
 
      <VAR
246
 
CLASS="literal"
247
 
>0</VAR
 
182
      <TT
 
183
CLASS="literal"
 
184
><CODE
 
185
CLASS="parameter"
 
186
>xmin</CODE
 
187
></TT
 
188
> maps to
 
189
      <TT
 
190
CLASS="literal"
 
191
>-<CODE
 
192
CLASS="parameter"
 
193
>basex</CODE
 
194
>/2</TT
 
195
>,
 
196
      <TT
 
197
CLASS="literal"
 
198
><CODE
 
199
CLASS="parameter"
 
200
>xmax</CODE
 
201
></TT
 
202
> maps to
 
203
      <TT
 
204
CLASS="literal"
 
205
><CODE
 
206
CLASS="parameter"
 
207
>basex</CODE
 
208
>/2</TT
 
209
>,
 
210
      <TT
 
211
CLASS="literal"
 
212
><CODE
 
213
CLASS="parameter"
 
214
>ymin</CODE
 
215
></TT
 
216
> maps to
 
217
      <TT
 
218
CLASS="literal"
 
219
>-<CODE
 
220
CLASS="parameter"
 
221
>basey</CODE
 
222
>/2</TT
 
223
>,
 
224
      <TT
 
225
CLASS="literal"
 
226
><CODE
 
227
CLASS="parameter"
 
228
>ymax</CODE
 
229
></TT
 
230
> maps to
 
231
      <TT
 
232
CLASS="literal"
 
233
><CODE
 
234
CLASS="parameter"
 
235
>basey</CODE
 
236
>/2</TT
 
237
>,
 
238
      <TT
 
239
CLASS="literal"
 
240
><CODE
 
241
CLASS="parameter"
 
242
>zmin</CODE
 
243
></TT
 
244
> maps to
 
245
      <TT
 
246
CLASS="literal"
 
247
>0</TT
248
248
> and
249
 
      <VAR
 
249
      <TT
250
250
CLASS="literal"
251
 
><VAR
 
251
><CODE
252
252
CLASS="parameter"
253
 
>zmax</VAR
254
 
></VAR
 
253
>zmax</CODE
 
254
></TT
255
255
> maps to
256
 
      <VAR
 
256
      <TT
257
257
CLASS="literal"
258
 
><VAR
 
258
><CODE
259
259
CLASS="parameter"
260
 
>height</VAR
261
 
></VAR
 
260
>height</CODE
 
261
></TT
262
262
>.  The resulting
263
263
      world-coordinate box is then viewed by an observer at altitude
264
 
      <VAR
 
264
      <TT
265
265
CLASS="literal"
266
 
><VAR
 
266
><CODE
267
267
CLASS="parameter"
268
 
>alt</VAR
269
 
></VAR
 
268
>alt</CODE
 
269
></TT
270
270
> and azimuth
271
 
      <VAR
 
271
      <TT
272
272
CLASS="literal"
273
 
><VAR
 
273
><CODE
274
274
CLASS="parameter"
275
 
>az</VAR
276
 
></VAR
 
275
>az</CODE
 
276
></TT
277
277
>.  This routine must be
278
278
      called before <A
279
279
HREF="plbox3.html"
301
301
><TD
302
302
><DL
303
303
><DT
304
 
><VAR
 
304
><CODE
305
305
CLASS="parameter"
306
 
>basex</VAR
 
306
>basex</CODE
307
307
>
308
 
          (<VAR
 
308
          (<TT
309
309
CLASS="literal"
310
 
>PLFLT</VAR
 
310
>PLFLT</TT
311
311
>, input)</DT
312
312
><DD
313
313
><P
315
315
          </P
316
316
></DD
317
317
><DT
318
 
><VAR
 
318
><CODE
319
319
CLASS="parameter"
320
 
>basey</VAR
 
320
>basey</CODE
321
321
>
322
 
          (<VAR
 
322
          (<TT
323
323
CLASS="literal"
324
 
>PLFLT</VAR
 
324
>PLFLT</TT
325
325
>, input)</DT
326
326
><DD
327
327
><P
329
329
          </P
330
330
></DD
331
331
><DT
332
 
><VAR
 
332
><CODE
333
333
CLASS="parameter"
334
 
>height</VAR
 
334
>height</CODE
335
335
>
336
 
          (<VAR
 
336
          (<TT
337
337
CLASS="literal"
338
 
>PLFLT</VAR
 
338
>PLFLT</TT
339
339
>, input)</DT
340
340
><DD
341
341
><P
343
343
          </P
344
344
></DD
345
345
><DT
346
 
><VAR
 
346
><CODE
347
347
CLASS="parameter"
348
 
>xmin</VAR
 
348
>xmin</CODE
349
349
>
350
 
          (<VAR
 
350
          (<TT
351
351
CLASS="literal"
352
 
>PLFLT</VAR
 
352
>PLFLT</TT
353
353
>, input)</DT
354
354
><DD
355
355
><P
357
357
          </P
358
358
></DD
359
359
><DT
360
 
><VAR
 
360
><CODE
361
361
CLASS="parameter"
362
 
>xmax</VAR
 
362
>xmax</CODE
363
363
>
364
 
          (<VAR
 
364
          (<TT
365
365
CLASS="literal"
366
 
>PLFLT</VAR
 
366
>PLFLT</TT
367
367
>, input)</DT
368
368
><DD
369
369
><P
371
371
          </P
372
372
></DD
373
373
><DT
374
 
><VAR
 
374
><CODE
375
375
CLASS="parameter"
376
 
>ymin</VAR
 
376
>ymin</CODE
377
377
>
378
 
          (<VAR
 
378
          (<TT
379
379
CLASS="literal"
380
 
>PLFLT</VAR
 
380
>PLFLT</TT
381
381
>, input)</DT
382
382
><DD
383
383
><P
385
385
          </P
386
386
></DD
387
387
><DT
388
 
><VAR
 
388
><CODE
389
389
CLASS="parameter"
390
 
>ymax</VAR
 
390
>ymax</CODE
391
391
>
392
 
          (<VAR
 
392
          (<TT
393
393
CLASS="literal"
394
 
>PLFLT</VAR
 
394
>PLFLT</TT
395
395
>, input)</DT
396
396
><DD
397
397
><P
399
399
          </P
400
400
></DD
401
401
><DT
402
 
><VAR
 
402
><CODE
403
403
CLASS="parameter"
404
 
>zmin</VAR
 
404
>zmin</CODE
405
405
>
406
 
          (<VAR
 
406
          (<TT
407
407
CLASS="literal"
408
 
>PLFLT</VAR
 
408
>PLFLT</TT
409
409
>, input)</DT
410
410
><DD
411
411
><P
413
413
          </P
414
414
></DD
415
415
><DT
416
 
><VAR
 
416
><CODE
417
417
CLASS="parameter"
418
 
>zmax</VAR
 
418
>zmax</CODE
419
419
>
420
 
          (<VAR
 
420
          (<TT
421
421
CLASS="literal"
422
 
>PLFLT</VAR
 
422
>PLFLT</TT
423
423
>, input)</DT
424
424
><DD
425
425
><P
427
427
          </P
428
428
></DD
429
429
><DT
430
 
><VAR
 
430
><CODE
431
431
CLASS="parameter"
432
 
>alt</VAR
 
432
>alt</CODE
433
433
>
434
 
          (<VAR
 
434
          (<TT
435
435
CLASS="literal"
436
 
>PLFLT</VAR
 
436
>PLFLT</TT
437
437
>, input)</DT
438
438
><DD
439
439
><P
441
441
          </P
442
442
></DD
443
443
><DT
444
 
><VAR
 
444
><CODE
445
445
CLASS="parameter"
446
 
>az</VAR
 
446
>az</CODE
447
447
>
448
 
          (<VAR
 
448
          (<TT
449
449
CLASS="literal"
450
 
>PLFLT</VAR
 
450
>PLFLT</TT
451
451
>, input)</DT
452
452
><DD
453
453
><P
454
454
>           The viewing azimuth in degrees.  When
455
 
            <VAR
 
455
            <TT
456
456
CLASS="literal"
457
 
><VAR
 
457
><CODE
458
458
CLASS="parameter"
459
 
>az</VAR
460
 
>=0</VAR
 
459
>az</CODE
 
460
>=0</TT
461
461
>, the observer is
462
462
            looking face onto the zx plane, and as
463
 
            <VAR
 
463
            <TT
464
464
CLASS="literal"
465
 
><VAR
 
465
><CODE
466
466
CLASS="parameter"
467
 
>az</VAR
468
 
></VAR
 
467
>az</CODE
 
468
></TT
469
469
> is increased, the
470
470
            observer moves clockwise around the box when viewed from above
471
471
            the xy plane.