← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/docbook/src/api-fortran.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/api-fortran.html
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<HTML
3
 
><HEAD
4
 
><TITLE
5
 
>The Specialized Fortran API for PLplot</TITLE
6
 
><META
7
 
NAME="GENERATOR"
8
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
9
 
REL="HOME"
10
 
TITLE="The PLplot Plotting Library"
11
 
HREF="index.html"><LINK
12
 
REL="UP"
13
 
TITLE=" Reference "
14
 
HREF="p2614.html"><LINK
15
 
REL="PREVIOUS"
16
 
TITLE="
17
 
      pltr2: Linear interpolation for grid to world
18
 
      mapping using doubly dimensioned coord arrays (column
19
 
      dominant, as per normal C 2d arrays)
20
 
    "
21
 
HREF="pltr2.html"><LINK
22
 
REL="NEXT"
23
 
TITLE="
24
 
      plcon1: Contour plot, general 1-d mapping for
25
 
fortran
26
 
    "
27
 
HREF="plcon1.html"><LINK
28
 
REL="STYLESHEET"
29
 
TYPE="text/css"
30
 
HREF="stylesheet.css"></HEAD
31
 
><BODY
32
 
CLASS="chapter"
33
 
BGCOLOR="#FFFFFF"
34
 
TEXT="#000000"
35
 
LINK="#0000FF"
36
 
VLINK="#840084"
37
 
ALINK="#0000FF"
38
 
><DIV
39
 
CLASS="NAVHEADER"
40
 
><TABLE
41
 
SUMMARY="Header navigation table"
42
 
WIDTH="100%"
43
 
BORDER="0"
44
 
CELLPADDING="0"
45
 
CELLSPACING="0"
46
 
><TR
47
 
><TH
48
 
COLSPAN="3"
49
 
ALIGN="center"
50
 
>The PLplot Plotting Library: Programmer's Reference Manual</TH
51
 
></TR
52
 
><TR
53
 
><TD
54
 
WIDTH="10%"
55
 
ALIGN="left"
56
 
VALIGN="bottom"
57
 
><A
58
 
HREF="pltr2.html"
59
 
ACCESSKEY="P"
60
 
>Prev</A
61
 
></TD
62
 
><TD
63
 
WIDTH="80%"
64
 
ALIGN="center"
65
 
VALIGN="bottom"
66
 
></TD
67
 
><TD
68
 
WIDTH="10%"
69
 
ALIGN="right"
70
 
VALIGN="bottom"
71
 
><A
72
 
HREF="plcon1.html"
73
 
ACCESSKEY="N"
74
 
>Next</A
75
 
></TD
76
 
></TR
77
 
></TABLE
78
 
><HR
79
 
ALIGN="LEFT"
80
 
WIDTH="100%"></DIV
81
 
><DIV
82
 
CLASS="chapter"
83
 
><H1
84
 
><A
85
 
NAME="API-FORTRAN"
86
 
></A
87
 
>Chapter 18. The Specialized Fortran API for PLplot</H1
88
 
><DIV
89
 
CLASS="TOC"
90
 
><DL
91
 
><DT
92
 
><B
93
 
>Table of Contents</B
94
 
></DT
95
 
><DT
96
 
><A
97
 
HREF="api-fortran.html#plcon0"
98
 
><CODE
99
 
CLASS="function"
100
 
>plcon0</CODE
101
 
>: Contour plot, identity mapping for fortran</A
102
 
></DT
103
 
><DT
104
 
><A
105
 
HREF="plcon1.html"
106
 
><CODE
107
 
CLASS="function"
108
 
>plcon1</CODE
109
 
>: Contour plot, general 1-d mapping for
110
 
fortran</A
111
 
></DT
112
 
><DT
113
 
><A
114
 
HREF="plcon2.html"
115
 
><CODE
116
 
CLASS="function"
117
 
>plcon2</CODE
118
 
>: Contour plot, general 2-d mapping for
119
 
fortran</A
120
 
></DT
121
 
><DT
122
 
><A
123
 
HREF="plcontfortran.html"
124
 
><CODE
125
 
CLASS="function"
126
 
>plcont</CODE
127
 
>: Contour plot, fixed linear mapping for
128
 
fortran</A
129
 
></DT
130
 
><DT
131
 
><A
132
 
HREF="plvec0.html"
133
 
><CODE
134
 
CLASS="function"
135
 
>plvec0</CODE
136
 
>: Vector plot, identity mapping for fortran</A
137
 
></DT
138
 
><DT
139
 
><A
140
 
HREF="plvec1.html"
141
 
><CODE
142
 
CLASS="function"
143
 
>plvec1</CODE
144
 
>: Vector plot, general 1-d mapping for
145
 
fortran</A
146
 
></DT
147
 
><DT
148
 
><A
149
 
HREF="plvec2.html"
150
 
><CODE
151
 
CLASS="function"
152
 
>plvec2</CODE
153
 
>: Vector plot, general 2-d mapping for
154
 
fortran</A
155
 
></DT
156
 
><DT
157
 
><A
158
 
HREF="plvectfortran.html"
159
 
><CODE
160
 
CLASS="function"
161
 
>plvect</CODE
162
 
>: Vector plot, fixed linear mapping for
163
 
fortran</A
164
 
></DT
165
 
><DT
166
 
><A
167
 
HREF="plmeshfortran.html"
168
 
><CODE
169
 
CLASS="function"
170
 
>plmesh</CODE
171
 
>: Plot surface mesh for fortran</A
172
 
></DT
173
 
><DT
174
 
><A
175
 
HREF="plot3dfortran.html"
176
 
><CODE
177
 
CLASS="function"
178
 
>plot3d</CODE
179
 
>: Plot 3-d surface plot for fortran</A
180
 
></DT
181
 
><DT
182
 
><A
183
 
HREF="plsescfortran.html"
184
 
><CODE
185
 
CLASS="function"
186
 
>plsesc</CODE
187
 
>: Set the escape character for text strings
188
 
for fortran</A
189
 
></DT
190
 
></DL
191
 
></DIV
192
 
><P
193
 
>  The purpose of this Chapter is to document the API for each Fortran function
194
 
  in PLplot that differs substantially (usually in argument lists)
195
 
  from the common API that has already been
196
 
  documented in <A
197
 
HREF="api.html"
198
 
>Chapter 16</A
199
 
>.
200
 
  </P
201
 
><P
202
 
>  Normally, the common API is wrapped in such a way for Fortran that there is
203
 
  and one-to-one correspondence between each fortran and C argument
204
 
  (see <A
205
 
HREF="fortran.html"
206
 
>Chapter 8</A
207
 
>
208
 
  for discussion).  However, for certain routines documented in this
209
 
  chapter the fortran argument lists
210
 
  necessarily differ substantially from the C versions.
211
 
  </P
212
 
><P
213
 
>  This chapter is incomplete and NEEDS DOCUMENTATION of, e.g., the fortran
214
 
  equivalent of the plshade C routines.
215
 
  </P
216
 
><DIV
217
 
CLASS="sect1"
218
 
><H3
219
 
CLASS="sect1"
220
 
><A
221
 
NAME="plcon0"
222
 
><CODE
223
 
CLASS="function"
224
 
>plcon0</CODE
225
 
>: Contour plot, identity mapping for fortran</A
226
 
></H3
227
 
><P
228
 
>      <DIV
229
 
CLASS="funcsynopsis"
230
 
><P
231
 
></P
232
 
><A
233
 
NAME="AEN9916"
234
 
></A
235
 
><TABLE
236
 
CLASS="funcprototype"
237
 
><TR
238
 
><TD
239
 
><CODE
240
 
CLASS="FUNCDEF"
241
 
>         plcon0
242
 
        </CODE
243
 
>(z, nx, ny, kx, lx, ky, ly, clevel, nlevel);</TD
244
 
></TR
245
 
></TABLE
246
 
><P
247
 
></P
248
 
></DIV
249
 
>
250
 
    </P
251
 
><P
252
 
>      Draws a contour plot of the data in
253
 
      <VAR
254
 
CLASS="literal"
255
 
><VAR
256
 
CLASS="parameter"
257
 
>z</VAR
258
 
>[<VAR
259
 
CLASS="parameter"
260
 
>nx</VAR
261
 
>][<VAR
262
 
CLASS="parameter"
263
 
>ny</VAR
264
 
>]</VAR
265
 
>,
266
 
      using the <VAR
267
 
CLASS="literal"
268
 
><VAR
269
 
CLASS="parameter"
270
 
>nlevel</VAR
271
 
></VAR
272
 
> contour
273
 
      levels specified by <VAR
274
 
CLASS="literal"
275
 
><VAR
276
 
CLASS="parameter"
277
 
>clevel</VAR
278
 
></VAR
279
 
>.
280
 
      Only the region of the array from
281
 
      <VAR
282
 
CLASS="literal"
283
 
><VAR
284
 
CLASS="parameter"
285
 
>kx</VAR
286
 
></VAR
287
 
> to
288
 
      <VAR
289
 
CLASS="literal"
290
 
><VAR
291
 
CLASS="parameter"
292
 
>lx</VAR
293
 
></VAR
294
 
> and from
295
 
      <VAR
296
 
CLASS="literal"
297
 
><VAR
298
 
CLASS="parameter"
299
 
>ky</VAR
300
 
></VAR
301
 
> to
302
 
      <VAR
303
 
CLASS="literal"
304
 
><VAR
305
 
CLASS="parameter"
306
 
>ly</VAR
307
 
></VAR
308
 
> is plotted out.  See
309
 
      <A
310
 
HREF="contour-plots.html"
311
 
>the Section called <I
312
 
>Contour and Shade Plots</I
313
 
> in Chapter 3</A
314
 
> for more information.
315
 
    </P
316
 
><TABLE
317
 
CLASS="variablelist"
318
 
><TR
319
 
><TD
320
 
><DL
321
 
><DT
322
 
><VAR
323
 
CLASS="parameter"
324
 
>z</VAR
325
 
>
326
 
          (<VAR
327
 
CLASS="literal"
328
 
>PLFLT **</VAR
329
 
>, input)</DT
330
 
><DD
331
 
><P
332
 
>           Pointer to a vectored two-dimensional array containing data to
333
 
            be contoured.
334
 
          </P
335
 
></DD
336
 
><DT
337
 
><VAR
338
 
CLASS="parameter"
339
 
>nx, ny</VAR
340
 
>
341
 
          (<VAR
342
 
CLASS="literal"
343
 
>PLINT</VAR
344
 
>, input)</DT
345
 
><DD
346
 
><P
347
 
>           Physical dimensions of array
348
 
            <VAR
349
 
CLASS="literal"
350
 
><VAR
351
 
CLASS="parameter"
352
 
>z</VAR
353
 
></VAR
354
 
>.
355
 
          </P
356
 
></DD
357
 
><DT
358
 
><VAR
359
 
CLASS="parameter"
360
 
>kx, lx</VAR
361
 
>
362
 
          (<VAR
363
 
CLASS="literal"
364
 
>PLINT</VAR
365
 
>, input)</DT
366
 
><DD
367
 
><P
368
 
>           Range of <VAR
369
 
CLASS="literal"
370
 
>x</VAR
371
 
> indices to consider.
372
 
          </P
373
 
></DD
374
 
><DT
375
 
><VAR
376
 
CLASS="parameter"
377
 
>ky, ly</VAR
378
 
>
379
 
          (<VAR
380
 
CLASS="literal"
381
 
>PLINT</VAR
382
 
>, input)</DT
383
 
><DD
384
 
><P
385
 
>           Range of <VAR
386
 
CLASS="literal"
387
 
>y</VAR
388
 
> indices to consider.
389
 
          </P
390
 
></DD
391
 
><DT
392
 
><VAR
393
 
CLASS="parameter"
394
 
>clevel</VAR
395
 
>
396
 
          (<VAR
397
 
CLASS="literal"
398
 
>PLFLT *</VAR
399
 
>, input)</DT
400
 
><DD
401
 
><P
402
 
>           Pointer to array specifying levels at which to draw contours.
403
 
          </P
404
 
></DD
405
 
><DT
406
 
><VAR
407
 
CLASS="parameter"
408
 
>nlevel</VAR
409
 
>
410
 
          (<VAR
411
 
CLASS="literal"
412
 
>PLINT</VAR
413
 
>, input)</DT
414
 
><DD
415
 
><P
416
 
>           Number of contour levels to draw.
417
 
          </P
418
 
></DD
419
 
></DL
420
 
></TD
421
 
></TR
422
 
></TABLE
423
 
><P
424
 
>      NOTE: this function is intended for use from a Fortran caller only.
425
 
      The C user should instead call <A
426
 
HREF="plcont.html"
427
 
><CODE
428
 
CLASS="function"
429
 
>plcont</CODE
430
 
></A
431
 
> using the built-in
432
 
      transformation function <CODE
433
 
CLASS="function"
434
 
>pltr0</CODE
435
 
> for the same
436
 
      capability.
437
 
    </P
438
 
></DIV
439
 
></DIV
440
 
><DIV
441
 
CLASS="NAVFOOTER"
442
 
><HR
443
 
ALIGN="LEFT"
444
 
WIDTH="100%"><TABLE
445
 
SUMMARY="Footer navigation table"
446
 
WIDTH="100%"
447
 
BORDER="0"
448
 
CELLPADDING="0"
449
 
CELLSPACING="0"
450
 
><TR
451
 
><TD
452
 
WIDTH="33%"
453
 
ALIGN="left"
454
 
VALIGN="top"
455
 
><A
456
 
HREF="pltr2.html"
457
 
ACCESSKEY="P"
458
 
>Prev</A
459
 
></TD
460
 
><TD
461
 
WIDTH="34%"
462
 
ALIGN="center"
463
 
VALIGN="top"
464
 
><A
465
 
HREF="index.html"
466
 
ACCESSKEY="H"
467
 
>Home</A
468
 
></TD
469
 
><TD
470
 
WIDTH="33%"
471
 
ALIGN="right"
472
 
VALIGN="top"
473
 
><A
474
 
HREF="plcon1.html"
475
 
ACCESSKEY="N"
476
 
>Next</A
477
 
></TD
478
 
></TR
479
 
><TR
480
 
><TD
481
 
WIDTH="33%"
482
 
ALIGN="left"
483
 
VALIGN="top"
484
 
><CODE
485
 
CLASS="function"
486
 
>pltr2</CODE
487
 
>: Linear interpolation for grid to world
488
 
      mapping using doubly dimensioned coord arrays (column
489
 
      dominant, as per normal C 2d arrays)</TD
490
 
><TD
491
 
WIDTH="34%"
492
 
ALIGN="center"
493
 
VALIGN="top"
494
 
><A
495
 
HREF="p2614.html"
496
 
ACCESSKEY="U"
497
 
>Up</A
498
 
></TD
499
 
><TD
500
 
WIDTH="33%"
501
 
ALIGN="right"
502
 
VALIGN="top"
503
 
><CODE
504
 
CLASS="function"
505
 
>plcon1</CODE
506
 
>: Contour plot, general 1-d mapping for
507
 
fortran</TD
508
 
></TR
509
 
></TABLE
510
 
></DIV
511
 
></BODY
512
 
></HTML
513
 
>
 
 
b'\\ No newline at end of file'