diff --git a/docs/api/en/extras/objects/ImmediateRenderObject.html b/docs/api/en/extras/objects/ImmediateRenderObject.html index 820bf80f5a393..f657ab53658d5 100644 --- a/docs/api/en/extras/objects/ImmediateRenderObject.html +++ b/docs/api/en/extras/objects/ImmediateRenderObject.html @@ -12,27 +12,103 @@
base class for immediate rendering objects.
++ 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] or [page:Geometry]. 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] +
- This creates a new [name]. + [page:Material material] — The material of the [name].
+See the base [page:Object3D] class for common properties.
+ ++ The material of the [name]. Assigning multiple materials is not supported. +
+ ++ Whether position data are defined or not. Default is *false*. +
+ ++ Whether normal data are defined or not. Default is *false*. +
+ ++ Whether color data are defined or not. Default is *false*. +
+ ++ Whether texture coordinates are defined or not. Default is *false*. +
+ ++ The buffer holding position data. Default is *null*. +
+ ++ The buffer holding normal data. Default is *null*. +
+ ++ The buffer holding color data. Default is *null*. +
+ ++ The buffer holding texture coordinates. Default is *null*. +
+ ++ 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](). +
See the base [page:Object3D] class for common methods.
- renderCallback -- A function to render the generated object. + renderCallback -- A function to render the generated geometry data.
- This function needs to be overridden to start the creation of the object and should call renderCallback when finished. + 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.
即时渲染对象的基类。
++ 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] or [page:Geometry]. 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] +
+ [page:Material material] — The material of the [name]. +
+ +See the base [page:Object3D] class for common properties.
+ ++ The material of the [name]. Assigning multiple materials is not supported. +
+ ++ Whether position data are defined or not. Default is *false*. +
+ ++ Whether normal data are defined or not. Default is *false*. +
+ ++ Whether color data are defined or not. Default is *false*. +
+ ++ Whether texture coordinates are defined or not. Default is *false*. +
+ ++ The buffer holding position data. Default is *null*. +
+ ++ The buffer holding normal data. Default is *null*. +
-- 这会创建一个新的 [name]。 + The buffer holding color data. Default is *null*.
++ The buffer holding texture coordinates. Default is *null*. +
+ ++ 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](). +
See the base [page:Object3D] class for common methods.
- renderCallback -- 生成对象的渲染函数。 + renderCallback -- A function to render the generated geometry data.
- 需要重写此函数以开始创建对象,并在完成时调用renderCallback。 + 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.