Version 3 (modified by martin, 10 years ago)



osgarchive is a utility program that creates and reads database archives. These archives can then be used at runtime with standard OSG applications such as Osgviewer?.

Quick step by step guide on using osgarchive.

  1. Creating a new archive
    To create an archive you have to specify the archive filename, including extension, via the -a <filename> switch, and the insert 3d database and imagery files into the archive vie the -i <filename> [ <filename> ..] syntax such as:
    osgarchive -a archive.osga -i cow.osg glider.osg
    You may also insert the contents of whole directories using the same syntanx.
    osgarchive -a archive.osga -i mydirectory
    The .osga format also has support for a master file, which is set to the first file inserted into the archive.

#Listing files contained in the archive\\ To list all the files contained specify the archive, then use the -l switch: \\ osgarchive -a archive.osga -l \\ This will print out the list of files contained within the archive. \\ \\

#Extracting files from an archive\\ To extract files from the archive specify the archive, then use the -e <filename> [<filename>...] syntanx: \\ osgarchive -a archive.osga -e cow.osg !!!Using archives in other [=OpenSceneGraph=] applications Archive files can be read just like normal OSG files, with the file extraction happening transparently with ReferenceGuides/{{osgDB}}. To load the archive's master file simple load the archive itself: ->osgviewer archive.osga Or to load a specific file within the archive: ->osgviewer archive.osga/glider.osg Or programmatically: ->osg::ref_ptr<osg::Node> masterNode = osgDB::readNodeFile("archive.osga"); ->osg::ref_ptr<osg::Node> gliderNode = osgDB::readNodeFile("archive.osga/glider.osg"); !!!Generating archives for paged databases from osgdem The UserGuides/{{Osgdem}} utility program also has support for generating .osga archives, simply by specify -a <filename> its possible to put all osgdem generated tiles into a single archive file. !!!File formats that are support by archiving The [=OpenSceneGraph=] mechanism for archive support uses istream and ostreams for streaming data in and out of the archive, and not all 3d database and image file formats supported by the [=OpenSceneGraph=] also support istream and ostreams. Follows are is a list of formats that are currently supported: *.osg [=OpenSceneGraph=] native ascii format *.ive [=OpenSceneGraph=] native binary format *.dds [=DirectDrawSurface?=] image file format *.jp2 [=JPEG2000=] imagery file format