new Sprite(texture)
The Sprite object is the base for all textured objects that are rendered to the screen
Parameters:
Name | Type | Description |
---|---|---|
texture |
PIXI.Texture | The texture for this sprite A sprite can be created directly from an image like this : var sprite = new PIXI.Sprite.fromImage('assets/image.png'); yourStage.addChild(sprite); then obviously don't forget to add it to the stage you have already created |
- Source - pixi/display/Sprite.js, line 5
Extends
Members
-
anchor :Point
-
The anchor sets the origin point of the texture. The default is 0,0 this means the texture's origin is the top left Setting than anchor to 0.5,0.5 means the textures origin is centered Setting the anchor to 1,1 would mean the textures origin points will be the bottom right corner
- Source - pixi/display/Sprite.js, line 22
-
blendMode :Number
-
The blend mode to be applied to the sprite. Set to PIXI.blendModes.NORMAL to remove any blend mode.
Warning: You cannot have a blend mode and a filter active on the same Sprite. Doing so will render the sprite invisible.
- Default Value:
- PIXI.blendModes.NORMAL;
- Source - pixi/display/Sprite.js, line 87
-
<readonly> children :Array.<DisplayObject>
-
[read-only] The array of children of this container.
Type:
- Array.<DisplayObject>
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 17
-
exists :Boolean
-
Controls if this Sprite is processed by the core Phaser game loops and Group loops.
- Default Value:
- true
- Source - pixi/display/Sprite.js, line 107
-
height :Number
-
The height of the sprite, setting this will actually modify the scale to achieve the value set
- Source - pixi/display/Sprite.js, line 148
-
ignoreChildInput :Boolean
-
If
ignoreChildInput
isfalse
it will allow this objects children to be considered as valid for Input events.If this property is
true
then the children will not be considered as valid for Input events.Note that this property isn't recursive: only immediate children are influenced, it doesn't scan further down.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 26
-
shader :PIXI.AbstractFilter
-
The shader that will be used to render the texture to the stage. Set to null to remove a current shader.
- Default Value:
- null
- Source - pixi/display/Sprite.js, line 98
-
texture :PIXI.Texture
-
The texture that the sprite is using
- Source - pixi/display/Sprite.js, line 33
-
tint :Number
-
The tint applied to the sprite. This is a hex value. A value of 0xFFFFFF will remove any tint effect.
- Default Value:
- 0xFFFFFF
- Source - pixi/display/Sprite.js, line 59
-
tintedTexture :Canvas
-
A canvas that contains the tinted version of the Sprite (in Canvas mode, WebGL doesn't populate this)
- Default Value:
- null
- Source - pixi/display/Sprite.js, line 78
-
width :Number
-
The width of the sprite, setting this will actually modify the scale to achieve the value set
- Source - pixi/display/Sprite.js, line 129
Methods
-
<static> fromFrame(frameId) → {PIXI.Sprite}
-
Helper function that creates a sprite that will contain a texture from the TextureCache based on the frameId The frame ids are created when a Texture packer file has been loaded
Parameters:
Name Type Description frameId
String The frame Id of the texture in the cache
Returns:
A new Sprite using a texture from the texture cache matching the frameId
- Source - pixi/display/Sprite.js, line 497
-
<static> fromImage(imageId) → {PIXI.Sprite}
-
Helper function that creates a sprite that will contain a texture based on an image url If the image is not in the texture cache it will be loaded
Parameters:
Name Type Description imageId
String The image url of the texture
Returns:
A new Sprite using a texture from the texture cache matching the image id
- Source - pixi/display/Sprite.js, line 516
-
addChild(child) → {DisplayObject}
-
Adds a child to the container.
Parameters:
Name Type Description child
DisplayObject The DisplayObject to add to the container
Returns:
The child that was added.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 102
-
addChildAt(child, index) → {DisplayObject}
-
Adds a child to the container at a specified index. If the index is out of bounds an error will be thrown
Parameters:
Name Type Description child
DisplayObject The child to add
index
Number The index to place the child in
Returns:
The child that was added.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 114
-
getBounds(matrix) → {Rectangle}
-
Returns the bounds of the Sprite as a rectangle. The bounds calculation takes the worldTransform into account.
It is important to note that the transform is not updated when you call this method. So if this Sprite is the child of a Display Object which has had its transform updated since the last render pass, those changes will not yet have been applied to this Sprites worldTransform. If you need to ensure that all parent transforms are factored into this getBounds operation then you should call
updateTransform
on the root most object in this Sprites display list first.Parameters:
Name Type Description matrix
Matrix the transformation matrix of the sprite
Returns:
Rectangle -the framing rectangle
- Source - pixi/display/Sprite.js, line 203
-
getChildAt(index) → {DisplayObject}
-
Returns the child at the specified index
Parameters:
Name Type Description index
Number The index to get the child from
Returns:
The child at the given index, if any.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 205
-
getChildIndex(child) → {Number}
-
Returns the index position of a child DisplayObject instance
Parameters:
Name Type Description child
DisplayObject The DisplayObject instance to identify
Returns:
Number -The index position of the child display object to identify
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 170
-
getLocalBounds() → {Rectangle}
-
Retrieves the non-global local bounds of the displayObjectContainer as a rectangle. The calculation takes all visible children into consideration.
Returns:
Rectangle -The rectangular bounding area
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 381
-
removeChild(child) → {DisplayObject}
-
Removes a child from the container.
Parameters:
Name Type Description child
DisplayObject The DisplayObject to remove
Returns:
The child that was removed.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 222
-
removeChildAt(index) → {DisplayObject}
-
Removes a child from the specified index position.
Parameters:
Name Type Description index
Number The index to get the child from
Returns:
The child that was removed.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 237
-
removeChildren(beginIndex, endIndex)
-
Removes all children from this container that are within the begin and end indexes.
Parameters:
Name Type Description beginIndex
Number The beginning position. Default value is 0.
endIndex
Number The ending position. Default value is size of the container.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 255
-
removeStageReference()
-
Removes the current stage reference from the container and all of its children.
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 426
-
setChildIndex(child, index)
-
Changes the position of an existing child in the display object container
Parameters:
Name Type Description child
DisplayObject The child DisplayObject instance for which you want to change the index number
index
Number The resulting index number for the child display object
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 187
-
setStageReference(stage)
-
Sets the containers Stage reference. This is the Stage that this object, and all of its children, is connected to.
Parameters:
Name Type Description stage
Stage the stage that the container will have as its current stage reference
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 410
-
setTexture(texture, destroy)
-
Sets the texture of the sprite. Be warned that this doesn't remove or destroy the previous texture this Sprite was using.
Parameters:
Name Type Argument Default Description texture
PIXI.Texture The PIXI texture that is displayed by the sprite
destroy
Boolean <optional>
false Call Texture.destroy on the current texture before replacing it with the new one?
- Source - pixi/display/Sprite.js, line 167
-
swapChildren(child, child2)
-
Swaps the position of 2 Display Objects within this container.
Parameters:
Name Type Description child
DisplayObject -
child2
DisplayObject -
- Inherited From:
- Source - pixi/display/DisplayObjectContainer.js, line 145