Sprite

Supported platforms:
Available since: Gideros 2011.6
Inherits from: EventDispatcher

Description

The Sprite class is the base class for all objects that can be placed on the scene tree. It is the basic scene tree building block.

A sprite can contain child sprites which makes the scene tree hierarchy. Transformations such as translation, rotation, scaling, and color transforms, propagate its effect to all of its children.

The drawing order is defined by the order of children. The first child is drawn first and the last child is drawn last. It is possible to change the drawing order by modifying the order of child list.

A Sprite instance can exist without attaching the scene tree.

An unattached sprite can receive Event.ENTER_FRAME event but it will only receive mouse and touch events when it is attached to the scene tree.

Methods Sprite.new creates a new Sprite object Sprite:addChild adds a sprite as a child Sprite:addChildAt add a sprite as a child at the index position specified Sprite:clearBlendMode clears the blending mode Sprite:contains determines whether the specified sprite is contained in the subtree of this sprite Sprite:get gets the specified property by its name Sprite:getAlpha returns the alpha transparency of this sprite Sprite:getAnchorPosition Returns anchor position of Sprite Sprite:getBounds returns the bounds as it appears in another sprite's coordinate system Sprite:getChildAt returns the child sprite that exists at the specified index Sprite:getChildIndex returns the index of the specified child sprite Sprite:getChildrenAtPoint returns the children sprites that corresponds to the given screen coordinates Sprite:getClip Sprite:getColorTransform returns the red, green, blue and alpha channel multipliers Sprite:getHeight returns the height Sprite:getLayoutConstraints get the current layout constraints Sprite:getLayoutInfo get information of the current layout Sprite:getLayoutParameters get the current layout parameters Sprite:getMatrix returns the transformation matrix of the sprite Sprite:getNumChildren returns the number of children of this sprite Sprite:getParent returns the parent sprite Sprite:getPosition gets the x,y and z coordinates of the sprite Sprite:getRotation returns the rotation of the sprite in degrees Sprite:getRotationX returns the rotation of the sprite around x axis in degrees Sprite:getRotationY returns the rotation of the sprite around y axis in degrees Sprite:getScale returns the horizontal, vertical and z scales of the sprite Sprite:getScaleX returns the horizontal scale of the sprite Sprite:getScaleY returns the vertical scale of the sprite Sprite:getScaleZ returns the scale on z axis of the sprite Sprite:getSkew Sprite:getSkewX Sprite:getSkewY Sprite:getWidth returns the width Sprite:getX returns the x coordinate of the sprite Sprite:getY returns the y coordinate of the sprite Sprite:getZ returns the z coordinate of the sprite Sprite:globalToLocal converts the x,y coordinates from the global to the sprite's (local) coordinates Sprite:hitTestPoint checks the given coordinates is in bounds of the sprite Sprite:isVisible returns the visibility of sprite Sprite:localToGlobal converts the x,y coordinates from the sprite's (local) coordinates to the global coordinates Sprite:removeChild removes the child sprite Sprite:removeChildAt removes the child sprite at the specifed index Sprite:removeFromParent if the sprite has a parent, removes the sprite from the child list of its parent sprite. Sprite:set sets the specified property by its name Sprite:setAlpha sets the alpha transparency of this sprite Sprite:setAnchorPosition Set anchor position Sprite:setBlendMode sets the blend mode of the sprite Sprite:setClip Clip Sprite contents Sprite:setColorTransform sets the red, green, blue and alpha channel multipliers Sprite:setLayoutConstraints specify the child placement constraints for Gideros's layout system Sprite:setLayoutParameters specify the parent parameters for Gideros's layout system Sprite:setMatrix sets the transformation matrix of the sprite Sprite:setPosition sets the x,y and z coordinates of the sprite Sprite:setRotation sets the rotation of the sprite in degrees Sprite:setRotationX sets the rotation of the sprite in degrees around x axis Sprite:setRotationY sets the rotation of the sprite in degrees around y axis Sprite:setScale sets the horizontal, vertical and z axis scales of the sprite Sprite:setScaleX sets the horizontal scale of the sprite Sprite:setScaleY sets the vertical scale of the sprite Sprite:setScaleZ Set scale on z axis Sprite:setShader Set shader for this sprite Sprite:setShaderConstant Change the value of a uniform for this sprite Sprite:setSkew Sprite:setSkewX Sprite:setSkewY Sprite:setStencilOperation Set the stencil operation for this sprite Sprite:setStopEventPropagation Select which events must not be propagated to parent sprite Sprite:setVisible sets the visibility of sprite Sprite:setX sets the x coordinate of the sprite Sprite:setY sets the y coordinate of the sprite Sprite:setZ sets the z coordinate of the sprite Sprite:swapChildren Swap two children index places Sprite:swapChildrenAt Swaps two child sprites.

Events Event.ADDED_TO_STAGE Event.ENTER_FRAME Event.KEY_DOWN Event.KEY_UP Event.LAYOUT_RESIZED Event.MOUSE_DOWN Event.MOUSE_HOVER Event.MOUSE_MOVE Event.MOUSE_UP Event.MOUSE_WHEEL Event.REMOVED_FROM_STAGE Event.TOUCHES_BEGIN Event.TOUCHES_CANCEL Event.TOUCHES_END Event.TOUCHES_MOVE Constants Sprite.ADD Sprite.ALPHA Sprite.LAYOUT_ANCHOR_CENTER Sprite.LAYOUT_ANCHOR_EAST Sprite.LAYOUT_ANCHOR_NORTH Sprite.LAYOUT_ANCHOR_NORTHEAST Sprite.LAYOUT_ANCHOR_NORTHWEST Sprite.LAYOUT_ANCHOR_SOUTH Sprite.LAYOUT_ANCHOR_SOUTHEAST Sprite.LAYOUT_ANCHOR_SOUTHWEST Sprite.LAYOUT_ANCHOR_WEST Sprite.LAYOUT_FILL_BOTH Sprite.LAYOUT_FILL_HORIZONTAL Sprite.LAYOUT_FILL_NONE Sprite.LAYOUT_FILL_VERTICAL Sprite.MULTIPLY Sprite.NO_ALPHA Sprite.SCREEN