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

« back to all changes in this revision

Viewing changes to doc/docbook/src/plaxes.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:
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
7
7
    </TITLE
8
8
><META
9
9
NAME="GENERATOR"
10
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 
10
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
11
11
REL="HOME"
12
12
TITLE="The PLplot Plotting Library"
13
13
HREF="index.html"><LINK
60
60
WIDTH="80%"
61
61
ALIGN="center"
62
62
VALIGN="bottom"
63
 
>Chapter 16. The Common API for PLplot</TD
 
63
>Chapter 17. The Common API for PLplot</TD
64
64
><TD
65
65
WIDTH="10%"
66
66
ALIGN="right"
93
93
><P
94
94
></P
95
95
><A
96
 
NAME="AEN2795"
 
96
NAME="AEN3493"
97
97
></A
98
98
><TABLE
99
99
CLASS="funcprototype"
114
114
><P
115
115
>      Draws a box around the currently defined viewport with arbitrary
116
116
      world-coordinate origin specified by
117
 
      <VAR
 
117
      <TT
118
118
CLASS="literal"
119
 
><VAR
 
119
><CODE
120
120
CLASS="parameter"
121
 
>x0</VAR
122
 
></VAR
 
121
>x0</CODE
 
122
></TT
123
123
> and
124
 
      <VAR
 
124
      <TT
125
125
CLASS="literal"
126
 
><VAR
 
126
><CODE
127
127
CLASS="parameter"
128
 
>y0</VAR
129
 
></VAR
 
128
>y0</CODE
 
129
></TT
130
130
>
131
131
      and labels it with world coordinate values appropriate to the
132
132
      window.  Thus <A
137
137
></A
138
138
> should only be called after defining both
139
139
      viewport and window.  The character strings
140
 
      <VAR
 
140
      <TT
141
141
CLASS="literal"
142
 
><VAR
 
142
><CODE
143
143
CLASS="parameter"
144
 
>xopt</VAR
145
 
></VAR
 
144
>xopt</CODE
 
145
></TT
146
146
> and
147
 
      <VAR
 
147
      <TT
148
148
CLASS="literal"
149
 
><VAR
 
149
><CODE
150
150
CLASS="parameter"
151
 
>yopt</VAR
152
 
></VAR
 
151
>yopt</CODE
 
152
></TT
153
153
> specify how the box
154
154
      should be drawn as described below.  If ticks and/or subticks are to
155
155
      be drawn for a particular axis, the tick intervals and number of
161
161
><TD
162
162
><DL
163
163
><DT
164
 
><VAR
 
164
><CODE
165
165
CLASS="parameter"
166
 
>x0</VAR
 
166
>x0</CODE
167
167
>
168
 
          (<VAR
 
168
          (<TT
169
169
CLASS="literal"
170
 
>PLFLT</VAR
 
170
>PLFLT</TT
171
171
>, input)</DT
172
172
><DD
173
173
><P
175
175
          </P
176
176
></DD
177
177
><DT
178
 
><VAR
 
178
><CODE
179
179
CLASS="parameter"
180
 
>y0</VAR
 
180
>y0</CODE
181
181
>
182
 
          (<VAR
 
182
          (<TT
183
183
CLASS="literal"
184
 
>PLFLT</VAR
 
184
>PLFLT</TT
185
185
>, input)</DT
186
186
><DD
187
187
><P
189
189
          </P
190
190
></DD
191
191
><DT
192
 
><VAR
 
192
><CODE
193
193
CLASS="parameter"
194
 
>xopt</VAR
 
194
>xopt</CODE
195
195
>
196
 
          (<VAR
 
196
          (<TT
197
197
CLASS="literal"
198
 
>const char *</VAR
 
198
>const char *</TT
199
199
>, input)</DT
200
200
><DD
201
201
><P
207
207
><UL
208
208
><LI
209
209
><P
210
 
>                 <VAR
 
210
>                 <TT
211
211
CLASS="literal"
212
 
>a</VAR
 
212
>a</TT
213
213
>: Draws axis, X-axis is horizontal
214
 
                  line (<VAR
 
214
                  line (<TT
215
215
CLASS="literal"
216
 
>y=0</VAR
 
216
>y=0</TT
217
217
>), and Y-axis is vertical
218
 
                  line (<VAR
 
218
                  line (<TT
219
219
CLASS="literal"
220
 
>x=0</VAR
 
220
>x=0</TT
221
221
>).
222
222
                </P
223
223
></LI
224
224
><LI
225
225
><P
226
 
>                 <VAR
 
226
>                 <TT
227
227
CLASS="literal"
228
 
>b</VAR
 
228
>b</TT
229
229
>: Draws bottom (X) or left (Y) edge
230
230
                  of frame.
231
231
                </P
232
232
></LI
233
233
><LI
234
234
><P
235
 
>                 <VAR
 
235
>                 <TT
236
236
CLASS="literal"
237
 
>c</VAR
 
237
>c</TT
238
238
>: Draws top (X) or right (Y) edge of
239
239
                  frame.
240
240
                </P
241
241
></LI
242
242
><LI
243
243
><P
244
 
>                 <VAR
 
244
>                 <TT
245
245
CLASS="literal"
246
 
>f</VAR
 
246
>f</TT
247
247
>:  Always use fixed point numeric labels.
248
248
                </P
249
249
></LI
250
250
><LI
251
251
><P
252
 
>                 <VAR
 
252
>                 <TT
253
253
CLASS="literal"
254
 
>g</VAR
 
254
>g</TT
255
255
>: Draws a grid at the major tick
256
256
                  interval.
257
257
                </P
258
258
></LI
259
259
><LI
260
260
><P
261
 
>                 <VAR
 
261
>                 <TT
262
262
CLASS="literal"
263
 
>h</VAR
 
263
>h</TT
264
264
>: Draws a grid at the minor tick
265
265
                  interval.
266
266
                </P
267
267
></LI
268
268
><LI
269
269
><P
270
 
>                 <VAR
 
270
>                 <TT
271
271
CLASS="literal"
272
 
>i</VAR
 
272
>i</TT
273
273
>: Inverts tick marks, so they are
274
274
                  drawn outwards, rather than inwards.
275
275
                </P
276
276
></LI
277
277
><LI
278
278
><P
279
 
>                 <VAR
 
279
>                 <TT
280
280
CLASS="literal"
281
 
>l</VAR
 
281
>l</TT
282
282
>: Labels axis logarithmically.  This
283
283
                  only affects the labels, not the data, and so it is
284
284
                  necessary to compute the logarithms of data points before
287
287
></LI
288
288
><LI
289
289
><P
290
 
>                 <VAR
 
290
>                 <TT
291
291
CLASS="literal"
292
 
>m</VAR
 
292
>m</TT
293
293
>: Writes numeric labels at major tick
294
294
                  intervals in the unconventional location (above box for
295
295
                  X, right of box for Y).
297
297
></LI
298
298
><LI
299
299
><P
300
 
>                 <VAR
 
300
>                 <TT
301
301
CLASS="literal"
302
 
>n</VAR
 
302
>n</TT
303
303
>: Writes numeric labels at major tick
304
304
                  intervals in the conventional location (below box for X,
305
305
                  left of box for Y).
307
307
></LI
308
308
><LI
309
309
><P
310
 
>                 <VAR
 
310
>                 <TT
311
311
CLASS="literal"
312
 
>s</VAR
 
312
>s</TT
313
313
>: Enables subticks between major
314
 
                  ticks, only valid if <VAR
 
314
                  ticks, only valid if <TT
315
315
CLASS="literal"
316
 
>t</VAR
 
316
>t</TT
317
317
> is also
318
318
                  specified.
319
319
                </P
320
320
></LI
321
321
><LI
322
322
><P
323
 
>                 <VAR
 
323
>                 <TT
324
324
CLASS="literal"
325
 
>t</VAR
 
325
>t</TT
326
326
>: Draws major ticks.
327
327
                </P
328
328
></LI
331
331
          </P
332
332
></DD
333
333
><DT
334
 
><VAR
 
334
><CODE
335
335
CLASS="parameter"
336
 
>xtick</VAR
 
336
>xtick</CODE
337
337
>
338
 
          (<VAR
 
338
          (<TT
339
339
CLASS="literal"
340
 
>PLFLT</VAR
 
340
>PLFLT</TT
341
341
>, input)</DT
342
342
><DD
343
343
><P
347
347
          </P
348
348
></DD
349
349
><DT
350
 
><VAR
 
350
><CODE
351
351
CLASS="parameter"
352
 
>nxsub</VAR
 
352
>nxsub</CODE
353
353
>
354
 
          (<VAR
 
354
          (<TT
355
355
CLASS="literal"
356
 
>PLINT</VAR
 
356
>PLINT</TT
357
357
>, input)</DT
358
358
><DD
359
359
><P
363
363
          </P
364
364
></DD
365
365
><DT
366
 
><VAR
 
366
><CODE
367
367
CLASS="parameter"
368
 
>yopt</VAR
 
368
>yopt</CODE
369
369
>
370
 
          (<VAR
 
370
          (<TT
371
371
CLASS="literal"
372
 
>const char *</VAR
 
372
>const char *</TT
373
373
>, input)</DT
374
374
><DD
375
375
><P
376
376
>           Pointer to character string specifying options for vertical
377
377
            axis.  The string can include any combination of the letters
378
378
            defined above for
379
 
            <VAR
 
379
            <TT
380
380
CLASS="literal"
381
 
><VAR
 
381
><CODE
382
382
CLASS="parameter"
383
 
>xopt</VAR
384
 
></VAR
 
383
>xopt</CODE
 
384
></TT
385
385
>, and in addition
386
386
            may contain:
387
387
            <P
389
389
><UL
390
390
><LI
391
391
><P
392
 
>                 <VAR
 
392
>                 <TT
393
393
CLASS="literal"
394
 
>v</VAR
 
394
>v</TT
395
395
>: Write numeric labels for vertical
396
396
                  axis parallel to the base of the graph, rather than
397
397
                  parallel to the axis.
402
402
          </P
403
403
></DD
404
404
><DT
405
 
><VAR
 
405
><CODE
406
406
CLASS="parameter"
407
 
>ytick</VAR
 
407
>ytick</CODE
408
408
>
409
 
          (<VAR
 
409
          (<TT
410
410
CLASS="literal"
411
 
>PLFLT</VAR
 
411
>PLFLT</TT
412
412
>, input)</DT
413
413
><DD
414
414
><P
418
418
          </P
419
419
></DD
420
420
><DT
421
 
><VAR
 
421
><CODE
422
422
CLASS="parameter"
423
 
>nysub</VAR
 
423
>nysub</CODE
424
424
>
425
 
          (<VAR
 
425
          (<TT
426
426
CLASS="literal"
427
 
>PLINT</VAR
 
427
>PLINT</TT
428
428
>, input)</DT
429
429
><DD
430
430
><P