new CanvasRenderer(width, height, options)
The CanvasRenderer draws the Stage and all its content onto a 2d canvas. This renderer should be used for browsers that do not support webGL. Don't forget to add the CanvasRenderer.view to your DOM or you will not see anything :)
Parameters
| Name | Type | Argument | Default | Description |
|---|---|---|---|---|
width |
Number |
<optional> |
800 | the width of the canvas view |
height |
Number |
<optional> |
600 | the height of the canvas view |
options |
Object |
<optional> |
The optional renderer parameters |
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 5)
Public Properties
-
autoResize : boolean
-
Whether the render view should be resized automatically
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 75)
-
CanvasMaskManager : PIXI.CanvasMaskManager
-
Instance of a PIXI.CanvasMaskManager, handles masking when using the canvas renderer
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 138)
-
clearBeforeRender : boolean
-
This sets if the CanvasRenderer will clear the canvas or not before the new render pass. If the Stage is NOT transparent Pixi will use a canvas sized fillRect operation every frame to set the canvas background color. If the Stage is transparent Pixi will use clearRect to clear the canvas every frame. Disable this by setting this to false. For example if your game has a canvas filling background image you often don't need this set.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 55)
-
context :CanvasRenderingContext2D
-
The canvas 2d context that everything is drawn with
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 112)
-
count : number
-
Internal var.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 130)
-
height : number
-
The height of the canvas view
- Default Value
- 600
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 92)
-
refresh : boolean
-
Boolean flag controlling canvas refresh.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 119)
-
renderSession : Object
-
The render session is just a bunch of parameter used for rendering
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 145)
-
resolution : number
-
The resolution of the canvas.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 47)
-
transparent : boolean
-
Whether the render view is transparent
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 67)
-
type : number
-
The renderer type.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 39)
-
view :HTMLCanvasElement
-
The canvas element that everything is drawn to.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 104)
-
width : number
-
The width of the canvas view
- Default Value
- 800
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 83)
Public Methods
-
destroy(removeView)
-
Removes everything from the renderer and optionally removes the Canvas DOM element.
Parameters
Name Type Argument Default Description removeViewBoolean <optional>
true Removes the Canvas element from the DOM.
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 221)
-
render(stage)
-
Renders the Stage to this canvas view
Parameters
Name Type Description stagePIXI.Stage the Stage element to be rendered
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 181)
-
resize(width, height)
-
Resizes the canvas view to the specified width and height
Parameters
Name Type Description widthNumber the new width of the canvas view
heightNumber the new height of the canvas view
- Source code: pixi/renderers/canvas/CanvasRenderer.js (Line 243)