Worldtransform

Functions
MGPLUS_EXPORT MPStatus	MGPlusSetWorldTransform (HGRAPHICS graphics, MPMatrix *matrix)
	Set the world transform of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusWorldTransform (HGRAPHICS graphics, MPMatrix *matrix)
	Multi the special matrix with matrix of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusGetWorldTransform (HGRAPHICS graphics, MPMatrix *matrix)
	Get the world transform of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusResetWorldTransform (HGRAPHICS graphics)
	Reset the world transform of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusTranslateWorldTransform (HGRAPHICS graphics, float dx, float dy)
	Translate the world transform of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusScaleWorldTransform (HGRAPHICS graphics, float sx, float sy)
	Scale the world transform of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusRotateWorldTransform (HGRAPHICS graphics, float angle)
	Rotate the world transform of graphic. More...
MGPLUS_EXPORT MPStatus	MGPlusPathTransform (HPATH path)
	Transform the path using its matrix. More...

Detailed Description

MGPlus maintains some worldtransform defines and operations

Function Documentation

MPStatus MGPlusGetWorldTransform	(	HGRAPHICS	graphics,
		MPMatrix *	matrix
	)

Get the world transform of graphic.

This function sets the world transform of graphic, supported by mGPlus V1.2.1 or upper.

Parameters

graphics	The MGPlusGraphics pointer.
matrix	The MPMatrix pointer.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform

MPStatus MGPlusPathTransform

(

HPATH

path

)

Transform the path using its matrix.

This function transforms the path using its matrix.

Parameters

path	The matrix path.

Returns

if success return TRUE, else return FALSE.

MPStatus MGPlusResetWorldTransform

(

HGRAPHICS

graphics

)

Reset the world transform of graphic.

This function resets the world transform of graphic

Parameters

graphics

The MGPlusGraphics pointer.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform

MPStatus MGPlusRotateWorldTransform	(	HGRAPHICS	graphics,
		float	angle
	)

Rotate the world transform of graphic.

This function rotates the world transform of graphic.

Parameters

graphics	The MGPlusGraphics pointer.
angle	The rotation angle.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform

MPStatus MGPlusScaleWorldTransform	(	HGRAPHICS	graphics,
		float	sx,
		float	sy
	)

Scale the world transform of graphic.

This function scales the world transform of graphic

Parameters

graphics	The MGPlusGraphics pointer.
sx	the x scaling factor.
sy	the y scaling factor.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform

MPStatus MGPlusSetWorldTransform	(	HGRAPHICS	graphics,
		MPMatrix *	matrix
	)

Set the world transform of graphic.

This function sets the world transform of graphic

Parameters

graphics	The MGPlusGraphics pointer.
matrix	The MPMatrix pointer.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform

MPStatus MGPlusTranslateWorldTransform	(	HGRAPHICS	graphics,
		float	dx,
		float	dy
	)

Translate the world transform of graphic.

This function translates the world transform of graphic

Parameters

graphics	The MGPlusGraphics pointer.
dx	The translate x distance.
dy	The translate y distance.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform

MPStatus MGPlusWorldTransform	(	HGRAPHICS	graphics,
		MPMatrix *	matrix
	)

Multi the special matrix with matrix of graphic.

This function sets the world transform of graphic, supported by mGPlus V1.2.1 or upper.

Parameters

graphics	The MGPlusGraphics pointer.
matrix	The MPMatrix pointer.

Returns

Get Status, MP_GENERIC_ERROR indicates an error.

See also

MGPlusSetWorldTransform