Transform

Functions
PEXPORT void PICAPI	ps_translate (ps_context *ctx, float tx, float ty)
	Changes the origin of the user coordinate system in graphic context.
PEXPORT void PICAPI	ps_scale (ps_context *ctx, float sx, float sy)
	Changes the scale of the user coordinate system in graphic context.
PEXPORT void PICAPI	ps_shear (ps_context *ctx, float shx, float shy)
	Changes the shear of the user coordinate system in graphic context.
PEXPORT void PICAPI	ps_rotate (ps_context *ctx, float angle)
	Rotates the user coordinate system in graphic context.
PEXPORT void PICAPI	ps_identity (ps_context *ctx)
	Reset the current transformation matrix to identity matrix.
PEXPORT void PICAPI	ps_transform (ps_context *ctx, const ps_matrix *matrix)
	Transforms the user coordinate system in graphic context using a specified matrix.
PEXPORT void PICAPI	ps_set_matrix (ps_context *ctx, const ps_matrix *matrix)
	Modifies the current transformation matrix to the given matrix.
PEXPORT ps_bool PICAPI	ps_get_matrix (ps_context *ctx, ps_matrix *matrix)
	Get the current transformation matrix from graphic context.
PEXPORT void PICAPI	ps_world_to_viewport (ps_context *ctx, ps_point *point)
	Transform a coordinate from device space to user space.
PEXPORT void PICAPI	ps_viewport_to_world (ps_context *ctx, ps_point *point)
	Transform a coordinate from user space to device space.

---

Function Documentation

ps_bool ps_get_matrix	(	ps_context *	ctx,
		ps_matrix *	matrix
	)

Get the current transformation matrix from graphic context.

Parameters:

ctx	Pointer to an existing context object.
matrix	Pointer to a matrix object to receiving the current transformation.

Returns:

True if is success, otherwise False.

See also:

ps_set_matrix

void ps_identity

(

ps_context *

ctx

)

Reset the current transformation matrix to identity matrix.

Parameters:

ctx	Pointer to an existing context object.

See also:

ps_translate, ps_scale, ps_shear, ps_rotate, ps_transform

void ps_rotate	(	ps_context *	ctx,
		float	angle
	)

Rotates the user coordinate system in graphic context.

Parameters:

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

See also:

ps_translate, ps_scale, ps_shear, ps_identity, ps_transform

void ps_scale	(	ps_context *	ctx,
		float	sx,
		float	sy
	)

Changes the scale of the user coordinate system in graphic context.

Parameters:

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

See also:

ps_translate, ps_shear, ps_rotate, ps_identity, ps_transform

void ps_set_matrix	(	ps_context *	ctx,
		const ps_matrix *	matrix
	)

Modifies the current transformation matrix to the given matrix.

Parameters:

ctx	Pointer to an existing context object.
matrix	The transformation matrix to be set.

See also:

ps_get_matrix

void ps_shear	(	ps_context *	ctx,
		float	shx,
		float	shy
	)

Changes the shear of the user coordinate system in graphic context.

Parameters:

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

See also:

ps_translate, ps_scale, ps_rotate, ps_identity, ps_transform

void ps_transform	(	ps_context *	ctx,
		const ps_matrix *	matrix
	)

Transforms the user coordinate system in graphic context using a specified matrix.

Parameters:

ctx	Pointer to an existing context object.
matrix	The matrix to apply to the specified context's current transformation matrix.

See also:

ps_translate, ps_scale, ps_shear, ps_rotate, ps_identity

void ps_translate	(	ps_context *	ctx,
		float	tx,
		float	ty
	)

Changes the origin of the user coordinate system in graphic context.

Parameters:

ctx	Pointer to an existing context 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_scale, ps_shear, ps_rotate, ps_identity, ps_transform

void ps_viewport_to_world	(	ps_context *	ctx,
		ps_point *	point
	)

Transform a coordinate from user space to device space.

Parameters:

ctx	Pointer to an existing context object.
point	The point which to be transformed.

See also:

ps_world_to_viewport

void ps_world_to_viewport	(	ps_context *	ctx,
		ps_point *	point
	)

Transform a coordinate from device space to user space.

Parameters:

ctx	Pointer to an existing context object.
point	The point which to be transformed.

See also:

ps_viewport_to_world