Documentation

Create a set of VRML writing connection hints from command line.

This function can be used to allow your programs to support a number of standard command line arguments for specifying preferences for writing TerraVRML file.

The function will scan the provided command line looking for any supported arguments. It will build a TsmConnectionParams structure based upon the options that it finds and return this to you the client. This TsmConnectionParams structure can then be passed directly to tsmConnect when opening a connection.

You should free the memory used by the TsmConnectionParams structure when you are finished with it by calling tsmFreeParams().

For example, if this function finds an option called "-gaussian" on the command line, it will insert an entry into the TsmConnectionParams structure to say that TerraVRML files should be written out with gaussian interpolation of elevation.

The currently supported options that this function recognises are:

• "-vrmldir <dir>" = directory where this dataset will be written to
• "-texurn <URN>" = URN of terrain texture map (multiple instances allowed)
• "-lcs <meters>" = start of local coordinate system in meters (multiple instances allowed)
• "-numpolys <n>" = polygons per side on a vtile
• "-lods <n>" = number of lods in one tree file
• "-treeskip <n>" = levels to skip between tree files
• "-gaussian" = use gaussian elevation interpolation instead of linear
• "-collision" = turn on collision detection for VRML geometry
• "-testvtiles" = create flat, randomly-colored vtiles
• "-start <n>" = TV start pyramid level (def=lowest-res)
• "-end <n>" = TV end pyramid level (def=highest-res)
• "-pixpertex <ratio>" = scale for LOD range calc (def=1.0)
• "-flat" = creates a flat world model (in lat-long coordinates) instead of a globe (in geocentric coordinates)
• "-utm" = creates a flat world model (in UTM coordinates) instead of a globe (in geocentric coordinates)
• "-elevscale" = sets the elevation scaling relative to lat/long dimensions (default = 1.0)
• "-worldscale" = sets the scale of the world (default 1 unit = 1 meter)
• "-anchortrees" = use the Anchor form of tree files
• "-quadlodtrees" = use the QuadLOD form of tree files
• "-lodtrees" = use the regular LOD form of tree files with no anchors
• "-nogeotiles" = do not generate geotiles for each tree file
• "-nonormals" = do not generate normals for each vtile file
• "-normals" = generate normals for each vtile file
• "-fastbbox" = use a faster (but approx) bbox calc for trees
• "-absurl" or "-vrmlurl" = set the absolute root URL
• "-rootlevel" = set the root tree file level for entry point
• "-include_vtiles" = include the vtile data directly in the tree file