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

Detailed Description

Function Documentation

ps_get_matrix()

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

ps_identity()

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

ps_rotate()

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

ps_scale()

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

ps_set_matrix()

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

ps_shear()

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

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

ps_translate()

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

ps_viewport_to_world()

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

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