LayerGradient Class Reference

LayerGradient is a subclass of LayerColor that draws gradients across the background. More...

#include <Layer.h>

Inherits LayerColor.

Public Member Functions
void	setCompressedInterpolation (bool compressedInterpolation)
	Whether or not the interpolation will be compressed in order to display all the colors of the gradient both in canonical and non canonical vectors.
bool	isCompressedInterpolation () const
	Get the compressedInterpolation.
void	setStartColor (const Color32 &startColor)
	Sets the start color of the gradient.
const Color32 &	getStartColor () const
	Returns the start color of the gradient.
void	setEndColor (const Color32 &endColor)
	Sets the end color of the gradient.
const Color32 &	getEndColor () const
	Returns the end color of the gradient.
void	setStartOpacity (uint8_t startOpacity)
	Returns the start opacity of the gradient.
uint8_t	getStartOpacity () const
	Returns the start opacity of the gradient.
void	setEndOpacity (uint8_t endOpacity)
	Returns the end opacity of the gradient.
uint8_t	getEndOpacity () const
	Returns the end opacity of the gradient.
void	setVector (const Vec2 &alongVector)
	Sets the directional vector that will be used for the gradient.
const Vec2 &	getVector () const
	Returns the directional vector used for the gradient.
std::string	getDescription () const override
	Gets the description string.
bool	initWithColor (const Color32 &start, const Color32 &end)
	Initializes the Layer with a gradient between start and end.
bool	initWithColor (const Color32 &start, const Color32 &end, const Vec2 &v)
	Initializes the Layer with a gradient between start and end in the direction of v.
Public Member Functions inherited from LayerColor
void	changeWidth (float w)
	Change width in Points.
void	changeHeight (float h)
	Change height in Points.
void	changeWidthAndHeight (float w, float h)
	Change width and height in Points.
Public Member Functions inherited from Sprite
virtual bool	isFrameDisplayed (SpriteFrame *frame) const
	Returns whether or not a SpriteFrame is being displayed.
virtual SpriteFrame *	getSpriteFrame () const
	Returns the current displayed frame.
const V3F_T2F_C4B_Quad &	getQuad () const
	Returns the quad (tex coords, vertex coords and color) information.
bool	isTextureRectRotated () const
	Returns whether or not the texture rectangle is rotated.
unsigned int	getAtlasIndex () const
	Returns the index used on the TextureAtlas.
void	setAtlasIndex (unsigned int atlasIndex)
	Sets the index used on the TextureAtlas.
const Rect &	getTextureRect () const
	Returns the rect of the Sprite in points.
TextureAtlas *	getTextureAtlas () const
	Gets the weak reference of the TextureAtlas when the sprite is rendered using via SpriteBatchNode.
bool	setProgramState (rhi::ProgramState *programState, bool ownPS=false) override
	Set or Attach new ProgramState.
void	setTextureAtlas (TextureAtlas *textureAtlas)
	Sets the weak reference of the TextureAtlas when the sprite is rendered using via SpriteBatchNode.
const Vec2 &	getOffsetPosition () const
	Gets the offset position of the sprite.
bool	isFlippedX () const
	Returns the flag which indicates whether the sprite is flipped horizontally or not.
void	setFlippedX (bool flippedX)
	Sets whether the sprite should be flipped horizontally or not.
bool	isFlippedY () const
	Return the flag which indicates whether the sprite is flipped vertically or not.
void	setFlippedY (bool flippedY)
	Sets whether the sprite should be flipped vertically or not.
const PolygonInfo &	getPolygonInfo () const
	returns a reference of the polygon information associated with this sprite
void	setPolygonInfo (const PolygonInfo &info)
	set the sprite to use this new PolygonInfo
void	setStretchEnabled (bool enabled)
	whether or not contentSize stretches the sprite's texture
bool	isStretchEnabled () const
	returns whether or not contentSize stretches the sprite's texture
virtual bool	initWithTexture (Texture2D *texture)
	Initializes a sprite with a texture.
virtual bool	initWithPolygon (const PolygonInfo &info)
	Initializes a sprite with a PolygonInfo.
virtual bool	initWithTexture (Texture2D *texture, const Rect &rect)
	Initializes a sprite with a texture and a rect.
virtual bool	initWithTexture (Texture2D *texture, const Rect &rect, bool rotated)
	Initializes a sprite with a texture and a rect in points, optionally rotated.
virtual bool	initWithSpriteFrame (SpriteFrame *spriteFrame)
	Initializes a sprite with an SpriteFrame.
virtual bool	initWithSpriteFrameName (std::string_view spriteFrameName)
	Initializes a sprite with an sprite frame name.
virtual bool	initWithFile (std::string_view filename)
	Initializes a sprite with an image filename.
virtual bool	initWithFile (std::string_view filename, const Rect &rect)
	Initializes a sprite with an image filename, and a rect.
virtual bool	initWithImageData (const ax::Data &imageData, std::string_view key)
	Initializes a sprite with an image data, and a key for the cache.
void	setAutoSize (bool enabled)
	Indicate if the sprite content size can change if new textures are applied to the sprite.
void	updateTransform () override
	Updates the quad according the rotation, position, scale values.
virtual SpriteBatchNode *	getBatchNode () const
	Returns the batch node object if this sprite is rendered by SpriteBatchNode.
virtual void	setBatchNode (SpriteBatchNode *spriteBatchNode)
	Sets the batch node to sprite.
virtual void	setTexture (std::string_view filename)
	Sets a new texture (from a filename) to the sprite.
void	setTexture (Texture2D *texture) override
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The Texture's rect is not changed.
Texture2D *	getTexture () const override
	Returns the Texture2D object used by the sprite.
virtual void	setTextureRect (const Rect &rect)
	Updates the texture rect of the Sprite in points.
virtual void	setTextureRect (const Rect &rect, bool rotated, const Vec2 &untrimmedSize)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.It will update the texture coordinates and the vertex rectangle.
virtual void	setVertexRect (const Rect &rect)
	Sets the vertex rect.
virtual void	setCenterRectNormalized (const Rect &rect)
	setCenterRectNormalized
virtual Rect	getCenterRectNormalized () const
	getCenterRectNormalized
virtual Rect	getCenterRect () const
	Returns the Cap Insets rect.
virtual void	setSpriteFrame (std::string_view spriteFrameName)
virtual void	setDisplayFrameWithAnimationName (std::string_view animationName, unsigned int frameIndex)
	Changes the display frame with animation name and index.
virtual bool	isDirty () const
	Whether or not the Sprite needs to be updated in the Atlas.
virtual void	setDirty (bool dirty)
	Makes the Sprite to be updated in the Atlas.
std::string	getDescription () const override
	Gets the description string.
void	setScaleX (float scaleX) override
	Sets the scale (x) of the node.
void	setScaleY (float scaleY) override
	Sets the scale (y) of the node.
void	setScale (float scaleX, float scaleY) override
	Sets the scale (x,y) of the node.
void	setPosition (const Vec2 &pos) override
	@lua NA
void	setPosition (float x, float y) override
	Sets the position (x,y) of the node in its parent's coordinate system.
void	setRotation (float rotation) override
	Sets the rotation (angle) of the node in degrees.
void	setRotationSkewX (float rotationX) override
	Sets the X rotation (angle) of the node in degrees which performs a horizontal rotational skew.
void	setRotationSkewY (float rotationY) override
	Sets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew.
void	setSkewX (float sx) override
	Changes the X skew angle of the node in degrees.
void	setSkewY (float sy) override
	Changes the Y skew angle of the node in degrees.
void	removeChild (Node *child, bool cleanup=true) override
	Removes a child from the container.
void	removeAllChildrenWithCleanup (bool cleanup) override
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter.
void	reorderChild (Node *child, int zOrder) override
	Reorders a child according to a new z value.
void	addChild (Node *child, int zOrder, int tag) override
	Adds a child to the container with z order and tag.
void	addChild (Node *child, int zOrder, std::string_view name) override
	Adds a child to the container with z order and tag.
void	sortAllChildren () override
	Sorts the children array once before drawing, instead of every time when a child is added or reordered.
void	setScale (float scale) override
	Sets the scale (x,y,z) of the node.
void	setPositionZ (float positionZ) override
	Sets the 'z' coordinate in the position.
void	setAnchorPoint (const Vec2 &anchor) override
	Sets the anchor point in percent.
void	setContentSize (const Vec2 &size) override
	Sets the untransformed size of the node.
void	setIgnoreAnchorPointForPosition (bool value) override
	Sets whether the anchor point will be (0,0) when you position this node.
void	setVisible (bool bVisible) override
	Sets whether the node is visible.
void	draw (const SceneRenderState &state, const Mat4 &transform, uint32_t flags) override
	Override this method to draw your own node.
void	setOpacityModifyRGB (bool modify) override
	If you want the opacity affect the color property, then set to true.
bool	isOpacityModifyRGB () const override
	If node opacity will modify the RGB color value, then you should override this method and return true.
virtual void	addChild (Node *child)
	Adds a child to the container with z-order as 0.
virtual void	addChild (Node *child, int localZOrder)
	Adds a child to the container with a local z-order.
void	setBlendFunc (const BlendFunc &blendFunc) override
const BlendFunc &	getBlendFunc () const override
	@lua NA
static Sprite *	create ()
	Creates an empty sprite without texture.
Public Member Functions inherited from Node
virtual bool	isRunning () const
	Returns whether or not the node is "running".
virtual void	cleanup ()
	Stops all running actions and schedulers.
virtual void	visit (const SceneRenderState &state, const Mat4 &parentTransform, uint32_t parentFlags)
	Visits this node's children and draw them recursively.
virtual Scene *	getScene () const
	Returns the Scene that contains the Node.
virtual Rect	getBoundingBox () const
	Returns an AABB (axis-aligned bounding-box) in its parent's coordinate system.
virtual Rect	getWorldBoundingBox () const
	Returns an AABB (axis-aligned bounding-box) in its world's coordinate system.
virtual void	setEventDispatcher (EventDispatcher *dispatcher)
	Set event dispatcher for scene.
virtual EventDispatcher *	getEventDispatcher () const
	Get the event dispatcher of scene.
virtual uint8_t	getOpacity () const
	Return the node's opacity.
virtual uint8_t	getDisplayedOpacity () const
	Return the node's display opacity.
virtual void	setOpacity (uint8_t opacity)
	Change node opacity.
virtual void	updateDisplayedOpacity (uint8_t parentOpacity)
	Update the displayed opacity of node with it's parent opacity;.
bool	isCascadeOpacityEnabled () const
	Whether cascadeOpacity is enabled or not.
virtual void	setCascadeOpacityEnabled (bool cascadeOpacityEnabled)
	Change node's cascadeOpacity property.
virtual const Color32 &	getColor () const
	Query node's color value.
virtual const Color32 &	getDisplayedColor () const
	Query node's displayed color.
virtual void	setColor (const Color32 &color)
	Change the color of node.
virtual void	updateDisplayedColor (const Color32 &parentColor)
	Update node's displayed color with its parent color.
bool	isCascadeColorEnabled () const
	Query whether cascadeColor is enabled or not.
virtual void	setCascadeColorEnabled (bool cascadeColorEnabled)
	Sets whether to enable color cascade.
void	setOnEnterCallback (const std::function< void()> &callback)
	Set the callback of event onEnter.
const std::function< void()> &	getOnEnterCallback () const
	Get the callback of event onEnter.
void	setOnExitCallback (const std::function< void()> &callback)
	Set the callback of event onExit.
const std::function< void()> &	getOnExitCallback () const
	Get the callback of event onExit.
void	setOnEnterTransitionDidFinishCallback (const std::function< void()> &callback)
	Set the callback of event EnterTransitionDidFinish.
const std::function< void()> &	getOnEnterTransitionDidFinishCallback () const
	Get the callback of event EnterTransitionDidFinish.
void	setOnExitTransitionDidStartCallback (const std::function< void()> &callback)
	Set the callback of event ExitTransitionDidStart.
const std::function< void()> &	getOnExitTransitionDidStartCallback () const
	Get the callback of event ExitTransitionDidStart.
void	setOnCleanupCallback (const std::function< void()> &callback)
	Set the callback invoked by cleanup before actions and scheduled callbacks are released.
unsigned short	getCameraMask () const
	get & set camera mask, the node is visible by the camera whose camera flag & node's camera mask is true
virtual void	setCameraMask (unsigned short mask, bool applyChildren=true)
	Modify the camera mask for current node.
void	applyMaskOnEnter (bool applyChildren)
	Should addChild() make the child follow it's parent's mask?
rhi::ProgramState *	setProgramStateByProgramId (uint64_t progId)
	Sets ProgramState by programId.
void	resetChild (Node *child, bool cleanup)
	Performs pointer hit testing for this node under the specified camera.
virtual void	setLocalZOrder (int localZOrder)
	LocalZOrder is the 'key' used to sort the node relative to its siblings.
void	updateOrderOfArrival ()
	!
virtual int	getLocalZOrder () const
	Gets the local Z order of this node.
virtual void	setGlobalZOrder (float globalZOrder)
	Defines the order in which the nodes are renderer.
virtual float	getGlobalZOrder () const
	Returns the Node's Global Z Order.
virtual float	getScaleX () const
	Returns the scale factor on X axis of this node.
virtual float	getScaleY () const
	Returns the scale factor on Y axis of this node.
virtual void	setScaleZ (float scaleZ)
	Changes the scale factor on Z axis of this node.
virtual float	getScaleZ () const
	Returns the scale factor on Z axis of this node.
virtual float	getScale () const
	Gets the scale factor of the node, when X and Y have the same scale factor.
virtual void	setPositionNormalized (const Vec2 &position)
	Sets the position (x,y) using values between 0 and 1.
virtual const Vec2 &	getPosition () const
	Gets the position (x,y) of the node in its parent's coordinate system.
virtual const Vec2 &	getPositionNormalized () const
	Returns the normalized position.
virtual void	getPosition (float *x, float *y) const
	Gets position in a more efficient way, returns two number instead of a Vec2 object.
virtual void	setPositionX (float x)
	Gets/Sets x or y coordinate individually for position.
virtual float	getPositionX () const
	Gets the x coordinate of the node in its parent's coordinate system.
virtual void	setPositionY (float y)
	Sets the y coordinate of the node in its parent's coordinate system.
virtual float	getPositionY () const
	Gets the y coordinate of the node in its parent's coordinate system.
virtual void	setPosition3D (const Vec3 &position)
	Sets the position (X, Y, and Z) in its parent's coordinate system.
virtual Vec3	getPosition3D () const
	Returns the position (X,Y,Z) in its parent's coordinate system.
virtual float	getPositionZ () const
	Gets position Z coordinate of this node.
virtual float	getSkewX () const
	Returns the X skew angle of the node in degrees.
virtual float	getSkewY () const
	Returns the Y skew angle of the node in degrees.
virtual const Vec2 &	getAnchorPoint () const
	Returns the anchor point in percent.
virtual const Vec2 &	getAnchorPointInPoints () const
	Returns the anchorPoint in absolute pixels.
virtual const Vec2 &	getContentSize () const
	Returns the untransformed size of the node.
virtual bool	isVisible () const
	Determines if the node is visible.
virtual float	getRotation () const
	Returns the rotation of the node in degrees.
virtual void	setRotation3D (const Vec3 &rotation)
	Sets the rotation (X,Y,Z) in degrees.
virtual Vec3	getRotation3D () const
	Returns the rotation (X,Y,Z) in degrees.
virtual void	setRotationQuat (const Quat &quat)
	Set rotation by quaternion.
virtual Quat	getRotationQuat () const
	Return the rotation by quaternion, Note that when _rotationZ_X == _rotationZ_Y, the returned quaternion equals to RotationZ_X * RotationY * RotationX, it equals to RotationY * RotationX otherwise.
virtual float	getRotationSkewX () const
	Gets the X rotation (angle) of the node in degrees which performs a horizontal rotation skew.
virtual float	getRotationSkewY () const
	Gets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew.
virtual bool	isIgnoreAnchorPointForPosition () const
	Gets whether the anchor point will be (0,0) when you position this node.
virtual int	getTag () const
	Returns a tag that is used to identify the node easily.
virtual void	setTag (int tag)
	Changes the tag that is used to identify the node easily.
virtual std::string_view	getName () const
	Returns a string that is used to identify the node.
virtual void	setName (std::string_view name)
	Changes the name that is used to identify the node easily.
virtual void *	getUserData ()
	Returns a custom user data pointer.
virtual const void *	getUserData () const
	@lua NA
virtual void	setUserData (void *userData)
	Sets a custom user data pointer.
virtual Object *	getUserObject ()
	Returns a user assigned Object.
virtual const Object *	getUserObject () const
	@lua NA
virtual void	setUserObject (Object *userObject)
	Returns a user assigned Object.
virtual void	onEnter ()
	Event callback that is invoked every time when Node enters the 'stage'.
virtual void	onEnterTransitionDidFinish ()
	Event callback that is invoked when the Node enters in the 'stage'.
virtual void	onExit ()
	Event callback that is invoked every time the Node leaves the 'stage'.
virtual void	onExitTransitionDidStart ()
	Event callback that is called every time the Node leaves the 'stage'.
virtual void	setActionManager (ActionManager *actionManager)
	Sets the ActionManager object that is used by all actions.
virtual ActionManager *	getActionManager ()
	Gets the ActionManager object that is used by all actions.
virtual Action *	runAction (Action *action)
	Executes an action, and returns the action that is executed.
void	stopAllActions ()
	Stops and removes all actions from the running action list .
void	stopAction (Action *action)
	Stops and removes an action from the running action list.
void	stopActionByTag (int tag)
	Removes an action from the running action list by its tag.
void	stopAllActionsByTag (int tag)
	Removes all actions from the running action list by its tag.
void	stopActionsByFlags (unsigned int flags)
	Removes all actions from the running action list by its flags.
Action *	getActionByTag (int tag)
	Gets an action from the running action list by its tag.
ssize_t	getNumberOfRunningActions () const
	Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays).
ssize_t	getNumberOfRunningActionsByTag (int tag) const
	Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays) with a specific tag.
virtual void	setScheduler (Scheduler *scheduler)
	Sets a Scheduler object that is used to schedule all "updates" and timers.
virtual Scheduler *	getScheduler ()
	Gets a Scheduler object.
bool	isScheduled (SEL_SCHEDULE selector) const
	Checks whether a selector is scheduled.
bool	isScheduled (std::string_view key) const
	Checks whether a lambda function is scheduled.
void	scheduleUpdate ()
	Schedules the "update" method.
void	scheduleUpdateWithPriority (int priority)
	Schedules the "update" method with a custom priority.
void	schedule (SEL_SCHEDULE selector, float interval, unsigned int repeat, float delay)
	Schedules a custom selector.
void	schedule (SEL_SCHEDULE selector, float interval)
	Schedules a custom selector with an interval time in seconds.
void	scheduleOnce (SEL_SCHEDULE selector, float delay)
	Schedules a selector that runs only once, with a delay of 0 or larger.
void	scheduleOnce (const std::function< void(float)> &callback, float delay, std::string_view key)
	Schedules a lambda function that runs only once, with a delay of 0 or larger.
void	schedule (SEL_SCHEDULE selector)
	Schedules a custom selector, the scheduled selector will be ticked every frame.
void	schedule (const std::function< void(float)> &callback, std::string_view key)
	Schedules a lambda function.
void	schedule (const std::function< void(float)> &callback, float interval, std::string_view key)
	Schedules a lambda function.
void	schedule (const std::function< void(float)> &callback, float interval, unsigned int repeat, float delay, std::string_view key)
	Schedules a lambda function.
void	unschedule (SEL_SCHEDULE selector)
	Unschedules a custom selector.
void	unschedule (std::string_view key)
	Unschedules a lambda function.
void	unscheduleAllCallbacks ()
	Unschedule all scheduled selectors and lambda functions: custom selectors, and the 'update' selector and lambda functions.
virtual void	resume ()
	Resumes all scheduled selectors, actions and event listeners.
virtual void	pause ()
	Pauses all scheduled selectors, actions and event listeners.
virtual void	update (float delta)
	Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live".
virtual const Mat4 &	getNodeToParentTransform () const
	Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates.
virtual Mat4	getNodeToParentTransform (Node *ancestor) const
	Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates.
virtual AffineTransform	getNodeToParentAffineTransform (Node *ancestor) const
	Returns the affine transform matrix that transform the node's (local) space coordinates into the parent's space coordinates.
virtual void	setNodeToParentTransform (const Mat4 &transform)
	Sets the transformation matrix manually.
virtual const Mat4 &	getParentToNodeTransform () const
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates.
virtual Mat4	getNodeToWorldTransform () const
	Returns the world affine transform matrix.
virtual Mat4	getWorldToNodeTransform () const
	Returns the inverse world affine transform matrix.
Vec2	convertToNodeSpace (const Vec2 &worldPoint) const
	Converts a Vec2 to node (local) space coordinates.
Vec2	convertToWorldSpace (const Vec2 &nodePoint) const
	Converts a Vec2 to world space coordinates.
Vec2	convertToNodeSpaceAR (const Vec2 &worldPoint) const
	Converts a Vec2 to node (local) space coordinates.
Vec2	convertToWorldSpaceAR (const Vec2 &nodePoint) const
	Converts a local Vec2 to world space coordinates.The result is in Points.
Vec2	convertPointerToNodeSpace (PointerEvent *event) const
	convenience methods which take a Touch instead of Vec2.
Vec2	convertPointerToNodeSpaceAR (PointerEvent *event) const
	converts a Touch (world coordinates) into a local coordinate.
Vec2	getWorldPosition () const
	Gets position of node in world space.
void	setWorldPosition (const Vec2 &position)
	Sets position of node in world space.
void	setAdditionalTransform (const Mat4 *additionalTransform)
	Sets an additional transform matrix to the node.
Component *	getComponent (std::string_view name)
	Gets a component by its name.
virtual bool	addComponent (Component *component)
	Adds a component.
virtual bool	removeComponent (std::string_view name)
	Removes a component by its name.
virtual bool	removeComponent (Component *component)
	Removes a component by its pointer.
virtual void	removeAllComponents ()
	Removes all components.
virtual Node *	getChildByTag (int tag) const
	Gets a child from the container with its tag.
template<typename T>
T	getChildByTag (int tag) const
	Gets a child from the container with its tag that can be cast to Type T.
virtual Node *	getChildByName (std::string_view name) const
	Gets a child from the container with its name.
template<typename T>
T	getChildByName (std::string_view name) const
	Gets a child from the container with its name that can be cast to Type T.
virtual void	enumerateChildren (std::string_view name, std::function< bool(Node *node)> callback) const
	Search the children of the receiving node to perform processing for nodes which share a name.
virtual Vector< Node * > &	getChildren ()
	Returns the array of the node's children.
virtual ssize_t	getChildrenCount () const
	Returns the amount of children.
virtual void	setParent (Node *parent)
	Sets the parent node.
virtual Node *	getParent ()
	Returns a pointer to the parent node.
virtual void	removeFromParent ()
	Removes this node itself from its parent node with a cleanup.
virtual void	removeFromParentAndCleanup (bool cleanup)
	Removes this node itself from its parent node.
virtual void	removeChildByTag (int tag, bool cleanup=true)
	Removes a child from the container by tag value.
virtual void	removeChildByName (std::string_view name, bool cleanup=true)
	Removes a child from the container by tag value.
virtual void	removeAllChildren ()
	Removes all children from the container with a cleanup.
Public Member Functions inherited from Object
void	retain ()
	Retains the ownership.
void	release ()
	Releases the ownership immediately.
Object *	autorelease ()
	Releases the ownership sometime soon automatically.
unsigned int	getReferenceCount () const
	Returns the Object's current reference count.
uint64_t	getObjectID () const noexcept
	Returns the process-local diagnostic identifier assigned at construction.
virtual	~Object ()
	Destructor.

Static Public Member Functions
static LayerGradient *	create ()
	Creates a fullscreen black layer.
static LayerGradient *	create (const Color32 &start, const Color32 &end)
	Creates a full-screen Layer with a gradient between start and end.
static LayerGradient *	create (const Color32 &start, const Color32 &end, const Vec2 &v)
	Creates a full-screen Layer with a gradient between start and end in the direction of v.
Static Public Member Functions inherited from LayerColor
static LayerColor *	create ()
	Creates a fullscreen black layer.
static LayerColor *	create (const Color32 &color, float width, float height)
	Creates a Layer with color, width and height in Points.
static LayerColor *	create (const Color32 &color)
	Creates a Layer with color.
static Sprite *	create (std::string_view filename)
	Creates a sprite with an image filename.
static Sprite *	create (const PolygonInfo &info)
	Creates a polygon sprite with a polygon info.
static Sprite *	create (std::string_view filename, const Rect &rect)
	Creates a sprite with an image filename and a rect.
static Sprite *	create (const ax::Data &imageData, std::string_view key)
	Creates a sprite with an image data and an image key.
static Sprite *	createWithTexture (Texture2D *texture)
	Creates a sprite with a Texture2D object.
static Sprite *	createWithTexture (Texture2D *texture, const Rect &rect, bool rotated=false)
	Creates a sprite with a texture and a rect.
static Sprite *	createWithSpriteFrame (SpriteFrame *spriteFrame)
	Creates a sprite with an sprite frame.
static Sprite *	createWithSpriteFrameName (std::string_view spriteFrameName)
	Creates a sprite with an sprite frame name.
static Node *	create ()
	Allocates and initializes a node.
static int	getAttachedNodeCount ()
	Gets count of nodes those are attached to scene graph.
template<typename _T>
static void	sortNodes (ax::Vector< _T * > &nodes)
	Sorts helper function.

Additional Inherited Members
Static Public Attributes inherited from Sprite
static const int	INDEX_NOT_INITIALIZED = -1
	Sprite invalid index on the SpriteBatchNode.
Static Public Attributes inherited from Node
static const int	INVALID_TAG = -1
	Default tag used for all the nodes.
Protected Member Functions inherited from Node
void	childrenAlloc ()
	lazy allocs
void	insertChild (Node *child, int z)
	helper that reorder a child
void	detachChild (Node *child, ssize_t index, bool cleanup)
	Removes a child, call child->onExit(), do cleanup, remove it from children array.
Vec2	convertToScreenSpace (const Vec2 &nodePoint) const
	Convert axmol coordinates to UI windows coordinate.
Protected Attributes inherited from Node
float	_rotationX
	rotation on the X-axis
float	_rotationY
	rotation on the Y-axis
float	_rotationZ_X
	rotation angle on Z-axis, component X
float	_rotationZ_Y
	rotation angle on Z-axis, component Y
rhi::VertexLayout *	_vertexLayout = nullptr
	rotation using quaternion, if _rotationZ_X == _rotationZ_Y, _rotationQuat = RotationZ_X * RotationY * RotationX, else _rotationQuat = RotationY * RotationX
float	_scaleX
	scaling factor on x-axis
float	_scaleY
	scaling factor on y-axis
float	_scaleZ
	scaling factor on z-axis
Vec2	_position
	position of the node
float	_positionZ
	OpenGL real Z position.
float	_skewX
	skew angle on x-axis
float	_skewY
	skew angle on y-axis
Vec2	_anchorPointInPoints
	anchor point in points
Vec2	_anchorPoint
	anchor point normalized (NOT in points)
Vec2	_contentSize
	untransformed size of the node
Mat4	_modelViewTransform
	ModelView transform of the Node.
Mat4	_transform
	transform
Mat4	_inverse
	inverse transform
Mat4 *	_additionalTransform
	two transforms needed by additional transforms
float	_globalZOrder
	Global order used to sort the node.
Vector< Node * >	_children
	array of children nodes
NodeIndexerMap_t *	_childrenIndexer
	The children indexer for fast find child.
Node *	_parent
	weak reference to parent node
int	_tag
	a tag. Can be any number you assigned just to identify this node
std::string	_name
	a string label, an user defined string to identify this node
uint64_t	_hashOfName
	hash value of _name, used for speed in getChildByName
void *	_userData
	A user assigned void pointer, Can be point to any cpp object.
Object *	_userObject
	A user assigned Object.
Scheduler *	_scheduler
	scheduler used to schedule timers and updates
ActionManager *	_actionManager
	a pointer to ActionManager singleton, which is used to handle all the actions
EventDispatcher *	_eventDispatcher
	event dispatcher used to dispatch all kinds of events
bool	_reorderChildDirty
	children order dirty flag
bool	_running
	is running
bool	_visible
	is this node visible
bool	_ignoreAnchorPointForPosition
	true if the Anchor Vec2 will be (0,0) when you position the Node, false otherwise. Used by Layer and Scene.
bool	_isTransitionFinished
	flag to indicate whether the transition was finished
bool	_contentSizeDirty
	whether or not the contentSize is dirty
bool	_transformDirty
	transform dirty flag
bool	_inverseDirty
	inverse transform dirty flag
bool	_additionalTransformDirty
	transform dirty ?
bool	_transformUpdated
	Whether or not the Transform object was updated since the last frame.
ComponentContainer *	_componentContainer
	Dictionary of components.

Detailed Description

LayerGradient is a subclass of LayerColor that draws gradients across the background.

All features from LayerColor are valid, plus the following new features:

• direction
• final color
• interpolation mode

Color is interpolated between the startColor and endColor along the given vector (starting at the origin, ending at the terminus). If no vector is supplied, it defaults to (0, -1) – a fade from top to bottom.

If 'compressedInterpolation' is disabled, you will not see either the start or end color for non-cardinal vectors; a smooth gradient implying both end points will be still be drawn, however.

If ' compressedInterpolation' is enabled (default mode) you will see both the start and end colors of the gradient.

Since

v0.99.5

Member Function Documentation

create() [1/3]

LayerGradient * create ( )

static

Creates a fullscreen black layer.

Returns

An autoreleased LayerGradient object.

create() [2/3]

LayerGradient * create ( const Color32 & start, const Color32 & end )

static

Creates a full-screen Layer with a gradient between start and end.

Parameters

start	The start color.
end	The end color.

Returns

An autoreleased LayerGradient object.

create() [3/3]

LayerGradient * create ( const Color32 & start, const Color32 & end, const Vec2 & v )

static

Creates a full-screen Layer with a gradient between start and end in the direction of v.

Parameters

start	The start color.
end	The end color.
v	The direction of gradient color.

Returns

An autoreleased LayerGradient object.

setCompressedInterpolation()

void setCompressedInterpolation

(

bool

compressedInterpolation

)

Whether or not the interpolation will be compressed in order to display all the colors of the gradient both in canonical and non canonical vectors.

Default: true.

Parameters

compressedInterpolation

The interpolation will be compressed if true.

isCompressedInterpolation()

bool isCompressedInterpolation

(

)

const

Get the compressedInterpolation.

Returns

The interpolation will be compressed if true.

setStartColor()

void setStartColor

(

const Color32 &

startColor

)

Sets the start color of the gradient.

Parameters

startColor

The start color.

getStartColor()

const Color32 & getStartColor

(

)

const

Returns the start color of the gradient.

Returns

The start color.

setEndColor()

void setEndColor

(

const Color32 &

endColor

)

Sets the end color of the gradient.

Parameters

endColor

The end color.

getEndColor()

const Color32 & getEndColor

(

)

const

Returns the end color of the gradient.

Returns

The end color.

setStartOpacity()

void setStartOpacity

(

uint8_t

startOpacity

)

Returns the start opacity of the gradient.

Parameters

startOpacity

The start opacity, from 0 to 255.

getStartOpacity()

uint8_t getStartOpacity

(

)

const

Returns the start opacity of the gradient.

Returns

The start opacity.

setEndOpacity()

void setEndOpacity

(

uint8_t

endOpacity

)

Returns the end opacity of the gradient.

Parameters

endOpacity

The end opacity, from 0 to 255.

getEndOpacity()

uint8_t getEndOpacity

(

)

const

Returns the end opacity of the gradient.

Returns

The end opacity.

setVector()

void setVector

(

const Vec2 &

alongVector

)

Sets the directional vector that will be used for the gradient.

The default value is vertical direction (0,-1).

Parameters

alongVector

The direction of gradient.

getVector()

const Vec2 & getVector

(

)

const

Returns the directional vector used for the gradient.

Returns

The direction of gradient.

getDescription()

std::string getDescription ( ) const

overridevirtual

Gets the description string.

It makes debugging easier.

Returns

A string @lua NA

Reimplemented from Node.

initWithColor() [1/2]

bool initWithColor	(	const Color32 &	start,
		const Color32 &	end )

Initializes the Layer with a gradient between start and end.

@lua init

initWithColor() [2/2]

bool initWithColor	(	const Color32 &	start,
		const Color32 &	end,
		const Vec2 &	v )

Initializes the Layer with a gradient between start and end in the direction of v.

@lua init

---

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

• Layer.h