The osgwnames Application

osgwnames displays the structure of a scene graph in human-readable form. It displays a summary of the hierarchy using indentation with each node represented as a single line of text, containing the class and Node name. If the Node name is empty, NULL displays in its place.

Simple Usage

Try running osgwnames on dectest20.ive, one of the osgWorks data files:

C:\Projects>osgwnames dectest20.ive
world (Group)
  door_assembly.asm.2 (Group)
    NULL (MatrixTransform)
      KNOB.PRT (Geode with 1 Drawable)
    NULL (MatrixTransform)
      KNOB.PRT #2 (Geode with 1 Drawable)
    NULL (MatrixTransform)
      DOOR.PRT (Geode with 1 Drawable)
    POLE.PRT (Geode with 1 Drawable)

The output shows the scene graph hierarchical structure:

• The scene graph has a top-level Group node named world, has a single Group child named door_assembly.asm.2.
• door_assembly.asm.2 has four children, three of which are unnamed MatrixTransform objects (the name is displayed as NULL), and the fourth child is a Geode named POLE.PRT.
• Each of the MatrixTransform objects have Geode children, with names KNOB.PRT, KNOB.PRT #2, and DOOR.PRT.

To produce more readable output, you can prevent the display of Geodes with the --nogeodes option:

C:\Projects>osgwnames --nogeodes dectest20.ive
world (Group)
  door_assembly.asm.2 (Group)
    NULL (MatrixTransform)
    NULL (MatrixTransform)
    NULL (MatrixTransform)

Command Line Parameters

--nogeodes	Do not display Geodes in the output.
--allNodes	Traverse all nodes regardless of node mask.
--mask <x>	Specify the scene graph traversal mask. Replace <x> with up to 8 hex digits. Default is ffffffff.
-O <option>	Pass <option> to the OSG import plugin.
-v/--version	Display the osgWorks version string.