From 574e954b3cc8a407527c794cbab9cca3524c0c92 Mon Sep 17 00:00:00 2001 From: puxiao Date: Thu, 26 Dec 2024 17:25:27 +0800 Subject: [PATCH] [Doc/zh]: Improve Chinese translation. (#30205) --- docs/api/zh/core/BufferAttribute.html | 20 +++++-- docs/api/zh/core/BufferGeometry.html | 85 ++++++++++++++++++--------- 2 files changed, 71 insertions(+), 34 deletions(-) diff --git a/docs/api/zh/core/BufferAttribute.html b/docs/api/zh/core/BufferAttribute.html index c2ef4b2a35c57d..940681ab7c1f46 100644 --- a/docs/api/zh/core/BufferAttribute.html +++ b/docs/api/zh/core/BufferAttribute.html @@ -58,9 +58,9 @@

[property:Integer count]

[property:Number gpuType]

- Configures the bound GPU type for use in shaders. Either [page:BufferAttribute THREE.FloatType] or [page:BufferAttribute THREE.IntType], default is [page:BufferAttribute THREE.FloatType]. + 配置着色器中使用的绑定 GPU 类型。[page:BufferAttribute THREE.FloatType] 或 [page:BufferAttribute THREE.IntType]，默认为 [page:BufferAttribute THREE.FloatType]。 - Note: this only has an effect for integer arrays and is not configurable for float arrays. For lower precision float types, see [page:BufferAttributeTypes THREE.Float16BufferAttribute]. + 注意：这仅对整数数组有效，对于浮点数组不可配置。对于精度较低的浮点类型，请参阅 [page:BufferAttributeTypes THREE.Float16BufferAttribute]。

[property:Boolean isBufferAttribute]

@@ -123,6 +123,16 @@

[method:this applyNormalMatrix]( [param:Matrix3 m] )

[method:this transformDirection]( [param:Matrix4 m] )

将矩阵[page:Matrix4 m]应用到此BufferAttribute的每一个Vector3元素中，并将所有元素解释为方向向量。

+ +

[method:this addUpdateRange]( [param:Integer start], [param:Integer count] )

+

+ 在数据数组中添加要在 GPU 上更新的数据范围。将描述范围的对象添加到 [page:BufferAttribute.updateRanges updateRanges] 数组。 +

+ +

[method:this clearUpdateRanges]()

+

+ 清除 [page:BufferAttribute.updateRanges updateRanges] 数组。 +

[method:BufferAttribute clone]()

返回该 BufferAttribute 的拷贝。

@@ -136,7 +146,7 @@

[method:this copyAt] ( [param:Integer index1], [param:BufferAttribute buffer

将一个矢量从 bufferAttribute[index2] 拷贝到 [page:BufferAttribute.array array][index1] 中。

[method:Number getComponent]( [param:Integer index], [param:Integer component] )

-

Returns the given component of the vector at the given index.

+

返回给定索引处的向量的给定分量。

[method:Number getX]( [param:Integer index] )

获取给定索引的矢量的第一维元素 （即 X 值）。

@@ -167,10 +177,10 @@

[method:this set] ( [param:Array value], [param:Integer offset] )

[method:this setUsage] ( [param:Usage value] )

-

Set [page:BufferAttribute.usage usage] to value. See usage [page:BufferAttributeUsage constants] for all possible input values.

+

设置 [page:BufferAttribute.usage usage] 值。查看所有可能的输入值的 usage [page:BufferAttributeUsage constants]。

[method:Number setComponent]( [param:Integer index], [param:Integer component], [param:Float value] )

-

Sets the given component of the vector at the given index.

+

在给定索引处设置向量的给定分量。

[method:this setX]( [param:Integer index], [param:Float x] )

设置给定索引的矢量的第一维数据（设置 X 值）。

diff --git a/docs/api/zh/core/BufferGeometry.html b/docs/api/zh/core/BufferGeometry.html index a6142f561ccc53..dd33f59c74f34b 100644 --- a/docs/api/zh/core/BufferGeometry.html +++ b/docs/api/zh/core/BufferGeometry.html @@ -37,6 +37,30 @@

代码示例

const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } ); const mesh = new THREE.Mesh( geometry, material ); + +

代码示例 (索引Index)

+ + + const geometry = new THREE.BufferGeometry(); + + const vertices = new Float32Array( [ + -1.0, -1.0, 1.0, // v0 + 1.0, -1.0, 1.0, // v1 + 1.0, 1.0, 1.0, // v2 + -1.0, 1.0, 1.0, // v3 + ] ); + + const indices = [ + 0, 1, 2, + 2, 3, 0, + ]; + + geometry.setIndex( indices ); + geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) ); + + const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } ); + const mesh = new THREE.Mesh( geometry, material ); +

例子

@@ -82,6 +106,8 @@

[property:Object drawRange]

{ start: 0, count: Infinity } + 对于非索引 BufferGeometry，count 是要渲染的顶点数。 + 对于索引 BufferGeometry，count 是要渲染的索引数。

[property:Array groups]

@@ -94,8 +120,8 @@

[property:Array groups]

start 表明当前 draw call 中的没有索引的几何体的几何体的第一个顶点；或者第一个三角面片的索引。 count 指明当前分割包含多少顶点（或 indices）。 materialIndex 指出当前用到的材质队列的索引。

- - 通过 [page:.addGroup] 来增加组，而不是直接更改当前队列。 + 通过 [page:.addGroup] 来增加组，而不是直接更改当前队列。

+ 每个顶点和索引必须恰好属于一个组，不同组之间不得共享顶点或索引，并且不得留下未使用的顶点或索引。

@@ -159,54 +185,52 @@

方法

[page:EventDispatcher EventDispatcher] 在该类上可用的所有方法。

-

[method:this setAttribute]( [param:String name], [param:BufferAttribute attribute] )

-

- 为当前几何体设置一个 attribute 属性。在类的内部，有一个存储 [page:.attributes] 的 hashmap， - 通过该 hashmap，遍历 attributes 的速度会更快。而使用该方法，可以向 hashmap 内部增加 attribute。 - 所以，你需要使用该方法来添加 attributes。 -

-

[method:undefined addGroup]( [param:Integer start], [param:Integer count], [param:Integer materialIndex] )

为当前几何体增加一个 group，详见 [page:BufferGeometry.groups groups] 属性。

-

[method:this applyMatrix4]( [param:Matrix4 matrix] )

用给定矩阵转换几何体的顶点坐标。

+

[method:this applyQuaternion]( [param:Quaternion quaternion] )

+

用给四元数表示的旋转应用于几何体的顶点坐标。

+

[method:this center] ()

根据边界矩形将几何体居中。

+ +

[method:undefined clearGroups]( )

+

清空所有的 groups。

[method:BufferGeometry clone]()

克隆当前的 BufferGeometry。

-

[method:this copy]( [param:BufferGeometry bufferGeometry] )

-

将参数指定的 BufferGeometry 的值拷贝到当前 BufferGeometry 中。

- -

[method:undefined clearGroups]( )

-

清空所有的 groups。

-

[method:undefined computeBoundingBox]()

- 计算当前几何体的的边界矩形，该操作会更新已有 [param:.boundingBox]。
+ 计算当前几何体的的边界矩形，该操作会更新已有 [page:.boundingBox]。
边界矩形不会默认计算，需要调用该接口指定计算边界矩形，否则保持默认值 *null*。

[method:undefined computeBoundingSphere]()

- 计算当前几何体的的边界球形，该操作会更新已有 [param:.boundingSphere]。
+ 计算当前几何体的的边界球形，该操作会更新已有 [page:.boundingSphere]。
边界球形不会默认计算，需要调用该接口指定计算边界球形，否则保持默认值 *null*。

[method:undefined computeTangents]()

计算并向此geometry中添加tangent attribute。
- 只支持索引化的几何体对象，并且必须拥有position(位置)，normal(法向)和 uv attributes。如果使用了切线空间法向贴图，最好使用[page:BufferGeometryUtils.computeMikkTSpaceTangents]中的MikkTSpace算法。 + 只支持索引化的几何体对象，并且必须拥有position(位置)，normal(法向)和 uv attributes。如果使用了切线空间法向贴图，最好使用 [page:BufferGeometryUtils.computeMikkTSpaceTangents] 中的MikkTSpace算法。

[method:undefined computeVertexNormals]()

-

通过面片法向量的平均值计算每个顶点的法向量。

+

通过面片法向量的平均值计算每个顶点的法向量。对于索引几何体，该方法将每个顶点法线设置为共享该顶点的面的面法线的平均值。对于非索引几何体，顶点不共享，该方法将每个顶点法线设置为与面法线相同。

+ +

[method:this copy]( [param:BufferGeometry bufferGeometry] )

+

将参数指定的 BufferGeometry 的值拷贝到当前 BufferGeometry 中。

+ +

[method:BufferAttribute deleteAttribute]( [param:String name] )

+

删除具有指定名称的 [page:BufferAttribute attribute]。

[method:undefined dispose]()

@@ -235,9 +259,6 @@

[method:undefined normalizeNormals]()

几何体中的每个法向量长度将会为 1。这样操作会更正光线在表面的效果。

-

[method:BufferAttribute deleteAttribute]( [param:String name] )

-

删除具有指定名称的 [page:BufferAttribute attribute]。

-

[method:this rotateX] ( [param:Float radians] )

在 X 轴上旋转几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.rotation] 实时旋转几何体。 @@ -258,24 +279,30 @@

[method:this scale] ( [param:Float x], [param:Float y], [param:Float z] ) -

[method:this setIndex] ( [param:BufferAttribute index] )

-

设置缓存的 [page:.index]。

+

[method:this setAttribute]( [param:String name], [param:BufferAttribute attribute] )

+

+ 为当前几何体设置一个 attribute 属性。在类的内部，有一个存储 [page:.attributes] 的 hashmap， + 通过该 hashmap，遍历 attributes 的速度会更快。 +

[method:undefined setDrawRange] ( [param:Integer start], [param:Integer count] )

-

设置缓存的 [page:.drawRange]。详见相关属性说明。

+

设置 [page:.drawRange] 属性。对于非索引 BufferGeometry，count 是要渲染的顶点数。对于索引 BufferGeometry，count 是要渲染的索引数。

[method:this setFromPoints] ( [param:Array points] )

-

通过点队列设置该 BufferGeometry 的 attribute。

+

通过基于给定的 points 设置几何图形的位置属性。该数组可以保存 Vector2 或 Vector3 的实例。使用二维数据时，所有顶点的 z 坐标均设置为 0。如果该方法与现有位置属性一起使用，则顶点数据将被数组中的数据覆盖。数组的长度必须与顶点数匹配。

+ +

[method:this setIndex] ( [param:BufferAttribute index] )

+

设置缓存的 [page:.index]。

[method:Object toJSON]()

-

返回代表该 BufferGeometry 的 JSON 对象。

+

返回代表该 BufferGeometry 符合 [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 Object/Scene 规范] 的 JSON 对象。

[method:BufferGeometry toNonIndexed]()

返回已索引的 BufferGeometry 的非索引版本。

[method:this translate] ( [param:Float x], [param:Float y], [param:Float z] )

- 移动几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.rotation] 实时旋转几何体。 + 移动几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.position] 实时移动几何体。

Source