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)