Cairo::Pattern is the paint with which cairo draws. More...

#include <cairomm/pattern.h>

Inheritance diagram for Cairo::Pattern:

[legend]

Public Types
typedef cairo_pattern_t	cobject

Public Member Functions
	Pattern (cairo_pattern_t *cobject, bool has_reference=false)
	Create a C++ wrapper for the C instance. More...

	Pattern (const Pattern &)=delete

Pattern &	operator= (const Pattern &)=delete

virtual	~Pattern ()

void	set_matrix (const Matrix & matrix)
	Sets the pattern's transformation matrix to @matrix. More...

void	get_matrix (Matrix & matrix) const
	Returns the pattern's transformation matrix. More...

Matrix	get_matrix () const
	Returns the pattern's transformation matrix. More...

void	set_matrix (const cairo_matrix_t & matrix)

void	get_matrix (cairo_matrix_t & matrix) const

PatternType	get_type () const
	Returns the type of the pattern. More...

void	set_extend (Extend extend)
	Sets the mode to be used for drawing outside the area of a pattern. More...

Extend	get_extend () const
	Gets the current extend mode See Cairo::Extend for details on the semantics of each extend strategy. More...

cobject *	cobj ()

const cobject *	cobj () const

void	reference () const

void	unreference () const

Protected Member Functions
	Pattern ()

Protected Attributes
cobject *	m_cobject

Detailed Description

Cairo::Pattern is the paint with which cairo draws.

The primary use of patterns is as the source for all cairo drawing operations, although they can also be used as masks, that is, as the brush too.

This is a reference-counted object that should be used via Cairo::RefPtr.

Member Typedef Documentation

◆ cobject

typedef cairo_pattern_t Cairo::Pattern::cobject

Constructor & Destructor Documentation

◆ Pattern() [1/3]

Cairo::Pattern::Pattern	(	cairo_pattern_t *	cobject,
		bool	has_reference = `false`
	)

explicit

Create a C++ wrapper for the C instance.

This C++ instance should then be given to a RefPtr.

Parameters

cobject	The C instance.
has_reference	Whether we already have a reference. Otherwise, the constructor will take an extra reference.

◆ Pattern() [2/3]

Cairo::Pattern::Pattern ( const Pattern & )

delete

◆ ~Pattern()

virtual Cairo::Pattern::~Pattern ( )

virtual

◆ Pattern() [3/3]

Cairo::Pattern::Pattern ( )

protected

Member Function Documentation

◆ cobj() [1/2]

cobject * Cairo::Pattern::cobj ( )

inline

◆ cobj() [2/2]

const cobject * Cairo::Pattern::cobj ( ) const

inline

◆ get_extend()

Extend Cairo::Pattern::get_extend ( ) const

Gets the current extend mode See Cairo::Extend for details on the semantics of each extend strategy.

Since: 1.12

◆ get_matrix() [1/3]

Matrix Cairo::Pattern::get_matrix ( ) const

Returns the pattern's transformation matrix.

Since: 1.8

◆ get_matrix() [2/3]

void Cairo::Pattern::get_matrix ( cairo_matrix_t & matrix ) const

◆ get_matrix() [3/3]

void Cairo::Pattern::get_matrix ( Matrix & matrix ) const

Returns the pattern's transformation matrix.

◆ get_type()

PatternType Cairo::Pattern::get_type ( ) const

Returns the type of the pattern.

Since: 1.2

◆ operator=()

Pattern & Cairo::Pattern::operator= ( const Pattern & )

delete

◆ reference()

void Cairo::Pattern::reference ( ) const

◆ set_extend()

void Cairo::Pattern::set_extend ( Extend extend )

Sets the mode to be used for drawing outside the area of a pattern.

See Cairo::Extend for details on the semantics of each extend strategy.

The default extend mode is Cairo::EXTEND_NONE for surface patterns and Cairo::EXTEND_PAD for gradient patterns.

Parameters

Cairo::Extend describing how the area outsize of the pattern will be drawn

Since: 1.12

◆ set_matrix() [1/2]

void Cairo::Pattern::set_matrix ( const cairo_matrix_t & matrix )

◆ set_matrix() [2/2]

void Cairo::Pattern::set_matrix ( const Matrix & matrix )

Sets the pattern's transformation matrix to @matrix.

This matrix is a transformation from user space to pattern space.

When a pattern is first created it always has the identity matrix for its transformation matrix, which means that pattern space is initially identical to user space.

Important: Please note that the direction of this transformation matrix is from user space to pattern space. This means that if you imagine the flow from a pattern to user space (and on to device space), then coordinates in that flow will be transformed by the inverse of the pattern matrix.

For example, if you want to make a pattern appear twice as large as it does by default the correct code to use is:

pattern->set_matrix(scaling_matrix(0.5, 0.5));

Meanwhile, using values of 2.0 rather than 0.5 in the code above would cause the pattern to appear at half of its default size.

Also, please note the discussion of the user-space locking semantics of set_source().

◆ unreference()

void Cairo::Pattern::unreference ( ) const

Member Data Documentation

◆ m_cobject

cobject* Cairo::Pattern::m_cobject