Match (Filter)
Introduced
4.0
Description
Returns true if the input object meets the filter requirements, the input object can be either a single object or a collection of objects. If a collection is passed in then the function returns true if each object in the collection matches the requirements, otherwise the function returns false. If no object is passed by the caller then the current selection is used.
Scripting Syntax
Filter.Match( Object )
C# Syntax
Boolean Filter.Match( Object in_pObj );Parameters
|
Parameter |
Type |
Description |
|
Object |
If this argument is omitted by the caller, the function receives a XSICollection object filled with the currently selected objects. |
Return Value
Examples
VBScript Example
'-------------------------------------------------------------------- ' Example to show how to use the LargeMesh filter Match ' method ' ' README: install the example from the filter object help ' page before running this example. '-------------------------------------------------------------------- set f = Application.Filters("LargeMesh") if ( typename(f) <> "Nothing" ) then set model = ActiveSceneRoot set cone = model.AddGeometry( "cone", "MeshSurface" ) set grid = model.AddGeometry( "Grid", "MeshSurface" ) For Each o in model.Children LogMessage o & " is a large mesh: " & f.Match(o) Next 'Output of above script: 'INFO : "Camera_Root is a large mesh: False" 'INFO : "light is a large mesh: False" 'INFO : "cone is a large mesh: False" 'INFO : "grid is a large mesh: True" end if
Autodesk Softimage v7.5