OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [packages/] [services/] [gfx/] [mw/] [v2_0/] [doc/] [nano-X/] [html/] [nano-x-regions.html] - Blame information for rev 565

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 27 unneback
<HTML
2
><HEAD
3
><TITLE
4
>regions</TITLE
5
><META
6
NAME="GENERATOR"
7
CONTENT="Modular DocBook HTML Stylesheet Version 1.33"><LINK
8
REL="HOME"
9
TITLE="Nano-X API Reference Manual"
10
HREF="index.html"><LINK
11
REL="UP"
12
TITLE="libnano-X"
13
HREF="libnano-x.html"><LINK
14
REL="PREVIOUS"
15
TITLE="colours"
16
HREF="nano-x-colours.html"><LINK
17
REL="NEXT"
18
TITLE="selections"
19
HREF="nano-x-selections.html"></HEAD
20
><BODY
21
BGCOLOR="#FFFFFF"
22
TEXT="#000000"
23
><DIV
24
CLASS="NAVHEADER"
25
><TABLE
26
WIDTH="100%"
27
BORDER="0"
28
BGCOLOR="#000000"
29
CELLPADDING="1"
30
CELLSPACING="0"
31
><TR
32
><TH
33
COLSPAN="4"
34
ALIGN="center"
35
><FONT
36
COLOR="#FFFFFF"
37
SIZE="5"
38
>Nano-X API Reference Manual</FONT
39
></TH
40
></TR
41
><TR
42
><TD
43
WIDTH="25%"
44
BGCOLOR="#C00000"
45
ALIGN="left"
46
><A
47
HREF="nano-x-colours.html"
48
><FONT
49
COLOR="#FFFFFF"
50
SIZE="3"
51
><B
52
>&#60;&#60;&#60; Previous Page</B
53
></FONT
54
></A
55
></TD
56
><TD
57
WIDTH="25%"
58
BGCOLOR="#0000C0"
59
ALIGN="center"
60
><FONT
61
COLOR="#FFFFFF"
62
SIZE="3"
63
><B
64
><A
65
HREF="index.html"
66
><FONT
67
COLOR="#FFFFFF"
68
SIZE="3"
69
><B
70
>Home</B
71
></FONT
72
></A
73
></B
74
></FONT
75
></TD
76
><TD
77
WIDTH="25%"
78
BGCOLOR="#00C000"
79
ALIGN="center"
80
><FONT
81
COLOR="#FFFFFF"
82
SIZE="3"
83
><B
84
><A
85
HREF="libnano-x.html"
86
><FONT
87
COLOR="#FFFFFF"
88
SIZE="3"
89
><B
90
>Up</B
91
></FONT
92
></A
93
></B
94
></FONT
95
></TD
96
><TD
97
WIDTH="25%"
98
BGCOLOR="#C00000"
99
ALIGN="right"
100
><A
101
HREF="nano-x-selections.html"
102
><FONT
103
COLOR="#FFFFFF"
104
SIZE="3"
105
><B
106
>Next Page &#62;&#62;&#62;</B
107
></FONT
108
></A
109
></TD
110
></TR
111
></TABLE
112
></DIV
113
><H1
114
>regions</H1
115
><DIV
116
CLASS="REFNAMEDIV"
117
><A
118
NAME="AEN2529"
119
></A
120
><H2
121
>Name</H2
122
>regions &#8212; </DIV
123
><DIV
124
CLASS="REFSYNOPSISDIV"
125
><A
126
NAME="AEN2532"
127
></A
128
><H2
129
>Synopsis</H2
130
><TABLE
131
BORDER="0"
132
BGCOLOR="#D6E8FF"
133
WIDTH="100%"
134
CELLPADDING="6"
135
><TR
136
><TD
137
><PRE
138
CLASS="SYNOPSIS"
139
>&#13;
140
 
141
<GTKDOCLINK
142
HREF="GR-REGION-ID-CAPS"
143
>GR_REGION_ID</GTKDOCLINK
144
> <A
145
HREF="nano-x-regions.html#GRNEWREGION"
146
>GrNewRegion</A
147
>                    (void);
148
void        <A
149
HREF="nano-x-regions.html#GRDESTROYREGION"
150
>GrDestroyRegion</A
151
>                 (<GTKDOCLINK
152
HREF="GR-REGION-ID-CAPS"
153
>GR_REGION_ID</GTKDOCLINK
154
> region);
155
void        <A
156
HREF="nano-x-regions.html#GRUNIONRECTWITHREGION"
157
>GrUnionRectWithRegion</A
158
>           (<GTKDOCLINK
159
HREF="GR-REGION-ID-CAPS"
160
>GR_REGION_ID</GTKDOCLINK
161
> region,
162
                                             <GTKDOCLINK
163
HREF="GR-RECT-CAPS"
164
>GR_RECT</GTKDOCLINK
165
> *rect);
166
void        <A
167
HREF="nano-x-regions.html#GRUNIONREGION"
168
>GrUnionRegion</A
169
>                   (<GTKDOCLINK
170
HREF="GR-REGION-ID-CAPS"
171
>GR_REGION_ID</GTKDOCLINK
172
> dst_rgn,
173
                                             <GTKDOCLINK
174
HREF="GR-REGION-ID-CAPS"
175
>GR_REGION_ID</GTKDOCLINK
176
> src_rgn1,
177
                                             <GTKDOCLINK
178
HREF="GR-REGION-ID-CAPS"
179
>GR_REGION_ID</GTKDOCLINK
180
> src_rgn2);
181
void        <A
182
HREF="nano-x-regions.html#GRSUBTRACTREGION"
183
>GrSubtractRegion</A
184
>                (<GTKDOCLINK
185
HREF="GR-REGION-ID-CAPS"
186
>GR_REGION_ID</GTKDOCLINK
187
> dst_rgn,
188
                                             <GTKDOCLINK
189
HREF="GR-REGION-ID-CAPS"
190
>GR_REGION_ID</GTKDOCLINK
191
> src_rgn1,
192
                                             <GTKDOCLINK
193
HREF="GR-REGION-ID-CAPS"
194
>GR_REGION_ID</GTKDOCLINK
195
> src_rgn2);
196
void        <A
197
HREF="nano-x-regions.html#GRXORREGION"
198
>GrXorRegion</A
199
>                     (<GTKDOCLINK
200
HREF="GR-REGION-ID-CAPS"
201
>GR_REGION_ID</GTKDOCLINK
202
> dst_rgn,
203
                                             <GTKDOCLINK
204
HREF="GR-REGION-ID-CAPS"
205
>GR_REGION_ID</GTKDOCLINK
206
> src_rgn1,
207
                                             <GTKDOCLINK
208
HREF="GR-REGION-ID-CAPS"
209
>GR_REGION_ID</GTKDOCLINK
210
> src_rgn2);
211
void        <A
212
HREF="nano-x-regions.html#GRINTERSECTREGION"
213
>GrIntersectRegion</A
214
>               (<GTKDOCLINK
215
HREF="GR-REGION-ID-CAPS"
216
>GR_REGION_ID</GTKDOCLINK
217
> dst_rgn,
218
                                             <GTKDOCLINK
219
HREF="GR-REGION-ID-CAPS"
220
>GR_REGION_ID</GTKDOCLINK
221
> src_rgn1,
222
                                             <GTKDOCLINK
223
HREF="GR-REGION-ID-CAPS"
224
>GR_REGION_ID</GTKDOCLINK
225
> src_rgn2);
226
void        <A
227
HREF="nano-x-regions.html#GRSETGCREGION"
228
>GrSetGCRegion</A
229
>                   (<GTKDOCLINK
230
HREF="GR-GC-ID-CAPS"
231
>GR_GC_ID</GTKDOCLINK
232
> gc,
233
                                             <GTKDOCLINK
234
HREF="GR-REGION-ID-CAPS"
235
>GR_REGION_ID</GTKDOCLINK
236
> region);
237
<GTKDOCLINK
238
HREF="GR-BOOL-CAPS"
239
>GR_BOOL</GTKDOCLINK
240
>     <A
241
HREF="nano-x-regions.html#GRPOINTINREGION"
242
>GrPointInRegion</A
243
>                 (<GTKDOCLINK
244
HREF="GR-REGION-ID-CAPS"
245
>GR_REGION_ID</GTKDOCLINK
246
> region,
247
                                             <GTKDOCLINK
248
HREF="GR-COORD-CAPS"
249
>GR_COORD</GTKDOCLINK
250
> x,
251
                                             <GTKDOCLINK
252
HREF="GR-COORD-CAPS"
253
>GR_COORD</GTKDOCLINK
254
> y);
255
int         <A
256
HREF="nano-x-regions.html#GRRECTINREGION"
257
>GrRectInRegion</A
258
>                  (<GTKDOCLINK
259
HREF="GR-REGION-ID-CAPS"
260
>GR_REGION_ID</GTKDOCLINK
261
> region,
262
                                             <GTKDOCLINK
263
HREF="GR-COORD-CAPS"
264
>GR_COORD</GTKDOCLINK
265
> x,
266
                                             <GTKDOCLINK
267
HREF="GR-COORD-CAPS"
268
>GR_COORD</GTKDOCLINK
269
> y,
270
                                             <GTKDOCLINK
271
HREF="GR-COORD-CAPS"
272
>GR_COORD</GTKDOCLINK
273
> w,
274
                                             <GTKDOCLINK
275
HREF="GR-COORD-CAPS"
276
>GR_COORD</GTKDOCLINK
277
> h);
278
<GTKDOCLINK
279
HREF="GR-BOOL-CAPS"
280
>GR_BOOL</GTKDOCLINK
281
>     <A
282
HREF="nano-x-regions.html#GREMPTYREGION"
283
>GrEmptyRegion</A
284
>                   (<GTKDOCLINK
285
HREF="GR-REGION-ID-CAPS"
286
>GR_REGION_ID</GTKDOCLINK
287
> region);
288
<GTKDOCLINK
289
HREF="GR-BOOL-CAPS"
290
>GR_BOOL</GTKDOCLINK
291
>     <A
292
HREF="nano-x-regions.html#GREQUALREGION"
293
>GrEqualRegion</A
294
>                   (<GTKDOCLINK
295
HREF="GR-REGION-ID-CAPS"
296
>GR_REGION_ID</GTKDOCLINK
297
> rgn1,
298
                                             <GTKDOCLINK
299
HREF="GR-REGION-ID-CAPS"
300
>GR_REGION_ID</GTKDOCLINK
301
> rgn2);
302
void        <A
303
HREF="nano-x-regions.html#GROFFSETREGION"
304
>GrOffsetRegion</A
305
>                  (<GTKDOCLINK
306
HREF="GR-REGION-ID-CAPS"
307
>GR_REGION_ID</GTKDOCLINK
308
> region,
309
                                             <GTKDOCLINK
310
HREF="GR-SIZE-CAPS"
311
>GR_SIZE</GTKDOCLINK
312
> dx,
313
                                             <GTKDOCLINK
314
HREF="GR-SIZE-CAPS"
315
>GR_SIZE</GTKDOCLINK
316
> dy);
317
int         <A
318
HREF="nano-x-regions.html#GRGETREGIONBOX"
319
>GrGetRegionBox</A
320
>                  (<GTKDOCLINK
321
HREF="GR-REGION-ID-CAPS"
322
>GR_REGION_ID</GTKDOCLINK
323
> region,
324
                                             <GTKDOCLINK
325
HREF="GR-RECT-CAPS"
326
>GR_RECT</GTKDOCLINK
327
> *rect);
328
<GTKDOCLINK
329
HREF="GR-REGION-ID-CAPS"
330
>GR_REGION_ID</GTKDOCLINK
331
> <A
332
HREF="nano-x-regions.html#GRNEWPOLYGONREGION"
333
>GrNewPolygonRegion</A
334
>             (int mode,
335
                                             <GTKDOCLINK
336
HREF="GR-COUNT-CAPS"
337
>GR_COUNT</GTKDOCLINK
338
> count,
339
                                             <GTKDOCLINK
340
HREF="GR-POINT-CAPS"
341
>GR_POINT</GTKDOCLINK
342
> *points);</PRE
343
></TD
344
></TR
345
></TABLE
346
></DIV
347
><DIV
348
CLASS="REFSECT1"
349
><A
350
NAME="AEN2590"
351
></A
352
><H2
353
>Description</H2
354
><P
355
></P
356
></DIV
357
><DIV
358
CLASS="REFSECT1"
359
><A
360
NAME="AEN2593"
361
></A
362
><H2
363
>Details</H2
364
><DIV
365
CLASS="REFSECT2"
366
><A
367
NAME="AEN2595"
368
></A
369
><H3
370
><A
371
NAME="GRNEWREGION"
372
></A
373
>GrNewRegion ()</H3
374
><TABLE
375
BORDER="0"
376
BGCOLOR="#D6E8FF"
377
WIDTH="100%"
378
CELLPADDING="6"
379
><TR
380
><TD
381
><PRE
382
CLASS="PROGRAMLISTING"
383
><GTKDOCLINK
384
HREF="GR-REGION-ID-CAPS"
385
>GR_REGION_ID</GTKDOCLINK
386
> GrNewRegion                    (void);</PRE
387
></TD
388
></TR
389
></TABLE
390
><P
391
>Creates a new region structure and returns the ID used to refer to it.
392
The structure is initialised with a set of default parameters.</P
393
><P
394
></P
395
><DIV
396
CLASS="INFORMALTABLE"
397
><P
398
></P
399
><TABLE
400
BORDER="0"
401
WIDTH="100%"
402
BGCOLOR="#FFD0D0"
403
CELLSPACING="0"
404
CELLPADDING="4"
405
CLASS="CALSTABLE"
406
><TR
407
><TD
408
WIDTH="20%"
409
ALIGN="RIGHT"
410
VALIGN="TOP"
411
><I
412
CLASS="EMPHASIS"
413
>Returns</I
414
> :</TD
415
><TD
416
WIDTH="80%"
417
ALIGN="LEFT"
418
VALIGN="TOP"
419
> the ID of the newly created region</TD
420
></TR
421
></TABLE
422
><P
423
></P
424
></DIV
425
></DIV
426
><HR><DIV
427
CLASS="REFSECT2"
428
><A
429
NAME="AEN2611"
430
></A
431
><H3
432
><A
433
NAME="GRDESTROYREGION"
434
></A
435
>GrDestroyRegion ()</H3
436
><TABLE
437
BORDER="0"
438
BGCOLOR="#D6E8FF"
439
WIDTH="100%"
440
CELLPADDING="6"
441
><TR
442
><TD
443
><PRE
444
CLASS="PROGRAMLISTING"
445
>void        GrDestroyRegion                 (<GTKDOCLINK
446
HREF="GR-REGION-ID-CAPS"
447
>GR_REGION_ID</GTKDOCLINK
448
> region);</PRE
449
></TD
450
></TR
451
></TABLE
452
><P
453
>Destroys the region structure with the specified ID.</P
454
><P
455
></P
456
><DIV
457
CLASS="INFORMALTABLE"
458
><P
459
></P
460
><TABLE
461
BORDER="0"
462
WIDTH="100%"
463
BGCOLOR="#FFD0D0"
464
CELLSPACING="0"
465
CELLPADDING="4"
466
CLASS="CALSTABLE"
467
><TR
468
><TD
469
WIDTH="20%"
470
ALIGN="RIGHT"
471
VALIGN="TOP"
472
><TT
473
CLASS="PARAMETER"
474
><I
475
>region</I
476
></TT
477
>&nbsp;:</TD
478
><TD
479
WIDTH="80%"
480
ALIGN="LEFT"
481
VALIGN="TOP"
482
> the ID of the region structure to destroy</TD
483
></TR
484
></TABLE
485
><P
486
></P
487
></DIV
488
></DIV
489
><HR><DIV
490
CLASS="REFSECT2"
491
><A
492
NAME="AEN2627"
493
></A
494
><H3
495
><A
496
NAME="GRUNIONRECTWITHREGION"
497
></A
498
>GrUnionRectWithRegion ()</H3
499
><TABLE
500
BORDER="0"
501
BGCOLOR="#D6E8FF"
502
WIDTH="100%"
503
CELLPADDING="6"
504
><TR
505
><TD
506
><PRE
507
CLASS="PROGRAMLISTING"
508
>void        GrUnionRectWithRegion           (<GTKDOCLINK
509
HREF="GR-REGION-ID-CAPS"
510
>GR_REGION_ID</GTKDOCLINK
511
> region,
512
                                             <GTKDOCLINK
513
HREF="GR-RECT-CAPS"
514
>GR_RECT</GTKDOCLINK
515
> *rect);</PRE
516
></TD
517
></TR
518
></TABLE
519
><P
520
>Makes a union of the specified region and the specified rectangle and
521
places the result back in the source region.</P
522
><P
523
></P
524
><DIV
525
CLASS="INFORMALTABLE"
526
><P
527
></P
528
><TABLE
529
BORDER="0"
530
WIDTH="100%"
531
BGCOLOR="#FFD0D0"
532
CELLSPACING="0"
533
CELLPADDING="4"
534
CLASS="CALSTABLE"
535
><TR
536
><TD
537
WIDTH="20%"
538
ALIGN="RIGHT"
539
VALIGN="TOP"
540
><TT
541
CLASS="PARAMETER"
542
><I
543
>region</I
544
></TT
545
>&nbsp;:</TD
546
><TD
547
WIDTH="80%"
548
ALIGN="LEFT"
549
VALIGN="TOP"
550
> the ID of the region to modify</TD
551
></TR
552
><TR
553
><TD
554
WIDTH="20%"
555
ALIGN="RIGHT"
556
VALIGN="TOP"
557
><TT
558
CLASS="PARAMETER"
559
><I
560
>rect</I
561
></TT
562
>&nbsp;:</TD
563
><TD
564
WIDTH="80%"
565
ALIGN="LEFT"
566
VALIGN="TOP"
567
> a pointer to the rectangle to add to the region</TD
568
></TR
569
></TABLE
570
><P
571
></P
572
></DIV
573
></DIV
574
><HR><DIV
575
CLASS="REFSECT2"
576
><A
577
NAME="AEN2648"
578
></A
579
><H3
580
><A
581
NAME="GRUNIONREGION"
582
></A
583
>GrUnionRegion ()</H3
584
><TABLE
585
BORDER="0"
586
BGCOLOR="#D6E8FF"
587
WIDTH="100%"
588
CELLPADDING="6"
589
><TR
590
><TD
591
><PRE
592
CLASS="PROGRAMLISTING"
593
>void        GrUnionRegion                   (<GTKDOCLINK
594
HREF="GR-REGION-ID-CAPS"
595
>GR_REGION_ID</GTKDOCLINK
596
> dst_rgn,
597
                                             <GTKDOCLINK
598
HREF="GR-REGION-ID-CAPS"
599
>GR_REGION_ID</GTKDOCLINK
600
> src_rgn1,
601
                                             <GTKDOCLINK
602
HREF="GR-REGION-ID-CAPS"
603
>GR_REGION_ID</GTKDOCLINK
604
> src_rgn2);</PRE
605
></TD
606
></TR
607
></TABLE
608
><P
609
>Makes a union of the specified source regions and places the result in the
610
specified destination region.</P
611
><P
612
></P
613
><DIV
614
CLASS="INFORMALTABLE"
615
><P
616
></P
617
><TABLE
618
BORDER="0"
619
WIDTH="100%"
620
BGCOLOR="#FFD0D0"
621
CELLSPACING="0"
622
CELLPADDING="4"
623
CLASS="CALSTABLE"
624
><TR
625
><TD
626
WIDTH="20%"
627
ALIGN="RIGHT"
628
VALIGN="TOP"
629
><TT
630
CLASS="PARAMETER"
631
><I
632
>dst_rgn</I
633
></TT
634
>&nbsp;:</TD
635
><TD
636
WIDTH="80%"
637
ALIGN="LEFT"
638
VALIGN="TOP"
639
> the ID of the destination region</TD
640
></TR
641
><TR
642
><TD
643
WIDTH="20%"
644
ALIGN="RIGHT"
645
VALIGN="TOP"
646
><TT
647
CLASS="PARAMETER"
648
><I
649
>src_rgn1</I
650
></TT
651
>&nbsp;:</TD
652
><TD
653
WIDTH="80%"
654
ALIGN="LEFT"
655
VALIGN="TOP"
656
> the ID of the first source region</TD
657
></TR
658
><TR
659
><TD
660
WIDTH="20%"
661
ALIGN="RIGHT"
662
VALIGN="TOP"
663
><TT
664
CLASS="PARAMETER"
665
><I
666
>src_rgn2</I
667
></TT
668
>&nbsp;:</TD
669
><TD
670
WIDTH="80%"
671
ALIGN="LEFT"
672
VALIGN="TOP"
673
> the ID of the second source region</TD
674
></TR
675
></TABLE
676
><P
677
></P
678
></DIV
679
></DIV
680
><HR><DIV
681
CLASS="REFSECT2"
682
><A
683
NAME="AEN2674"
684
></A
685
><H3
686
><A
687
NAME="GRSUBTRACTREGION"
688
></A
689
>GrSubtractRegion ()</H3
690
><TABLE
691
BORDER="0"
692
BGCOLOR="#D6E8FF"
693
WIDTH="100%"
694
CELLPADDING="6"
695
><TR
696
><TD
697
><PRE
698
CLASS="PROGRAMLISTING"
699
>void        GrSubtractRegion                (<GTKDOCLINK
700
HREF="GR-REGION-ID-CAPS"
701
>GR_REGION_ID</GTKDOCLINK
702
> dst_rgn,
703
                                             <GTKDOCLINK
704
HREF="GR-REGION-ID-CAPS"
705
>GR_REGION_ID</GTKDOCLINK
706
> src_rgn1,
707
                                             <GTKDOCLINK
708
HREF="GR-REGION-ID-CAPS"
709
>GR_REGION_ID</GTKDOCLINK
710
> src_rgn2);</PRE
711
></TD
712
></TR
713
></TABLE
714
><P
715
>Subtracts the second source region from the first source region and places
716
the result in the specified destination region.</P
717
><P
718
></P
719
><DIV
720
CLASS="INFORMALTABLE"
721
><P
722
></P
723
><TABLE
724
BORDER="0"
725
WIDTH="100%"
726
BGCOLOR="#FFD0D0"
727
CELLSPACING="0"
728
CELLPADDING="4"
729
CLASS="CALSTABLE"
730
><TR
731
><TD
732
WIDTH="20%"
733
ALIGN="RIGHT"
734
VALIGN="TOP"
735
><TT
736
CLASS="PARAMETER"
737
><I
738
>dst_rgn</I
739
></TT
740
>&nbsp;:</TD
741
><TD
742
WIDTH="80%"
743
ALIGN="LEFT"
744
VALIGN="TOP"
745
> the ID of the destination region</TD
746
></TR
747
><TR
748
><TD
749
WIDTH="20%"
750
ALIGN="RIGHT"
751
VALIGN="TOP"
752
><TT
753
CLASS="PARAMETER"
754
><I
755
>src_rgn1</I
756
></TT
757
>&nbsp;:</TD
758
><TD
759
WIDTH="80%"
760
ALIGN="LEFT"
761
VALIGN="TOP"
762
> the ID of the first source region</TD
763
></TR
764
><TR
765
><TD
766
WIDTH="20%"
767
ALIGN="RIGHT"
768
VALIGN="TOP"
769
><TT
770
CLASS="PARAMETER"
771
><I
772
>src_rgn2</I
773
></TT
774
>&nbsp;:</TD
775
><TD
776
WIDTH="80%"
777
ALIGN="LEFT"
778
VALIGN="TOP"
779
> the ID of the second source region</TD
780
></TR
781
></TABLE
782
><P
783
></P
784
></DIV
785
></DIV
786
><HR><DIV
787
CLASS="REFSECT2"
788
><A
789
NAME="AEN2700"
790
></A
791
><H3
792
><A
793
NAME="GRXORREGION"
794
></A
795
>GrXorRegion ()</H3
796
><TABLE
797
BORDER="0"
798
BGCOLOR="#D6E8FF"
799
WIDTH="100%"
800
CELLPADDING="6"
801
><TR
802
><TD
803
><PRE
804
CLASS="PROGRAMLISTING"
805
>void        GrXorRegion                     (<GTKDOCLINK
806
HREF="GR-REGION-ID-CAPS"
807
>GR_REGION_ID</GTKDOCLINK
808
> dst_rgn,
809
                                             <GTKDOCLINK
810
HREF="GR-REGION-ID-CAPS"
811
>GR_REGION_ID</GTKDOCLINK
812
> src_rgn1,
813
                                             <GTKDOCLINK
814
HREF="GR-REGION-ID-CAPS"
815
>GR_REGION_ID</GTKDOCLINK
816
> src_rgn2);</PRE
817
></TD
818
></TR
819
></TABLE
820
><P
821
>Performs a logical exclusive OR operation on the specified source regions
822
and places the result in the destination region. The destination region
823
will contain only the parts of the source regions which do not overlap.</P
824
><P
825
></P
826
><DIV
827
CLASS="INFORMALTABLE"
828
><P
829
></P
830
><TABLE
831
BORDER="0"
832
WIDTH="100%"
833
BGCOLOR="#FFD0D0"
834
CELLSPACING="0"
835
CELLPADDING="4"
836
CLASS="CALSTABLE"
837
><TR
838
><TD
839
WIDTH="20%"
840
ALIGN="RIGHT"
841
VALIGN="TOP"
842
><TT
843
CLASS="PARAMETER"
844
><I
845
>dst_rgn</I
846
></TT
847
>&nbsp;:</TD
848
><TD
849
WIDTH="80%"
850
ALIGN="LEFT"
851
VALIGN="TOP"
852
> the ID of the destination region</TD
853
></TR
854
><TR
855
><TD
856
WIDTH="20%"
857
ALIGN="RIGHT"
858
VALIGN="TOP"
859
><TT
860
CLASS="PARAMETER"
861
><I
862
>src_rgn1</I
863
></TT
864
>&nbsp;:</TD
865
><TD
866
WIDTH="80%"
867
ALIGN="LEFT"
868
VALIGN="TOP"
869
> the ID of the first source region</TD
870
></TR
871
><TR
872
><TD
873
WIDTH="20%"
874
ALIGN="RIGHT"
875
VALIGN="TOP"
876
><TT
877
CLASS="PARAMETER"
878
><I
879
>src_rgn2</I
880
></TT
881
>&nbsp;:</TD
882
><TD
883
WIDTH="80%"
884
ALIGN="LEFT"
885
VALIGN="TOP"
886
> the ID of the second source region</TD
887
></TR
888
></TABLE
889
><P
890
></P
891
></DIV
892
></DIV
893
><HR><DIV
894
CLASS="REFSECT2"
895
><A
896
NAME="AEN2726"
897
></A
898
><H3
899
><A
900
NAME="GRINTERSECTREGION"
901
></A
902
>GrIntersectRegion ()</H3
903
><TABLE
904
BORDER="0"
905
BGCOLOR="#D6E8FF"
906
WIDTH="100%"
907
CELLPADDING="6"
908
><TR
909
><TD
910
><PRE
911
CLASS="PROGRAMLISTING"
912
>void        GrIntersectRegion               (<GTKDOCLINK
913
HREF="GR-REGION-ID-CAPS"
914
>GR_REGION_ID</GTKDOCLINK
915
> dst_rgn,
916
                                             <GTKDOCLINK
917
HREF="GR-REGION-ID-CAPS"
918
>GR_REGION_ID</GTKDOCLINK
919
> src_rgn1,
920
                                             <GTKDOCLINK
921
HREF="GR-REGION-ID-CAPS"
922
>GR_REGION_ID</GTKDOCLINK
923
> src_rgn2);</PRE
924
></TD
925
></TR
926
></TABLE
927
><P
928
>Calculates the intersection of the two specified source regions and places
929
the result in the specified destination region. The destination region
930
will contain only the parts of the source regions which overlap each other.</P
931
><P
932
></P
933
><DIV
934
CLASS="INFORMALTABLE"
935
><P
936
></P
937
><TABLE
938
BORDER="0"
939
WIDTH="100%"
940
BGCOLOR="#FFD0D0"
941
CELLSPACING="0"
942
CELLPADDING="4"
943
CLASS="CALSTABLE"
944
><TR
945
><TD
946
WIDTH="20%"
947
ALIGN="RIGHT"
948
VALIGN="TOP"
949
><TT
950
CLASS="PARAMETER"
951
><I
952
>dst_rgn</I
953
></TT
954
>&nbsp;:</TD
955
><TD
956
WIDTH="80%"
957
ALIGN="LEFT"
958
VALIGN="TOP"
959
> the ID of the destination region</TD
960
></TR
961
><TR
962
><TD
963
WIDTH="20%"
964
ALIGN="RIGHT"
965
VALIGN="TOP"
966
><TT
967
CLASS="PARAMETER"
968
><I
969
>src_rgn1</I
970
></TT
971
>&nbsp;:</TD
972
><TD
973
WIDTH="80%"
974
ALIGN="LEFT"
975
VALIGN="TOP"
976
> the ID of the first source region</TD
977
></TR
978
><TR
979
><TD
980
WIDTH="20%"
981
ALIGN="RIGHT"
982
VALIGN="TOP"
983
><TT
984
CLASS="PARAMETER"
985
><I
986
>src_rgn2</I
987
></TT
988
>&nbsp;:</TD
989
><TD
990
WIDTH="80%"
991
ALIGN="LEFT"
992
VALIGN="TOP"
993
> the ID of the second source region</TD
994
></TR
995
></TABLE
996
><P
997
></P
998
></DIV
999
></DIV
1000
><HR><DIV
1001
CLASS="REFSECT2"
1002
><A
1003
NAME="AEN2752"
1004
></A
1005
><H3
1006
><A
1007
NAME="GRSETGCREGION"
1008
></A
1009
>GrSetGCRegion ()</H3
1010
><TABLE
1011
BORDER="0"
1012
BGCOLOR="#D6E8FF"
1013
WIDTH="100%"
1014
CELLPADDING="6"
1015
><TR
1016
><TD
1017
><PRE
1018
CLASS="PROGRAMLISTING"
1019
>void        GrSetGCRegion                   (<GTKDOCLINK
1020
HREF="GR-GC-ID-CAPS"
1021
>GR_GC_ID</GTKDOCLINK
1022
> gc,
1023
                                             <GTKDOCLINK
1024
HREF="GR-REGION-ID-CAPS"
1025
>GR_REGION_ID</GTKDOCLINK
1026
> region);</PRE
1027
></TD
1028
></TR
1029
></TABLE
1030
><P
1031
>Sets the clip mask of the specified graphics context to the specified
1032
region. Subsequent drawing operations using this graphics context will not
1033
draw outside the specified region. The region ID can be set to 0 to remove
1034
the clipping region from the specified graphics context.</P
1035
><P
1036
></P
1037
><DIV
1038
CLASS="INFORMALTABLE"
1039
><P
1040
></P
1041
><TABLE
1042
BORDER="0"
1043
WIDTH="100%"
1044
BGCOLOR="#FFD0D0"
1045
CELLSPACING="0"
1046
CELLPADDING="4"
1047
CLASS="CALSTABLE"
1048
><TR
1049
><TD
1050
WIDTH="20%"
1051
ALIGN="RIGHT"
1052
VALIGN="TOP"
1053
><TT
1054
CLASS="PARAMETER"
1055
><I
1056
>gc</I
1057
></TT
1058
>&nbsp;:</TD
1059
><TD
1060
WIDTH="80%"
1061
ALIGN="LEFT"
1062
VALIGN="TOP"
1063
> the ID of the graphics context to set the clip mask of</TD
1064
></TR
1065
><TR
1066
><TD
1067
WIDTH="20%"
1068
ALIGN="RIGHT"
1069
VALIGN="TOP"
1070
><TT
1071
CLASS="PARAMETER"
1072
><I
1073
>region</I
1074
></TT
1075
>&nbsp;:</TD
1076
><TD
1077
WIDTH="80%"
1078
ALIGN="LEFT"
1079
VALIGN="TOP"
1080
> the ID of the region to use as the clip mask</TD
1081
></TR
1082
></TABLE
1083
><P
1084
></P
1085
></DIV
1086
></DIV
1087
><HR><DIV
1088
CLASS="REFSECT2"
1089
><A
1090
NAME="AEN2773"
1091
></A
1092
><H3
1093
><A
1094
NAME="GRPOINTINREGION"
1095
></A
1096
>GrPointInRegion ()</H3
1097
><TABLE
1098
BORDER="0"
1099
BGCOLOR="#D6E8FF"
1100
WIDTH="100%"
1101
CELLPADDING="6"
1102
><TR
1103
><TD
1104
><PRE
1105
CLASS="PROGRAMLISTING"
1106
><GTKDOCLINK
1107
HREF="GR-BOOL-CAPS"
1108
>GR_BOOL</GTKDOCLINK
1109
>     GrPointInRegion                 (<GTKDOCLINK
1110
HREF="GR-REGION-ID-CAPS"
1111
>GR_REGION_ID</GTKDOCLINK
1112
> region,
1113
                                             <GTKDOCLINK
1114
HREF="GR-COORD-CAPS"
1115
>GR_COORD</GTKDOCLINK
1116
> x,
1117
                                             <GTKDOCLINK
1118
HREF="GR-COORD-CAPS"
1119
>GR_COORD</GTKDOCLINK
1120
> y);</PRE
1121
></TD
1122
></TR
1123
></TABLE
1124
><P
1125
>Tests whether the specified point is within the specified region, and
1126
then returns either True or False depending on the result.</P
1127
><P
1128
></P
1129
><DIV
1130
CLASS="INFORMALTABLE"
1131
><P
1132
></P
1133
><TABLE
1134
BORDER="0"
1135
WIDTH="100%"
1136
BGCOLOR="#FFD0D0"
1137
CELLSPACING="0"
1138
CELLPADDING="4"
1139
CLASS="CALSTABLE"
1140
><TR
1141
><TD
1142
WIDTH="20%"
1143
ALIGN="RIGHT"
1144
VALIGN="TOP"
1145
><TT
1146
CLASS="PARAMETER"
1147
><I
1148
>region</I
1149
></TT
1150
>&nbsp;:</TD
1151
><TD
1152
WIDTH="80%"
1153
ALIGN="LEFT"
1154
VALIGN="TOP"
1155
> the ID of the region to examine</TD
1156
></TR
1157
><TR
1158
><TD
1159
WIDTH="20%"
1160
ALIGN="RIGHT"
1161
VALIGN="TOP"
1162
><TT
1163
CLASS="PARAMETER"
1164
><I
1165
>x</I
1166
></TT
1167
>&nbsp;:</TD
1168
><TD
1169
WIDTH="80%"
1170
ALIGN="LEFT"
1171
VALIGN="TOP"
1172
> the X coordinate of the point to test for</TD
1173
></TR
1174
><TR
1175
><TD
1176
WIDTH="20%"
1177
ALIGN="RIGHT"
1178
VALIGN="TOP"
1179
><TT
1180
CLASS="PARAMETER"
1181
><I
1182
>y</I
1183
></TT
1184
>&nbsp;:</TD
1185
><TD
1186
WIDTH="80%"
1187
ALIGN="LEFT"
1188
VALIGN="TOP"
1189
> the Y coordinate of the point to test for</TD
1190
></TR
1191
><TR
1192
><TD
1193
WIDTH="20%"
1194
ALIGN="RIGHT"
1195
VALIGN="TOP"
1196
><I
1197
CLASS="EMPHASIS"
1198
>Returns</I
1199
> :</TD
1200
><TD
1201
WIDTH="80%"
1202
ALIGN="LEFT"
1203
VALIGN="TOP"
1204
> True if the point is within the region, or False otherwise</TD
1205
></TR
1206
></TABLE
1207
><P
1208
></P
1209
></DIV
1210
></DIV
1211
><HR><DIV
1212
CLASS="REFSECT2"
1213
><A
1214
NAME="AEN2804"
1215
></A
1216
><H3
1217
><A
1218
NAME="GRRECTINREGION"
1219
></A
1220
>GrRectInRegion ()</H3
1221
><TABLE
1222
BORDER="0"
1223
BGCOLOR="#D6E8FF"
1224
WIDTH="100%"
1225
CELLPADDING="6"
1226
><TR
1227
><TD
1228
><PRE
1229
CLASS="PROGRAMLISTING"
1230
>int         GrRectInRegion                  (<GTKDOCLINK
1231
HREF="GR-REGION-ID-CAPS"
1232
>GR_REGION_ID</GTKDOCLINK
1233
> region,
1234
                                             <GTKDOCLINK
1235
HREF="GR-COORD-CAPS"
1236
>GR_COORD</GTKDOCLINK
1237
> x,
1238
                                             <GTKDOCLINK
1239
HREF="GR-COORD-CAPS"
1240
>GR_COORD</GTKDOCLINK
1241
> y,
1242
                                             <GTKDOCLINK
1243
HREF="GR-COORD-CAPS"
1244
>GR_COORD</GTKDOCLINK
1245
> w,
1246
                                             <GTKDOCLINK
1247
HREF="GR-COORD-CAPS"
1248
>GR_COORD</GTKDOCLINK
1249
> h);</PRE
1250
></TD
1251
></TR
1252
></TABLE
1253
><P
1254
>Tests whether the specified rectangle is contained within the specified
1255
region. Returns GR_RECT_OUT if it is not inside it at all, GR_RECT_ALLIN
1256
if it is completely contained within the region, or GR_RECT_PARTIN if
1257
it is partially contained within the region.</P
1258
><P
1259
></P
1260
><DIV
1261
CLASS="INFORMALTABLE"
1262
><P
1263
></P
1264
><TABLE
1265
BORDER="0"
1266
WIDTH="100%"
1267
BGCOLOR="#FFD0D0"
1268
CELLSPACING="0"
1269
CELLPADDING="4"
1270
CLASS="CALSTABLE"
1271
><TR
1272
><TD
1273
WIDTH="20%"
1274
ALIGN="RIGHT"
1275
VALIGN="TOP"
1276
><TT
1277
CLASS="PARAMETER"
1278
><I
1279
>region</I
1280
></TT
1281
>&nbsp;:</TD
1282
><TD
1283
WIDTH="80%"
1284
ALIGN="LEFT"
1285
VALIGN="TOP"
1286
> the ID of the region to examine</TD
1287
></TR
1288
><TR
1289
><TD
1290
WIDTH="20%"
1291
ALIGN="RIGHT"
1292
VALIGN="TOP"
1293
><TT
1294
CLASS="PARAMETER"
1295
><I
1296
>x</I
1297
></TT
1298
>&nbsp;:</TD
1299
><TD
1300
WIDTH="80%"
1301
ALIGN="LEFT"
1302
VALIGN="TOP"
1303
> the X coordinates of the rectangle to test</TD
1304
></TR
1305
><TR
1306
><TD
1307
WIDTH="20%"
1308
ALIGN="RIGHT"
1309
VALIGN="TOP"
1310
><TT
1311
CLASS="PARAMETER"
1312
><I
1313
>y</I
1314
></TT
1315
>&nbsp;:</TD
1316
><TD
1317
WIDTH="80%"
1318
ALIGN="LEFT"
1319
VALIGN="TOP"
1320
> the Y coordinates of the rectangle to test</TD
1321
></TR
1322
><TR
1323
><TD
1324
WIDTH="20%"
1325
ALIGN="RIGHT"
1326
VALIGN="TOP"
1327
><TT
1328
CLASS="PARAMETER"
1329
><I
1330
>w</I
1331
></TT
1332
>&nbsp;:</TD
1333
><TD
1334
WIDTH="80%"
1335
ALIGN="LEFT"
1336
VALIGN="TOP"
1337
> the width of the rectangle to test</TD
1338
></TR
1339
><TR
1340
><TD
1341
WIDTH="20%"
1342
ALIGN="RIGHT"
1343
VALIGN="TOP"
1344
><TT
1345
CLASS="PARAMETER"
1346
><I
1347
>h</I
1348
></TT
1349
>&nbsp;:</TD
1350
><TD
1351
WIDTH="80%"
1352
ALIGN="LEFT"
1353
VALIGN="TOP"
1354
> the height of the rectangle to test</TD
1355
></TR
1356
><TR
1357
><TD
1358
WIDTH="20%"
1359
ALIGN="RIGHT"
1360
VALIGN="TOP"
1361
><I
1362
CLASS="EMPHASIS"
1363
>Returns</I
1364
> :</TD
1365
><TD
1366
WIDTH="80%"
1367
ALIGN="LEFT"
1368
VALIGN="TOP"
1369
> GR_RECT_PARTIN, GR_RECT_ALLIN, or GR_RECT_OUT</TD
1370
></TR
1371
></TABLE
1372
><P
1373
></P
1374
></DIV
1375
></DIV
1376
><HR><DIV
1377
CLASS="REFSECT2"
1378
><A
1379
NAME="AEN2844"
1380
></A
1381
><H3
1382
><A
1383
NAME="GREMPTYREGION"
1384
></A
1385
>GrEmptyRegion ()</H3
1386
><TABLE
1387
BORDER="0"
1388
BGCOLOR="#D6E8FF"
1389
WIDTH="100%"
1390
CELLPADDING="6"
1391
><TR
1392
><TD
1393
><PRE
1394
CLASS="PROGRAMLISTING"
1395
><GTKDOCLINK
1396
HREF="GR-BOOL-CAPS"
1397
>GR_BOOL</GTKDOCLINK
1398
>     GrEmptyRegion                   (<GTKDOCLINK
1399
HREF="GR-REGION-ID-CAPS"
1400
>GR_REGION_ID</GTKDOCLINK
1401
> region);</PRE
1402
></TD
1403
></TR
1404
></TABLE
1405
><P
1406
>Determines whether the specified region is empty, and returns GR_TRUE
1407
if it is, or GR_FALSE otherwise.</P
1408
><P
1409
></P
1410
><DIV
1411
CLASS="INFORMALTABLE"
1412
><P
1413
></P
1414
><TABLE
1415
BORDER="0"
1416
WIDTH="100%"
1417
BGCOLOR="#FFD0D0"
1418
CELLSPACING="0"
1419
CELLPADDING="4"
1420
CLASS="CALSTABLE"
1421
><TR
1422
><TD
1423
WIDTH="20%"
1424
ALIGN="RIGHT"
1425
VALIGN="TOP"
1426
><TT
1427
CLASS="PARAMETER"
1428
><I
1429
>region</I
1430
></TT
1431
>&nbsp;:</TD
1432
><TD
1433
WIDTH="80%"
1434
ALIGN="LEFT"
1435
VALIGN="TOP"
1436
> the ID of the region to examine</TD
1437
></TR
1438
><TR
1439
><TD
1440
WIDTH="20%"
1441
ALIGN="RIGHT"
1442
VALIGN="TOP"
1443
><I
1444
CLASS="EMPHASIS"
1445
>Returns</I
1446
> :</TD
1447
><TD
1448
WIDTH="80%"
1449
ALIGN="LEFT"
1450
VALIGN="TOP"
1451
> GR_TRUE if the region is empty, or GR_FALSE if it is not</TD
1452
></TR
1453
></TABLE
1454
><P
1455
></P
1456
></DIV
1457
></DIV
1458
><HR><DIV
1459
CLASS="REFSECT2"
1460
><A
1461
NAME="AEN2865"
1462
></A
1463
><H3
1464
><A
1465
NAME="GREQUALREGION"
1466
></A
1467
>GrEqualRegion ()</H3
1468
><TABLE
1469
BORDER="0"
1470
BGCOLOR="#D6E8FF"
1471
WIDTH="100%"
1472
CELLPADDING="6"
1473
><TR
1474
><TD
1475
><PRE
1476
CLASS="PROGRAMLISTING"
1477
><GTKDOCLINK
1478
HREF="GR-BOOL-CAPS"
1479
>GR_BOOL</GTKDOCLINK
1480
>     GrEqualRegion                   (<GTKDOCLINK
1481
HREF="GR-REGION-ID-CAPS"
1482
>GR_REGION_ID</GTKDOCLINK
1483
> rgn1,
1484
                                             <GTKDOCLINK
1485
HREF="GR-REGION-ID-CAPS"
1486
>GR_REGION_ID</GTKDOCLINK
1487
> rgn2);</PRE
1488
></TD
1489
></TR
1490
></TABLE
1491
><P
1492
>Determines whether the specified regions are identical, and returns GR_TRUE
1493
if it is, or GR_FALSE otherwise.</P
1494
><P
1495
></P
1496
><DIV
1497
CLASS="INFORMALTABLE"
1498
><P
1499
></P
1500
><TABLE
1501
BORDER="0"
1502
WIDTH="100%"
1503
BGCOLOR="#FFD0D0"
1504
CELLSPACING="0"
1505
CELLPADDING="4"
1506
CLASS="CALSTABLE"
1507
><TR
1508
><TD
1509
WIDTH="20%"
1510
ALIGN="RIGHT"
1511
VALIGN="TOP"
1512
><TT
1513
CLASS="PARAMETER"
1514
><I
1515
>rgn1</I
1516
></TT
1517
>&nbsp;:</TD
1518
><TD
1519
WIDTH="80%"
1520
ALIGN="LEFT"
1521
VALIGN="TOP"
1522
> the ID of the first region to examine</TD
1523
></TR
1524
><TR
1525
><TD
1526
WIDTH="20%"
1527
ALIGN="RIGHT"
1528
VALIGN="TOP"
1529
><TT
1530
CLASS="PARAMETER"
1531
><I
1532
>rgn2</I
1533
></TT
1534
>&nbsp;:</TD
1535
><TD
1536
WIDTH="80%"
1537
ALIGN="LEFT"
1538
VALIGN="TOP"
1539
> the ID of the second region to examine</TD
1540
></TR
1541
><TR
1542
><TD
1543
WIDTH="20%"
1544
ALIGN="RIGHT"
1545
VALIGN="TOP"
1546
><I
1547
CLASS="EMPHASIS"
1548
>Returns</I
1549
> :</TD
1550
><TD
1551
WIDTH="80%"
1552
ALIGN="LEFT"
1553
VALIGN="TOP"
1554
> GR_TRUE if the regions are equal, or GR_FALSE otherwise</TD
1555
></TR
1556
></TABLE
1557
><P
1558
></P
1559
></DIV
1560
></DIV
1561
><HR><DIV
1562
CLASS="REFSECT2"
1563
><A
1564
NAME="AEN2891"
1565
></A
1566
><H3
1567
><A
1568
NAME="GROFFSETREGION"
1569
></A
1570
>GrOffsetRegion ()</H3
1571
><TABLE
1572
BORDER="0"
1573
BGCOLOR="#D6E8FF"
1574
WIDTH="100%"
1575
CELLPADDING="6"
1576
><TR
1577
><TD
1578
><PRE
1579
CLASS="PROGRAMLISTING"
1580
>void        GrOffsetRegion                  (<GTKDOCLINK
1581
HREF="GR-REGION-ID-CAPS"
1582
>GR_REGION_ID</GTKDOCLINK
1583
> region,
1584
                                             <GTKDOCLINK
1585
HREF="GR-SIZE-CAPS"
1586
>GR_SIZE</GTKDOCLINK
1587
> dx,
1588
                                             <GTKDOCLINK
1589
HREF="GR-SIZE-CAPS"
1590
>GR_SIZE</GTKDOCLINK
1591
> dy);</PRE
1592
></TD
1593
></TR
1594
></TABLE
1595
><P
1596
>Offsets the specified region by the specified distance.</P
1597
><P
1598
></P
1599
><DIV
1600
CLASS="INFORMALTABLE"
1601
><P
1602
></P
1603
><TABLE
1604
BORDER="0"
1605
WIDTH="100%"
1606
BGCOLOR="#FFD0D0"
1607
CELLSPACING="0"
1608
CELLPADDING="4"
1609
CLASS="CALSTABLE"
1610
><TR
1611
><TD
1612
WIDTH="20%"
1613
ALIGN="RIGHT"
1614
VALIGN="TOP"
1615
><TT
1616
CLASS="PARAMETER"
1617
><I
1618
>region</I
1619
></TT
1620
>&nbsp;:</TD
1621
><TD
1622
WIDTH="80%"
1623
ALIGN="LEFT"
1624
VALIGN="TOP"
1625
> the ID of the region to offset</TD
1626
></TR
1627
><TR
1628
><TD
1629
WIDTH="20%"
1630
ALIGN="RIGHT"
1631
VALIGN="TOP"
1632
><TT
1633
CLASS="PARAMETER"
1634
><I
1635
>dx</I
1636
></TT
1637
>&nbsp;:</TD
1638
><TD
1639
WIDTH="80%"
1640
ALIGN="LEFT"
1641
VALIGN="TOP"
1642
> the distance to offset the region by in the X axis</TD
1643
></TR
1644
><TR
1645
><TD
1646
WIDTH="20%"
1647
ALIGN="RIGHT"
1648
VALIGN="TOP"
1649
><TT
1650
CLASS="PARAMETER"
1651
><I
1652
>dy</I
1653
></TT
1654
>&nbsp;:</TD
1655
><TD
1656
WIDTH="80%"
1657
ALIGN="LEFT"
1658
VALIGN="TOP"
1659
> the distance to offset the region by in the Y axis</TD
1660
></TR
1661
></TABLE
1662
><P
1663
></P
1664
></DIV
1665
></DIV
1666
><HR><DIV
1667
CLASS="REFSECT2"
1668
><A
1669
NAME="AEN2917"
1670
></A
1671
><H3
1672
><A
1673
NAME="GRGETREGIONBOX"
1674
></A
1675
>GrGetRegionBox ()</H3
1676
><TABLE
1677
BORDER="0"
1678
BGCOLOR="#D6E8FF"
1679
WIDTH="100%"
1680
CELLPADDING="6"
1681
><TR
1682
><TD
1683
><PRE
1684
CLASS="PROGRAMLISTING"
1685
>int         GrGetRegionBox                  (<GTKDOCLINK
1686
HREF="GR-REGION-ID-CAPS"
1687
>GR_REGION_ID</GTKDOCLINK
1688
> region,
1689
                                             <GTKDOCLINK
1690
HREF="GR-RECT-CAPS"
1691
>GR_RECT</GTKDOCLINK
1692
> *rect);</PRE
1693
></TD
1694
></TR
1695
></TABLE
1696
><P
1697
>Fills in the specified rectangle structure with a bounding box that would
1698
completely enclose the specified region, and also returns the type of the
1699
specified region.</P
1700
><P
1701
></P
1702
><DIV
1703
CLASS="INFORMALTABLE"
1704
><P
1705
></P
1706
><TABLE
1707
BORDER="0"
1708
WIDTH="100%"
1709
BGCOLOR="#FFD0D0"
1710
CELLSPACING="0"
1711
CELLPADDING="4"
1712
CLASS="CALSTABLE"
1713
><TR
1714
><TD
1715
WIDTH="20%"
1716
ALIGN="RIGHT"
1717
VALIGN="TOP"
1718
><TT
1719
CLASS="PARAMETER"
1720
><I
1721
>region</I
1722
></TT
1723
>&nbsp;:</TD
1724
><TD
1725
WIDTH="80%"
1726
ALIGN="LEFT"
1727
VALIGN="TOP"
1728
> the ID of the region to get the bounding box of</TD
1729
></TR
1730
><TR
1731
><TD
1732
WIDTH="20%"
1733
ALIGN="RIGHT"
1734
VALIGN="TOP"
1735
><TT
1736
CLASS="PARAMETER"
1737
><I
1738
>rect</I
1739
></TT
1740
>&nbsp;:</TD
1741
><TD
1742
WIDTH="80%"
1743
ALIGN="LEFT"
1744
VALIGN="TOP"
1745
> pointer to a rectangle structure</TD
1746
></TR
1747
><TR
1748
><TD
1749
WIDTH="20%"
1750
ALIGN="RIGHT"
1751
VALIGN="TOP"
1752
><I
1753
CLASS="EMPHASIS"
1754
>Returns</I
1755
> :</TD
1756
><TD
1757
WIDTH="80%"
1758
ALIGN="LEFT"
1759
VALIGN="TOP"
1760
> the region type</TD
1761
></TR
1762
></TABLE
1763
><P
1764
></P
1765
></DIV
1766
></DIV
1767
><HR><DIV
1768
CLASS="REFSECT2"
1769
><A
1770
NAME="AEN2942"
1771
></A
1772
><H3
1773
><A
1774
NAME="GRNEWPOLYGONREGION"
1775
></A
1776
>GrNewPolygonRegion ()</H3
1777
><TABLE
1778
BORDER="0"
1779
BGCOLOR="#D6E8FF"
1780
WIDTH="100%"
1781
CELLPADDING="6"
1782
><TR
1783
><TD
1784
><PRE
1785
CLASS="PROGRAMLISTING"
1786
><GTKDOCLINK
1787
HREF="GR-REGION-ID-CAPS"
1788
>GR_REGION_ID</GTKDOCLINK
1789
> GrNewPolygonRegion             (int mode,
1790
                                             <GTKDOCLINK
1791
HREF="GR-COUNT-CAPS"
1792
>GR_COUNT</GTKDOCLINK
1793
> count,
1794
                                             <GTKDOCLINK
1795
HREF="GR-POINT-CAPS"
1796
>GR_POINT</GTKDOCLINK
1797
> *points);</PRE
1798
></TD
1799
></TR
1800
></TABLE
1801
><P
1802
>Creates a new region structure, fills it with the region described by the
1803
specified polygon, and returns the ID used to refer to it.</P
1804
><P
1805
></P
1806
><DIV
1807
CLASS="INFORMALTABLE"
1808
><P
1809
></P
1810
><TABLE
1811
BORDER="0"
1812
WIDTH="100%"
1813
BGCOLOR="#FFD0D0"
1814
CELLSPACING="0"
1815
CELLPADDING="4"
1816
CLASS="CALSTABLE"
1817
><TR
1818
><TD
1819
WIDTH="20%"
1820
ALIGN="RIGHT"
1821
VALIGN="TOP"
1822
><TT
1823
CLASS="PARAMETER"
1824
><I
1825
>mode</I
1826
></TT
1827
>&nbsp;:</TD
1828
><TD
1829
WIDTH="80%"
1830
ALIGN="LEFT"
1831
VALIGN="TOP"
1832
> the polygon mode to use (GR_POLY_EVENODD or GR_POLY_WINDING)</TD
1833
></TR
1834
><TR
1835
><TD
1836
WIDTH="20%"
1837
ALIGN="RIGHT"
1838
VALIGN="TOP"
1839
><TT
1840
CLASS="PARAMETER"
1841
><I
1842
>count</I
1843
></TT
1844
>&nbsp;:</TD
1845
><TD
1846
WIDTH="80%"
1847
ALIGN="LEFT"
1848
VALIGN="TOP"
1849
> the number of points in the polygon</TD
1850
></TR
1851
><TR
1852
><TD
1853
WIDTH="20%"
1854
ALIGN="RIGHT"
1855
VALIGN="TOP"
1856
><TT
1857
CLASS="PARAMETER"
1858
><I
1859
>points</I
1860
></TT
1861
>&nbsp;:</TD
1862
><TD
1863
WIDTH="80%"
1864
ALIGN="LEFT"
1865
VALIGN="TOP"
1866
> pointer to an array of point structures describing the polygon</TD
1867
></TR
1868
><TR
1869
><TD
1870
WIDTH="20%"
1871
ALIGN="RIGHT"
1872
VALIGN="TOP"
1873
><I
1874
CLASS="EMPHASIS"
1875
>Returns</I
1876
> :</TD
1877
><TD
1878
WIDTH="80%"
1879
ALIGN="LEFT"
1880
VALIGN="TOP"
1881
> the ID of the newly allocated region structure, or 0 on error</TD
1882
></TR
1883
></TABLE
1884
><P
1885
></P
1886
></DIV
1887
></DIV
1888
></DIV
1889
><DIV
1890
CLASS="NAVFOOTER"
1891
><BR
1892
CLEAR="all"><BR><TABLE
1893
WIDTH="100%"
1894
BORDER="0"
1895
BGCOLOR="#000000"
1896
CELLPADDING="1"
1897
CELLSPACING="0"
1898
><TR
1899
><TD
1900
WIDTH="25%"
1901
BGCOLOR="#C00000"
1902
ALIGN="left"
1903
><A
1904
HREF="nano-x-colours.html"
1905
><FONT
1906
COLOR="#FFFFFF"
1907
SIZE="3"
1908
><B
1909
>&#60;&#60;&#60; Previous Page</B
1910
></FONT
1911
></A
1912
></TD
1913
><TD
1914
WIDTH="25%"
1915
BGCOLOR="#0000C0"
1916
ALIGN="center"
1917
><FONT
1918
COLOR="#FFFFFF"
1919
SIZE="3"
1920
><B
1921
><A
1922
HREF="index.html"
1923
><FONT
1924
COLOR="#FFFFFF"
1925
SIZE="3"
1926
><B
1927
>Home</B
1928
></FONT
1929
></A
1930
></B
1931
></FONT
1932
></TD
1933
><TD
1934
WIDTH="25%"
1935
BGCOLOR="#00C000"
1936
ALIGN="center"
1937
><FONT
1938
COLOR="#FFFFFF"
1939
SIZE="3"
1940
><B
1941
><A
1942
HREF="libnano-x.html"
1943
><FONT
1944
COLOR="#FFFFFF"
1945
SIZE="3"
1946
><B
1947
>Up</B
1948
></FONT
1949
></A
1950
></B
1951
></FONT
1952
></TD
1953
><TD
1954
WIDTH="25%"
1955
BGCOLOR="#C00000"
1956
ALIGN="right"
1957
><A
1958
HREF="nano-x-selections.html"
1959
><FONT
1960
COLOR="#FFFFFF"
1961
SIZE="3"
1962
><B
1963
>Next Page &#62;&#62;&#62;</B
1964
></FONT
1965
></A
1966
></TD
1967
></TR
1968
><TR
1969
><TD
1970
COLSPAN="2"
1971
ALIGN="left"
1972
><FONT
1973
COLOR="#FFFFFF"
1974
SIZE="3"
1975
><B
1976
>colours</B
1977
></FONT
1978
></TD
1979
><TD
1980
COLSPAN="2"
1981
ALIGN="right"
1982
><FONT
1983
COLOR="#FFFFFF"
1984
SIZE="3"
1985
><B
1986
>selections</B
1987
></FONT
1988
></TD
1989
></TR
1990
></TABLE
1991
></DIV
1992
></BODY
1993
></HTML
1994
>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.