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

Subversion Repositories or1k

[/] [or1k/] [trunk/] [mw/] [doc/] [nano-X/] [html/] [nano-x-regions.html] - Blame information for rev 1765

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 673 markom 
<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.