SelectAllUsingFilter

Introduced

1.0

Description

Selects all elements using a selection filter.

Scripting Syntax

    SelectAllUsingFilter( [SelFilter], [CheckComponentVisibility], [AffectSelectionList], [CheckObjectSelectability] )

Parameters

Parameter | Type | Description
SelFilter | FilterConstant | Selection filter to use. Default Value: Current selection filter
CheckComponentVisibility | siComponentVisibilityMode | weither or not the command should apply to visible components only Default Value: siIgnoreComponentVisibility Possible Values: • siIgnoreComponentVisibility: The command will ignore component visibility • siCheckComponentVisibility: The command will apply to visible components only
AffectSelectionList | Boolean | True to select objects, False to return a list of objects. Default Value: True
CheckObjectSelectability | Boolean | Specifies whether to select objects that marked as unselectable. Default Value: False Possible Values: • False: Select objects even if they are marked as unselectable. • True: Do not select objects if they are marked as unselectable.

Return Value

If SelectFlag is False, returns XSICollection containing the objects.

Examples

1. VBScript Example

    ' Selects all objects. Objects that are already selected remain selected.
    SelectAllUsingFilter "object"
    ' Select all lights. This deselect anything that is not a light.
    SelectAllUsingFilter "light"
    ' Select all points on active objects
    SelectAllUsingFilter "Point"

2. VBScript Example

    ' Create a sphere, hide some polygons, deselect all polygons, select all using filter
    ' result = only the visible polygons are selected
    NewScene
    CreatePrim "Sphere", "MeshSurface"
    ActivatePolygonSelTool
    SelectGeometryComponents "sphere.poly[0-20]"
    SITogglePolygonVisibility
    DeselectAll
    SelectAllUsingFilter, siCheckComponentVisibility

Autodesk Softimage v7.5