CSFML - C binding of the Simple and Fast Multimedia Library

#include <SFML/Graphics/Export.h>
#include <SFML/Graphics/Types.h>
#include <SFML/Graphics/Transform.h>
#include <SFML/System/Vector2.h>

Go to the source code of this file.

Functions
CSFML_GRAPHICS_API sfTransformable *	sfTransformable_create (void)
	Create a new transformable.

CSFML_GRAPHICS_API sfTransformable *	sfTransformable_copy (const sfTransformable *transformable)
	Copy an existing transformable.

CSFML_GRAPHICS_API void	sfTransformable_destroy (sfTransformable *transformable)
	Destroy an existing transformable.

CSFML_GRAPHICS_API void	sfTransformable_setPosition (sfTransformable *transformable, sfVector2f position)
	Set the position of a transformable.

CSFML_GRAPHICS_API void	sfTransformable_setRotation (sfTransformable *transformable, float angle)
	Set the orientation of a transformable.

CSFML_GRAPHICS_API void	sfTransformable_setScale (sfTransformable *transformable, sfVector2f scale)
	Set the scale factors of a transformable.

CSFML_GRAPHICS_API void	sfTransformable_setOrigin (sfTransformable *transformable, sfVector2f origin)
	Set the local origin of a transformable.

CSFML_GRAPHICS_API sfVector2f	sfTransformable_getPosition (const sfTransformable *transformable)
	Get the position of a transformable.

CSFML_GRAPHICS_API float	sfTransformable_getRotation (const sfTransformable *transformable)
	Get the orientation of a transformable.

CSFML_GRAPHICS_API sfVector2f	sfTransformable_getScale (const sfTransformable *transformable)
	Get the current scale of a transformable.

CSFML_GRAPHICS_API sfVector2f	sfTransformable_getOrigin (const sfTransformable *transformable)
	Get the local origin of a transformable.

CSFML_GRAPHICS_API void	sfTransformable_move (sfTransformable *transformable, sfVector2f offset)
	Move a transformable by a given offset.

CSFML_GRAPHICS_API void	sfTransformable_rotate (sfTransformable *transformable, float angle)
	Rotate a transformable.

CSFML_GRAPHICS_API void	sfTransformable_scale (sfTransformable *transformable, sfVector2f factors)
	Scale a transformable.

CSFML_GRAPHICS_API sfTransform	sfTransformable_getTransform (const sfTransformable *transformable)
	Get the combined transform of a transformable.

CSFML_GRAPHICS_API sfTransform	sfTransformable_getInverseTransform (const sfTransformable *transformable)
	Get the inverse of the combined transform of a transformable.

Function Documentation

CSFML_GRAPHICS_API sfTransformable* sfTransformable_copy ( const sfTransformable * transformable )

Copy an existing transformable.

Parameters

transformable Transformable to copy

Returns: Copied object

CSFML_GRAPHICS_API sfTransformable* sfTransformable_create ( void )

Create a new transformable.

Returns: A new sfTransformable object

CSFML_GRAPHICS_API void sfTransformable_destroy ( sfTransformable * transformable )

Destroy an existing transformable.

Parameters

transformable Transformable to delete

CSFML_GRAPHICS_API sfTransform sfTransformable_getInverseTransform ( const sfTransformable * transformable )

Get the inverse of the combined transform of a transformable.

Parameters

transformable Transformable object

Returns: Inverse of the combined transformations applied to the object

CSFML_GRAPHICS_API sfVector2f sfTransformable_getOrigin ( const sfTransformable * transformable )

Get the local origin of a transformable.

Parameters

transformable Transformable object

Returns: Current origin

CSFML_GRAPHICS_API sfVector2f sfTransformable_getPosition ( const sfTransformable * transformable )

Get the position of a transformable.

Parameters

transformable Transformable object

Returns: Current position

CSFML_GRAPHICS_API float sfTransformable_getRotation ( const sfTransformable * transformable )

Get the orientation of a transformable.

The rotation is always in the range [0, 360].

Parameters

transformable Transformable object

Returns: Current rotation, in degrees

CSFML_GRAPHICS_API sfVector2f sfTransformable_getScale ( const sfTransformable * transformable )

Get the current scale of a transformable.

Parameters

transformable Transformable object

Returns: Current scale factors

CSFML_GRAPHICS_API sfTransform sfTransformable_getTransform ( const sfTransformable * transformable )

Get the combined transform of a transformable.

Parameters

transformable Transformable object

Returns: Transform combining the position/rotation/scale/origin of the object

CSFML_GRAPHICS_API void sfTransformable_move	(	sfTransformable *	transformable,
		sfVector2f	offset
	)

Move a transformable by a given offset.

This function adds to the current position of the object, unlike sfTransformable_setPosition which overwrites it.

Parameters

transformable	Transformable object
offset	Offset

CSFML_GRAPHICS_API void sfTransformable_rotate	(	sfTransformable *	transformable,
		float	angle
	)

Rotate a transformable.

This function adds to the current rotation of the object, unlike sfTransformable_setRotation which overwrites it.

Parameters

transformable	Transformable object
angle	Angle of rotation, in degrees

CSFML_GRAPHICS_API void sfTransformable_scale	(	sfTransformable *	transformable,
		sfVector2f	factors
	)

Scale a transformable.

This function multiplies the current scale of the object, unlike sfTransformable_setScale which overwrites it.

Parameters

transformable	Transformable object
factors	Scale factors

CSFML_GRAPHICS_API void sfTransformable_setOrigin	(	sfTransformable *	transformable,
		sfVector2f	origin
	)

Set the local origin of a transformable.

The origin of an object defines the center point for all transformations (position, scale, rotation). The coordinates of this point must be relative to the top-left corner of the object, and ignore all transformations (position, scale, rotation). The default origin of a transformable Transformable object is (0, 0).

Parameters

transformable	Transformable object
origin	New origin

CSFML_GRAPHICS_API void sfTransformable_setPosition	(	sfTransformable *	transformable,
		sfVector2f	position
	)

Set the position of a transformable.

This function completely overwrites the previous position. See sfTransformable_move to apply an offset based on the previous position instead. The default position of a transformable Transformable object is (0, 0).

Parameters

transformable	Transformable object
position	New position

CSFML_GRAPHICS_API void sfTransformable_setRotation	(	sfTransformable *	transformable,
		float	angle
	)

Set the orientation of a transformable.

This function completely overwrites the previous rotation. See sfTransformable_rotate to add an angle based on the previous rotation instead. The default rotation of a transformable Transformable object is 0.

Parameters

transformable	Transformable object
angle	New rotation, in degrees

CSFML_GRAPHICS_API void sfTransformable_setScale	(	sfTransformable *	transformable,
		sfVector2f	scale
	)

Set the scale factors of a transformable.

This function completely overwrites the previous scale. See sfTransformable_scale to add a factor based on the previous scale instead. The default scale of a transformable Transformable object is (1, 1).

Parameters

transformable	Transformable object
scale	New scale factors