TGUI  0.10-beta
tgui::Sprite Class Reference

Public Types

enum class  ScalingType { Normal , Horizontal , Vertical , NineSlice }
 The way the image should be scaled. More...
 

Public Member Functions

 Sprite ()=default
 Default constructor.
 
 Sprite (const Texture &texture)
 Constructor that immediately sets the texture. More...
 
 Sprite (const Sprite &)
 Copy constructor.
 
 Sprite (Sprite &&) noexcept
 Move constructor.
 
Spriteoperator= (const Sprite &)
 Overload of copy assignment operator.
 
Spriteoperator= (Sprite &&) noexcept
 Move assignment.
 
void setTexture (const Texture &texture)
 Changes the texture. More...
 
const TexturegetTexture () const
 Returns the texture used by this sprite. More...
 
bool isSet () const
 Returns whether a texture was set. More...
 
void setSize (const Vector2f &size)
 Changes the size that the image will have when drawing. More...
 
Vector2f getSize () const
 Returns the size that the image has when drawing. More...
 
void setOpacity (float opacity)
 Changes the opacity of the texture. More...
 
float getOpacity () const
 Returns the opacity of the texture. More...
 
void setVisibleRect (const FloatRect &visibleRect)
 Changes the part of the sprite that should be drawn. More...
 
FloatRect getVisibleRect () const
 Returns the part of the sprite that is drawn. More...
 
void setPosition (Vector2f position)
 Sets the position of the sprite. More...
 
Vector2f getPosition () const
 Gets the position of the sprite. More...
 
void setRotation (float angle)
 Sets rotation of the sprite. More...
 
float getRotation () const
 Gets rotation of the sprite. More...
 
bool isTransparentPixel (Vector2f pos) const
 Checks if a certain pixel is transparent. More...
 
ScalingType getScalingType () const
 Returns the way in which the image is being scaled. More...
 
const std::shared_ptr< BackendTexture > & getSvgTexture () const
 
const std::vector< Vertex > & getVertices () const
 
const std::vector< int > & getIndices () const
 

Member Enumeration Documentation

◆ ScalingType

enum class tgui::Sprite::ScalingType
strong

The way the image should be scaled.

Enumerator
Normal 

The image is not split and scaled normally.

Horizontal 

Image is split in Left, Middle and Right parts. Left and Right keep ratio, Middle gets stretched.

Vertical 

Image is split in Top, Middle and Bottom parts. Top and Bottom keep ratio, Middle gets stretched.

NineSlice 

Image is split in 9 parts. Corners keep size, sides are stretched in one direction, middle is stretched in both directions.

Constructor & Destructor Documentation

◆ Sprite()

tgui::Sprite::Sprite ( const Texture texture)

Constructor that immediately sets the texture.

Parameters
textureTexture to use in the sprite

Member Function Documentation

◆ getOpacity()

float tgui::Sprite::getOpacity ( ) const

Returns the opacity of the texture.

Returns
The opacity of the texture. 0 means completely transparent, while 1 (default) means fully opaque

◆ getPosition()

Vector2f tgui::Sprite::getPosition ( ) const

Gets the position of the sprite.

Returns
Sprite position

◆ getRotation()

float tgui::Sprite::getRotation ( ) const

Gets rotation of the sprite.

Returns
Degrees rotated counterclockwise

◆ getScalingType()

ScalingType tgui::Sprite::getScalingType ( ) const

Returns the way in which the image is being scaled.

Returns
Scaling type

◆ getSize()

Vector2f tgui::Sprite::getSize ( ) const

Returns the size that the image has when drawing.

Returns
Size of the sprite

◆ getTexture()

const Texture & tgui::Sprite::getTexture ( ) const

Returns the texture used by this sprite.

Returns
Texture of the sprite

◆ getVisibleRect()

FloatRect tgui::Sprite::getVisibleRect ( ) const

Returns the part of the sprite that is drawn.

Returns
Visible part of the sprite

◆ isSet()

bool tgui::Sprite::isSet ( ) const

Returns whether a texture was set.

Returns
Has a valid texture been assigned to this sprite?

◆ isTransparentPixel()

bool tgui::Sprite::isTransparentPixel ( Vector2f  pos) const

Checks if a certain pixel is transparent.

Parameters
posCoordinate of the pixel
Returns
True when the pixel is transparent, false when it is not

◆ setOpacity()

void tgui::Sprite::setOpacity ( float  opacity)

Changes the opacity of the texture.

Parameters
opacityThe opacity of the texture. 0 means completely transparent, while 1 (default) means fully opaque

The alpha component of the color specified with setColor is multiplied with this factor.

◆ setPosition()

void tgui::Sprite::setPosition ( Vector2f  position)

Sets the position of the sprite.

Parameters
positionNew sprite position

◆ setRotation()

void tgui::Sprite::setRotation ( float  angle)

Sets rotation of the sprite.

Parameters
angleDegrees to rotate counterclockwise

Rotation can currently only be a multiple of 90 degrees.

◆ setSize()

void tgui::Sprite::setSize ( const Vector2f size)

Changes the size that the image will have when drawing.

Parameters
sizeSize of the sprite

◆ setTexture()

void tgui::Sprite::setTexture ( const Texture texture)

Changes the texture.

Parameters
textureNew texture

◆ setVisibleRect()

void tgui::Sprite::setVisibleRect ( const FloatRect visibleRect)

Changes the part of the sprite that should be drawn.

Parameters
visibleRectVisible part of the sprite

Set this to (0, 0, 0, 0) to show the entire sprite


The documentation for this class was generated from the following file: