Object Filters

You can use the object filter options to select objects based upon differing criteria. You can select one or many, from the following options. Descriptions of each option are detailed in the table below.

Filter	Condition	Description
All Objects		All objects match this filter. This is commonly used for hiding or showing or unselecting all objects.
Name		All objects that contain the text entered, match this filter. This filter is used in conjunction with the following conditions:
	Is equal	The name of an object matches exactly the text specified.
	Is not equal	The opposite of 'is'. Allows the filter to specify everything other than the text specified.
	Is Equal to Any	The name of an object matches any of the specified sub-strings that are delimited by a space or quotation marks Note The condition “is equal to any” is intended to assist when query is used on array data. For example, if a node has an array metadata field with values a,b,c,d,e and the query specifies “is equal to any” passing 3 values c,h,p, then the expression will evaluate to true becasue both arrays contain c. The same query would evaluate to true for a node that contained a,p but would be false for a nodes with k,j,z
	Is not Equal to Any	Allows the filter to specify names other than the sub-strings specified
	includes	Matches all objects that have the specified text included in them
	does not include	Matches all objects that do not specified text included in them
	starts with	Matches all the objects with a name starting with the specified text
	does not start with	Matches all the objects with a name that does not start with the specified text
	ends with	Matches all the objects with a name ending with the specified text
	does not end with	Matches all the objects with a name that does not end with the specified text
	not case sensitive	Case is not considered when assessing searching criteria. Note This condition applies to all of the above name filters.
	case sensitive	Case is considered when assessing searching criteria. Note This condition applies to all of the above name filters.
	matches regexp	The field must match exactly the specified regular expression to be matched.
	does not match regexp
	includes regexp	Selects all objects that include text matching the specified regular expression
	does not include regexp
ID		Used to set filters relating to Asset and Instance IDs
Asset ID		All objects that contain the SAP 3D Visual Enterprise Generator allocated Asset ID entered, match this filter. This is used in conjunction with the following conditions:
	Is equal	The name of an object matches exactly the text specified.
	Is not equal	The opposite of 'is'. Allows the filter to specify everything other than the text specified.
	Is Equal to Any	Asset or Instance IDs match any of the specified sub-strings that are delimited by a space or quotation marks Note The condition “is equal to any” is intended to assist when query is used on array data. For example, if a node has an array metadata field with values a,b,c,d,e and the query specifies “is equal to any” passing 3 values c,h,p, then the expression will evaluate to true becasue both arrays contain c. The same query would evaluate to true for a node that contained a,p but would be false for a nodes with k,j,z
	Is not Equal to Any	Allows the filter to specify IDs other than the sub-strings specified
	includes	Matches all objects that have the specified text included in them
	does not include	Matches all objects that do not specified text included in them
	starts with	Matches all the objects with a name starting with the specified text
	does not start with	Matches all the objects with a name that does not start with the specified text
	ends with	Matches all the objects with a name ending with the specified text
	does not end with	Matches all the objects with a name that does not end with the specified text
	not case sensitive	Case is not considered when assessing searching criteria. Note This condition applies to all of the above name filters.
	case sensitive	Case is considered when assessing searching criteria. Note This condition applies to all of the above name filters.
	matches regexp	The field must match exactly the specified regular expression to be matched.
	does not match regexp
	includes regexp	Selects all objects that include text matching the specified regular expression
	does not include regexp
Instance ID		All objects that contain the SAP 3D Visual Enterprise Generator allocated Instance ID entered, match this filter. This is used in conjunction with the following conditions:
	Is equal	The name of an object matches exactly the text specified.
	Is not equal	The opposite of 'is'. Allows the filter to specify everything other than the text specified.
	Is Equal to Any	Asset or Instance IDs match any of the specified sub-strings that are delimited by a space or quotation marks Note The condition “is equal to any” is intended to assist when query is used on array data. For example, if a node has an array metadata field with values a,b,c,d,e and the query specifies “is equal to any” passing 3 values c,h,p, then the expression will evaluate to true becasue both arrays contain c. The same query would evaluate to true for a node that contained a,p but would be false for a nodes with k,j,z
	Is not Equal to Any	Allows the filter to specify IDs other than the sub-strings specified
	includes	Matches all objects that have the specified text included in them
	does not include	Matches all objects that do not specified text included in them
	starts with	Matches all the objects with a name starting with the specified text
	does not start with	Matches all the objects with a name that does not start with the specified text
	ends with	Matches all the objects with a name ending with the specified text
	does not end with	Matches all the objects with a name that does not end with the specified text
	not case sensitive	Case is not considered when assessing searching criteria. Note This condition applies to all of the above name filters.
	case sensitive	Case is considered when assessing searching criteria. Note This condition applies to all of the above name filters.
	matches regexp	The field must match exactly the specified regular expression to be matched.
	does not match regexp
	includes regexp	Selects all objects that include text matching the specified regular expression
	does not include regexp
Properties		Provides filters relating to object properties; for example, 'selected', 'visible'. Note that all filter property options can be negated; for example, the highlighted filter can be set to 'Highlighted' or 'Not Highlighted'.
Selected		All selected objects match this filter. This is commonly used for hiding or showing or unselecting all selected objects.
Visible		All objects that are visible match this filter. This is commonly used for hiding or showing or unselecting all visible objects.
Highlighted		Only highlighted or non highlighted objects match this filter.
Suppressed		Either 'Suppressed' or 'Not Suppressed' objects match this filter. If a node is ‘suppressed’, the node and its children do not exist in the scene, and are not visible in the viewport or the scene BOM. The suppressed node and its children will be loaded into the scene once the suppressed node is 'resumed' at a later time. Filters cannot process the children of a suppressed node, and only run for the suppressed node itself. Filters can process suppressed nodes so that it is possible to find such nodes with a query, and resume them.
Group		Either 'Group' or 'Not Group' objects match this filter. Groups do not have a mesh object, or drawable geometry
Matched Previous Statement		Matches objects matched in the previous statement unless negated
Mark		All objects that are set to either Marked or Not Marked match this filter. The idea of marking an object is like selecting it, but silently. The mark on the object is maintained, so that you can test for it later. The marks are not saved with the file. They are active only during the current session
Mark2		All objects that are set to Mark2 match this filter
Mark3		All objects that are set to Mark3 match this filter
Mark4		All objects that are set to Mark4 match this filter
Mark5		All objects that are set to Mark5 match this filter
Mark6		All objects that are set to Mark6 match this filter
Number of
Children		All objects that contain the specified number of child nodes, match this filter. This is used in conjunction with the following conditions:
Polygons		All objects that contain the specified number of polygons, match this filter. This is used in conjunction with the following conditions:
Vertices		All objects that contain the specified number of vertices, match this filter. This is used in conjunction with the following conditions:
	equal to	The number matches exactly the number specified
	less than	Matches all objects that have a count less than the specified number.
	greater than	Matches all objects that have a count greater than the specified number
	in the range	Used to check a variable’s value as being between two values. The test is for the inclusive range.
	greater than or equal to	Matches all objects that have a count greater than or equal to the specified number
	less than or equal to	Matches all objects that have a count less than or equal to the specified number
Size
Bounding box width		All objects with the specified bounding box width match this filter. This is used in conjunction with the following conditions.
Bounding box height		All objects with the specified bounding box height match this filter. This is used in conjunction with the following conditions.
Bounding box depth		All objects with the specified bounding box depth match this filter. This is used in conjunction with the following conditions.
Bounding box diagonal		All objects with the specified bounding box diagonal size match this filter. This is used in conjunction with the following conditions.
Bounding box volume		All objects with the specified bounding box volume match this filter. This is used in conjunction with the following conditions:
	equal to	The number matches exactly the number specified
	less than	Matches all objects that have a measurement less than the specified number
	greater than	Matches all objects that have a measurement greater than the specified number
	in the range	Used to check a variable’s value as being between two values. The test is for the inclusive range.
	greater than or equal to	Matches all objects that have a measurement greater than or equal to the specified number
	less than or equal to	Matches all objects that have a measurement less than or equal to the specified number
Other
Level of hierarchy		All objects at the specified level of hierarchy match this filter. This is commonly used for hiding or showing or unselecting certain objects. This is used in conjunction with the following conditions.
Opacity		All objects with the specified level of opacity match this filter. This is used in conjunction with the following conditions:
	equal to	The number matches exactly the number specified.
	less than	Matches all objects that have a count less than the specified number
	greater than	Matches all objects that have a count greater than the specified number
	in the range	Used to check a variable’s value as being between two values. The test is for the inclusive range.
	greater than or equal to	Matches all objects that have a count greater than or equal to the specified number
	less than or equal to	Matches all objects that have a count less than or equal to the specified number
Using Material		Opens the Select Material dialog box, and is used to specify a specific object material.
Is included in layer		Opens the Select Layer dialog box, and is used to specify a specific layer in which the object or objects exist.
Included in XML List		Opens the Select XML List dialog box, and is used to specify parts that are included in a previously saved XML list.

If you select the Using Material option, the following further filter selections can be made when you choose to display the Select Material window:

Filter	Functional Description
Material Name	The name of the material
Get from Scene	Selects a material from the scene

If you select the Included in Layer option, the following further filter selections can be made when you choose to display the Select Layer window:

Filter	Functional Description
Layer Name	The name of the layer
Get from Scene	Selects a layer from the scene

If you select the Included in XML List option, the following further filter selections can be made in the Select XML List window:

Filter	Functional Description
Look In	The location of the file
File Name	The name of the XML file
Files of Type	The type of file; for example, XML list.