Sprite

From GiderosMobile
Revision as of 09:52, 22 July 2020 by Hgy29 (talk | contribs) (→‎Methods)


Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
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:getDrawCount returns the number of Sprites actually drawn each frame on this subtree
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