Name

tree — Lists the contents of the specified objects in a tree-like format that displays the hierarchical structure of the objects, and all objects referenced by them, down to the primitive shape level.

Synopsis

tree {objects(s)} [-a] [-c] [-d#] [-i#] [-ooutfile]

DESCRIPTION

Lists the contents of the specified objects in a tree-like format that displays the hierarchical structure of the objects, and all objects referenced by them, down to the primitive shape level.

-a

The -a option adds a list of all attributes for each object. Attributes are shown with a leading "@ " and are followed by their values.

-c

If -c is given, only combinations will be printed (i.e., not primitive shapes).

-d #

The -d # option prints out the hierarchy to a specified depth.

-i #

The -i # option allows the user to set the number of spaces to indent.

-o filename

The -o option prints results to the specified filename.

EXAMPLES

The first example shows the use of the tree command to list the contents of specified objects hierarchically. The second and third examples show the use of the tree command with arguments.

Example 1. Show the structure of an object down to the primitive shape level.

mged> tree group1

Shows the structure of the tree rooted at group1 down to the primitive shape level.



Example 2. Specify the amount of indentation in the tree.

mged> tree -i2 group1

Uses two spaces for each level of indentation.



Example 3. Specify that no shapes are to be printed.

mged> tree -c group1

No shapes are printed.



Example 4. Specify that attributes are listed for each object printed.

mged> tree -a -c group1

No shapes are printed, but attributes are shown for the printed objects.



AUTHOR

BRL-CAD Team

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to