.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.11. .TH OSGCONV "1" "September 2019" "OpenSceneGraph" "User Commands" .SH NAME osgconv \- Convert between file formats parsed by OSG. .SH DESCRIPTION .SS "usage:" .IP obj\-x86_64\-linux\-gnu/bin/osgconv [options] infile1 [infile2 ...] outfile .SS "environment:" .TP OSG_ASSIGN_PBO_TO_IMAGES Set whether PixelBufferObjects should be assigned to Images to aid download to the GPU. .TP OSG_BUFFER_OBJECT_POOL_SIZE Set the hint for the size of the vertex buffer object pool to manage. .TP OSG_BUILD_KDTREES on/off Enable/disable the automatic building of KdTrees for each loaded Geometry. .TP OSG_COMPILE_CONTEXTS OFF | ON Disable/enable the use of background compiled contexts and threads. .TP OSG_COMPUTE_NEAR_FAR_MODE DO_NOT_COMPUTE_NEAR_FAR | COMPUTE_NEAR_FAR_USING_BOUNDING_VOLUMES | COMPUTE_NEAR_FAR_USING_PRIMITIVES .TP OSG_CONFIG_FILE Specify a viewer configuration file to load by default. .TP OSG_DATABASE_PAGER_DRAWABLE Set the drawable policy for setting of loaded drawable to specified type. mode can be one of DoNotModify, DisplayList, VBO or VertexArrays>. .TP OSG_DATABASE_PAGER_PRIORITY Set the thread priority to DEFAULT, MIN, LOW, NOMINAL, HIGH or MAX. .TP OSG_DEFAULT_BIN_SORT_MODE SORT_BY_STATE | SORT_BY_STATE_THEN_FRONT_TO_BACK | SORT_FRONT_TO_BACK | SORT_BACK_TO_FRONT .TP OSG_DISPLAY_TYPE MONITOR | POWERWALL | REALITY_CENTER | HEAD_MOUNTED_DISPLAY .TP OSG_DO_PRE_COMPILE Switch on or off the pre compile of OpenGL object database pager. .TP OSG_EYE_SEPARATION Physical distance between eyes. .TP OSG_FBO_POOL_SIZE Set the hint for the size of the frame buffer object pool to manage. .TP OSG_FILE_PATH [:path].. Paths for locating datafiles .TP OSG_FORCE_TEXTURE_DOWNLOAD should the texture compiles be forced to download using a dummy Geometry. .TP OSG_GL_CONTEXT_FLAGS Set the hint for the GL context flags to use when creating contexts. .TP OSG_GL_CONTEXT_PROFILE_MASK Set the hint for the GL context profile mask to use when creating contexts. .TP OSG_GL_CONTEXT_VERSION Set the hint for the GL version to create contexts for. .TP OSG_GL_ERROR_CHECKING ONCE_PER_ATTRIBUTE | ON | on enables fine grained checking, ONCE_PER_FRAME enables coarse grained checking .TP OSG_GL_EXTENSION_DISABLE Use space deliminarted list of GL extensions to disable associated GL extensions .TP OSG_GL_TEXTURE_STORAGE ON|OFF or ENABLE|DISABLE, Enables/disables usage of glTexStorage for textures where supported, default is ENABLED. .TP OSG_IMPLICIT_BUFFER_ATTACHMENT_RENDER_MASK OFF | DEFAULT | [~]COLOR | [~]DEPTH | [~]STENCIL. Substitute missing buffer attachments for render FBO. .TP OSG_IMPLICIT_BUFFER_ATTACHMENT_RESOLVE_MASK OFF | DEFAULT | [~]COLOR | [~]DEPTH | [~]STENCIL. Substitute missing buffer attachments for resolve FBO. .TP OSG_KEYSTONE ON | OFF Specify the hint to whether the viewer should set up keystone correction. .TP OSG_KEYSTONE_FILES [:filename].. Specify filenames of keystone parameter files. Under Windows use ; to deliminate files, otherwise use : .TP OSG_LIBRARY_PATH [:path].. Paths for locating libraries/ plugins .TP OSG_MAXIMUM_OBJECTS_TO_COMPILE_PER_FRAME maximum number of OpenGL objects to compile per frame in database pager. .TP OSG_MAX_NUMBER_OF_GRAPHICS_CONTEXTS Maximum number of graphics contexts to be used with applications. .TP OSG_MAX_PAGEDLOD Set the target maximum number of PagedLOD to maintain. .TP OSG_MAX_TEXTURE_SIZE Set the maximum size of textures. .TP OSG_MAX_TEXTURE_SIZE Clamp the maximum GL texture size to specified value. .TP OSG_MENUBAR_BEHAVIOR OSX Only : Specify the behavior of the menubar (AUTO_HIDE, FORCE_HIDE, FORCE_SHOW) .TP OSG_MINIMUM_COMPILE_TIME_PER_FRAME minimum compile time alloted to compiling OpenGL objects per frame in database pager. .TP OSG_MULTI_SAMPLES Set the hint for the number of samples to use when multi\-sampling. .TP OSG_NEAR_FAR_RATIO Set the ratio between near and far planes \- must greater than 0.0 but less than 1.0. .TP OSG_NOTIFY_LEVEL FATAL | WARN | NOTICE | DEBUG_INFO | DEBUG_FP | DEBUG | INFO | ALWAYS .TP OSG_NUM_DATABASE_THREADS Set the hint for the total number of threads to set up in the DatabasePager. .TP OSG_NUM_HTTP_DATABASE_THREADS Set the hint for the total number of threads dedicated to http requests to set up in the DatabasePager. .TP OSG_NvOptimusEnablement Set the hint to NvOptimus of whether to enable it or not, set 1 to enable, 0 to disable .TP OSG_OPTIMIZER " []" OFF | DEFAULT | FLATTEN_STATIC_TRANSFORMS | FLATTEN_STATIC_TRANSFORMS_DUPLICATING_SHARED_SUBGRAPHS | REMOVE_REDUNDANT_NODES | COMBINE_ADJACENT_LODS | SHARE_DUPLICATE_STATE | MERGE_GEOMETRY | MERGE_GEODES | SPATIALIZE_GROUPS | COPY_SHARED_NODES | OPTIMIZE_TEXTURE_SETTINGS | REMOVE_LOADED_PROXY_NODES | TESSELLATE_GEOMETRY | CHECK_GEOMETRY | FLATTEN_BILLBOARDS | TEXTURE_ATLAS_BUILDER | STATIC_OBJECT_DETECTION | INDEX_MESH | VERTEX_POSTTRANSFORM | VERTEX_PRETRANSFORM | BUFFER_OBJECT_SETTINGS .TP OSG_RUN_FRAME_COUNT Set the maximum number of frames to run the viewer run method. .TP OSG_RUN_FRAME_SCHEME Frame rate manage scheme that viewer run should use, ON_DEMAND or CONTINUOUS (default). .TP OSG_RUN_MAX_FRAME_RATE Set the maximum number of frame as second that viewer run. 0.0 is default and disables an frame rate capping. .TP OSG_SCREEN Set the default screen that windows should open up on. .TP OSG_SCREEN_DISTANCE Physical distance between eyes and screen. .TP OSG_SCREEN_HEIGHT Physical screen height. .TP OSG_SCREEN_WIDTH Physical screen width. .TP OSG_SERIALIZE_DRAW_DISPATCH OFF | ON Disable/enable the use of a mutex to serialize the draw dispatch when there are multiple graphics threads. .TP OSG_SPLIT_STEREO_AUTO_ADJUST_ASPECT_RATIO OFF | ON Default to OFF 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. .TP OSG_SPLIT_STEREO_HORIZONTAL_EYE_MAPPING LEFT_EYE_LEFT_VIEWPORT | LEFT_EYE_RIGHT_VIEWPORT .TP OSG_SPLIT_STEREO_HORIZONTAL_SEPARATION Number of pixels between viewports. .TP OSG_SPLIT_STEREO_VERTICAL_EYE_MAPPING LEFT_EYE_TOP_VIEWPORT | LEFT_EYE_BOTTOM_VIEWPORT .TP OSG_SPLIT_STEREO_VERTICAL_SEPARATION Number of pixels between viewports. .IP OSG_STEREO OFF | ON OSG_STEREO_MODE .TP QUAD_BUFFER | ANAGLYPHIC | HORIZONTAL_SPLIT | VERTICAL_SPLIT | LEFT_EYE | RIGHT_EYE | VERTICAL_INTERLACE | HORIZONTAL_INTERLACE .TP OSG_SWAP_METHOD DEFAULT | EXCHANGE | COPY | UNDEFINED. Select preferred swap method. .TP OSG_TEXTURE_POOL_SIZE Set the hint for the size of the texture pool to manage. .TP OSG_TEXT_SHADER_TECHNIQUE Set the defafult osgText::ShaderTechnique. ALL_FEATURES | ALL | GREYSCALE | SIGNED_DISTANCE_FIELD | SDF | NO_TEXT_SHADER | NONE .TP OSG_THREADING Set the threading model using by Viewer, can be SingleThreaded, CullDrawThreadPerContext, DrawThreadPerContext or CullThreadPerCameraDrawThreadPerContext. .TP OSG_USE_SCENEVIEW_FOR_STEREO OFF | ON Disable/enable the hint to use osgUtil::SceneView to implement stereo when required.. .TP OSG_VERTEX_BUFFER_HINT Set the hint to what backend osg::Geometry implementation to use. NO_PREFERENCE | VERTEX_BUFFER_OBJECT | VERTEX_ARRAY_OBJECT .TP OSG_WINDOW x y width height Set the default window dimensions that windows should open up on. .TP OSG_WRITE_OUT_DEFAULT_VALUES ON | OFF .SS "options:" .HP \fB\-O\fR option \- ReaderWriter option .TP \fB\-\-compressed\fR \- Enable the usage of compressed textures, defaults to OpenGL ARB compressed textures. .HP \fB\-\-compressed\-arb\fR \- Enable the usage of OpenGL ARB compressed textures .HP \fB\-\-compressed\-dxt1\fR \- Enable the usage of S3TC DXT1 compressed textures .HP \fB\-\-compressed\-dxt3\fR \- Enable the usage of S3TC DXT3 compressed textures .HP \fB\-\-compressed\-dxt5\fR \- Enable the usage of S3TC DXT5 compressed textures .TP \fB\-\-fix\-transparency\fR \- fix statesets which are currently declared as transparent, but should be opaque. Defaults to using the fixTranspancyMode MAKE_OPAQUE_TEXTURE_STATESET_OPAQUE. .TP \fB\-\-fix\-transparency\-mode\fR \- fix statesets which are currently declared as transparent but should be opaque. The mode_string determines which algorithm is used to fix the transparency, options are: .TP MAKE_OPAQUE_TEXTURE_STATESET_OPAQUE, MAKE_ALL_STATESET_OPAQUE. .TP \fB\-l\fR libraryName \- load plugin of name libraryName i.e. \fB\-l\fR osgdb_pfb Useful for loading reader/writers which can load other file formats in addition to its extension. .TP \fB\-e\fR extensionName \- load reader/wrter plugin for file extension i.e. \fB\-e\fR pfb Useful short hand for specifying full library name as done with \fB\-l\fR above, as it automatically expands to the full library name appropriate for each platform. .TP \fB\-o\fR orientation \- Convert geometry from input files to output files. Format of orientation argument must be the following: .TP X1,Y1,Z1\-X2,Y2,Z2 or .IP degrees\-A0,A1,A2 .TP 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 .TP 0,1,0\-0,0,1 or .IP \fB\-90\-1\fR,0,0 .TP \fB\-t\fR translation \- Convert spatial position of output files. Format of translation argument must be the following : .IP X,Y,Z .TP where X, Y, and Z represent the coordinates of the absolute position in world space .TP \fB\-\-use\-world\-frame\fR \- Perform transformations in the world frame, rather than relative to the center of the bounding sphere. .TP \fB\-\-simplify\fR n \- Run simplifier prior to output. Argument must be a normalized value for the resultant percentage reduction. Example: \fB\-\-simplify\fR .5 .IP will produce a 50% reduced model. .TP \fB\-s\fR scale \- Scale size of model. Scale argument must be the following : .IP SX,SY,SZ .TP where SX, SY, and SZ represent the scale factors Caution: Scaling is done in destination orientation .TP \fB\-\-smooth\fR \- Smooth the surface by regenerating surface normals on all geometry nodes .TP \fB\-\-addMissingColors\fR \- Add a white color value to all geometry nodes that don't have their own color values (\fB\-\-addMissingColours\fR also accepted). .HP \fB\-\-overallNormal\fR \- Replace normals with a single overall normal. .HP \fB\-\-enable\-object\-cache\fR \- Enable caching of objects, images, etc. .HP \fB\-\-formats\fR \- List all supported formats and their supported options. .TP \fB\-\-format\fR \- Display information about the specified , where is the file extension, such as "flt". .HP \fB\-\-plugins\fR \- List all supported plugin files. .TP \fB\-\-plugin\fR \- Display information about the specified , where is the plugin's full path and file name.