Class: WebGLRenderer

Constructor

new WebGLRenderer(context)

Create a WebGL renderer.

Parameters:

Name	Type	Description
`context`	WebGLRenderingContext	The Rendering Context privided by canvas.

Extends

ThinRenderer

Members

capabilities :WebGLCapabilities

An object containing details about the capabilities of the current RenderingContext.

Type:

WebGLCapabilities

Overrides: ThinRenderer#capabilities

context :WebGLRenderingContext|WebGPURenderingContext

The Rendering Context privided by canvas.

Type:

WebGLRenderingContext | WebGPURenderingContext

Overrides: ThinRenderer#context

lightingOptions :object

The lighting options.

Type:

object

Properties

Name Type Description

clustered

object

The clustered lighting options.

Properties

Name	Type	Description
`enabled`	boolean	Whether to use clustered lighting, defaults to false.
`maxClusterLights`	number	The maximum number of lights, defaults to 1024.
`useFloatPrecision`	boolean	Whether the lights are stored as floats, defaults to false (half floats).
`gridDimensions`	Vector3	The number of cells in each dimension, defaults to Vector3(16, 8, 32).
`maxLightsPerCell`	number	The maximum number of lights per cell, defaults to 256.
`zClip`	Vector2	The near and far clipping planes for the cells, defaults to Vector2(-1, -1) (clip based on camera near and far planes).
`version`	number	The version of the clustered lighting options. If the options change, the version should be incremented, defaults to 0.

Overrides: ThinRenderer#lightingOptions

shaderCompileOptions :object

The shader compiler options.

Type:

object

Properties

Name	Type	Description
`checkErrors`	boolean	Whether to use error checking when compiling shaders, defaults to true.
`compileAsynchronously`	boolean	Whether to compile shaders asynchronously, defaults to false.
`maxMaterialPrograms`	number	The maximum number of programs that one material can cache, defaults to 5.

Overrides: ThinRenderer#shaderCompileOptions

Methods

beginQuery(query, target)

Begin a query instance.

Parameters:

Name	Type	Description
`query`	Query
`target`	QUERY_TYPE

Overrides: ThinRenderer#beginQuery

beginRender()

Begin rendering.

Overrides: ThinRenderer#beginRender

blitRenderTarget(read, draw, coloropt, depthopt, stencilopt)

Copy a frame buffer to another. This copy process can be used to perform multi-sampling (MSAA).

Parameters:

Name	Type	Attributes	Default	Description
`read`	RenderTargetBase			The source renderTarget.
`draw`	RenderTargetBase			The destination renderTarget.
`color`	boolean	<optional>	true	Copy color buffer.
`depth`	boolean	<optional>	true	Copy depth buffer.
`stencil`	boolean	<optional>	true	Copy stencil buffer.

Overrides: ThinRenderer#blitRenderTarget

clear(coloropt, depthopt, stencilopt)

Clear the color, depth and stencil buffers.

Parameters:

Name	Type	Attributes	Default	Description
`color`	boolean	<optional>	false	Clear color buffer.
`depth`	boolean	<optional>	false	Clear depth buffer.
`stencil`	boolean	<optional>	false	Clear stencil buffer.

Overrides: ThinRenderer#clear

endQuery(query)

End a query instance.

Parameters:

Name	Type	Description
`query`	Query

Overrides: ThinRenderer#endQuery

endRender()

End rendering.

Overrides: ThinRenderer#endRender

getClearColor() → {Vector4}

Returns a Vector4 instance with the current clear color and alpha. Note: Do not modify the value of Vector4, it is read-only.

Overrides: ThinRenderer#getClearColor

Returns:

Type:: Vector4

getQueryResult(query) → {number}

Get the query result.

Parameters:

Name	Type	Description
`query`	Query

Overrides: ThinRenderer#getQueryResult

Returns:

The query result.

Type:: number

getRenderTarget() → {RenderTargetBase|null}

Returns the current RenderTarget if there are; returns null otherwise.

Overrides: ThinRenderer#getRenderTarget

Returns:

Type:: RenderTargetBase | null

(protected) increaseId() → {number}

Used for context lost and restored.

Overrides: ThinRenderer#increaseId

Returns:

Type:: number

init()

Initialize the renderer. This method will be called automatically by the constructor. In the case of context lost, you can call this function to restart the renderer.

isQueryResultAvailable(query) → {boolean}

Check if the query result is available.

Parameters:

Name	Type	Description
`query`	Query

Overrides: ThinRenderer#isQueryResultAvailable

Returns:

If query result is available.

Type:: boolean

isTimerQueryDisjoint(query) → {boolean}

Returns true if the timer query was disjoint, indicating that timing results are invalid. This is rare and might occur, for example, if the GPU was throttled while timing.

Parameters:

Name	Type	Description
`query`	Query

Overrides: ThinRenderer#isTimerQueryDisjoint

Returns:

Returns true if the timer query was disjoint.

Type:: boolean

queryCounter(query)

Records the current time into the corresponding query object.

Parameters:

Name	Type	Description
`query`	Query

Overrides: ThinRenderer#queryCounter

readTexturePixels(texture, x, y, width, height, buffer, zIndexopt, mipLevelopt) → {Promise.<TypedArray>}

Read pixels from a texture. This is an asynchronous operation. See ThinRenderer#readTexturePixelsSync for the synchronous version.

Parameters:

Name	Type	Attributes	Default	Description
`texture`	TextureBase			The texture to read from.
`x`	number			The x coordinate of the rectangle to read from.
`y`	number			The y coordinate of the rectangle to read from.
`width`	number			The width of the rectangle to read from.
`height`	number			The height of the rectangle to read from.
`buffer`	TypedArray			The buffer to store the pixel data.
`zIndex`	number	<optional>	0	For CubeTexture, the face index; for Texture3D/TextureArray, the layer/slice index.
`mipLevel`	number	<optional>	0	The mip level to read.

Overrides: ThinRenderer#readTexturePixels

Returns:

A promise that resolves with the passed in buffer after it has been filled with the pixel data.

Type:: Promise.<TypedArray>

readTexturePixelsSync(texture, x, y, width, height, buffer, zIndexopt, mipLevelopt) → {TypedArray}

Read pixels from a texture. This is a synchronous operation. See ThinRenderer#readTexturePixels for the asynchronous version.

Parameters:

Name	Type	Attributes	Default	Description
`texture`	TextureBase			The texture to read from.
`x`	number			The x coordinate of the rectangle to read from.
`y`	number			The y coordinate of the rectangle to read from.
`width`	number			The width of the rectangle to read from.
`height`	number			The height of the rectangle to read from.
`buffer`	TypedArray			The buffer to store the pixel data.
`zIndex`	number	<optional>	0	For CubeTexture, the face index; for Texture3D/TextureArray, the layer/slice index.
`mipLevel`	number	<optional>	0	The mip level to read.

Overrides: ThinRenderer#readTexturePixelsSync

Returns:

The passed in buffer after it has been filled with the pixel data.

Type:: TypedArray

renderRenderableItem(renderable, renderStates, optionsopt)

Render a single renderable item with render states.

Parameters:

Name	Type	Attributes	Description
`renderable`	object		The renderable item.
`renderStates`	RenderStates		The render states.
`options`	RenderOptions	<optional>	The render options for this render task.

Overrides: ThinRenderer#renderRenderableItem

renderRenderableList(renderables, renderStates, optionsopt)

Render a single renderable list with render states.

Parameters:

Name	Type	Attributes	Description
`renderables`	Array		Array of renderable.
`renderStates`	RenderStates		Render states.
`options`	RenderOptions	<optional>	The render options for this render task.

Overrides: ThinRenderer#renderRenderableList

renderScene(scene, camera, optionsopt)

Render a scene with a particular camera. This method will render all layers in scene's RenderQueue by default. If you need a customized rendering process, it is recommended to use renderRenderableList method.

Parameters:

Name	Type	Attributes	Description
`scene`	Scene		The scene to render.
`camera`	Camera		The camera used to render the scene.
`options`	RenderOptions	<optional>	The render options for this scene render task.

Overrides: ThinRenderer#renderScene

resetState()

Reset all render states cached in this renderer. This is useful when you use multiple renderers in one application.

Overrides: ThinRenderer#resetState

resetVertexArrayBindings(forceopt)

Reset vertex array object bindings.

Parameters:

Name	Type	Attributes	Default	Description
`force`	boolean	<optional>	false	Whether clear the current vertex array object.

Overrides: ThinRenderer#resetVertexArrayBindings

setBufferExternal(buffer, webglBuffer)

Bind webglBuffer to Buffer.

Parameters:

Name	Type	Description
`buffer`	Buffer
`webglBuffer`	WebGLBuffer

Overrides: ThinRenderer#setBufferExternal

setClearColor(r, g, b, a, premultipliedAlpha)

Set clear color.

Parameters:

Name	Type	Description
`r`	number	Red component in the range 0.0 - 1.0.
`g`	number	Green component in the range 0.0 - 1.0.
`b`	number	Blue component in the range 0.0 - 1.0.
`a`	number	Alpha component in the range 0.0 - 1.0.
`premultipliedAlpha`	number	Whether the alpha is premultiplied.

Overrides: ThinRenderer#setClearColor

setRenderBufferExternal(renderBuffer, webglRenderbuffer)

Bind webglRenderbuffer to RenderBuffer.

Parameters:

Name	Type	Description
`renderBuffer`	RenderBuffer
`webglRenderbuffer`	WebGLRenderbuffer

Overrides: ThinRenderer#setRenderBufferExternal

setRenderTarget(renderTarget)

This method sets the active rendertarget.

Parameters:

Name	Type	Description
`renderTarget`	RenderTargetBase	The renderTarget that needs to be activated.

Overrides: ThinRenderer#setRenderTarget

setTextureExternal(texture, webglTexture)

Bind webglTexture to Texture.

Parameters:

Name	Type	Description
`texture`	TextureBase
`webglTexture`	WebGLTexture

Overrides: ThinRenderer#setTextureExternal

updateRenderTargetMipmap(renderTarget)

Generate mipmaps for the renderTarget you pass in.

Parameters:

Name	Type	Description
`renderTarget`	RenderTargetBase	The renderTarget to update.

Overrides: ThinRenderer#updateRenderTargetMipmap