Returns the first member of this collection that matches the find criteria. If no item is found, it returns "Nothing", which you can use to trap errors.
ClipEffectItem ClipEffectItemCollection.Find( String in_filter ); |
oReturn = ClipEffectItemCollection.Find( [Type] ); |
Object (type varies according to find criteria).
' ' This example demonstrates how to find X3DObject objects ' ' Set up the example using a mesh grid, cube, cone, and a nurbs cube: set oRoot = activesceneroot oRoot.addgeometry "grid", "meshsurface" oRoot.addgeometry "cube", "meshsurface" oRoot.addgeometry "cone", "meshsurface" oRoot.addgeometry "cube", "nurbssurface" set oGeoms = oRoot.findchildren( ,,siGeometryFamily) logmessage "The collection of geometry from the root is a " & typename( oGeoms ) logmessage "There are " & oGeoms.count & " geometry objects under the root." logmessage "" for each item in oGeoms logmessage item.name & " is a " & item.type & " " & typename( item ) next set oCone = oGeoms.find( "cone" ) set oCube = oGeoms.find( "cube" ) set oGrid = oGeoms.find( "grid" ) logmessage "" logmessage "==========================================================================" logmessage " Stats for the collection:" logmessage " ------------------------" logmessage " Total number of objects in collection: " & oGeoms.count logmessage " Name of the first cone in the collection: " & oCone.name logmessage " Name of the first cube in the collection: " & oCube.name ' Try some error trapping ( if you are trying to use a find criteria that returns Nothing, ' you will see this error message: 'ERROR : "Object required: 'oCube1'" ) set oCube1 = oGeoms.find( "cube1" ) if typename( oCube1 ) = "Nothing" then logmessage " Can't get the name of the other cube in the collection." else logmessage " Name of the other cube in the collection: " & oCube1.name end if logmessage " Name of the first grid in the collection: " & oGrid.name ' Output of above script is: 'INFO : "The collection of geometry from the root is a X3DObjectCollection" 'INFO : "There are 4 geometry objects under the root." 'INFO : "" 'INFO : "grid is a polymsh X3DObject" 'INFO : "cube is a polymsh X3DObject" 'INFO : "cone is a polymsh X3DObject" 'INFO : "cube1 is a surfmsh X3DObject" 'INFO : "" 'INFO : "==========================================================================" 'INFO : " Stats for the collection:" 'INFO : " ------------------------" 'INFO : " Total number of objects in collection: 4" 'INFO : " Name of the first cone in the collection: cone" 'INFO : " Name of the first cube in the collection: cube" 'INFO : " Can't get the name of the other cube in the collection." 'INFO : " Name of the first grid in the collection: grid" |
/* This example demonstrates how to find Cluster objects */ NewScene( null, false ); var obj = CreatePrim( "Cube", "MeshSurface" ); CreateCluster("cube.pnt[2,3,6,LAST]"); CreateCluster("cube.poly[1]"); CreateCluster("cube.edge[0,1,3,5-8,LAST]"); CreateCluster("cube.sample[0,3-9,12,15,20,21]"); // find the cluster using the siType constant. var cls = obj.activeprimitive.geometry.clusters.find( siPolygonCluster ); if ( cls != null ) logmessage( "found polygon cluster: " + cls.fullname ); //Expected results: //INFO : found polygon cluster: cube.polymsh.cls.Polygon |
# # This example demonstrates how to to find PlayControl Property objects # under the scene root # PlayCtrlProp = Application.ActiveProject.Properties.Find( "PlayControl" ) try : if Application.ClassName(PlayCtrlProp) == "Property" : Application.LogMessage( "PlayControl property OK" ) else : Application.LogMessage( "PlayControl property NOT found" ) except : Application.LogMessage( "PlayControl property NOT found" ) # Output of above script: #INFO : PlayControl property OK |