Sprite bank interface. More...

#include <IGUISpriteBank.h>

Inheritance diagram for irr::gui::IGUISpriteBank:

Public Member Functions
virtual core::array< core::rect< s32 > > &	getPositions ()=0
	Returns the list of rectangles held by the sprite bank. More...

virtual core::array< SGUISprite > &	getSprites ()=0
	Returns the array of animated sprites within the sprite bank. More...

virtual u32	getTextureCount () const =0
	Returns the number of textures held by the sprite bank. More...

virtual video::ITexture *	getTexture (u32 index) const =0
	Gets the texture with the specified index. More...

virtual void	addTexture (video::ITexture *texture)=0
	Adds a texture to the sprite bank. More...

virtual void	setTexture (u32 index, video::ITexture *texture)=0
	Changes one of the textures in the sprite bank. More...

virtual s32	addTextureAsSprite (video::ITexture *texture)=0
	Add the texture and use it for a single non-animated sprite. More...

virtual void	clear ()=0
	Clears sprites, rectangles and textures. More...

virtual void	draw2DSprite (u32 index, const core::position2di &pos, const core::rect< s32 > *clip=0, const video::SColor &color=video::SColor(255, 255, 255, 255), u32 starttime=0, u32 currenttime=0, bool loop=true, bool center=false)=0
	Draws a sprite in 2d with position and color. More...

virtual void	draw2DSprite (u32 index, const core::rect< s32 > &destRect, const core::rect< s32 > clip=0, const video::SColor const colors=0, u32 timeTicks=0, bool loop=true)=0
	Draws a sprite in 2d with destination rectangle and colors. More...

virtual void	draw2DSpriteBatch (const core::array< u32 > &indices, const core::array< core::position2di > &pos, const core::rect< s32 > *clip=0, const video::SColor &color=video::SColor(255, 255, 255, 255), u32 starttime=0, u32 currenttime=0, bool loop=true, bool center=false)=0
	Draws a sprite batch in 2d using an array of positions and a color. More...

Public Member Functions inherited from irr::IReferenceCounted
	IReferenceCounted ()
	Constructor. More...

virtual	~IReferenceCounted ()
	Destructor. More...

void	grab () const
	Grabs the object. Increments the reference counter by one. More...

bool	drop () const
	Drops the object. Decrements the reference counter by one. More...

s32	getReferenceCount () const
	Get the reference count. More...

const c8 *	getDebugName () const
	Returns the debug name of the object. More...

Additional Inherited Members
Protected Member Functions inherited from irr::IReferenceCounted
void	setDebugName (const c8 *newName)
	Sets the debug name of the object. More...

Detailed Description

Sprite bank interface.

See http://http://irrlicht.sourceforge.net/forum//viewtopic.php?f=9&t=25742 for more information how to use the spritebank.

Definition at line 63 of file IGUISpriteBank.h.

Member Function Documentation

◆ addTexture()

virtual void irr::gui::IGUISpriteBank::addTexture ( video::ITexture * texture )

pure virtual

Adds a texture to the sprite bank.

◆ addTextureAsSprite()

virtual s32 irr::gui::IGUISpriteBank::addTextureAsSprite ( video::ITexture * texture )

pure virtual

Add the texture and use it for a single non-animated sprite.

The texture and the corresponding rectangle and sprite will all be added to the end of each array.

Returns: The index of the sprite or -1 on failure

◆ clear()

virtual void irr::gui::IGUISpriteBank::clear ( )

pure virtual

Clears sprites, rectangles and textures.

◆ draw2DSprite() [1/2]

virtual void irr::gui::IGUISpriteBank::draw2DSprite	(	u32	index,
		const core::position2di &	pos,
		const core::rect< s32 > *	clip = `0`,
		const video::SColor &	color = `video::SColor(255, 255, 255, 255)`,
		u32	starttime = `0`,
		u32	currenttime = `0`,
		bool	loop = `true`,
		bool	center = `false`
	)

pure virtual

Draws a sprite in 2d with position and color.

Parameters

index	Index of SGUISprite to draw
pos	Target position - depending on center value either the left-top or the sprite center is used as pivot
clip	Clipping rectangle, can be 0 when clipping is not wanted.
color	Color with which the image is drawn. Note that the alpha component is used. If alpha is other than 255, the image will be transparent.
starttime	Tick when the first frame was drawn (only difference currenttime-starttime matters).
currenttime	To calculate the frame of animated sprites
loop	When true animations are looped
center	When true pivot is set to the sprite-center. So it affects pos.

◆ draw2DSprite() [2/2]

virtual void irr::gui::IGUISpriteBank::draw2DSprite	(	u32	index,
		const core::rect< s32 > &	destRect,
		const core::rect< s32 > *	clip = `0`,
		const video::SColor *const	colors = `0`,
		u32	timeTicks = `0`,
		bool	loop = `true`
	)

pure virtual

Draws a sprite in 2d with destination rectangle and colors.

Parameters

index	Index of SGUISprite to draw
destRect	The sprite will be scaled to fit this target rectangle
clip	Clipping rectangle, can be 0 when clipping is not wanted.
colors	Array of 4 colors denoting the color values of the corners of the destRect
timeTicks	Current frame for animated sprites (same as currenttime-starttime in other draw2DSprite function)
loop	When true animations are looped

◆ draw2DSpriteBatch()

virtual void irr::gui::IGUISpriteBank::draw2DSpriteBatch	(	const core::array< u32 > &	indices,
		const core::array< core::position2di > &	pos,
		const core::rect< s32 > *	clip = `0`,
		const video::SColor &	color = `video::SColor(255, 255, 255, 255)`,
		u32	starttime = `0`,
		u32	currenttime = `0`,
		bool	loop = `true`,
		bool	center = `false`
	)

pure virtual

Draws a sprite batch in 2d using an array of positions and a color.

◆ getPositions()

virtual core::array< core::rect<s32> >& irr::gui::IGUISpriteBank::getPositions ( )

pure virtual

Returns the list of rectangles held by the sprite bank.

◆ getSprites()

virtual core::array< SGUISprite >& irr::gui::IGUISpriteBank::getSprites ( )

pure virtual

Returns the array of animated sprites within the sprite bank.

◆ getTexture()

virtual video::ITexture* irr::gui::IGUISpriteBank::getTexture ( u32 index ) const

pure virtual

Gets the texture with the specified index.

◆ getTextureCount()

virtual u32 irr::gui::IGUISpriteBank::getTextureCount ( ) const

pure virtual

Returns the number of textures held by the sprite bank.

◆ setTexture()

virtual void irr::gui::IGUISpriteBank::setTexture	(	u32	index,
		video::ITexture *	texture
	)

pure virtual

Changes one of the textures in the sprite bank.

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

include/irrlicht/IGUISpriteBank.h

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addTexture()

◆ addTextureAsSprite()

◆ clear()

◆ draw2DSprite() [1/2]

◆ draw2DSprite() [2/2]

◆ draw2DSpriteBatch()

◆ getPositions()

◆ getSprites()

◆ getTexture()

◆ getTextureCount()

◆ setTexture()