[page:Object3D] → [page:Line] → [page:LineSegments] →

# 顶点切线辅助对象([name])

可视化对象的顶点切线。要求已在 [page:BufferAttribute custom attribute] 中指定切线或已使用 [page:BufferGeometry.computeTangents computeTangents] 计算切线。

## 引入

[name] 是一个附加组件，必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons].

`import { VertexTangentsHelper } from 'three/addons/helpers/VertexTangentsHelper.js';`

## 代码示例

`const geometry = new THREE.BoxGeometry( 10, 10, 10, 2, 2, 2 ); const material = new THREE.MeshStandardMaterial(); const mesh = new THREE.Mesh( geometry, material ); const helper = new VertexTangentsHelper( mesh, 1, 0x00ffff ); scene.add( mesh ); scene.add( helper );`

## 例子

[example:webgl_helpers WebGL / helpers]

## 构造函数

### [name]( [param:Object3D object], [param:Number size], [param:Hex color] )

[page:Object3D object] -- 要为其渲染顶点切线的对象。
[page:Number size] -- （可选）箭头的长度。默认值为 *1*。
[page:Hex color] --（可选）箭头的十六进制颜色。默认值为 *0x00ffff*。

## 属性

有关常见属性，请参阅 [page:LineSegments] 基类。

### [property:Object matrixAutoUpdate]

请参阅 [page:Object3D.matrixAutoUpdate]。默认设置为 `false`，因为正在使用对象的 [page:Object3D.matrixWorld matrixWorld]。

### [property:Object3D object]

对其顶点切线进行可视化的对象。

### [property:Number size]

箭头的长度。默认值为 *1*。

## 方法

有关常用方法，请参阅 [page:LineSegments] 基类。

### [method:undefined update]()

根据对象的世界变换更新顶点切线预览。

### [method:undefined dispose]()

释放该实例分配的GPU相关资源。每当您的应用程序中不再使用此实例时，请调用此方法。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/helpers/VertexTangentsHelper.js examples/jsm/helpers/VertexTangentsHelper.js]