Phaser Class: TileSprite

new TileSprite(game, x, y, width, height, key, frame)

A TileSprite is a Sprite whos texture is set to repeat and can be scrolled. As it scrolls the texture repeats (wraps) on the edges.

Parameters:

Name	Type	Description
`game`	Phaser.Game	Current game instance.
`x`	number	X position of the new tileSprite.
`y`	number	Y position of the new tileSprite.
`width`	number	the width of the tilesprite.
`height`	number	the height of the tilesprite.
`key`	string \| Phaser.RenderTexture \| PIXI.Texture	This is the image or texture used by the Sprite during rendering. It can be a string which is a reference to the Cache entry, or an instance of a RenderTexture or PIXI.Texture.
`frame`	string \| number	If this Sprite is using part of a sprite sheet or texture atlas you can specify the exact frame to use by giving a string or numeric index.

Source:

gameobjects/TileSprite.js, line 20

Extends

Phaser.Sprite

Members

alive

Properties:

Name	Type	Description
`alive`	boolean	This is a handy little var your game can use to determine if a sprite is alive or not, it doesn't effect rendering.

Inherited From:

Phaser.Sprite#alive

Default Value:

true

Source:

gameobjects/Sprite.js, line 45

anchor

The anchor sets the origin point of the texture. The default is 0,0 this means the textures 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

Properties:

Name	Type	Description
`anchor`	Phaser.Point	The anchor around which rotation and scaling takes place.

Inherited From:

Phaser.Sprite#anchor

Source:

gameobjects/Sprite.js, line 172

angle

Indicates the rotation of the Sprite, in degrees, from its original orientation. Values from 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside this range are added to or subtracted from 360 to obtain a value within the range. For example, the statement player.angle = 450 is the same as player.angle = 90. If you wish to work in radians instead of degrees use the property Sprite.rotation instead.

Properties:

Name	Type	Description
`angle`	number	Gets or sets the Sprites angle of rotation in degrees.

Inherited From:

Phaser.Sprite#angle

Source:

gameobjects/Sprite.js, line 977

animations

Properties:

Name	Type	Description
`animations`	Phaser.AnimationManager	This manages animations of the sprite. You can modify animations through it (see Phaser.AnimationManager)

Inherited From:

Phaser.Sprite#animations

Source:

gameobjects/Sprite.js, line 86

autoCull

Should this Sprite be automatically culled if out of range of the camera? A culled sprite has its renderable property set to 'false'.

Properties:

Name	Type	Description
`autoCull`	boolean	A flag indicating if the Sprite should be automatically camera culled or not.

Inherited From:

Phaser.Sprite#autoCull

Default Value:

false

Source:

gameobjects/Sprite.js, line 199

body

Properties:

Name	Type	Description
`body`	Phaser.Physics.Arcade.Body	By default Sprites have a Phaser.Physics Body attached to them. You can operate physics actions via this property, or null it to skip all physics updates.

Inherited From:

Phaser.Sprite#body

Source:

gameobjects/Sprite.js, line 316

bottomLeft

Properties:

Name	Type	Description
`bottomLeft`	Phaser.Point	A Point containing the bottom left coordinate of the Sprite. Takes rotation and scale into account.

Inherited From:

Phaser.Sprite#bottomLeft

Source:

gameobjects/Sprite.js, line 303

bottomRight

Properties:

Name	Type	Description
`bottomRight`	Phaser.Point	A Point containing the bottom right coordinate of the Sprite. Takes rotation and scale into account.

Inherited From:

Phaser.Sprite#bottomRight

Source:

gameobjects/Sprite.js, line 298

bounds

This Rectangle object fully encompasses the Sprite and is updated in real-time. The bounds is the full bounding area after rotation and scale have been taken into account. It should not be modified directly. It's used for Camera culling and physics body alignment.

Properties:

Name	Type	Description
`bounds`	Phaser.Rectangle

Inherited From:

Phaser.Sprite#bounds

Source:

gameobjects/Sprite.js, line 311

cameraOffset

Properties:

Name	Type	Description
`cameraOffset`	Phaser.Point	If this Sprite is fixed to the camera then use this Point to specify how far away from the Camera x/y it's rendered.

Inherited From:

Phaser.Sprite#cameraOffset

Source:

gameobjects/Sprite.js, line 357

center

Properties:

Name	Type	Description
`center`	Phaser.Point	A Point containing the center coordinate of the Sprite. Takes rotation and scale into account.

Inherited From:

Phaser.Sprite#center

Source:

gameobjects/Sprite.js, line 283

crop

You can crop the Sprites texture by modifying the crop properties. For example crop.width = 50 would set the Sprite to only render 50px wide. The crop is only applied if you have set Sprite.cropEnabled to true.

Properties:

Name	Type	Description
`crop`	Phaser.Rectangle	The crop Rectangle applied to the Sprite texture before rendering.

Inherited From:

Phaser.Sprite#crop

Source:

gameobjects/Sprite.js, line 365

cropEnabled

Properties:

Name	Type	Description
`cropEnabled`	boolean	If true the Sprite.crop property is used to crop the texture before render. Set to false to disable.

Inherited From:

Phaser.Sprite#cropEnabled

Default Value:

false

Source:

gameobjects/Sprite.js, line 371

currentFrame

Properties:

Name	Type	Description
`currentFrame`	Phaser.Frame	A reference to the currently displayed frame.

Inherited From:

Phaser.Sprite#currentFrame

Source:

gameobjects/Sprite.js, line 101

events

Properties:

Name	Type	Description
`events`	Phaser.Events	The Events you can subscribe to that are dispatched when certain things happen on this Sprite or its components.

Inherited From:

Phaser.Sprite#events

Source:

gameobjects/Sprite.js, line 81

exists

Properties:

Name	Type	Description
`exists`	boolean	If exists = false then the Sprite isn't updated by the core game loop or physics subsystem at all.

Inherited From:

Phaser.Sprite#exists

Default Value:

true

Source:

gameobjects/Sprite.js, line 39

fixedToCamera

A Sprite that is fixed to the camera ignores the position of any ancestors in the display list and uses its x/y coordinates as offsets from the top left of the camera.

Properties:

Name	Type	Description
`fixedToCamera`	boolean	Fixes this Sprite to the Camera.

Inherited From:

Phaser.Sprite#fixedToCamera

Default Value:

false

Source:

gameobjects/Sprite.js, line 352

frame

Properties:

Name	Type	Description
`frame`	number	Gets or sets the current frame index and updates the Texture Cache for display.

Inherited From:

Phaser.Sprite#frame

Source:

gameobjects/Sprite.js, line 996

frameName

Properties:

Name	Type	Description
`frameName`	string	Gets or sets the current frame name and updates the Texture Cache for display.

Inherited From:

Phaser.Sprite#frameName

Source:

gameobjects/Sprite.js, line 1012

game

Properties:

Name	Type	Description
`game`	Phaser.Game	A reference to the currently running Game.

Inherited From:

Phaser.Sprite#game

Source:

gameobjects/Sprite.js, line 33

group

Properties:

Name	Type	Description
`group`	Phaser.Group	The parent Group of this Sprite. This is usually set after Sprite instantiation by the parent.

Inherited From:

Phaser.Sprite#group

Source:

gameobjects/Sprite.js, line 50

health

Properties:

Name	Type	Description
`health`	number	Health value. Used in combination with damage() to allow for quick killing of Sprites.

Inherited From:

Phaser.Sprite#health

Source:

gameobjects/Sprite.js, line 321

height

The height of the sprite in pixels, setting this will actually modify the scale to acheive the value desired. If you wish to crop the Sprite instead see the Sprite.crop value.

Properties:

Name	Type	Description
`height`	number	The height of the Sprite in pixels.

Inherited From:

Phaser.Sprite#height

Source:

gameobjects/Sprite.js, line 1064

<readonly> inCamera

Properties:

Name	Type	Description
`inCamera`	boolean	Is this sprite visible to the camera or not?

Inherited From:

Phaser.Sprite#inCamera

Source:

gameobjects/Sprite.js, line 1028

input

Properties:

Name	Type	Description
`input`	Phaser.InputHandler	The Input Handler Component.

Inherited From:

Phaser.Sprite#input

Source:

gameobjects/Sprite.js, line 91

inputEnabled

By default a Sprite won't process any input events at all. By setting inputEnabled to true the Phaser.InputHandler is activated for this Sprite instance and it will then start to process click/touch events and more.

Properties:

Name	Type	Description
`inputEnabled`	boolean	Set to true to allow this Sprite to receive input events, otherwise false.

Inherited From:

Phaser.Sprite#inputEnabled

Source:

gameobjects/Sprite.js, line 1087

inWorld

Properties:

Name	Type	Description
`inWorld`	boolean	This value is set to true if the Sprite is positioned within the World, otherwise false.

Inherited From:

Phaser.Sprite#inWorld

Source:

gameobjects/Sprite.js, line 326

inWorldThreshold

Properties:

Name	Type	Description
`inWorldThreshold`	number	A threshold value applied to the inWorld check. If you don't want a Sprite to be considered "out of the world" until at least 100px away for example then set it to 100.

Inherited From:

Phaser.Sprite#inWorldThreshold

Default Value:

Source:

gameobjects/Sprite.js, line 332

key

Properties:

Name	Type	Description
`key`	string \| Phaser.RenderTexture \| Phaser.BitmapData \| PIXI.Texture	This is the image or texture used by the Sprite during rendering. It can be a string which is a reference to the Cache entry, or an instance of a RenderTexture, BitmapData or PIXI.Texture.

Inherited From:

Phaser.Sprite#key

Source:

gameobjects/Sprite.js, line 96

lifespan

If you would like the Sprite to have a lifespan once 'born' you can set this to a positive value. Handy for particles, bullets, etc. The lifespan is decremented by game.time.elapsed each update, once it reaches zero the kill() function is called.

Properties:

Name	Type	Description
`lifespan`	number	The lifespan of the Sprite (in ms) before it will be killed.

Inherited From:

Phaser.Sprite#lifespan

Default Value:

Source:

gameobjects/Sprite.js, line 76

name

Properties:

Name	Type	Description
`name`	string	The user defined name given to this Sprite.

Inherited From:

Phaser.Sprite#name

Source:

gameobjects/Sprite.js, line 56

offset

Properties:

Name	Type	Description
`offset`	Phaser.Point	Corner point defaults. Should not typically be modified.

Inherited From:

Phaser.Sprite#offset

Source:

gameobjects/Sprite.js, line 278

outOfBoundsKill

Properties:

Name	Type	Description
`outOfBoundsKill`	boolean	If true the Sprite is killed as soon as Sprite.inWorld is false.

Inherited From:

Phaser.Sprite#outOfBoundsKill

Default Value:

false

Source:

gameobjects/Sprite.js, line 338

renderOrderID

Properties:

Name	Type	Description
`renderOrderID`	number	Used by the Renderer and Input Manager to control picking order.

Inherited From:

Phaser.Sprite#renderOrderID

Source:

gameobjects/Sprite.js, line 68

scale

Properties:

Name	Type	Description
`scale`	Phaser.Point	The scale of the Sprite when rendered. By default it's set to 1 (no scale). You can modify it via scale.x or scale.y or scale.setTo(x, y). A value of 1 means no change to the scale, 0.5 means "half the size", 2 means "twice the size", etc.

Inherited From:

Phaser.Sprite#scale

Source:

gameobjects/Sprite.js, line 204

texture

Properties:

Name	Type	Description
`texture`	PIXI.Texture	The texture that the sprite renders with.

Source:

gameobjects/TileSprite.js, line 34

textureRegion

The rectangular area from the texture that will be rendered.

Properties:

Name	Type	Description
`textureRegion`	Phaser.Rectangle

Inherited From:

Phaser.Sprite#textureRegion

Source:

gameobjects/Sprite.js, line 162

tilePosition

Properties:

Name	Type	Description
`tilePosition`	Phaser.Point	The offset position of the image that is being tiled.

Source:

gameobjects/TileSprite.js, line 52

tileScale

Properties:

Name	Type	Description
`tileScale`	Phaser.Point	The scaling of the image that is being tiled.

Source:

gameobjects/TileSprite.js, line 47

topLeft

Properties:

Name	Type	Description
`topLeft`	Phaser.Point	A Point containing the top left coordinate of the Sprite. Takes rotation and scale into account.

Inherited From:

Phaser.Sprite#topLeft

Source:

gameobjects/Sprite.js, line 288

topRight

Properties:

Name	Type	Description
`topRight`	Phaser.Point	A Point containing the top right coordinate of the Sprite. Takes rotation and scale into account.

Inherited From:

Phaser.Sprite#topRight

Source:

gameobjects/Sprite.js, line 293

<readonly> type

Properties:

Name	Type	Description
`type`	number	The const type of this object.

Source:

gameobjects/TileSprite.js, line 42

width

The width of the sprite in pixels, setting this will actually modify the scale to acheive the value desired. If you wish to crop the Sprite instead see the Sprite.crop value.

Properties:

Name	Type	Description
`width`	number	The width of the Sprite in pixels.

Inherited From:

Phaser.Sprite#width

Source:

gameobjects/Sprite.js, line 1041

world

Properties:

Name	Type	Description
`world`	Phaser.Point	The world coordinates of this Sprite. This differs from the x/y coordinates which are relative to the Sprites container.

Inherited From:

Phaser.Sprite#world

Source:

gameobjects/Sprite.js, line 190

x

Properties:

Name	Type	Description
`x`	number	The x coordinate in world space of this Sprite.

Inherited From:

Phaser.Sprite#x

Source:

gameobjects/Sprite.js, line 177

y

Properties:

Name	Type	Description
`y`	number	The y coordinate in world space of this Sprite.

Inherited From:

Phaser.Sprite#y

Source:

gameobjects/Sprite.js, line 182

Methods

bringToTop()

Brings the Sprite to the top of the display list it is a child of. Sprites that are members of a Phaser.Group are only bought to the top of that Group, not the entire display list.

Inherited From:

Phaser.Sprite#bringToTop

Source:

gameobjects/Sprite.js, line 933

Returns:

(Phaser.Sprite) This instance.

centerOn(x, y)

Moves the sprite so its center is located on the given x and y coordinates. Doesn't change the anchor point of the sprite.

Parameters:

Name	Type	Description
`x`	number	The x coordinate (in world space) to position the Sprite at.
`y`	number	The y coordinate (in world space) to position the Sprite at.

Inherited From:

Phaser.Sprite#centerOn

Source:

gameobjects/Sprite.js, line 763

Returns:

(Phaser.Sprite) This instance.

damage(amount)

Damages the Sprite, this removes the given amount from the Sprites health property. If health is then taken below zero Sprite.kill is called.

Parameters:

Name	Type	Description
`amount`	number	The amount to subtract from the Sprite.health value.

Inherited From:

Phaser.Sprite#damage

Source:

gameobjects/Sprite.js, line 871

Returns:

(Phaser.Sprite) This instance.

destroy()

Destroy this Graphics instance.

Inherited From:

Phaser.Sprite#destroy

Source:

gameobjects/Graphics.js, line 36

destroy()

Destroys the Sprite. This removes it from its parent group, destroys the input, event and animation handlers if present and nulls its reference to game, freeing it up for garbage collection.

Inherited From:

Phaser.Sprite#destroy

Source:

gameobjects/Sprite.js, line 834

getLocalPosition(p, x, y, sx, sy) → {Phaser.Point}

Gets the local position of a coordinate relative to the Sprite, factoring in rotation and scale. Mostly only used internally.

Parameters:

Name	Type	Description
`p`	Phaser.Point	The Point object to store the results in.
`x`	number	x coordinate within the Sprite to translate.
`y`	number	x coordinate within the Sprite to translate.
`sx`	number	Scale factor to be applied.
`sy`	number	Scale factor to be applied.

Inherited From:

Phaser.Sprite#getLocalPosition

Source:

gameobjects/Sprite.js, line 608

Returns:

The translated point.

Type: Phaser.Point

getLocalUnmodifiedPosition(p, x, y) → {Phaser.Point}

Gets the local unmodified position of a coordinate relative to the Sprite, factoring in rotation and scale. Mostly only used internally by the Input Manager, but also useful for custom hit detection.

Parameters:

Name	Type	Description
`p`	Phaser.Point	The Point object to store the results in.
`x`	number	x coordinate within the Sprite to translate.
`y`	number	x coordinate within the Sprite to translate.

Inherited From:

Phaser.Sprite#getLocalUnmodifiedPosition

Source:

gameobjects/Sprite.js, line 630

Returns:

The translated point.

Type: Phaser.Point

kill()

Kills a Sprite. A killed Sprite has its alive, exists and visible properties all set to false. It will dispatch the onKilled event, you can listen to Sprite.events.onKilled for the signal. Note that killing a Sprite is a way for you to quickly recycle it in a Sprite pool, it doesn't free it up from memory. If you don't need this Sprite any more you should call Sprite.destroy instead.

Inherited From:

Phaser.Sprite#kill

Source:

gameobjects/Sprite.js, line 809

Returns:

(Phaser.Sprite) This instance.

loadTexture(key, frame)

Changes the Texture the Sprite is using entirely. The old texture is removed and the new one is referenced or fetched from the Cache. This causes a WebGL texture update, so use sparingly or in low-intensity portions of your game.

Parameters:

Name	Type	Description
`key`	string \| Phaser.RenderTexture \| Phaser.BitmapData \| PIXI.Texture	This is the image or texture used by the Sprite during rendering. It can be a string which is a reference to the Cache entry, or an instance of a RenderTexture, BitmapData or PIXI.Texture.
`frame`	string \| number	If this Sprite is using part of a sprite sheet or texture atlas you can specify the exact frame to use by giving a string or numeric index.

Inherited From:

Phaser.Sprite#loadTexture

Source:

gameobjects/Sprite.js, line 704

play(name, frameRate, loop, killOnComplete) → {Phaser.Animation}

Play an animation based on the given key. The animation should previously have been added via sprite.animations.add() If the requested animation is already playing this request will be ignored. If you need to reset an already running animation do so directly on the Animation object itself.

Parameters:

Name	Type	Argument	Default	Description
`name`	string			The name of the animation to be played, e.g. "fire", "walk", "jump".
`frameRate`	number	<optional>	null	The framerate to play the animation at. The speed is given in frames per second. If not provided the previously set frameRate of the Animation is used.
`loop`	boolean	<optional>	false	Should the animation be looped after playback. If not provided the previously set loop value of the Animation is used.
`killOnComplete`	boolean	<optional>	false	If set to true when the animation completes (only happens if loop=false) the parent Sprite will be killed.

Inherited From:

Phaser.Sprite#play

Source:

gameobjects/Sprite.js, line 956

Returns:

A reference to playing Animation instance.

Type: Phaser.Animation

postUpdate()

Internal function called by the World postUpdate cycle.

Inherited From:

Phaser.Sprite#postUpdate

Source:

gameobjects/Sprite.js, line 664

preUpdate()

Automatically called by World.preUpdate. Handles cache updates, lifespan checks, animation updates and physics updates.

Inherited From:

Phaser.Sprite#preUpdate

Source:

gameobjects/Sprite.js, line 382

reset(x, y, health)

Resets the Sprite. This places the Sprite at the given x/y world coordinates and then sets alive, exists, visible and renderable all to true. Also resets the outOfBounds state and health values. If the Sprite has a physics body that too is reset.

Parameters:

Name	Type	Argument	Default	Description
`x`	number			The x coordinate (in world space) to position the Sprite at.
`y`	number			The y coordinate (in world space) to position the Sprite at.
`health`	number	<optional>	1	The health to give the Sprite.

Inherited From:

Phaser.Sprite#reset

Source:

gameobjects/Sprite.js, line 896

Returns:

(Phaser.Sprite) This instance.

resetCrop()

Resets the Sprite.crop value back to the frame dimensions.

Inherited From:

Phaser.Sprite#resetCrop

Source:

gameobjects/Sprite.js, line 650

revive(health)

Brings a 'dead' Sprite back to life, optionally giving it the health value specified. A resurrected Sprite has its alive, exists and visible properties all set to true. It will dispatch the onRevived event, you can listen to Sprite.events.onRevived for the signal.