Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Doc/zh]: Improve Chinese translation. #30205

Merged
merged 1 commit into from
Dec 26, 2024
Merged

[Doc/zh]: Improve Chinese translation. #30205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 15 additions & 5 deletions docs/api/zh/core/BufferAttribute.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,9 @@ <h3>[property:Integer count]</h3>

<h3>[property:Number gpuType]</h3>
<p>
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]。
</p>

<h3>[property:Boolean isBufferAttribute]</h3>
Expand Down Expand Up @@ -123,6 +123,16 @@ <h3>[method:this applyNormalMatrix]( [param:Matrix3 m] )</h3>

<h3>[method:this transformDirection]( [param:Matrix4 m] )</h3>
<p>将矩阵[page:Matrix4 m]应用到此BufferAttribute的每一个Vector3元素中，并将所有元素解释为方向向量。</p>

<h3>[method:this addUpdateRange]( [param:Integer start], [param:Integer count] )</h3>
<p>
在数据数组中添加要在 GPU 上更新的数据范围。将描述范围的对象添加到 [page:BufferAttribute.updateRanges updateRanges] 数组。
</p>

<h3>[method:this clearUpdateRanges]()</h3>
<p>
清除 [page:BufferAttribute.updateRanges updateRanges] 数组。
</p>

<h3>[method:BufferAttribute clone]() </h3>
<p>返回该 BufferAttribute 的拷贝。</p>
Expand All @@ -136,7 +146,7 @@ <h3>[method:this copyAt] ( [param:Integer index1], [param:BufferAttribute buffer
<p>将一个矢量从 bufferAttribute[index2] 拷贝到 [page:BufferAttribute.array array][index1] 中。</p>

<h3>[method:Number getComponent]( [param:Integer index], [param:Integer component] ) </h3>
<p>Returns the given component of the vector at the given index.</p>
<p>返回给定索引处的向量的给定分量。</p>

<h3>[method:Number getX]( [param:Integer index] ) </h3>
<p>获取给定索引的矢量的第一维元素 （即 X 值）。</p>
Expand Down Expand Up @@ -167,10 +177,10 @@ <h3>[method:this set] ( [param:Array value], [param:Integer offset] ) </h3>
</p>

<h3>[method:this setUsage] ( [param:Usage value] ) </h3>
<p>Set [page:BufferAttribute.usage usage] to value. See usage [page:BufferAttributeUsage constants] for all possible input values.</p>
<p>设置 [page:BufferAttribute.usage usage] 值。查看所有可能的输入值的 usage [page:BufferAttributeUsage constants]。</p>

<h3>[method:Number setComponent]( [param:Integer index], [param:Integer component], [param:Float value] ) </h3>
<p>Sets the given component of the vector at the given index.</p>
<p>在给定索引处设置向量的给定分量。</p>

<h3>[method:this setX]( [param:Integer index], [param:Float x] ) </h3>
<p>设置给定索引的矢量的第一维数据（设置 X 值）。</p>
Expand Down
85 changes: 56 additions & 29 deletions docs/api/zh/core/BufferGeometry.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,30 @@ <h2>代码示例</h2>
const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } );
const mesh = new THREE.Mesh( geometry, material );
</code>

<h2>代码示例 (索引Index)</h2>

<code>
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 );
</code>

<h2>例子</h2>
<p>
Expand Down Expand Up @@ -82,6 +106,8 @@ <h3>[property:Object drawRange]</h3>
<code>
{ start: 0, count: Infinity }
</code>
对于非索引 BufferGeometry，count 是要渲染的顶点数。
对于索引 BufferGeometry，count 是要渲染的索引数。
</p>

<h3>[property:Array groups]</h3>
Expand All @@ -94,8 +120,8 @@ <h3>[property:Array groups]</h3>
start 表明当前 draw call 中的没有索引的几何体的几何体的第一个顶点；或者第一个三角面片的索引。
count 指明当前分割包含多少顶点（或 indices）。
materialIndex 指出当前用到的材质队列的索引。<br /><br />

通过 [page:.addGroup] 来增加组，而不是直接更改当前队列。
通过 [page:.addGroup] 来增加组，而不是直接更改当前队列。<br /><br />
每个顶点和索引必须恰好属于一个组，不同组之间不得共享顶点或索引，并且不得留下未使用的顶点或索引。
</p>


Expand Down Expand Up @@ -159,54 +185,52 @@ <h2>方法</h2>

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

<h3>[method:this setAttribute]( [param:String name], [param:BufferAttribute attribute] )</h3>
<p>
为当前几何体设置一个 attribute 属性。在类的内部，有一个存储 [page:.attributes] 的 hashmap，
通过该 hashmap，遍历 attributes 的速度会更快。而使用该方法，可以向 hashmap 内部增加 attribute。
所以，你需要使用该方法来添加 attributes。
</p>

<h3>[method:undefined addGroup]( [param:Integer start], [param:Integer count], [param:Integer materialIndex] )</h3>
<p>
为当前几何体增加一个 group，详见 [page:BufferGeometry.groups groups] 属性。
</p>


<h3>[method:this applyMatrix4]( [param:Matrix4 matrix] )</h3>
<p> 用给定矩阵转换几何体的顶点坐标。</p>

<h3>[method:this applyQuaternion]( [param:Quaternion quaternion] )</h3>
<p>用给四元数表示的旋转应用于几何体的顶点坐标。</p>

<h3>[method:this center] ()</h3>
<p>根据边界矩形将几何体居中。</p>

<h3>[method:undefined clearGroups]( )</h3>
<p>清空所有的 groups。</p>

<h3>[method:BufferGeometry clone]()</h3>
<p>克隆当前的 BufferGeometry。</p>

<h3>[method:this copy]( [param:BufferGeometry bufferGeometry] )</h3>
<p>将参数指定的 BufferGeometry 的值拷贝到当前 BufferGeometry 中。</p>

<h3>[method:undefined clearGroups]( )</h3>
<p>清空所有的 groups。</p>

<h3>[method:undefined computeBoundingBox]()</h3>
<p>
计算当前几何体的的边界矩形，该操作会更新已有 [param:.boundingBox]。<br />
计算当前几何体的的边界矩形，该操作会更新已有 [page:.boundingBox]。<br />
边界矩形不会默认计算，需要调用该接口指定计算边界矩形，否则保持默认值 *null*。
</p>

<h3>[method:undefined computeBoundingSphere]()</h3>
<p>
计算当前几何体的的边界球形，该操作会更新已有 [param:.boundingSphere]。<br />
计算当前几何体的的边界球形，该操作会更新已有 [page:.boundingSphere]。<br />
边界球形不会默认计算，需要调用该接口指定计算边界球形，否则保持默认值 *null*。
</p>

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

<h3>[method:undefined computeVertexNormals]()</h3>
<p>通过面片法向量的平均值计算每个顶点的法向量。</p>
<p>通过面片法向量的平均值计算每个顶点的法向量。对于索引几何体，该方法将每个顶点法线设置为共享该顶点的面的面法线的平均值。对于非索引几何体，顶点不共享，该方法将每个顶点法线设置为与面法线相同。</p>

<h3>[method:this copy]( [param:BufferGeometry bufferGeometry] )</h3>
<p>将参数指定的 BufferGeometry 的值拷贝到当前 BufferGeometry 中。</p>

<h3>[method:BufferAttribute deleteAttribute]( [param:String name] )</h3>
<p>删除具有指定名称的 [page:BufferAttribute attribute]。</p>

<h3>[method:undefined dispose]()</h3>
<p>
Expand Down Expand Up @@ -235,9 +259,6 @@ <h3>[method:undefined normalizeNormals]()</h3>
几何体中的每个法向量长度将会为 1。这样操作会更正光线在表面的效果。
</p>

<h3>[method:BufferAttribute deleteAttribute]( [param:String name] )</h3>
<p>删除具有指定名称的 [page:BufferAttribute attribute]。</p>

<h3>[method:this rotateX] ( [param:Float radians] )</h3>
<p>
在 X 轴上旋转几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.rotation] 实时旋转几何体。
Expand All @@ -258,24 +279,30 @@ <h3>[method:this scale] ( [param:Float x], [param:Float y], [param:Float z] )</h
缩放几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.scale] 实时旋转几何体。
</p>

<h3>[method:this setIndex] ( [param:BufferAttribute index] )</h3>
<p>设置缓存的 [page:.index]。</p>
<h3>[method:this setAttribute]( [param:String name], [param:BufferAttribute attribute] )</h3>
<p>
为当前几何体设置一个 attribute 属性。在类的内部，有一个存储 [page:.attributes] 的 hashmap，
通过该 hashmap，遍历 attributes 的速度会更快。
</p>

<h3>[method:undefined setDrawRange] ( [param:Integer start], [param:Integer count] )</h3>
<p>设置缓存的 [page:.drawRange]。详见相关属性说明。</p>
<p>设置 [page:.drawRange] 属性。对于非索引 BufferGeometry，count 是要渲染的顶点数。对于索引 BufferGeometry，count 是要渲染的索引数。</p>

<h3>[method:this setFromPoints] ( [param:Array points] )</h3>
<p>通过点队列设置该 BufferGeometry 的 attribute。</p>
<p>通过基于给定的 points 设置几何图形的位置属性。该数组可以保存 Vector2 或 Vector3 的实例。使用二维数据时，所有顶点的 z 坐标均设置为 0。如果该方法与现有位置属性一起使用，则顶点数据将被数组中的数据覆盖。数组的长度必须与顶点数匹配。</p>

<h3>[method:this setIndex] ( [param:BufferAttribute index] )</h3>
<p>设置缓存的 [page:.index]。</p>

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

<h3>[method:BufferGeometry toNonIndexed]()</h3>
<p>返回已索引的 BufferGeometry 的非索引版本。</p>

<h3>[method:this translate] ( [param:Float x], [param:Float y], [param:Float z] )</h3>
<p>
移动几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.rotation] 实时旋转几何体。
移动几何体。该操作一般在一次处理中完成，不会循环处理。典型的用法是通过调用 [page:Object3D.position] 实时移动几何体。
</p>

<h2>Source</h2>
Expand Down
Loading