Faces

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

Name	Type / Returns	Description
Faces.new		Returns a `Faces` with the corresponding face of each passed `NormalId` as `true`.

Faces.new

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.

Parameters

Name	Type	Default	Description
normalIds...	Tuple		Any number of `NormalId` values indicating which faces to enable in the new `Faces`.

Properties

Name	Type / Returns	Description
Faces.Top	bool	Whether the top face is included.
Faces.Bottom	bool	Whether the bottom face is included.
Faces.Left	bool	Whether the left face is included.
Faces.Right	bool	Whether the right face is included.
Faces.Back	bool	Whether the back face is included.
Faces.Front	bool	Whether the front face is included.

Faces.Top

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.

Field	Value
type	bool

Faces.Bottom

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.

Field	Value
type	bool

Faces.Left

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.

Field	Value
type	bool

Faces.Right

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.

Field	Value
type	bool

Faces.Back

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.

Field	Value
type	bool

Faces.Front

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.

Field	Value
type	bool