Class: WebGLRenderer

WebGLRenderer

new WebGLRenderer(params)

renderer/WebGLRenderer.js, line 52

WebGL渲染器

Name Type Description
params Object optional

初始化参数，所有params都会复制到实例上
Fires:
  • event:init 初始化事件
  • event:beforeRender 渲染前事件
  • event:beforeRenderScene 渲染场景前事件
  • event:afterRender 渲染后事件
  • event:initFailed 初始化失败事件
  • event:webglContextLost webglContextLost 事件
  • event:webglContextRestored webglContextRestored 事件

Mixes In

Members Show Inherited

Name Type Default Description
className String WebGLRenderer
isWebGLRenderer Boolean true
gl WebGLRenderingContext null

gl
width Number 0

宽
height Number 0

高
pixelRatio Number 1

像素密度
domElement HTMLCanvasElement null

dom元素
useInstanced Boolean false

是否使用instanced
useVao Boolean true

是否使用VAO
alpha Boolean false

是否开启透明背景
depth Boolean true
stencil Boolean false
antialias Boolean true

是否开启抗锯齿
premultipliedAlpha Boolean true

Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
preserveDrawingBuffer Boolean false

If the value is true the buffers will not be cleared and will preserve their values until cleared or overwritten by the author.
failIfMajorPerformanceCaveat Boolean false

Boolean that indicates if a context will be created if the system performance is low.
gameMode Boolean false

游戏模式, UC浏览器专用
useFramebuffer Boolean false

是否使用framebuffer
framebufferOption Object {}

framebuffer配置
useLogDepth Boolean false

是否使用对数深度
vertexPrecision String highp

顶点着色器精度, 可以是以下值：highp, mediump, lowp
fragmentPrecision String mediump

片段着色器精度, 可以是以下值：highp, mediump, lowp
fog Fog null

雾
offsetX Number 0

偏移值
offsetY Number 0

偏移值
forceMaterial Material null

强制渲染时使用的材质
isInitFailed Boolean false

是否初始化失败
isWebGL2 Boolean false

是否是 WebGL2
preferWebGL2 Boolean false

是否优先使用 WebGL2
clearColor Color new Color(1, 1, 1, 1)

背景色
renderInfo RenderInfo new RenderInfo

渲染信息
renderList RenderList new RenderList

渲染列表
lightManager ILightManager new LightManager

灯光管理器
resourceManager WebGLResourceManager new WebGLResourceManager

资源管理器
isInit Boolean false

是否初始化
state WebGLState null

state，初始化后生成。
framebuffer Framebuffer null

framebuffer，只在 useFramebuffer 为 true 时初始化后生成

Methods Show Inherited

resize(width, height, force)

renderer/WebGLRenderer.js, line 318

改变大小

Name Type Default Description
width Number

宽
height Number

高
force Boolean false optional

是否强制刷新

setOffset(x, y)

renderer/WebGLRenderer.js, line 337

设置viewport偏移值

Name Type Description
x Number

x
y Number

y

viewport(x, y, width, height)

renderer/WebGLRenderer.js, line 351

设置viewport

Name Type Default Description
x Number this.offsetX optional

x
y Number this.offsetY optional

y
width Number this.gl.drawingBufferWidth optional

width
height Number this.gl.drawingBufferHeight optional

height

onInit(){WebGLRenderer}

renderer/WebGLRenderer.js, line 396

初始化回调

Returns:
Type Description
WebGLRenderer this

initContext()

renderer/WebGLRenderer.js, line 408

初始化 context

setupDepthTest(material)

renderer/WebGLRenderer.js, line 532

设置深度检测

Name Type Description
material Material

setupSampleAlphaToCoverage(material)

renderer/WebGLRenderer.js, line 547

设置alphaToCoverage

Name Type Description
material Material

setupCullFace(material)

renderer/WebGLRenderer.js, line 559

设置背面剔除

Name Type Description
material Material

setupBlend(material)

renderer/WebGLRenderer.js, line 573

设置混合

Name Type Description
material Material

setupStencil(material)

renderer/WebGLRenderer.js, line 596

设置模板

Name Type Description
material Material

setupUniforms(program, mesh, force)

renderer/WebGLRenderer.js, line 618

设置通用的 uniform

Name Type Default Description
program Program
mesh Mesh
force Boolean false optional

是否强制更新

setupVao(vao, program, mesh)

renderer/WebGLRenderer.js, line 650

设置vao

Name Type Description
vao VertexArrayObject
program Program
mesh Mesh

setupMaterial(program, mesh)

renderer/WebGLRenderer.js, line 684

设置材质

Name Type Description
program Program
mesh Mesh

setupMesh(mesh, useInstanced){Object}

renderer/WebGLRenderer.js, line 708

设置mesh

Name Type Description
mesh Mesh
useInstanced Boolean
Returns:
Name Type Description
res Object
Name Type Description
res.vao VertexArrayObject
res.program Program
res.geometry Geometry

addRenderInfo(faceCount, drawCount)

renderer/WebGLRenderer.js, line 748

增加渲染信息

Name Type Description
faceCount Number

面数量
drawCount Number

绘图数量

render(stage, camera, fireEvent)

renderer/WebGLRenderer.js, line 760

渲染

Name Type Default Description
stage Stage | Node
camera Camera
fireEvent Boolean false optional

是否发送事件

renderScene()

renderer/WebGLRenderer.js, line 830

渲染场景

clear(clearColor)

renderer/WebGLRenderer.js, line 849

清除背景

Name Type Default Description
clearColor Color this.clearColor optional

clearDepth()

renderer/WebGLRenderer.js, line 872

清除深度

clearStencil()

renderer/WebGLRenderer.js, line 883

清除模板

renderToScreen(framebuffer)

renderer/WebGLRenderer.js, line 895

将framebuffer渲染到屏幕

Name Type Description
framebuffer Framebuffer

renderMesh(mesh)

renderer/WebGLRenderer.js, line 903

渲染一个mesh

Name Type Description
mesh Mesh

renderInstancedMeshes(meshes)

renderer/WebGLRenderer.js, line 912

渲染一组 instanced mesh

Name Type Description
meshes Array.<Mesh>

renderMultipleMeshes(meshes)

renderer/WebGLRenderer.js, line 941

渲染一组普通mesh

Name Type Description
meshes Array.<Mesh>

releaseGLResource()

renderer/WebGLRenderer.js, line 949

销毁 WebGL 资源