Overrides the hidden flag when assembling path lists, if a generic toplevel path has been specified.

Exit quietly without printing error messages if the search plan contains errors. Primarily used in situations where programs automatically generate search invocations.

Prints extra information in full path results.

Returns TRUE if the object has attribute attrib. If a specific value is also supplied for the attribute with an equal condition, TRUE is returned if the object both has the attribute and the attribute is set to value val. In the case of >, <, >=, and <= there are two possibilities - if val is numerical a numerical comparison is performed, otherwise a string comparison is performed. Both attrib and val are treated as patterns under shell pattern matching rules when a string comparison is performed, but in numerical mode only the attribute name is pattern matched.

True if the object in question is being combined into the local hierarchy with the specified boolean operation. Recognized types are Union (u), Intersection (+), and Subtraction (-).

Note that by convention, top level objects are implicitly "unioned" into the database. To see only objects that have been unioned into a comb tree without returning the top level comb object as well, use the -mindepth option to filter for returns deeper in the tree.

True if the depth of the object in the tree is within the range specified.

True if the Tcl expression returns true. Any pair of curly braces ('{}') in an arguemt is replaced by the name or full path of the object. The semicolon terminates the argument list and must not be omitted. Remember to quote the parameters properly. The semicolon must stand on its own and must be quoted.

When using multiple -exec filters, keep in mind that filters are evaluated lazily, so if you have two -execs and the first one returns false for one node, the second one will not run at all.

Like name except the match is case insensitive.

Like regex except the match is case insensitive.

True if the depth of the object in the tree is less than or equal to n.

True if the depth of the object in the tree is greater than or equal to n.

True if the object name (not the full path, just the name) matches pattern. The evaluation is done according to shell pattern matching rules.

True if the object is a combination and has n nodes. This option also supports supplying <, >, <=, and >= in front of the number to support returning true for objects with node counts less than, greater than, less than or equal to, and greater than or equal to n.

Returns TRUE if the object has parameter param. Unlike -attr, which looks only at general attributes stored as metadata on objects, the -param filters based only on the internal geometric object's characteristics. If a specific value is also supplied for the parameter with an equal condition, TRUE is returned if the object both has the parameter and the parameter is set to value val. In the case of >, <, >=, and <= there are two possibilities - if val is numerical a numerical comparison is performed, otherwise a string comparison is performed. Both attrib and val are treated as patterns under shell pattern matching rules when a string comparison is performed, but in numerical mode only the parameter name is pattern matched.

The following table outlines what parameters are visible to the -param option. Because BRL-CAD uses the same internal containers for some types, some parameters will be present even when they do not make sense for the specific subtype. Examples include using arb8's container for arb4 and tgc for rcc. Note: there are also a number of primitives whose parameters are not exposed in a way that that -param can access them: arbn, ars, brep, bspline, dsp, metaball, nmg, pipe, pnts, and poly.

True if the object path matches pattern. The evaluation is done according to shell pattern matching rules.

Evaluates to TRUE - used to print out the path and name of the object.

True if the object path matches pattern. Pattern evaluation is done using Regular Expression matching.

True if the size of the object is within the range specified. NOTE: for combs, extrudes, and other composite objects this filter considers only the object definition itself, not its related elements.

Returns TRUE if an object has ONLY standard attributes associated with it. Standard attributes in BRL-CAD are:

Returns TRUE if the type of the object matches pattern. Pattern evaluation is done using shell pattern matching. Types recognized include:

As a convenience, the -type option will also recognize the pattern shape, which will match any object that is not a combination, region, annotation, constraint, grip or joint.

In order to identify shapes defined as implicit solids using the "plate mode" methodology, the pattern plate will match any object whose internal definition indiciates it is of that type. Currently such objects are possible with "bot" and "brep" objects.

The the pattern volume can be used as a mirror of plate, in that it will report objects that clearly define a non-implicit solid volume. Its determination is local - for example, combs aren't matched because a comb may be made up of non-volumetric objects. In particular, plate mode objects will not match because their volume is implicit, and (for example) surface mode BoTs will not match because they don't define a volume.

Evaluates to true if the expression inside the parentheses evaluates to true. Used to establish order of operations.

The below operator applies the expression to every object below the matching object in the tree hierarchy. E.g. searching with -below -name start\* on /component/region.r/start_comb.c/prim1.s would return prim1.s, as the object below start_comb.c

Optionally, inequality and equality constraints on depth can be appended to the operator to limit what relative depths are accepted as matches.

The and operator operates like the logical AND operator - TRUE only if both expressions are true. AND is the default operator assumed if two expressions are present with no operator explicitly defined.

The above operator applies the expression to every object above the current full path to that object, and returns TRUE if one or more of them satisfies the expression. E.g., searching with -above -name s\* on /component/region.r/start_comb.c/prim1.s would return TRUE for /component and /component/region.r as start_comb.c is below both of them, but would return FALSE for any deeper objects (i.e., prim1.s in this example).

Optionally, inequality and equality constraints on depth can be appended to the operator to limit what relative depths are accepted as matches.

The logical NOT operator - returns the opposite of the evaluation result of expression.

The logical OR operator - true if either expression is true.