Skip to content

Faces

Supported Datatype

A data type containing six booleans, each representing a face of a BasePart.

Description

The Faces data type contains six booleans representing whether a feature is enabled for each face (NormalId) of a Part. In other words, this contains a boolean for each axes (X/Y/Z) in both directions (positive/negative). The Handles object uses this data type to enable whether a direction has a visible handle on a Part's face.

local handles = Instance.new("Handles")
handles.Faces = Faces.new(Enum.NormalId.Front, Enum.NormalId.Left)

Like most data types on Roblox, the Faces data type is immutable and you cannot assign to its properties once created.

Constructors

new Supported Returns a Faces with the corresponding face of each passed NormalId as true.
Faces.new(normalIds...: Tuple)

Returns a Faces with the corresponding face of each passed NormalId as true.

Creates a new Faces given some number of NormalId as arguments. Each NormalId provided indicates the property of the same name in the new Faces will be true.

  • The table.unpack() function can be used to unpack a table of NormalId to be included.
  • Passing values that are not a NormalId will do nothing; they are ignored silently.

Properties

Top Supported Whether the top face is included.
Faces.Top()

Whether the top face is included.

Whether the top face (positive Y direction, corresponding to NormalId.Top) is included in this Faces value. Defaults to false when NormalId.Top is not passed to the Faces.new() constructor.

Bottom Supported Whether the bottom face is included.
Faces.Bottom()

Whether the bottom face is included.

Whether the bottom face (negative Y direction, corresponding to NormalId.Bottom) is included in this Faces value. Defaults to false when NormalId.Bottom is not passed to the Faces.new() constructor.

Left Supported Whether the left face is included.
Faces.Left()

Whether the left face is included.

Whether the left face (negative X direction, corresponding to NormalId.Left) is included in this Faces value. Defaults to false when NormalId.Left is not passed to the Faces.new() constructor.

Right Supported Whether the right face is included.
Faces.Right()

Whether the right face is included.

Whether the right face (positive X direction, corresponding to NormalId.Right) is included in this Faces value. Defaults to false when NormalId.Right is not passed to the Faces.new() constructor.

Back Supported Whether the back face is included.
Faces.Back()

Whether the back face is included.

Whether the back face (positive Z direction, corresponding to NormalId.Back) is included in this Faces value. Defaults to false when NormalId.Back is not passed to the Faces.new() constructor.

Front Supported Whether the front face is included.
Faces.Front()

Whether the front face is included.

Whether the front face (negative Z direction, corresponding to NormalId.Front) is included in this Faces value. Defaults to false when NormalId.Front is not passed to the Faces.new() constructor.

Nova binding inventory

Library Members
new Back, Bottom, Front, Left, Right, Top

Roblox reference: Faces