NAME

       ivfix - restructures an Inventor object for improved rendering performance

SYNOPSIS

       ivfix [ -ahntvV ] [ -d dir ] [infile] [outfile]

DESCRIPTION

       ivfix  reads an Inventor object and restructures it to improve the object's rendering performance.  ivfix
       processes the scene graph in two phases:

       Phase 1)
              Analyzes the organization of the input scene graph, and tries to sort it  a  better  way  to  take
              advantage  of  coherence.  For  example,  it tries to organize subgraphs by common textures, since
              switching textures is expensive.  Once sorted, it also tries to  combine  subgraphs  so  that  the
              final result has fewer nodes.

       Phase 2)
              "Flattens"  the  subgraphs  that  result  from  the first phase.  This tessellates all shapes into
              triangles that are then organized into triangle strips.  For example, two spheres may be  combined
              into one triangle strip.

       Warning!   ivfix  does  not  try  to preserve any non-appearance attributes, such as names.  It will also
       remove most engines, animation nodes, and field-to-field connections.  ivfix is best  run  on  individual
       objects, not on entire scenes.  When rendered, the output object will be equivalent to the original file,
       but much of the object hierarchy will be lost.

       Note also that the output file may be larger than the input file.  For example, a  sphere  node  will  be
       converted into triangle strips.

       The following command line options are allowed:

       -a   Write an ASCII file.  The output file is binary by default.

       -d dir
            Add dir to the list of directories to search, e.g. for file nodes.

       -h   Print the usage message.

       -n   Do not generate any normals.

       -p   ivfix usually tries to define properties as SoVertexProperty nodes.  This option prevents that.

       -t   Do not generate any texture coordinates.

       -v   (Verbose) Display status information during processing.

       -V   (Very verbose) Display more detailed status information.

SOURCE CODE

       Note that the source code to ivfix comes with the Open Inventor 3d Toolkit.

FILES

       /usr/share/data/models/* - Sample 3D data files /usr/share/src/Inventor/tools/ivfix/* - Source to ivfix

EXAMPLES

              ivfix < slowObject.iv > quickObject.iv

SEE ALSO

       inventor, ivview, ivcat, ivinfo, SceneViewer, gview, drop, maze, noodle, revo, showcase, textomatic

KNOWN BUGS

       Ignore flags are not properly handled.

                                                                                                        ivfix(1)