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