即时渲染对象([name])

This experimental class provides a fast code path for rendering meshes with frequently updated geometry data. When the renderer encounters an instance of [name], it only takes care about the most primitive rendering operations (e.g. binding vertex attributes, determining correct shader program or perfoming the actual draw call). Features like view frustum culling, wireframe rendering or using multiple materials are not supported. Besides [name] can only be used to render triangles.

[name] does not work with instances of [page:BufferGeometry]. The raw geometry data have to be maintained as properties of the [name].

Using [name] makes only sense if you are updating your geometry data per frame. You can then benefit of a faster code path compared to the default mesh redering logic.

例子

[example:webgl_marchingcubes Marching Cubes]

构造函数(Constructor)

[name]( [param:Material material] )

[page:Material material] — The material of the [name].

Properties

See the base [page:Object3D] class for common properties.

[property:Boolean material]

The material of the [name]. Assigning multiple materials is not supported.

[property:Boolean hasPositions]

Whether position data are defined or not. Default is *false*.

[property:Boolean hasNormals]

Whether normal data are defined or not. Default is *false*.

[property:Boolean hasColors]

Whether color data are defined or not. Default is *false*.

[property:Boolean hasUvs]

Whether texture coordinates are defined or not. Default is *false*.

[property:Float32Array positionArray]

The buffer holding position data. Default is *null*.

[property:Float32Array normalArray]

The buffer holding normal data. Default is *null*.

[property:Float32Array colorArray]

The buffer holding color data. Default is *null*.

[property:Float32Array uvArray]

The buffer holding texture coordinates. Default is *null*.

[property:Integer count]

The number of primitives to be rendered. Default is *0*. This property will be set to *0* after each rendering so you usually set it in the implementatio of [page:.render]().

方法(Methods)

See the base [page:Object3D] class for common methods.

[method:null render]([param:Function renderCallback])

renderCallback -- A function to render the generated geometry data.

This method needs to be implemented by the deriving class of [name]. You normally want to implement the vertex buffer update logic and execute *renderCallback* at the end of your implementation.

源码(Source)

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]