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

# [name]

渲染箭头辅助对象 [page:ArrowHelper arrows] 来模拟顶点的法线. 需要定义了法线缓存属性 [page:BufferAttribute custom attribute] 或 使用了 [page:BufferGeometry.computeVertexNormals computeVertexNormals] 方法计算了顶点法线.

## 进口

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

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

## 代码示例

`const geometry = new THREE.BoxGeometry( 10, 10, 10, 2, 2, 2 ); const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } ); const box = new THREE.Mesh( geometry, material ); const helper = new VertexNormalsHelper( box, 2, 0x00ff00, 1 ); scene.add( box ); scene.add( helper );`

## 例子

[example:webgl_helpers WebGL / helpers]

## 构造函数

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

[page:Object3D object] -- 要渲染顶点法线辅助的对象.
[page:Number size] -- (可选的) 箭头的长度. 默认为 1.
[page:Hex color] -- 16进制颜色值. 默认为 0xff0000.
[page:Number linewidth] -- (可选的) 箭头线段的宽度. 默认为 1.

## 属性

请到基类 [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]()

基于对象的运动更新顶点法线辅助对象.

## 源码

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