API Docs for: 1.3.0
Show:

WebGLBatch Class

A WebGLBatch Enables a group of sprites to be drawn using the same settings. if a group of sprites all have the same baseTexture and blendMode then they can be grouped into a batch. All the sprites in a batch can then be drawn in one go by the GPU which is hugely efficient. ALL sprites in the webGL renderer are added to a batch even if the batch only contains one sprite. Batching is handled automatically by the webGL renderer. A good tip is: the smaller the number of batchs there are, the faster the webGL renderer will run.

Constructor

WebGLBatch

(
  • gl
)

Parameters:

  • gl WebGLContext

    an instance of the webGL context

Methods

addDisplayObjectAndChildren

(
  • displayObject
)
private

Adds a display object and children to the webgl context

Parameters:

addFilterBlocks

(
  • start
  • end
)
private

Adds filter blocks

Parameters:

  • start FilterBlock
  • end FilterBlock

clean

()

Cleans the batch so that is can be returned to an object pool and reused

growBatch

()

Grows the size of the batch. As the elements in the batch cannot have a dynamic size this function is used to increase the size of the batch. It also creates a little extra room so that the batch does not need to be resized every time a sprite is added

init

(
  • sprite
)

inits the batch's texture and blend mode based if the supplied sprite

Parameters:

  • sprite Sprite

    the first sprite to be added to the batch. Only sprites with the same base texture and blend mode will be allowed to be added to this batch

initStrip

(
  • strip
)
private

Initializes a strip to be rendered

Parameters:

  • strip Strip

    The strip to initialize

initTilingSprite

(
  • sprite
)
private

Initializes a tiling sprite

Parameters:

insertAfter

(
  • item
  • displayObject
)
private

Inserts a displayObject into the linked list

Parameters:

insertAfter

(
  • sprite
  • previousSprite
)

inserts a sprite after the specified sprite

Parameters:

  • sprite Sprite

    the sprite to be added

  • previousSprite Sprite

    the first sprite will be inserted after this sprite

insertBefore

(
  • sprite
  • nextSprite
)

inserts a sprite before the specified sprite

Parameters:

  • sprite Sprite

    the sprite to be added

  • nextSprite NextSprite

    the first sprite will be inserted before this sprite

insertObject

(
  • displayObject
  • previousObject
  • nextObject
)
private

Inserts a displayObject into the linked list

Parameters:

merge

(
  • batch
)

Merges two batchs together

Parameters:

refresh

()

Refresh's all the data in the batch and sync's it with the webGL buffers

remove

(
  • sprite
)

removes a sprite from the batch

Parameters:

  • sprite Sprite

    the sprite to be removed

removeDisplayObjectAndChildren

(
  • displayObject
)
private

Removes a display object and children to the webgl context

Parameters:

removeFilterBlocks

(
  • start
  • end
)
private

Remove filter blocks

Parameters:

  • start FilterBlock
  • end FilterBlock

removeObject

(
  • displayObject
)
private

Removes a displayObject from the linked list

Parameters:

render

()

Draws the batch to the frame buffer

render

(
  • projection
)

Renders the stage to its webgl view

Parameters:

  • projection Object

renderSpecial

(
  • renderable
  • projection
)
private

Renders a specific renderable

Parameters:

renderSpecific

(
  • displayObject
  • projection
)
private

Renders a specific displayObject

Parameters:

renderStrip

(
  • strip
  • projection
)
private

Renders a Strip

Parameters:

  • strip Strip

    The strip to render

  • projection Object

renderTilingSprite

(
  • sprite
  • projectionMatrix
)
private

Renders a TilingSprite

Parameters:

  • sprite TilingSprite

    The tiling sprite to render

  • projectionMatrix Object

restoreLostContext

(
  • gl
)

Recreates the buffers in the event of a context loss

Parameters:

  • gl WebGLContext

setRenderable

(
  • displayObject
)
private

Add a display object to the webgl renderer

Parameters:

split

(
  • sprite
)
WebGLBatch

Splits the batch into two with the specified sprite being the start of the new batch.

Parameters:

  • sprite Sprite

    the sprite that indicates where the batch should be split

Returns:

WebGLBatch:

the new batch

update

()

Updates all the relevant geometry and uploads the data to the GPU

updateTexture

(
  • displayObject
)
private

Updates a webgl texture

Parameters: