ivfix(1) - f34

1ivfix(1)                    General Commands Manual                   ivfix(1)
2
3
4

NAME

6       ivfix  - restructures an Inventor object for improved rendering perfor‐
7       mance
8

SYNOPSIS

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

DESCRIPTION

13       ivfix reads an Inventor object  and  restructures  it  to  improve  the
14       object's rendering performance.  ivfix processes the scene graph in two
15       phases:
16
17       Phase 1)
18              Analyzes the organization of the input scene graph, and tries to
19              sort  it  a better way to take advantage of coherence. For exam‐
20              ple, it tries to organize subgraphs by  common  textures,  since
21              switching  textures is expensive.  Once sorted, it also tries to
22              combine subgraphs so that the final result has fewer nodes.
23
24       Phase 2)
25              "Flattens" the subgraphs that result from the first phase.  This
26              tessellates  all  shapes  into triangles that are then organized
27              into triangle strips.  For example, two spheres may be  combined
28              into one triangle strip.
29
30       Warning!  ivfix does not try to preserve any non-appearance attributes,
31       such as names.  It will also remove most engines, animation nodes,  and
32       field-to-field  connections.   ivfix is best run on individual objects,
33       not on entire scenes.  When rendered, the output object will be equiva‐
34       lent  to  the  original  file, but much of the object hierarchy will be
35       lost.
36
37       Note also that the output file may be larger than the input file.   For
38       example, a sphere node will be converted into triangle strips.
39
40       The following command line options are allowed:
41
42       -a   Write an ASCII file.  The output file is binary by default.
43
44       -d dir
45            Add dir to the list of directories to search, e.g. for file nodes.
46
47       -h   Print the usage message.
48
49       -n   Do not generate any normals.
50
51       -p   ivfix  usually  tries  to  define  properties  as SoVertexProperty
52            nodes.  This option prevents that.
53
54       -t   Do not generate any texture coordinates.
55
56       -v   (Verbose) Display status information during processing.
57
58       -V   (Very verbose) Display more detailed status information.
59

SOURCE CODE

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

FILES

65       /usr/share/data/models/*  -  Sample 3D data files /usr/share/src/Inven‐
66       tor/tools/ivfix/* - Source to ivfix
67

EXAMPLES

69              ivfix < slowObject.iv > quickObject.iv
70

KNOWN BUGS

76       Ignore flags are not properly handled.
77
78
79
80
81                                                                      ivfix(1)