← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/docbook/src/drawing.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/drawing.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
5
5
>Drawing the Graph</TITLE
6
6
><META
7
7
NAME="GENERATOR"
8
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9
9
REL="HOME"
10
10
TITLE="The PLplot Plotting Library"
11
11
HREF="index.html"><LINK
125
125
CLASS="function"
126
126
>plsym</CODE
127
127
></A
128
 
> mark out <VAR
 
128
> mark out <TT
129
129
CLASS="literal"
130
 
>n</VAR
 
130
>n</TT
131
131
> points
132
 
        <VAR
 
132
        <TT
133
133
CLASS="literal"
134
 
>(x[i], y[i])</VAR
 
134
>(x[i], y[i])</TT
135
135
> with the specified symbol.  The
136
136
        routines differ only in the interpretation of the symbol codes.
137
137
        <A
159
159
><P
160
160
></P
161
161
><A
162
 
NAME="AEN369"
 
162
NAME="AEN386"
163
163
></A
164
164
><TABLE
165
165
CLASS="funcprototype"
182
182
><P
183
183
></P
184
184
><A
185
 
NAME="AEN382"
 
185
NAME="AEN399"
186
186
></A
187
187
><TABLE
188
188
CLASS="funcprototype"
206
206
><TD
207
207
><DL
208
208
><DT
209
 
><VAR
 
209
><CODE
210
210
CLASS="parameter"
211
 
>n</VAR
212
 
> (<VAR
 
211
>n</CODE
 
212
> (<TT
213
213
CLASS="literal"
214
 
>PLINT</VAR
 
214
>PLINT</TT
215
215
>, input)</DT
216
216
><DD
217
217
><P
219
219
            </P
220
220
></DD
221
221
><DT
222
 
><VAR
 
222
><CODE
223
223
CLASS="parameter"
224
 
>x, y</VAR
225
 
> (<VAR
 
224
>x, y</CODE
 
225
> (<TT
226
226
CLASS="literal"
227
 
>PLFLT *</VAR
 
227
>PLFLT *</TT
228
228
>, input)</DT
229
229
><DD
230
230
><P
231
231
>             Pointers to arrays of the coordinates of the
232
 
              <VAR
 
232
              <TT
233
233
CLASS="literal"
234
 
>n</VAR
 
234
>n</TT
235
235
> points.
236
236
            </P
237
237
></DD
238
238
><DT
239
 
><VAR
 
239
><CODE
240
240
CLASS="parameter"
241
 
>code</VAR
242
 
> (<VAR
 
241
>code</CODE
 
242
> (<TT
243
243
CLASS="literal"
244
 
>PLINT</VAR
 
244
>PLINT</TT
245
245
>,
246
246
            input)</DT
247
247
><DD
280
280
>plline</CODE
281
281
></A
282
282
> draws a line or curve.  The curve consists of
283
 
        <VAR
284
 
CLASS="literal"
285
 
>n-1</VAR
286
 
> line segments joining the <VAR
287
 
CLASS="literal"
288
 
>n</VAR
 
283
        <TT
 
284
CLASS="literal"
 
285
>n-1</TT
 
286
> line segments joining the <TT
 
287
CLASS="literal"
 
288
>n</TT
289
289
>
290
290
        points in the input arrays.  For single line segments, <A
291
291
HREF="pljoin.html"
302
302
><P
303
303
></P
304
304
><A
305
 
NAME="AEN426"
 
305
NAME="AEN443"
306
306
></A
307
307
><TABLE
308
308
CLASS="funcprototype"
326
326
><TD
327
327
><DL
328
328
><DT
329
 
><VAR
 
329
><CODE
330
330
CLASS="parameter"
331
 
>n</VAR
332
 
> (<VAR
 
331
>n</CODE
 
332
> (<TT
333
333
CLASS="literal"
334
 
>PLINT</VAR
 
334
>PLINT</TT
335
335
>, input)</DT
336
336
><DD
337
337
><P
339
339
            </P
340
340
></DD
341
341
><DT
342
 
><VAR
 
342
><CODE
343
343
CLASS="parameter"
344
 
>x, y</VAR
345
 
> (<VAR
 
344
>x, y</CODE
 
345
> (<TT
346
346
CLASS="literal"
347
 
>PLFLT *</VAR
 
347
>PLFLT *</TT
348
348
>, input)</DT
349
349
><DD
350
350
><P
351
 
>             Pointers to arrays with coordinates of the <VAR
 
351
>             Pointers to arrays with coordinates of the <TT
352
352
CLASS="literal"
353
 
>n</VAR
 
353
>n</TT
354
354
>
355
355
              points.
356
356
            </P
365
365
><P
366
366
></P
367
367
><A
368
 
NAME="AEN451"
 
368
NAME="AEN468"
369
369
></A
370
370
><TABLE
371
371
CLASS="funcprototype"
389
389
><TD
390
390
><DL
391
391
><DT
392
 
><VAR
 
392
><CODE
393
393
CLASS="parameter"
394
 
>x1, y1</VAR
395
 
> (<VAR
 
394
>x1, y1</CODE
 
395
> (<TT
396
396
CLASS="literal"
397
 
>PLFLT</VAR
 
397
>PLFLT</TT
398
398
>, input)</DT
399
399
><DD
400
400
><P
402
402
            </P
403
403
></DD
404
404
><DT
405
 
><VAR
 
405
><CODE
406
406
CLASS="parameter"
407
 
>x2, y2</VAR
408
 
> (<VAR
 
407
>x2, y2</CODE
 
408
> (<TT
409
409
CLASS="literal"
410
 
>PLFLT</VAR
 
410
>PLFLT</TT
411
411
>, input)</DT
412
412
><DD
413
413
><P
444
444
        The reference point of a text string may be located anywhere along an
445
445
        imaginary horizontal line passing through the string at half the
446
446
        height of a capital letter.  The parameter
447
 
        <VAR
 
447
        <CODE
448
448
CLASS="parameter"
449
 
>just</VAR
 
449
>just</CODE
450
450
> specifies where along this line the
451
451
        reference point is located.  The string is then rotated about the
452
452
        reference point through an angle specified by the parameters
453
 
        <VAR
454
 
CLASS="parameter"
455
 
>dx</VAR
456
 
> and <VAR
457
 
CLASS="parameter"
458
 
>dy</VAR
 
453
        <CODE
 
454
CLASS="parameter"
 
455
>dx</CODE
 
456
> and <CODE
 
457
CLASS="parameter"
 
458
>dy</CODE
459
459
>, so that the
460
 
        string becomes parallel to a line joining <VAR
 
460
        string becomes parallel to a line joining <TT
461
461
CLASS="literal"
462
 
>(x, y)</VAR
 
462
>(x, y)</TT
463
463
>
464
 
        to <VAR
 
464
        to <TT
465
465
CLASS="literal"
466
 
>(x+dx, y+dy)</VAR
 
466
>(x+dx, y+dy)</TT
467
467
>.
468
468
      </P
469
469
><P
472
472
><P
473
473
></P
474
474
><A
475
 
NAME="AEN489"
 
475
NAME="AEN506"
476
476
></A
477
477
><TABLE
478
478
CLASS="funcprototype"
496
496
><TD
497
497
><DL
498
498
><DT
499
 
><VAR
 
499
><CODE
500
500
CLASS="parameter"
501
 
>x, y</VAR
502
 
> (<VAR
 
501
>x, y</CODE
 
502
> (<TT
503
503
CLASS="literal"
504
 
>PLFLT</VAR
 
504
>PLFLT</TT
505
505
>, input)</DT
506
506
><DD
507
507
><P
509
509
            </P
510
510
></DD
511
511
><DT
512
 
><VAR
 
512
><CODE
513
513
CLASS="parameter"
514
 
>dx, dy</VAR
515
 
> (<VAR
 
514
>dx, dy</CODE
 
515
> (<TT
516
516
CLASS="literal"
517
 
>PLFLT</VAR
 
517
>PLFLT</TT
518
518
>, input)</DT
519
519
><DD
520
520
><P
521
521
>             These specify the angle at which the text is to be printed.
522
522
              The text is written parallel to a line joining the points
523
 
              <VAR
524
 
CLASS="literal"
525
 
>(x, y)</VAR
526
 
> to <VAR
527
 
CLASS="literal"
528
 
>(x+dx, y+dy)</VAR
 
523
              <TT
 
524
CLASS="literal"
 
525
>(x, y)</TT
 
526
> to <TT
 
527
CLASS="literal"
 
528
>(x+dx, y+dy)</TT
529
529
>
530
530
              on the graph.
531
531
            </P
532
532
></DD
533
533
><DT
534
 
><VAR
 
534
><CODE
535
535
CLASS="parameter"
536
 
>dx, dy</VAR
537
 
> (<VAR
 
536
>dx, dy</CODE
 
537
> (<TT
538
538
CLASS="literal"
539
 
>PLFLT</VAR
 
539
>PLFLT</TT
540
540
>, input)</DT
541
541
><DD
542
542
><P
543
543
>             These specify the angle at which the text is to be printed.
544
544
              The text is written parallel to a line joining the points
545
 
              <VAR
546
 
CLASS="literal"
547
 
>(x, y)</VAR
548
 
> to <VAR
549
 
CLASS="literal"
550
 
>(x+dx, y+dy)</VAR
 
545
              <TT
 
546
CLASS="literal"
 
547
>(x, y)</TT
 
548
> to <TT
 
549
CLASS="literal"
 
550
>(x+dx, y+dy)</TT
551
551
> on
552
552
              the graph.
553
553
            </P
554
554
></DD
555
555
><DT
556
 
><VAR
 
556
><CODE
557
557
CLASS="parameter"
558
 
>just</VAR
559
 
> (<VAR
 
558
>just</CODE
 
559
> (<TT
560
560
CLASS="literal"
561
 
>PLFLT</VAR
 
561
>PLFLT</TT
562
562
>, input)</DT
563
563
><DD
564
564
><P
565
565
>             Determines justification of the string by specifying which
566
566
              point within the string is placed at the reference point
567
 
              <VAR
 
567
              <TT
568
568
CLASS="literal"
569
 
>(x, y)</VAR
 
569
>(x, y)</TT
570
570
>.  This parameter is a fraction of the
571
571
              distance along the string.  Thus if
572
 
              <VAR
 
572
              <TT
573
573
CLASS="literal"
574
 
><VAR
 
574
><CODE
575
575
CLASS="parameter"
576
 
>just</VAR
577
 
> = 0.0</VAR
 
576
>just</CODE
 
577
> = 0.0</TT
578
578
>, the
579
579
              reference point is at the left-hand edge of the string.  If
580
 
              <VAR
 
580
              <TT
581
581
CLASS="literal"
582
 
><VAR
 
582
><CODE
583
583
CLASS="parameter"
584
 
>just</VAR
585
 
> = 0.5</VAR
 
584
>just</CODE
 
585
> = 0.5</TT
586
586
>, it is at
587
 
              the center and if <VAR
 
587
              the center and if <TT
588
588
CLASS="literal"
589
 
><VAR
 
589
><CODE
590
590
CLASS="parameter"
591
 
>just</VAR
 
591
>just</CODE
592
592
> =
593
 
                1.0</VAR
 
593
                1.0</TT
594
594
>, it is at the right-hand edge.
595
595
            </P
596
596
></DD
597
597
><DT
598
 
><VAR
 
598
><CODE
599
599
CLASS="parameter"
600
 
>text</VAR
601
 
> (<VAR
 
600
>text</CODE
 
601
> (<TT
602
602
CLASS="literal"
603
 
>char *</VAR
 
603
>char *</TT
604
604
>, input)</DT
605
605
><DD
606
606
><P
632
632
>plfill</CODE
633
633
></A
634
634
> fills a polygon.  The polygon consists of
635
 
        <VAR
 
635
        <TT
636
636
CLASS="literal"
637
 
>n</VAR
 
637
>n</TT
638
638
> vertices which define the polygon.
639
639
      </P
640
640
><P
643
643
><P
644
644
></P
645
645
><A
646
 
NAME="AEN555"
 
646
NAME="AEN572"
647
647
></A
648
648
><TABLE
649
649
CLASS="funcprototype"
667
667
><TD
668
668
><DL
669
669
><DT
670
 
><VAR
 
670
><CODE
671
671
CLASS="parameter"
672
 
>n</VAR
673
 
> (<VAR
 
672
>n</CODE
 
673
> (<TT
674
674
CLASS="literal"
675
 
>PLINT</VAR
 
675
>PLINT</TT
676
676
>, input)</DT
677
677
><DD
678
678
><P
680
680
            </P
681
681
></DD
682
682
><DT
683
 
><VAR
 
683
><CODE
684
684
CLASS="parameter"
685
 
>x, y</VAR
686
 
> (<VAR
 
685
>x, y</CODE
 
686
> (<TT
687
687
CLASS="literal"
688
 
>PLFLT *</VAR
 
688
>PLFLT *</TT
689
689
>, input)</DT
690
690
><DD
691
691
><P
692
 
>             Pointers to arrays with coordinates of the <VAR
 
692
>             Pointers to arrays with coordinates of the <TT
693
693
CLASS="literal"
694
 
>n</VAR
 
694
>n</TT
695
695
>
696
696
              vertices.
697
697
            </P
738
738
> draw error bars about specified
739
739
        points.  There are lots more too (see <A
740
740
HREF="api.html"
741
 
>Chapter 16</A
 
741
>Chapter 17</A
742
742
>).
743
743
      </P
744
744
></DIV