Functions
PEXPORT ps_matrix *PICAPI	ps_matrix_create (void)
	Create a identity matrix object. More...

PEXPORT ps_matrix *PICAPI	ps_matrix_create_init (float sx, float shy, float shx, float sy, float tx, float ty)
	Create a matrix with given parameters. More...

PEXPORT ps_matrix *PICAPI	ps_matrix_create_copy (const ps_matrix *matrix)
	Create a matrix copy from an exist one. More...

PEXPORT ps_matrix *PICAPI	ps_matrix_ref (ps_matrix *matrix)
	Increases the reference count of the matrix by 1. More...

PEXPORT void PICAPI	ps_matrix_unref (ps_matrix *matrix)
	Decrements the reference count for the matrix object. If the reference count on the matrix falls to 0, the matrix is freed. More...

PEXPORT void PICAPI	ps_matrix_init (ps_matrix *matrix, float sx, float shy, float shx, float sy, float tx, float ty)
	Initialize an existing matrix object with given parameters. More...

PEXPORT void PICAPI	ps_matrix_translate (ps_matrix *matrix, float tx, float ty)
	Modify a matrix by translating. More...

PEXPORT void PICAPI	ps_matrix_scale (ps_matrix *matrix, float sx, float sy)
	Modify a matrix by scaling. More...

PEXPORT void PICAPI	ps_matrix_rotate (ps_matrix *matrix, float angle)
	Modify a matrix by rotating. More...

PEXPORT void PICAPI	ps_matrix_shear (ps_matrix *matrix, float shx, float shy)
	Modify a matrix by shearing. More...

PEXPORT void PICAPI	ps_matrix_invert (ps_matrix *matrix)
	Modify a matrix by inverting. More...

PEXPORT void PICAPI	ps_matrix_identity (ps_matrix *matrix)
	Reset a matrix to identity matrix. More...

PEXPORT void PICAPI	ps_matrix_flip_x (ps_matrix *matrix)
	Flip a matrix in the horizontal direction. More...

PEXPORT void PICAPI	ps_matrix_flip_y (ps_matrix *matrix)
	Flip a matrix in the vertical direction. More...

PEXPORT void PICAPI	ps_matrix_multiply (ps_matrix result, const ps_matrix a, const ps_matrix *b)
	Multiplies the matrix in a and b together and stores the result in result. More...

PEXPORT ps_bool PICAPI	ps_matrix_is_identity (const ps_matrix *matrix)
	Checks whether the matrix is the identity transform matrix. More...

PEXPORT ps_bool PICAPI	ps_matrix_is_equal (const ps_matrix a, const ps_matrix b)
	Checks whether two matrix are equal. More...

PEXPORT float PICAPI	ps_matrix_get_determinant (const ps_matrix *matrix)
	Return the determinant from a matrix. More...

PEXPORT void PICAPI	ps_matrix_set_translate_factor (ps_matrix *matrix, float tx, float ty)
	Set the translate factors to the matrix. More...

PEXPORT ps_bool PICAPI	ps_matrix_get_translate_factor (ps_matrix matrix, float tx, float *ty)
	Get the translate factors from the matrix. More...

PEXPORT void PICAPI	ps_matrix_set_scale_factor (ps_matrix *matrix, float sx, float sy)
	Set the scale factors to the matrix. More...

PEXPORT ps_bool PICAPI	ps_matrix_get_scale_factor (ps_matrix matrix, float sx, float *sy)
	Get the scale factors from the matrix. More...

PEXPORT void PICAPI	ps_matrix_set_shear_factor (ps_matrix *matrix, float shx, float shy)
	Set the shear factors to the matrix. More...

PEXPORT ps_bool PICAPI	ps_matrix_get_shear_factor (ps_matrix matrix, float shx, float *shy)
	Get the shear factors from the matrix. More...

PEXPORT void PICAPI	ps_matrix_transform_point (const ps_matrix matrix, ps_point point)
	Transform an existing point using the matrix. More...

PEXPORT void PICAPI	ps_matrix_transform_rect (const ps_matrix matrix, ps_rect rect)
	Transform an existing rectangle using the matrix. More...

PEXPORT void PICAPI	ps_matrix_transform_path (const ps_matrix matrix, ps_path path)
	Transform an existing path using the matrix. More...

Detailed Description

Function Documentation

◆ ps_matrix_create()

ps_matrix * ps_matrix_create ( void )

Create a identity matrix object.

Returns: If the function succeeds, the return value is the pointer to a new matrix object. If the function fails, the return value is NULL.

Note: To get extended error information, call ps_last_status.

See also: ps_matrix_create_init, ps_matrix_create_copy, ps_matrix_ref, ps_matrix_unref

◆ ps_matrix_create_copy()

ps_matrix * ps_matrix_create_copy ( const ps_matrix * matrix )

Create a matrix copy from an exist one.

Parameters

matrix Pointer to an existing matrix object.

Returns: If the function succeeds, the return value is the pointer to a new matrix object. If the function fails, the return value is NULL.

Note: To get extended error information, call ps_last_status.

See also: ps_matrix_create_init, ps_matrix_create, ps_matrix_ref, ps_matrix_unref

◆ ps_matrix_create_init()

ps_matrix * ps_matrix_create_init	(	float	sx,
		float	shy,
		float	shx,
		float	sy,
		float	tx,
		float	ty
	)

Create a matrix with given parameters.

Parameters

sx	The horizontal scaling factor.
shy	The vertical skewing factor.
shx	The horizontal skewing factor.
sy	The vertical scaling factor.
tx	The horizontal translating factor.
ty	The vertical translating factor.

Returns: If the function succeeds, the return value is the pointer to a new matrix object. If the function fails, the return value is NULL.

Note: To get extended error information, call ps_last_status.

See also: ps_matrix_create, ps_matrix_create_copy, ps_matrix_ref, ps_matrix_unref

◆ ps_matrix_flip_x()

void ps_matrix_flip_x ( ps_matrix * matrix )

Flip a matrix in the horizontal direction.

Parameters

matrix Pointer to an existing matrix object.

See also: ps_matrix_identity, ps_matrix_flip_y, ps_matrix_invert

◆ ps_matrix_flip_y()

void ps_matrix_flip_y ( ps_matrix * matrix )

Flip a matrix in the vertical direction.

Parameters

matrix Pointer to an existing matrix object.

See also: ps_matrix_identity, ps_matrix_flip_x, ps_matrix_invert

◆ ps_matrix_get_determinant()

float ps_matrix_get_determinant ( const ps_matrix * matrix )

Return the determinant from a matrix.

Parameters

matrix Pointer to an existing matrix object.

Returns: The determinant of the matrix.

See also: ps_matrix_is_equal, ps_matrix_is_identity, ps_matrix_multiply

◆ ps_matrix_get_scale_factor()

ps_bool ps_matrix_get_scale_factor	(	ps_matrix *	matrix,
		float *	sx,
		float *	sy
	)

Get the scale factors from the matrix.

Parameters

matrix	Pointer to an existing matrix object.
sx	Pointer to a buffer to receiving the scale factor in x dimension.
sy	Pointer to a buffer to receiving the scale factor in y dimension.

Returns: True if is success, otherwise False.

See also: ps_matrix_set_scale_factor

◆ ps_matrix_get_shear_factor()

ps_bool ps_matrix_get_shear_factor	(	ps_matrix *	matrix,
		float *	shx,
		float *	shy
	)

Get the shear factors from the matrix.

Parameters

matrix	Pointer to an existing matrix object.
shx	Pointer to a buffer to receiving the shear factor in horizontal.
shy	Pointer to a buffer to receiving the shear factor in vertical.

Returns: True if is success, otherwise False.

See also: ps_matrix_set_shear_factor

◆ ps_matrix_get_translate_factor()

ps_bool ps_matrix_get_translate_factor	(	ps_matrix *	matrix,
		float *	tx,
		float *	ty
	)

Get the translate factors from the matrix.

Parameters

matrix	Pointer to an existing matrix object.
tx	Pointer to a buffer to receiving the translate factor in x direction.
ty	Pointer to a buffer to receiving the translate factor in y direction.

Returns: True if is success, otherwise False.

See also: ps_matrix_set_translate_factor

◆ ps_matrix_identity()

void ps_matrix_identity ( ps_matrix * matrix )

Reset a matrix to identity matrix.

Parameters

matrix Pointer to an existing matrix object.

See also: ps_matrix_flip_x, ps_matrix_flip_y, ps_matrix_invert

◆ ps_matrix_init()

void ps_matrix_init	(	ps_matrix *	matrix,
		float	sx,
		float	shy,
		float	shx,
		float	sy,
		float	tx,
		float	ty
	)

Initialize an existing matrix object with given parameters.

Parameters

matrix	Pointer to an existing matrix object.
sx	The horizontal scaling factor.
shy	The vertical skewing factor.
shx	The horizontal skewing factor.
sy	The vertical scaling factor.
tx	The horizontal translating factor.
ty	The vertical translating factor.

See also: ps_matrix_translate, ps_matrix_scale, ps_matrix_shear, ps_matrix_rotate

◆ ps_matrix_invert()

void ps_matrix_invert ( ps_matrix * matrix )

Modify a matrix by inverting.

Parameters

matrix Pointer to an existing matrix object.

See also: ps_matrix_flip_x, ps_matrix_flip_y, ps_matrix_identity

◆ ps_matrix_is_equal()

ps_bool ps_matrix_is_equal	(	const ps_matrix *	a,
		const ps_matrix *	b
	)

Checks whether two matrix are equal.

Parameters

a	Pointer to an existing matrix object.
b	Pointer to an existing matrix object.

Returns: True if a and b are equal, otherwise False.

See also: ps_matrix_is_identity, ps_matrix_get_determinant, ps_matrix_multiply

◆ ps_matrix_is_identity()

ps_bool ps_matrix_is_identity ( const ps_matrix * matrix )

Checks whether the matrix is the identity transform matrix.

Parameters

matrix Pointer to an existing matrix object.

Returns: True if is identity, otherwise False.

See also: ps_matrix_is_equal, ps_matrix_get_determinant, ps_matrix_multiply

◆ ps_matrix_multiply()

void ps_matrix_multiply	(	ps_matrix *	result,
		const ps_matrix *	a,
		const ps_matrix *	b
	)

Multiplies the matrix in a and b together and stores the result in result.

Parameters

result	Pointer to an existing matrix object in which to store the result.
a	Pointer to an existing matrix object.
b	Pointer to an existing matrix object.

See also: ps_matrix_is_identity, ps_matrix_is_equal ps_matrix_get_determinant

◆ ps_matrix_ref()

ps_matrix * ps_matrix_ref ( ps_matrix * matrix )

Increases the reference count of the matrix by 1.

Parameters

matrix Pointer to an existing matrix object.

Returns: If the function succeeds, the return value is the pointer to the matrix object. If the function fails, the return value is NULL.

Note: To get extended error information, call ps_last_status.

See also: ps_matrix_create_init, ps_matrix_create, ps_matrix_create_copy, ps_matrix_unref

◆ ps_matrix_rotate()

void ps_matrix_rotate	(	ps_matrix *	matrix,
		float	angle
	)

Modify a matrix by rotating.

Parameters

matrix	Pointer to an existing matrix object.
angle	The angle, in radians, which to rotate the specified matrix.

See also: ps_matrix_translate, ps_matrix_shear, ps_matrix_scale

◆ ps_matrix_scale()

void ps_matrix_scale	(	ps_matrix *	matrix,
		float	sx,
		float	sy
	)

Modify a matrix by scaling.

Parameters

matrix	Pointer to an existing matrix object.
sx	The scale factor for the X dimension.
sy	The scale factor for the Y dimension.

See also: ps_matrix_translate, ps_matrix_shear, ps_matrix_rotate

◆ ps_matrix_set_scale_factor()

void ps_matrix_set_scale_factor	(	ps_matrix *	matrix,
		float	sx,
		float	sy
	)

Set the scale factors to the matrix.

Parameters

matrix	Pointer to an existing matrix object.
sx	The scale factor in x dimension.
sy	The scale factor in y dimension.

See also: ps_matrix_get_scale_factor

◆ ps_matrix_set_shear_factor()

void ps_matrix_set_shear_factor	(	ps_matrix *	matrix,
		float	shx,
		float	shy
	)

Set the shear factors to the matrix.

Parameters

matrix	Pointer to an existing matrix object.
shx	The shear factor for the horizontal.
shy	The shear factor for the vertical.

See also: ps_matrix_get_shear_factor

◆ ps_matrix_set_translate_factor()

void ps_matrix_set_translate_factor	(	ps_matrix *	matrix,
		float	tx,
		float	ty
	)

Set the translate factors to the matrix.

Parameters

matrix	Pointer to an existing matrix object.
tx	The amount, in pixels, which the translate factor in x direction.
ty	The amount, in pixels, which the translate factor in y direction.

See also: ps_matrix_get_translate_factor

◆ ps_matrix_shear()

void ps_matrix_shear	(	ps_matrix *	matrix,
		float	shx,
		float	shy
	)

Modify a matrix by shearing.

Parameters

matrix	Pointer to an existing matrix object.
shx	The shear factor for the horizontal.
shy	The shear factor for the vertical.

See also: ps_matrix_translate, ps_matrix_scale, ps_matrix_rotate

◆ ps_matrix_transform_path()

void ps_matrix_transform_path	(	const ps_matrix *	matrix,
		ps_path *	path
	)

Transform an existing path using the matrix.

Parameters

matrix	Pointer to an existing matrix object.
path	An existing path which will be transformed.

See also: ps_matrix_transform_point, ps_matrix_transform_rect

◆ ps_matrix_transform_point()

void ps_matrix_transform_point	(	const ps_matrix *	matrix,
		ps_point *	point
	)

Transform an existing point using the matrix.

Parameters

matrix	Pointer to an existing matrix object.
point	An existing point which will be transformed.

See also: ps_matrix_transform_rect, ps_matrix_transform_path

◆ ps_matrix_transform_rect()

void ps_matrix_transform_rect	(	const ps_matrix *	matrix,
		ps_rect *	rect
	)

Transform an existing rectangle using the matrix.

Parameters

matrix	Pointer to an existing matrix object.
rect	An existing rectangle which will be transformed.

See also: ps_matrix_transform_point, ps_matrix_transform_path

◆ ps_matrix_translate()

void ps_matrix_translate	(	ps_matrix *	matrix,
		float	tx,
		float	ty
	)

Modify a matrix by translating.

Parameters

matrix	Pointer to an existing matrix object.
tx	The amount, in pixels, which to translate in x direction.
ty	The amount, in pixels, which to translate in y direction.

See also: ps_matrix_scale, ps_matrix_shear, ps_matrix_rotate

◆ ps_matrix_unref()

void ps_matrix_unref ( ps_matrix * matrix )

Decrements the reference count for the matrix object. If the reference count on the matrix falls to 0, the matrix is freed.

Parameters

matrix Pointer to an existing matrix object.

See also: ps_matrix_create_init, ps_matrix_create, ps_matrix_create_copy, ps_matrix_ref

Functions

Detailed Description

Function Documentation

◆ ps_matrix_create()

◆ ps_matrix_create_copy()

◆ ps_matrix_create_init()

◆ ps_matrix_flip_x()

◆ ps_matrix_flip_y()

◆ ps_matrix_get_determinant()

◆ ps_matrix_get_scale_factor()

◆ ps_matrix_get_shear_factor()

◆ ps_matrix_get_translate_factor()

◆ ps_matrix_identity()

◆ ps_matrix_init()

◆ ps_matrix_invert()

◆ ps_matrix_is_equal()

◆ ps_matrix_is_identity()

◆ ps_matrix_multiply()

◆ ps_matrix_ref()

◆ ps_matrix_rotate()

◆ ps_matrix_scale()

◆ ps_matrix_set_scale_factor()

◆ ps_matrix_set_shear_factor()

◆ ps_matrix_set_translate_factor()

◆ ps_matrix_shear()

◆ ps_matrix_transform_path()

◆ ps_matrix_transform_point()

◆ ps_matrix_transform_rect()

◆ ps_matrix_translate()

◆ ps_matrix_unref()