API Docs for: 2.2.1
Show:

RenderTexture Class

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

Constructor

RenderTexture

(
  • [width]
  • [height]
  • [renderer]
  • [scaleMode]
  • [resolution]
)

Parameters:

  • [width] Float optional

    The width of the render texture

  • [height] Float optional

    The height of the render texture

  • [renderer] CanvasRenderer | WebGLRenderer optional

    The renderer used for this RenderTexture

  • [scaleMode] Int optional

    Should be one of the PIXI.scaleMode consts

  • [resolution] Float optional

    The resolution of the texture being generated

Methods

clear

()

Clears the RenderTexture.

destroy

(
  • destroyBase
)

Destroys this texture

Parameters:

  • destroyBase Bool

    Whether to destroy the base texture as well

emit

(
  • eventName
  • data
)
Bool

Emit an event to all registered event listeners.

Parameters:

  • eventName String

    The name of the event.

  • data Dynamic

Returns:

Bool:

Indication if we've emitted an event.

getBase64

() String

Will return a 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.

getCanvas

() CanvasElement

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

Returns:

CanvasElement:

A Canvas element with the texture rendered on.

getImage

() HTMLImage

Will return a HTML Image of the texture

Returns:

HTMLImage:

listeners

(
  • eventName
)
Array

Return a list of assigned event listeners.

Parameters:

  • eventName String

    The events that should be listed.

Returns:

Array:

An array of listener functions

off

(
  • eventName
  • callback
)

Remove event listeners.

Parameters:

  • eventName String

    The event we want to remove.

  • callback Function

    The listener that we need to find.

on

(
  • eventName
  • callback
)

Register a new EventListener for the given event.

Parameters:

  • eventName String

    Name of the event.

  • callback Functon

    Callback function.

once

(
  • eventName
  • callback
)

Add an EventListener that's only called once.

Parameters:

  • eventName String

    Name of the event.

  • callback Function

    Callback function.

removeAllListeners

(
  • eventName
)

Remove all listeners or only the listeners for the specified event.

Parameters:

  • eventName String

    The event you want to remove all listeners for.

renderWebGL/renderCanvas

(
  • displayObject
  • [matrix]
  • [clear]
)

This function will draw the display object to the texture.

Parameters:

  • displayObject DisplayObject

    The display object to render this texture on

  • [matrix] Matrix optional

    Optional matrix to apply to the display object before rendering.

  • [clear] Bool optional

    If true the texture will be cleared before the displayObject is drawn

resize

(
  • width
  • height
  • [updateBase]
)

Resize the RenderTexture.

Parameters:

  • width Float

    The width to resize to.

  • height Float

    The height to resize to.

  • [updateBase] Bool optional

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

setFrame

(
  • frame
)

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

Parameters:

  • frame Rectangle

    The frame of the texture to set it to

Properties

renderer

CanvasRenderer | WebGLRenderer

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

resolution

Number

The Resolution of the texture.