Navigation
These archived docs are for Phaser 2.4.8 Phaser 3 docs can be found on newdocs.phaser.io.
Phaser CE docs can be found on the Phaser CE Documentation site.

Constructor

PIXI. RenderTexture

new RenderTexture(width, height, renderer, scaleMode, resolution)

A RenderTexture is a special texture that allows any Pixi display object to be rendered to it.

Hint: All DisplayObjects (i.e. Sprites) that render to a RenderTexture should be preloaded otherwise black rectangles will be drawn instead.

A RenderTexture takes a snapshot of any Display Object given to its render method. The position and rotation of the given Display Objects is ignored. For example:

var renderTexture = new PIXI.RenderTexture(800, 600); var sprite = PIXI.Sprite.fromImage("spinObj_01.png"); sprite.position.x = 800/2; sprite.position.y = 600/2; sprite.anchor.x = 0.5; sprite.anchor.y = 0.5; renderTexture.render(sprite);

The Sprite in this case will be rendered to a position of 0,0. To render this sprite at its actual position a DisplayObjectContainer should be used:

var doc = new PIXI.DisplayObjectContainer(); doc.addChild(sprite); renderTexture.render(doc); // Renders to center of renderTexture

Parameters
Name Type Description
width Number

The width of the render texture

height Number

The height of the render texture

renderer PIXI.CanvasRenderer | PIXI.WebGLRenderer

The renderer used for this RenderTexture

scaleMode Number

See {{#crossLink "PIXI/scaleModes:property"}}PIXI.scaleModes{{/crossLink}} for possible values

resolution Number

The resolution of the texture being generated

Source code: pixi/textures/RenderTexture.js (Line 5)

Extends

Public Properties

baseTexture : PIXI.BaseTexture

The base texture object that this texture uses

Source code: pixi/textures/RenderTexture.js (Line 78)

crop :Rectangle

This is the area of the BaseTexture image to actually copy to the Canvas / WebGL when rendering, irrespective of the actual frame size or placement (which can be influenced by trimmed texture atlases)

Source code: pixi/textures/RenderTexture.js (Line 69)

frame :Rectangle

The framing rectangle of the render texture

Source code: pixi/textures/RenderTexture.js (Line 61)

height : number

The height of the render texture

Source code: pixi/textures/RenderTexture.js (Line 45)

isTiling : boolean

Is this a tiling texture? As used by the likes of a TilingSprite.

Inherited From
Source code: pixi/textures/Texture.js (Line 84)

noFrame : boolean

Does this Texture have any frame data assigned to it?

Inherited From
Source code: pixi/textures/Texture.js (Line 33)

renderer : PIXI.CanvasRenderer | PIXI.WebGLRenderer

The renderer this RenderTexture uses. A RenderTexture can only belong to one renderer at the moment if its webGL.

Type
Source code: pixi/textures/RenderTexture.js (Line 99)

requiresReTint : boolean

This will let a renderer know that a tinted parent has updated its texture.

Inherited From
Source code: pixi/textures/Texture.js (Line 100)

requiresUpdate : boolean

This will let a renderer know that a texture has been updated (used mainly for webGL uv updates)

Inherited From
Source code: pixi/textures/Texture.js (Line 92)

resolution : number

The Resolution of the texture.

Source code: pixi/textures/RenderTexture.js (Line 53)

trim :Rectangle

The texture trim data.

Inherited From
Source code: pixi/textures/Texture.js (Line 68)

valid : boolean

Source code: pixi/textures/RenderTexture.js (Line 125)

width : number

The with of the render texture

Source code: pixi/textures/RenderTexture.js (Line 37)

Public Methods

clear()

Clears the RenderTexture.

Source code: pixi/textures/RenderTexture.js (Line 175)

destroy(destroyBase)

Destroys this texture

Parameters
Name Type Description
destroyBase Boolean

Whether to destroy the base texture as well

Inherited From
Source code: pixi/textures/Texture.js (Line 170)

getBase64() → {String}

Will return a base64 encoded string of this texture. It works by calling RenderTexture.getCanvas and then running toDataURL on that.

Returns
String -

A base64 encoded string of the texture.

Source code: pixi/textures/RenderTexture.js (Line 309)

getCanvas() → {HTMLCanvasElement}

Creates a Canvas element, renders this RenderTexture to it and then returns it.

Returns
HTMLCanvasElement -

A Canvas element with the texture rendered on.

Source code: pixi/textures/RenderTexture.js (Line 320)

getImage() → {Image}

Will return a HTML Image of the texture

Returns
Image -
Source code: pixi/textures/RenderTexture.js (Line 296)

resize(width, height, updateBase)

Resizes the RenderTexture.

Parameters
Name Type Description
width Number

The width to resize to.

height Number

The height to resize to.

updateBase Boolean

Should the baseTexture.width and height values be resized as well?

Source code: pixi/textures/RenderTexture.js (Line 139)

setFrame(frame)

Specifies the region of the baseTexture that this texture will use.

Parameters
Name Type Description
frame Rectangle

The frame of the texture to set it to

Inherited From
Source code: pixi/textures/Texture.js (Line 183)