#include <CUSpriteNode.h>

Inheritance diagram for cugl::scene2::SpriteNode:

Public Member Functions
	SpriteNode ()

	~SpriteNode ()

bool	initWithSheet (const std::shared_ptr< graphics::Texture > &texture, int rows, int cols)

bool	initWithSheet (const std::shared_ptr< graphics::Texture > &texture, int rows, int cols, int size)

bool	initWithSprite (const std::shared_ptr< SpriteNode > &sprite)

virtual bool	initWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data) override

virtual std::shared_ptr< SceneNode >	copy (const std::shared_ptr< SceneNode > &dst) const override

int	getCount () const

unsigned int	getFrame () const

void	setFrame (int frame)

Public Member Functions inherited from cugl::scene2::PolygonNode
	PolygonNode ()

	~PolygonNode ()

bool	initWithPoly (const std::vector< Vec2 > &vertices)

bool	initWithPoly (const Poly2 &poly)

bool	initWithPoly (const Rect rect)

virtual bool	initWithFile (const std::string filename) override

bool	initWithFilePoly (const std::string filename, const std::vector< Vec2 > &vertices)

bool	initWithFilePoly (const std::string filename, const Poly2 &poly)

bool	initWithFilePoly (const std::string filename, const Rect rect)

virtual bool	initWithTexture (const std::shared_ptr< graphics::Texture > &texture) override

bool	initWithTexturePoly (const std::shared_ptr< graphics::Texture > &texture, const std::vector< Vec2 > &vertices)

bool	initWithTexturePoly (const std::shared_ptr< graphics::Texture > &texture, const Poly2 &poly)

bool	initWithTexturePoly (const std::shared_ptr< graphics::Texture > &texture, const Rect rect)

virtual bool	initWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data) override

virtual std::shared_ptr< SceneNode >	copy (const std::shared_ptr< SceneNode > &dst) const override

float	getFringe () const

void	setFringe (float fringe)

virtual void	setPolygon (const std::vector< Vec2 > &vertices)

virtual void	setPolygon (const Poly2 &poly)

virtual void	setPolygon (const Rect rect)

const Poly2 &	getPolygon () const

const Rect	getBoundingRect () const

virtual void	draw (const std::shared_ptr< graphics::SpriteBatch > &batch, const Affine2 &transform, Color4 tint) override

Public Member Functions inherited from cugl::scene2::TexturedNode
	TexturedNode ()

	~TexturedNode ()

virtual void	dispose () override

virtual bool	init () override

virtual bool	initWithFile (const std::string filename)

virtual bool	initWithTexture (const std::shared_ptr< graphics::Texture > &texture)

virtual bool	initWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data) override

virtual std::shared_ptr< SceneNode >	copy (const std::shared_ptr< SceneNode > &dst) const override

void	setTexture (const std::string &filename)

void	setTexture (const std::shared_ptr< graphics::Texture > &texture)

std::shared_ptr< graphics::Texture >	getTexture ()

const std::shared_ptr< graphics::Texture >	getTexture () const

const std::shared_ptr< graphics::Gradient >	getGradient () const

void	setGradient (const std::shared_ptr< graphics::Gradient > &gradient)

void	shiftTexture (float dx, float dy)

void	setBlendFunc (GLenum srcFactor, GLenum dstFactor)

GLenum	getSourceBlendFactor () const

GLenum	getDestinationBlendFactor () const

void	setBlendEquation (GLenum equation)

GLenum	getBlendEquation () const

void	flipHorizontal (bool flag)

bool	isFlipHorizontal () const

void	flipVertical (bool flag)

bool	isFlipVertical () const

virtual std::string	toString (bool verbose=false) const override

bool	isAbsolute () const

void	setAbsolute (bool flag)

virtual void	setAnchor (const Vec2 anchor) override

virtual void	setAnchor (float x, float y) override

virtual void	setContentSize (const Size size) override

virtual void	setContentSize (float width, float height) override

virtual void	draw (const std::shared_ptr< graphics::SpriteBatch > &batch, const Affine2 &transform, Color4 tint) override=0

void	refresh ()

Public Member Functions inherited from cugl::scene2::SceneNode
	SceneNode ()

	~SceneNode ()

virtual void	dispose ()

virtual bool	init ()

virtual bool	initWithPosition (const Vec2 pos)

bool	initWithPosition (float x, float y)

virtual bool	initWithBounds (const Size size)

virtual bool	initWithBounds (float width, float height)

virtual bool	initWithBounds (const Rect rect)

virtual bool	initWithBounds (float x, float y, float width, float height)

virtual bool	initWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data)

virtual std::shared_ptr< SceneNode >	copy (const std::shared_ptr< SceneNode > &dst) const

unsigned int	getTag () const

void	setTag (unsigned int tag)

const std::string	getName () const

void	setName (const std::string name)

const std::string	getClassName () const

virtual std::string	toString (bool verbose=false) const

	operator std::string () const

const std::shared_ptr< cugl::JsonValue > &	getJSON () const

const Vec2	getPosition () const

void	setPosition (const Vec2 &position)

void	setPosition (float x, float y)

float	getPositionX (void) const

void	setPositionX (float x)

float	getPositionY (void) const

void	setPositionY (float y)

Vec2	getWorldPosition () const

const Size	getContentSize () const

virtual void	setContentSize (const Size size)

virtual void	setContentSize (float width, float height)

float	getContentWidth () const

void	setContentWidth (float width)

float	getContentHeight () const

void	setContentHeight (float height)

virtual Rect	getLayoutBounds () const

Size	getSize () const

float	getWidth () const

float	getHeight () const

Rect	getBoundingBox () const

virtual bool	inContentBounds (const Vec2 point)

bool	inContentBounds (float x, float y)

virtual void	setAnchor (const Vec2 anchor)

virtual void	setAnchor (float x, float y)

const Vec2	getAnchor () const

Vec2	getAnchorInPixels ()

Color4	getColor () const

virtual void	setColor (Color4 color)

Color4	getAbsoluteColor ()

bool	isVisible () const

void	setVisible (bool visible)

bool	hasRelativeColor () const

void	setRelativeColor (bool flag)

std::shared_ptr< graphics::Scissor >	getScissor () const

void	setScissor (const std::shared_ptr< graphics::Scissor > &scissor)

void	setScissor ()

const Vec2	getScale () const

float	getScaleX () const

float	getScaleY () const

void	setScale (float scale)

void	setScale (const Vec2 vec)

void	setScale (float sx, float sy)

float	getAngle ()

void	setAngle (float angle)

const Affine2 &	getTransform () const

const Affine2 &	getAlternateTransform () const

void	setAlternateTransform (const Affine2 &transform)

bool	withAlternateTransform ()

void	chooseAlternateTransform (bool active)

const Affine2 &	getNodeToParentTransform () const

Affine2	getParentToNodeTransform () const

virtual Affine2	getNodeToWorldTransform () const

Affine2	getWorldToNodeTransform () const

Vec2	screenToNodeCoords (const Vec2 screenPoint) const

Vec2	worldToNodeCoords (const Vec2 worldPoint) const

Vec2	nodeToScreenCoords (const Vec2 nodePoint) const

Vec2	nodeToWorldCoords (const Vec2 nodePoint) const

Vec2	parentToNodeCoords (const Vec2 parentPoint) const

Vec2	nodeToParentCoords (const Vec2 nodePoint) const

size_t	getChildCount () const

std::shared_ptr< SceneNode >	getChild (unsigned int pos)

const std::shared_ptr< SceneNode > &	getChild (unsigned int pos) const

template<typename T >
std::shared_ptr< T >	getChild (unsigned int pos) const

std::shared_ptr< SceneNode >	getChildByTag (unsigned int tag) const

template<typename T >
std::shared_ptr< T >	getChildByTag (unsigned int tag) const

std::shared_ptr< SceneNode >	getChildByName (const std::string name) const

template<typename T >
std::shared_ptr< T >	getChildByName (const std::string name) const

std::vector< std::shared_ptr< SceneNode > >	getChildren ()

const std::vector< std::shared_ptr< SceneNode > > &	getChildren () const

void	addChild (const std::shared_ptr< SceneNode > &child)

void	addChildWithTag (const std::shared_ptr< SceneNode > &child, unsigned int tag)

void	addChildWithName (const std::shared_ptr< SceneNode > &child, const std::string name)

void	swapChild (const std::shared_ptr< SceneNode > &child1, const std::shared_ptr< SceneNode > &child2, bool inherit=false)

SceneNode *	getParent ()

const SceneNode *	getParent () const

Scene2 *	getScene ()

const Scene2 *	getScene () const

void	removeFromParent ()

virtual void	removeChild (unsigned int pos)

void	removeChild (const std::shared_ptr< SceneNode > &child)

void	removeChildByTag (unsigned int tag)

void	removeChildByName (const std::string name)

virtual void	removeAllChildren ()

void	setPriority (float priority)

float	getPriority ()

virtual void	render (const std::shared_ptr< graphics::SpriteBatch > &batch, const Affine2 &transform, Color4 tint)

virtual void	render (const std::shared_ptr< graphics::SpriteBatch > &batch)

virtual void	draw (const std::shared_ptr< graphics::SpriteBatch > &batch, const Affine2 &transform, Color4 tint)

const std::shared_ptr< Layout > &	getLayout () const

void	setLayout (const std::shared_ptr< Layout > &layout)

virtual void	doLayout ()

Static Public Member Functions
static std::shared_ptr< SpriteNode >	allocWithSheet (const std::shared_ptr< graphics::Texture > &texture, int rows, int cols)

static std::shared_ptr< SpriteNode >	allocWithSheet (const std::shared_ptr< graphics::Texture > &texture, int rows, int cols, int size)

static std::shared_ptr< SpriteNode >	allocWithSprite (const std::shared_ptr< SpriteNode > &sprite)

static std::shared_ptr< SceneNode >	allocWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data)

Static Public Member Functions inherited from cugl::scene2::PolygonNode
static std::shared_ptr< PolygonNode >	alloc ()

static std::shared_ptr< PolygonNode >	allocWithPoly (const std::vector< Vec2 > &vertices)

static std::shared_ptr< PolygonNode >	allocWithPoly (const Poly2 &poly)

static std::shared_ptr< PolygonNode >	allocWithPoly (const Rect rect)

static std::shared_ptr< PolygonNode >	allocWithFile (const std::string filename)

static std::shared_ptr< PolygonNode >	allocWithFilePoly (const std::string filename, const std::vector< Vec2 > &vertices)

static std::shared_ptr< PolygonNode >	allocWithFilePoly (const std::string filename, const Poly2 &poly)

static std::shared_ptr< PolygonNode >	allocWithFilePoly (const std::string filename, const Rect rect)

static std::shared_ptr< PolygonNode >	allocWithTexture (const std::shared_ptr< graphics::Texture > &texture)

static std::shared_ptr< PolygonNode >	allocWithTexture (const std::shared_ptr< graphics::Texture > &texture, const std::vector< Vec2 > &vertices)

static std::shared_ptr< PolygonNode >	allocWithTexture (const std::shared_ptr< graphics::Texture > &texture, const Poly2 &poly)

static std::shared_ptr< PolygonNode >	allocWithTexture (const std::shared_ptr< graphics::Texture > &texture, const Rect rect)

static std::shared_ptr< SceneNode >	allocWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data)

Static Public Member Functions inherited from cugl::scene2::SceneNode
static std::shared_ptr< SceneNode >	alloc ()

static std::shared_ptr< SceneNode >	allocWithPosition (const Vec2 pos)

static std::shared_ptr< SceneNode >	allocWithPosition (float x, float y)

static std::shared_ptr< SceneNode >	allocWithBounds (const Size size)

static std::shared_ptr< SceneNode >	allocWithBounds (float width, float height)

static std::shared_ptr< SceneNode >	allocWithBounds (const Rect rect)

static std::shared_ptr< SceneNode >	allocWithBounds (float x, float y, float width, float height)

static std::shared_ptr< SceneNode >	allocWithData (const AssetManager *manager, const std::shared_ptr< JsonValue > &data)

Protected Attributes
int	_cols

int	_rows

int	_limit

int	_frame

Rect	_bounds

Protected Attributes inherited from cugl::scene2::PolygonNode
Poly2	_polygon

float	_fringe

Protected Attributes inherited from cugl::scene2::TexturedNode
std::shared_ptr< graphics::Texture >	_texture

std::shared_ptr< graphics::Gradient >	_gradient

bool	_absolute

Vec2	_offset

bool	_rendered

graphics::Mesh< graphics::SpriteVertex >	_mesh

GLenum	_blendEquation

GLenum	_srcFactor

GLenum	_dstFactor

bool	_flipHorizontal

bool	_flipVertical

Protected Attributes inherited from cugl::scene2::SceneNode
Vec2	_position

Vec2	_anchor

Size	_contentSize

Color4	_tintColor

bool	_hasParentColor

bool	_isVisible

std::shared_ptr< graphics::Scissor >	_scissor

Vec2	_scale

float	_angle

Affine2	_transform

bool	_useTransform

Affine2	_combined

std::vector< std::shared_ptr< SceneNode > >	_children

SceneNode *	_parent

Scene2 *	_graph

std::shared_ptr< Layout >	_layout

int	_childOffset

unsigned int	_tag

std::string	_name

size_t	_hashOfName

std::string	_classname

float	_priority

std::shared_ptr< JsonValue >	_json

Additional Inherited Members
Protected Member Functions inherited from cugl::scene2::TexturedNode
virtual void	generateRenderData ()=0

virtual void	updateTextureCoords ()=0

virtual void	clearRenderData ()

	CU_DISALLOW_COPY_AND_ASSIGN (TexturedNode)

Detailed Description

This is a scene graph node to support simple sprite sheet animation

The API for this class is very similar to PolygonNode, except that it treats the texture as a sprite sheet. This means that you must specify the rows and columns in the sprite sheet so that it can break up the images for you.

The basic constructors always set this object equal to a rectangle the same size as a single frame in the sprite sheet. However, you could conceivably animate the sprite sheet over polygons, simpy by changing the shape via setPolygon. This can have undesirable effects if the polygon coordinate extend beyond a single animation frame. The basic renderer does not allow us to wrap a single frame of a texture atlas.

For example, suppose you have a sprite sheet where each frame has a given width and height. Setting the polygon to a triangle with vertices (0,0), (width/2, height), and (width,height) is okay. However, the vertices (0,0), (width, 2*height), and (2*width, height) are not okay.

Constructor & Destructor Documentation

◆ SpriteNode()

cugl::scene2::SpriteNode::SpriteNode ( )

Constructs a sprite node with no texture.

You must initialize this object before use.

NEVER USE A CONSTRUCTOR WITH NEW. If you want to allocate an object on the heap, use one of the static constructors instead.

◆ ~SpriteNode()

cugl::scene2::SpriteNode::~SpriteNode ( )

inline

Releases all resources allocated with this node.

This will release, but not necessarily delete, the associated texture. However, the polygon and drawing commands will be deleted and no longer safe to use.

Member Function Documentation

◆ allocWithData()

static std::shared_ptr< SceneNode > cugl::scene2::SpriteNode::allocWithData	(	const AssetManager *	manager,
		const std::shared_ptr< JsonValue > &	data
	)

inlinestatic

Returns a newly allocated node with the given JSON specificaton.

This initializer is designed to receive the "data" object from the JSON passed to Scene2Loader. This JSON format supports all of the attribute values of its parent class. In addition, it supports the following additional attributes:

 "span":     The number of frames in the filmstrip
 "cols":     An int specifying the number of columns
 "frame":    The initial starting frame.

All attributes are optional. However, if nothing is specified, it assumes that this is a degenerate filmstrip with just one frame. If only span is specified, it assumes that it is just one row.

Parameters

manager	The asset manager handling this asset
data	The JSON object specifying the node

Returns: a newly allocated node with the given JSON specificaton.

◆ allocWithSheet() [1/2]

static std::shared_ptr< SpriteNode > cugl::scene2::SpriteNode::allocWithSheet	(	const std::shared_ptr< graphics::Texture > &	texture,
		int	rows,
		int	cols
	)

inlinestatic

Returns a newly allocated sprite node node from the given texture.

This constructor assumes that the sprite sheet is rectangular, and that there are no unused frames.

The size of the node is equal to the size of a single frame in the sprite sheet. To resize the node, scale it up or down. Do NOT change the polygon, as that will interfere with the animation.

Parameters

texture	The texture image to use
rows	The number of rows in the filmstrip
cols	The number of columns in the filmstrip

Returns: a newly allocated filmstrip node from the given texture.

◆ allocWithSheet() [2/2]

static std::shared_ptr< SpriteNode > cugl::scene2::SpriteNode::allocWithSheet	(	const std::shared_ptr< graphics::Texture > &	texture,
		int	rows,
		int	cols,
		int	size
	)

inlinestatic

Returns a newly allocated sprite node node from the given texture.

The parameter size is to indicate that there are unused frames in the sprite sheet. The value size must be less than or equal to rows*cols, or this constructor will raise an error.

The size of the node is equal to the size of a single frame in the sprite sheet. To resize the node, scale it up or down. Do NOT change the polygon, as that will interfere with the animation.

Parameters

texture	The texture image to use
rows	The number of rows in the filmstrip
cols	The number of columns in the filmstrip
size	The number of frames in the filmstrip

Returns: a newly allocated filmstrip node from the given texture.

◆ allocWithSprite()

static std::shared_ptr< SpriteNode > cugl::scene2::SpriteNode::allocWithSprite ( const std::shared_ptr< SpriteNode > & sprite )

inlinestatic

Returns a newly allocated sprite node as a copy of the given one.

Parameters

sprite The sprite to copy

Returns: a newly allocated sprite node node from the given texture.

◆ copy()

virtual std::shared_ptr< SceneNode > cugl::scene2::SpriteNode::copy ( const std::shared_ptr< SceneNode > & dst ) const

overridevirtual

Performs a shallow copy of this node into dst.

No children from this node are copied, and no children of dst are modified. In addition, the parents of both Nodes are unchanged. However, all other attributes of this node are copied.

Parameters

dst	The node to copy into

Returns: A reference to dst for chaining.

Reimplemented from cugl::scene2::PolygonNode.

◆ getCount()

int cugl::scene2::SpriteNode::getCount ( ) const

inline

Returns the number of frames in this filmstrip.

Returns: the number of frames in this filmstrip.

◆ getFrame()

unsigned int cugl::scene2::SpriteNode::getFrame ( ) const

inline

Returns the current active frame.

Returns: the current active frame.

◆ initWithData()

virtual bool cugl::scene2::SpriteNode::initWithData	(	const AssetManager *	manager,
		const std::shared_ptr< JsonValue > &	data
	)

overridevirtual

Initializes a node with the given JSON specificaton.

This initializer is designed to receive the "data" object from the JSON passed to Scene2Loader. This JSON format supports all of the attribute values of its parent class. In addition, it supports the following additional attributes:

 "span":     The number of frames in the filmstrip
 "cols":     An int specifying the number of columns
 "frame":    The initial starting frame.

All attributes are optional. However, if nothing is specified, it assumes that this is a degenerate filmstrip with just one frame. If only span is specified, it assumes that it is just one row.

Parameters

manager	The asset manager handling this asset
data	The JSON object specifying the node

Returns: true if initialization was successful.

Reimplemented from cugl::scene2::PolygonNode.

◆ initWithSheet() [1/2]

bool cugl::scene2::SpriteNode::initWithSheet	(	const std::shared_ptr< graphics::Texture > &	texture,
		int	rows,
		int	cols
	)

inline

Initializes the sprite node with the given texture.

This initializer assumes that the sprite node is rectangular, and that there are no unused frames.

The size of the node is equal to the size of a single frame in the sprite sheet. To resize the node, scale it up or down. Do NOT change the polygon, as that will interfere with the animation.

Parameters

texture	The texture image to use
rows	The number of rows in the filmstrip
cols	The number of columns in the filmstrip

Returns: true if the node is initialized properly, false otherwise.

◆ initWithSheet() [2/2]

bool cugl::scene2::SpriteNode::initWithSheet	(	const std::shared_ptr< graphics::Texture > &	texture,
		int	rows,
		int	cols,
		int	size
	)

Initializes the sprite node with the given texture.

The parameter size is to indicate that there are unused frames in the filmstrip. The value size must be less than or equal to rows*cols, or this constructor will raise an error.

The size of the node is equal to the size of a single frame in the sprite sheet. To resize the node, scale it up or down. Do NOT change the polygon, as that will interfere with the animation.

Parameters

texture	The texture image to use
rows	The number of rows in the filmstrip
cols	The number of columns in the filmstrip
size	The number of frames in the filmstrip

Returns: true if the node is initialized properly, false otherwise.

◆ initWithSprite()

bool cugl::scene2::SpriteNode::initWithSprite ( const std::shared_ptr< SpriteNode > & sprite )

Initializes the sprite node as a copy of the given one.

Parameters

sprite The sprite node to copy

Returns: true if the node is initialized properly, false otherwise.

◆ setFrame()

void cugl::scene2::SpriteNode::setFrame ( int frame )

Sets the active frame as the given index.

If the frame index is invalid, an error is raised.

Parameters

frame the index to make the active frame

Member Data Documentation

◆ _bounds

Rect cugl::scene2::SpriteNode::_bounds

protected

The size of a single animation frame (different from active polygon)

◆ _cols

int cugl::scene2::SpriteNode::_cols

protected

The number of columns in this sprite sheet

◆ _frame

int cugl::scene2::SpriteNode::_frame

protected

The active animation frame

◆ _limit

int cugl::scene2::SpriteNode::_limit

protected

The number of frames in this filmstrip

◆ _rows

int cugl::scene2::SpriteNode::_rows

protected

The number of rows in this sprite sheet

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

/Users/wmwhite/Developer/CUGL/include/cugl/scene2/CUSpriteNode.h

Public Member Functions

Static Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SpriteNode()

◆ ~SpriteNode()

Member Function Documentation

◆ allocWithData()

◆ allocWithSheet() [1/2]

◆ allocWithSheet() [2/2]

◆ allocWithSprite()

◆ copy()

◆ getCount()

◆ getFrame()

◆ initWithData()

◆ initWithSheet() [1/2]

◆ initWithSheet() [2/2]

◆ initWithSprite()

◆ setFrame()

Member Data Documentation

◆ _bounds

◆ _cols

◆ _frame

◆ _limit

◆ _rows