Renders arrows to visualize an object's face normals. Requires that face normals have been specified on all faces or calculated with computeFaceNormals.

Note that this only works with the objects whose geometry is an instance of Geometry. For BufferGeometry use a VertexNormalsHelper instead.


WebGL / helpers
geometry = new v3d.BoxGeometry(10, 10, 10, 2, 2, 2); material = new v3d.MeshBasicMaterial({ color: 0xff0000 }); box = new v3d.Mesh(geometry, material); helper = new v3d.FaceNormalsHelper(box, 2, 0x00ff00, 1); scene.add(box); scene.add(helper);


FaceNormalsHelper(object : Object3D, size : Number, color : Color, linewidth : Number)

object -- object for which to render face normals.
size -- (optional) length of the arrows. Default is 1.
color -- (optional) hex color of the arrows. Default is 0xffff00.
linewidth -- (optional) width of the arrow lines. Default is 1.


See the base LineSegments class for common properties.

.matrixAutoUpdate : object

See Object3D.matrixAutoUpdate. Set to false here as the helper is using the objects's matrixWorld.

.object : Object3D

The object for which the face normals are being visualized.

.size : Number

Length of the arrows. Default is 1.


See the base LineSegments class for common methods.

.update () : null

Updates the face normal preview based on movement of the object.


For more info on how to obtain the source code of this module see this page.