WebGLRenderer

此组件内部生成一个 canvas 节点。 ::: warning 组件必须赋予其属性 width height,否则无法显示. :::

属性名是否必须默认值含义
widthYes1000渲染器宽
heightYes1000渲染器高
pixelRatioNowindow.devicePixelRatio设备像素比
backgroundColorNo0x000000渲染器背景颜色
backgroundAlphaNo1渲染器背景透明度
renderCallbackNo(detle,time)=>渲染器执行回调后面会采用 其它方式
enableEventNotrue渲染器执行回调后面会采用 其它方式
css2DNofalse开启 dom 支持 SDCSS2DObject 节点
css3DNofalse开启 dom 支持 SDCSS3DObject 节点
parametersNo详见下文

parameters

  • canvas 一个供渲染器绘制其输出的 canvas 它和下面的 domElement 属性对应。 如果没有传这个参数,会创建一个新 canvas
  • context - 可用于将渲染器附加到已有的渲染环境(RenderingContext)中。默认值是 null
  • precision - 着色器精度. 可以是 "highp", "mediump" 或者 "lowp". 如果设备支持,默认为"highp" . 点击 here 查看"应该避免的事"
  • alpha - canvas 是否包含 alpha (透明度)。默认为 false
  • premultipliedAlpha - renderer 是否假设颜色有 premultiplied alpha. 默认为 true
  • antialias - 是否执行抗锯齿。默认为 false.
  • stencil - 绘图缓存是否有一个至少 8 位的模板缓存(stencil buffer)。默认为 true
  • preserveDrawingBuffer -是否保留缓直到手动清除或被覆盖。 默认 false.
  • powerPreference - 提示用户代理怎样的配置更适用于当前 WebGL 环境。 可能是"high-performance", "low-power" 或 "default"。默认是"default". 详见 WebGL spec
  • failIfMajorPerformanceCaveat - 检测渲染器是否会因性能过差而创建失败。默认为 false。详见 WebGL spec for details.
  • depth - 绘图缓存是否有一个至少 6 位的深度缓存(depth buffer )。 默认是 true.
  • logarithmicDepthBuffer - 是否使用对数深度缓存。如果要在单个场景中处理巨大的比例差异,就有必要使用。 Note that this setting uses gl_FragDepth if available which disables the Early Fragment Test optimization and can cause a decrease in performance. 默认是 false。 示例:camera / logarithmicdepthbuffer