Value > Collections > Collection Types > FaceSelection Values |
A FaceSelection represents a set of faces for a scene mesh node as a virtual array.
As such, you can access a face by index, iterate over the faces, and apply mapped functions to the faces.
See also Editable Mesh.
The FaceSelection array is dynamic (its contents change as the faces or selected faces of the mesh node change).
FaceSelection values are mappable.
The currently selected faces of the mesh object.
All of the faces of the mesh object (read-only).
Returns the number of faces in the FaceSelection array.
Returns an array of names of the current face-level named selection sets for the object the FaceSelection is associated with.
The following property is present for singleton selections (of the form $foo.faces[n]):
Returns the index of the selected element in the mesh,
Iterating over a selection yields singleton selections in the loop body:
Retrieves the indexed face as a singleton FaceSelection. Index starts at 1.
Sets the vertices of the indexed face to the vertex indices specified in the point3 value.
Retrieves the indexed faces as a FaceSelection. Index starts at 1.
Retrieves the face-level named selection set, where the name of the named selection set can be specified as a name or string value.
Sets the face-level named selection set to the specified faces.
The name of the named selection set can be specified as a name or string value, and the faces can be specified as an array, a bitArray, or a FaceSelection from the same object.
Moves the faces in the FaceSelection.
Selects the faces in the FaceSelection.
Deselects the faces in the FaceSelection.
Deletes the faces in the FaceSelection.
Appends the face(s) to the FaceSelection.
Returns the selection index of the matching item or 0 if not found. The item is selection index or singleton FaceSelection.