09 April 2009

osgConv Command Reference

The OpenSceneGraph utility osgConv reads 3D databases, applies basic operations to them, then writes them out as a single 3D database.


usage:
osgconv [options] infile1 [infile2 ...] outfile

environment:
OSG_BUILD_KDTREES on/off Enable/disable the
automatic building of
KdTrees for each loaded
Geometry.
OSG_COMPIlE_CONTEXTS <mode> OFF | ON Enable/disable
the use a backgrouind
compile contexts and
threads.
OSG_COMPUTE_NEAR_FAR_MODE <mode> DO_NOT_COMPUTE_NEAR_FAR |
COMPUTE_NEAR_FAR_USING_B-
OUNDING_VOLUMES |
COMPUTE_NEAR_FAR_USING_P-
RIMITIVES
OSG_CONFIG_FILE <filename> Specify a viewer
configuration file to
load by default.
OSG_DATABASE_PAGER_DRAWABLE <mode> Set the drawable policy
for setting of loaded
drawable to specified
type. mode can be one of
DoNotModify, DisplayList,
VBO or VertexArrays>.
OSG_DATABASE_PAGER_PRIORITY <mode> Set the thread priority
to DEFAULT, MIN, LOW,
NOMINAL, HIGH or MAX.
OSG_DEFAULT_BIN_SORT_MODE <type> SORT_BY_STATE |
SORT_BY_STATE_THEN_FRONT-
_TO_BACK |
SORT_FRONT_TO_BACK |
SORT_BACK_TO_FRONT
OSG_DISPLAY_TYPE <type> MONITOR | POWERWALL |
REALITY_CENTER |
HEAD_MOUNTED_DISPLAY
OSG_DO_PRE_COMPILE <ON/OFF> Switch on or off the pre
compile of OpenGL object
database pager.
OSG_EXPIRY_DELAY <float> Set the length of time a
PagedLOD child is kept in
memory, without being
used, before its tagged
as expired, and ear
marked to deletion.
OSG_EXPIRY_FRAMES <int> Set number of frames a
PagedLOD child is kept in
memory, without being
used, before its tagged
as expired, and ear
marked to deletion.
OSG_EYE_SEPARATION <float> physical distance between
eyes
OSG_FILE_PATH <path>[;path].. Paths for locating
datafiles
OSG_GL_ERROR_CHECKING <type> ONCE_PER_ATTRIBUTE | ON |
on enables fine grained
checking, ONCE_PER_FRAME
enables coarse grained
checking
OSG_LIBRARY_PATH <path>[;path].. Paths for locating
libraries/ plugins
OSG_MAXIMUM_OBJECTS_TO_COMPILE_PER_FRAME <int> maximum number of OpenGL
objects to compile per
frame in database pager.
OSG_MAX_NUMBER_OF_GRAPHICS_CONTEXTS <int> maximum number of
graphics contexts to be
used with applications.
OSG_MAX_PAGEDLOD <num> Set the target maximum
number of PagedLOD to
maintain.
OSG_MAX_TEXTURE_SIZE Set the maximum size of
textures.
OSG_MINIMUM_COMPILE_TIME_PER_FRAME <float> minimum compile time
alloted to compiling
OpenGL objects per frame
in database pager.
OSG_NEAR_FAR_RATIO <float> Set the ratio between
near and far planes -
must greater than 0.0 but
less than 1.0.
OSG_NUM_DATABASE_THREADS <int> Set the hint for the
total number of threads
to set up in the
DatabasePager.
OSG_NUM_HTTP_DATABASE_THREADS <int> Set the hint for the
total number of threads
dedicated to http
requests to set up in the
DatabasePager.
OSG_OPTIMIZER "<type> [<type>]" OFF | DEFAULT |
FLATTEN_STATIC_TRANSFORMS
|
FLATTEN_STATIC_TRANSFORM-
S_DUPLICATING_SHARED_SUB-
GRAPHS |
REMOVE_REDUNDANT_NODES |
COMBINE_ADJACENT_LODS |
SHARE_DUPLICATE_STATE |
MERGE_GEOMETRY |
MERGE_GEODES |
SPATIALIZE_GROUPS |
COPY_SHARED_NODES |
TRISTRIP_GEOMETRY |
OPTIMIZE_TEXTURE_SETTINGS
|
REMOVE_LOADED_PROXY_NODES
| TESSELLATE_GEOMETRY |
CHECK_GEOMETRY |
FLATTEN_BILLBOARDS |
TEXTURE_ATLAS_BUILDER |
STATIC_OBJECT_DETECTION
OSG_RELEASE_DELAY <float> Set the length of time a
PagedLOD child's OpenGL
objects are kept in
memory, without being
used, before be released
(setting to OFF disables
this feature.)
OSG_RELEASE_FRAMES <int> Set number of frames a
PagedLOD child's OpenGL
objects are kept in
memory, without being
used, before be released.
OSG_SCREEN <value> Set the default screen
that windows should open
up on.
OSG_SCREEN_DISTANCE <float> physical distance between
eyes and screen
OSG_SCREEN_HEIGHT <float> physical screen height
OSG_SCREEN_WIDTH <float> physical screen width
OSG_SERIALIZE_DRAW_DISPATCH <mode> OFF | ON Enable/disable
the use a muetx to
serialize the draw
dispatch when there are
multiple graphics
threads.
OSG_SPLIT_STEREO_AUTO_ADJUST_ASPECT_RATIO <mode> OFF | ON Default to ON
to compenstate for the
compression of the aspect
ratio when viewing in
split screen stereo.
Note, if you are setting
fovx and fovy explicityly
OFF should be used.
OSG_SPLIT_STEREO_HORIZONTAL_EYE_MAPPING <mode> LEFT_EYE_LEFT_VIEWPORT |
LEFT_EYE_RIGHT_VIEWPORT
OSG_SPLIT_STEREO_HORIZONTAL_SEPARATION <float> number of pixels between
viewports
OSG_SPLIT_STEREO_VERTICAL_EYE_MAPPING <mode> LEFT_EYE_TOP_VIEWPORT |
LEFT_EYE_BOTTOM_VIEWPORT
OSG_SPLIT_STEREO_VERTICAL_SEPARATION <float> number of pixels between
viewports
OSG_STEREO <mode> OFF | ON
OSG_STEREO_MODE <mode> QUAD_BUFFER | ANAGLYPHIC
| HORIZONTAL_SPLIT |
VERTICAL_SPLIT | LEFT_EYE
| RIGHT_EYE |
VERTICAL_INTERLACE |
HORIZONTAL_INTERLACE
OSG_TEXT_INCREMENTAL_SUBLOADING <type> ON | OFF
OSG_THREADING <value> Set the threading model
using by Viewer, <value>
can be SingleThreaded,
CullDrawThreadPerContext,
DrawThreadPerContext or
CullThreadPerCameraDrawT-
hreadPerContext.
OSG_THREAD_SAFE_REF_UNREF
OSG_WIN32_NV_MULTIMON_MULTITHREAD_WORKAROUND on/off Enable/disable duplicate
makeCurrentContext call
used as workaround for
WinXP/NVidia/MultiView/M-
ulitThread isues (pre
178.13 drivers).
OSG_WINDOW x y width height Set the default window
dimensions that windows
should open up on.
OSG_WRITE_OUT_DEFAULT_VALUES ON | OFF

options:
-O option - ReaderWriter option

--compressed - Enable the usage of compressed textures,
defaults to OpenGL ARB compressed textures.
--compressed-arb - Enable the usage of OpenGL ARB compressed textures
--compressed-dxt1 - Enable the usage of S3TC DXT1 compressed textures
--compressed-dxt3 - Enable the usage of S3TC DXT3 compressed textures
--compressed-dxt5 - Enable the usage of S3TC DXT5 compressed textures

--fix-transparency - fix stateset which are curerntly declared as transprent,
but should be opaque. Defaults to using the
fixTranspancyMode MAKE_OPAQUE_TEXTURE_STATESET_OPAQUE.
--fix-transparency-mode <mode_string> - fix stateset which are curerntly declared as
transprent but should be opaque. The mode_string determines
algorithm is used to fix the transparency, options are:
MAKE_OPAQUE_TEXTURE_STATESET_OPAQUE,
MAKE_ALL_STATESET_OPAQUE.

-l libraryName - load plugin of name libraryName
i.e. -l osgdb_pfb
Useful for loading reader/writers which can load
other file formats in addition to its extension.
-e extensionName - load reader/wrter plugin for file extension
i.e. -e pfb
Useful short hand for specifying full library name as
done with -l above, as it automatically expands to the
full library name appropriate for each platform.
-o orientation - Convert geometry from input files to output files.
Format of orientation argument must be the following:

X1,Y1,Z1-X2,Y2,Z2
or
degrees-A0,A1,A2

where X1,Y1,Z1 represent the UP vector in the input
files and X2,Y2,Z2 represent the UP vector of the
output file, or degrees is the rotation angle in degrees
around axis (A0,A1,A2). For example, to convert a model
built in a Y-Up coordinate system to a model with a Z-up
coordinate system, the argument may look like

0,1,0-0,0,1
or
-90-1,0,0


-t translation - Convert spatial position of output files. Format of
translation argument must be the following :

X,Y,Z

where X, Y, and Z represent the coordinates of the
absolute position in world space

--simplify n - Run simplifier on prior to output. Argument must be a
normalized value for the resultant percentage reduction.
Example: --simplify .5 will produce an 50 reduced model.

-s scale - Scale size of model. Scale argument must be the
following :

SX,SY,SZ

where SX, SY, and SZ represent the scale factors
Caution: Scaling will be done in destination orientation

--smooth - Smooth the surface by regenerating surface normals on
all geometry
--addMissingColors - Adding a white color value to all geometry that don't have
their own color values (--addMissingColours also accepted).
--overallNormal - Replace normals with a single overall normal.

--formats - Lists all supported formats and their supported options.
--format <format> - Displays information about the spefied <format>, where <format>
is the file extension, such as "flt".
--plugins - Lists all supported plugin files.
--plugin >plugin> - Displays information about the spefied <plugin>, where <plugin>
is the plugin's full path and file name.

No comments: