Gdk::Region Class Reference

#include <region.h>

Public Member Functions
	Region ()
	Region (GdkRegion *castitem, bool make_a_copy=false)
	Region (const Region &src)
Region &	operator= (const Region &src)
	~Region ()
GdkRegion *	gobj ()
const GdkRegion *	gobj () const
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. More...
	Region (const Glib::ArrayHandle< Gdk::Point > &points, FillRule fill_rule)
	Region (const Rectangle &rectangle)
void	get_clipbox (const Rectangle &rectangle)
Glib::ArrayHandle< Rectangle >	get_rectangles () const
bool	empty ()
bool	point_in (int x, int y)
OverlapType	rect_in (const Rectangle &rect)
void	offset (int dx, int dy)
void	shrink (int dx, int dy)
void	union_with_rect (const Rectangle &rect)
void	intersect (const Region &source2)
void	union_ (const Region &source2)
void	subtract (const Region &source2)
void	xor_ (const Region &source2)
void	spans_intersect_foreach (GdkSpan *spans, int n_spans, bool sorted, GdkSpanFunc function, gpointer data)

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)

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()).

Definition at line 144 of file tk/ydkmm/ydkmm/region.h.

Constructor & Destructor Documentation

Region() [1/5]

Gdk::Region::Region

(

)

Constructs an invalid object. E.g. for output arguments to methods. There is not much you can do with the object before it has been assigned a valid value.

Region() [2/5]

Gdk::Region::Region ( GdkRegion *  castitem, bool  make_a_copy = false  )

explicit

Region() [3/5]

Gdk::Region::Region

(

const Region &

src

)

~Region()

Gdk::Region::~Region

(

)

Region() [4/5]

Gdk::Region::Region	(	const Glib::ArrayHandle< Gdk::Point > &	points,
		FillRule	fill_rule
	)

Region() [5/5]

Gdk::Region::Region ( const Rectangle &  rectangle )

explicit

Member Function Documentation

empty()

bool Gdk::Region::empty

(

)

Finds out if the Gdk::Region is empty.

Returns

true if region is empty.

get_clipbox()

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.

get_rectangles()

Glib::ArrayHandle<Rectangle> Gdk::Region::get_rectangles

(

)

const

gobj() [1/2]

GdkRegion* Gdk::Region::gobj ( )

inline

Definition at line 166 of file tk/ydkmm/ydkmm/region.h.

gobj() [2/2]

const GdkRegion* Gdk::Region::gobj ( ) const

inline

Definition at line 167 of file tk/ydkmm/ydkmm/region.h.

gobj_copy()

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.

intersect()

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.

offset()

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.

operator=()

Region& Gdk::Region::operator=

(

const Region &

src

)

point_in()

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

true if the point is in region.

rect_in()

OverlapType Gdk::Region::rect_in

(

const Rectangle &

rect

)

Tests whether a rectangle is within a region.

Parameters

rect	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.

shrink()

void Gdk::Region::shrink	(	int	dx,
		int	dy
	)

Resizes a region by the specified amount. Positive values shrink the region. Negative values expand it.

Deprecated: 2.22: There is no replacement for this function.

Parameters

dx	The number of pixels to shrink the region horizontally.
dy	The number of pixels to shrink the region vertically.

spans_intersect_foreach()

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.

Deprecated: 2.22: There is no replacement.

Parameters

spans	An array of Gdk::Spans.
n_spans	The length of spans.
sorted	true if spans is sorted wrt. the y coordinate.
function	Function to call on each span in the intersection.
data	Data to pass to function.

subtract()

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.

union_()

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.

union_with_rect()

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.

xor_()

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

operator!=()

bool operator!= ( const Region &  lhs, const Region &  rhs  )

related

Parameters

lhs	The left-hand side
rhs	The right-hand side

Returns

The result

operator==()

bool operator== ( const Region &  lhs, const Region &  rhs  )

related

Parameters

lhs	The left-hand side
rhs	The right-hand side

Returns

The result

wrap()

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

gobject_

GdkRegion* Gdk::Region::gobject_

protected

Definition at line 173 of file tk/ydkmm/ydkmm/region.h.

---

The documentation for this class was generated from the following file:

• tk/ydkmm/ydkmm/region.h