 /**
 * @page ToolsIvShapeBenchmark ivShapeBenchmark tool
 *
 * @B ivShapeBenchmark @b performs benchmark tests.
 *
 * @H3 SYNOPSIS: @h3
 *    @B ivShapeBenchmark @b
 *
 * @H3 DESCRIPTION: @h3
 * @B ivShapeBenchmark @b performs benchmark tests on all Inventor shapes.
 *
 * @SCREENSHOT
 * Running ivShapeBenchmark without any arguments will start the gui.
 *
 * @IMAGE ivShapeBenchmark.png
 *
 * @H3 USAGE: @h3
 * The following command line options are allowed:
 *
 * @TABLE_1B
 * @TR --display-width value        @TD The width of the rendering display (Default: 640)
 * @TR --display-height value       @TD The height of the rendering display (Default: 480)
 *
 * @TR --bench-all                       @TD Perform a full bench of all the shapes (Default: Not active)
 *
 * @TR --dump-display                 @TD allows to dump the display to a PNG file (Default: not active)
 * @TR --dump-display-file value   @TD Dump the framebuffer to a PNG file, value is the filename (Default: the corresponding benchString)
 * @TR --dump-scenegraph value  @TD Dump the SceneGraph to an IV file, value is the filename (Default: "")
 * @TR --output-html value           @TD Set the path for the HTML output, value is the output path (Default: ./output)
 * @TR --output-csv value             @TD Enable the dump, to the console, of the bench information in CSV format.(Default: Not active)
 *
 *Optional (not used if the option --benchString is used)
 * @TR --viewing-mode                 @TD Enter in interactive viewing mode, no benchmarking is performed.
 * @TR --rendering-mode value     @TD The ScaleViz/Multipipe rendering mode (ex: 2_Pipes_(Depth)), (Default STANDALONE).
 * @TR --generate-normals           @TD Use OIV normals generator (Default: not active)
 * @TR --generate-colors              @TD Use OIV colors generator (Default: not active)
 * @TR --generate-texcoords         @TD Use OIV textures coordinates generator (Default: active)
 * @TR --generate-texcoords3       @TD Use OIV textures coordinates generator for 3D textures (Default: active)
 * @TR --normals-binding  value    @TD Normals binding (default V): O for overall, V per vertex, F per face, G per face indexed, W per vertex indexed.
 * @TR --colors-binding value        @TD Colors binding (default V): O for overall, V per vertex, F per face, G per face indexed, W per vertex indexed.
 * @TR --geometry value              @TD Use the embedded geometry (0-3) (Default 0).
 * @TR --geometry-type value       @TD The shape type used for the geometry (Defaults: FACESET:3).
 * @TR --geometry-width value      @TD The width of the geometry in vertices (Default 100).
 * @TR --geometry-height value     @TD The height of the geometry in vertices (Default 100).
 * @TR --geometry-count value      @TD The number of instances of the displayed geometry (Default 1).
 * @TR --bench-frame-count value  @TD The number of frame to bench, -1 for infinite (Default -1).
 * @TR --bench-frame-start value   @TD The index of the first benched frame (Default 0).
 * @TR --bench-frame-end value    @TD The index of the last benched frame, -1 for all (Default -1).
 * @TR --bench-frame-steps value  @TD The number of frames rendered between each benched frame (Default 0).
 *
 * @TR --bench-string value           @TD Performs a single bench define by the specified bench string []
 *
 * OIVShapeName FLAGS OVERALL_FLAGS geomIndex geomWidth geomHeight geomCount frameNum benchFrameStart benchFrameEnd benchFrameStepping renderMode
 *
 * FLAGS is a combination of VNC where:
 * @UL
 * @LI V stands for vertices (mandatory) @li
 * @LI N is normal @li
 * @LI C is color @li
 * @LI T for textures, 3 for 3D textures @li
 * @ul
 *
 * OVERALL_FLAGS: xx where:
 * @UL
 * @LI each x is O for overall, V per vertex, F per face, G per face indexed, W per vertex indexed @li
 * @LI The first x is for the normals @li
 * @LI The second x is for the colors @li
 * @ul
 *
 * frameNum is the number of frame to render; -1 for infinite; -2 to display just display viewer
 *
 * benchFrameStart is the number of the first benched frame
 *
 * benchFrameEnd is the number of the last benched frame; -1 for all the frames
 *
 * benchFrameStepping is the number of frames to use for a single bench result
 *
 * renderMode is the configuration to load at application startup (ex: 2_Pipes_(Depth)). default is STANDALONE
 * 
 * @TABLE_END
 *
 * @H3 EXAMPLES @h3
 *
 * @code
 *   ivShapeBenchmark --benchString FaceSet VC WW 0 193 223 2 100 0 -1 1 STANDALONE
 * @endcode
 *
 *
 * @FILE_LIST
 * @UL
 * @LI tools/source/ivShapeBenchmark/bencher.h @li
 * @LI tools/source/ivShapeBenchmark/geometry.h @li
 * @LI tools/source/ivShapeBenchmark/ivShapeBenchmarkGui_Design.h @li
 * @LI tools/source/ivShapeBenchmark/reporting.h @li
 * @LI tools/source/ivShapeBenchmark/viewer.h @li
 * @LI tools/source/ivShapeBenchmark/bencher.cxx @li
 * @LI tools/source/ivShapeBenchmark/geometry.cxx @li
 * @LI tools/source/ivShapeBenchmark/ivShapeBenchmarkGui_Design.cxx @li
 * @LI tools/source/ivShapeBenchmark/maincmd.cxx @li
 * @LI tools/source/ivShapeBenchmark/reporting.cxx @li
 * @LI tools/source/ivShapeBenchmark/viewer.cxx @li
 * @LI tools/source/ivShapeBenchmark/ivShapeBenchmarkGui.ui @li
 * @LI tools/source/ivShapeBenchmark/layer1.png @li
 * @LI tools/source/ivShapeBenchmark/layer2.png @li
 * @LI tools/source/ivShapeBenchmark/texture2d.png @li
 * @LI tools/source/ivShapeBenchmark/benches/benchesCPX.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/shapesMP.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/shapesFULL.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/shapesCPX.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/configsMP3.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/configsMP2.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/configsMINI.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/configsFULL.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/configsCPX3.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/configsCPX2.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/benchesMP.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/benchesFULL.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/shapesMINI.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/benchesMINI.txt @li
 * @LI tools/source/ivShapeBenchmark/benches/benchFULL.bat @li
 * @LI tools/source/ivShapeBenchmark/benches/benchCPX3.bat @li
 * @LI tools/source/ivShapeBenchmark/benches/benchCPX2.bat @li
 * @LI tools/source/ivShapeBenchmark/benches/benchSHAPE.bat @li
 * @LI tools/source/ivShapeBenchmark/benches/benchMP3.bat @li
 * @LI tools/source/ivShapeBenchmark/benches/benchMP2.bat @li
 * @LI tools/source/ivShapeBenchmark/benches/benchMINI.bat @li
 * @ul
 *
 */
 
