Gdk::Region Class Reference
This is an opaque data type holding a set of arbitrary pixels, and is usually used for clipping graphical operations (see Gdk::GC::set_clip_region()). More...
Public Member Functions | |
| bool | empty () |
| Finds out if the Gdk::Region is empty. | |
| void | get_clipbox (const Rectangle& rectangle) |
| Obtains the smallest rectangle which includes the entire Gdk::Region. | |
| Glib::ArrayHandle<Rectangle> | get_rectangles () const |
| const GdkRegion* | gobj () const |
| GdkRegion* | gobj () |
| GdkRegion* | gobj_copy () const |
| Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs. | |
| void | intersect (const Region& source2) |
| Sets the area of source1 to the intersection of the areas of source1 and source2. | |
| void | offset (int dx, int dy) |
| Moves a region the specified distance. | |
| Region& | operator= (const Region& src) |
| bool | point_in (int x, int y) |
| Finds out if a point is in a region. | |
| OverlapType | rect_in (const Rectangle& rect) |
| Tests whether a rectangle is within a region. | |
| Region (const Rectangle& rectangle) | |
| Region (const Glib::ArrayHandle<Gdk::Point>& points, FillRule fill_rule) | |
| Region (const Region& src) | |
| Region (GdkRegion* castitem, bool make_a_copy=false) | |
| Region () | |
| void | shrink (int dx, int dy) |
| Resizes a region by the specified amount. | |
| void | spans_intersect_foreach (GdkSpan* spans, int n_spans, bool sorted, GdkSpanFunc function, gpointer data) |
| Calls a function on each span in the intersection of region and spans. | |
| void | subtract (const Region& source2) |
| Subtracts the area of source2 from the area source1. | |
| void | union_ (const Region& source2) |
| Sets the area of source1 to the union of the areas of source1 and source2. | |
| void | union_with_rect (const Rectangle& rect) |
| Sets the area of region to the union of the areas of region and rect. | |
| void | xor_ (const Region& source2) |
| Sets the area of source1 to the exclusive-OR of the areas of source1 and source2. | |
| ~Region () | |
Protected Attributes | |
| GdkRegion* | gobject_ |
Related Functions | |
| (Note that these are not member functions.) | |
| bool | operator!= (const Region& lhs, const Region& rhs) |
| bool | operator== (const Region& lhs, const Region& rhs) |
| Gdk::Region | wrap (GdkRegion* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
Detailed Description
This is an opaque data type holding a set of arbitrary pixels, and is usually used for clipping graphical operations (see Gdk::GC::set_clip_region()).Constructor& Destructor Documentation
| Gdk::Region::Region | ( | ) |
| Gdk::Region::Region | ( | GdkRegion* | castitem, | |
| bool | make_a_copy = false | |||
| ) | [explicit] |
| Gdk::Region::Region | ( | const Region& | src | ) |
| Gdk::Region::~Region | ( | ) |
| Gdk::Region::Region | ( | const Glib::ArrayHandle<Gdk::Point>& | points, | |
| FillRule | fill_rule | |||
| ) |
| Gdk::Region::Region | ( | const Rectangle& | rectangle | ) | [explicit] |
Member Function Documentation
| bool Gdk::Region::empty | ( | ) |
| void Gdk::Region::get_clipbox | ( | const Rectangle& | rectangle | ) |
Obtains the smallest rectangle which includes the entire Gdk::Region.
- Parameters:
-
rectangle Return location for the clipbox.
| Glib::ArrayHandle<Rectangle> Gdk::Region::get_rectangles | ( | ) | const |
| GdkRegion* Gdk::Region::gobj_copy | ( | ) | const |
Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
| void Gdk::Region::intersect | ( | const Region& | source2 | ) |
Sets the area of source1 to the intersection of the areas of source1 and source2.
The resulting area is the set of pixels contained in both source1 and source2.
- Parameters:
-
source2 Another Gdk::Region.
| void Gdk::Region::offset | ( | int | dx, | |
| int | dy | |||
| ) |
Moves a region the specified distance.
- Parameters:
-
dx The distance to move the region horizontally. dy The distance to move the region vertically.
| bool Gdk::Region::point_in | ( | int | x, | |
| int | y | |||
| ) |
Finds out if a point is in a region.
- Parameters:
-
x The x coordinate of a point. y The y coordinate of a point.
- Returns:
trueif the point is in region.
| OverlapType Gdk::Region::rect_in | ( | const Rectangle& | rect | ) |
Tests whether a rectangle is within a region.
- Parameters:
-
rectangle A Gdk::Rectangle.
- Returns:
- Gdk::OVERLAP_RECTANGLE_IN, Gdk::OVERLAP_RECTANGLE_OUT, or Gdk::OVERLAP_RECTANGLE_PART, depending on whether the rectangle is inside, outside, or partly inside the Gdk::Region, respectively.
| void Gdk::Region::shrink | ( | int | dx, | |
| int | dy | |||
| ) |
Resizes a region by the specified amount.
Positive values shrink the region. Negative values expand it.
- Parameters:
-
dx The number of pixels to shrink the region horizontally. dy The number of pixels to shrink the region vertically.
| void Gdk::Region::spans_intersect_foreach | ( | GdkSpan * | spans, | |
| int | n_spans, | |||
| bool | sorted, | |||
| GdkSpanFunc | function, | |||
| gpointer | data | |||
| ) |
Calls a function on each span in the intersection of region and spans.
- Parameters:
-
spans An array of Gdk::Spans. n_spans The length of spans. sorted trueif spans is sorted wrt. the y coordinate.function Function to call on each span in the intersection. data Data to pass to function.
| void Gdk::Region::subtract | ( | const Region& | source2 | ) |
Subtracts the area of source2 from the area source1.
The resulting area is the set of pixels contained in source1 but not in source2.
- Parameters:
-
source2 Another Gdk::Region.
| void Gdk::Region::union_ | ( | const Region& | source2 | ) |
Sets the area of source1 to the union of the areas of source1 and source2.
The resulting area is the set of pixels contained in either source1 or source2.
- Parameters:
-
source2 A Gdk::Region.
| void Gdk::Region::union_with_rect | ( | const Rectangle& | rect | ) |
Sets the area of region to the union of the areas of region and rect.
The resulting area is the set of pixels contained in either region or rect.
- Parameters:
-
rect A Gdk::Rectangle.
| void Gdk::Region::xor_ | ( | const Region& | source2 | ) |
Sets the area of source1 to the exclusive-OR of the areas of source1 and source2.
The resulting area is the set of pixels contained in one or the other of the two sources but not in both.
- Parameters:
-
source2 Another Gdk::Region.
Friends And Related Function Documentation
- Parameters:
-
lhs The left-hand side rhs The right-hand side
- Returns:
- The result
- Parameters:
-
lhs The left-hand side rhs The right-hand side
- Returns:
- The result
| Gdk::Region wrap | ( | GdkRegion* | object, | |
| bool | take_copy = false | |||
| ) | [related] |
A Glib::wrap() method for this object.
- Parameters:
-
object The C instance. take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
- Returns:
- A C++ instance that wraps this C instance.
Member Data Documentation
GdkRegion* Gdk::Region::gobject_ [protected] |
Referenced by gobj().
The documentation for this class was generated from the following file:
