openscenegraph
Public Types | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes
osgDB::Options Class Reference
Inheritance diagram for osgDB::Options:
osg::Object osg::Referenced osgDB::ImageOptions

List of all members.

Public Types

enum  CacheHintOptions {
  CACHE_NONE = 0, CACHE_NODES = 1<<0, CACHE_IMAGES = 1<<1, CACHE_HEIGHTFIELDS = 1<<2,
  CACHE_ARCHIVES = 1<<3, CACHE_OBJECTS = 1<<4, CACHE_SHADERS = 1<<5, CACHE_ALL
}
 bit mask for setting up which object types get cached by readObject/Image/HeightField/Node(filename) calls More...
enum  PrecisionHint {
  FLOAT_PRECISION_ALL = 0, DOUBLE_PRECISION_VERTEX = 1<<0, DOUBLE_PRECISION_NORMAL = 1<<1, DOUBLE_PRECISION_COLOR = 1<<2,
  DOUBLE_PRECISION_SECONDARY_COLOR = 1<<3, DOUBLE_PRECISION_FOG_COORD = 1<<4, DOUBLE_PRECISION_TEX_COORD = 1<<5, DOUBLE_PRECISION_VERTEX_ATTRIB = 1<<6,
  DOUBLE_PRECISION_ALL
}
enum  BuildKdTreesHint { NO_PREFERENCE, DO_NOT_BUILD_KDTREES, BUILD_KDTREES }
 range of options of whether to build kdtrees automatically on loading More...

Public Member Functions

 Options ()
 Options (const std::string &str)
 Options (const Options &options, const osg::CopyOp &copyop=osg::CopyOp::SHALLOW_COPY)
 META_Object (osgDB, Options)
Options * cloneOptions (const osg::CopyOp &copyop=osg::CopyOp::SHALLOW_COPY) const
void setOptionString (const std::string &str)
const std::string & getOptionString () const
void setDatabasePath (const std::string &str)
FilePathList & getDatabasePathList ()
const FilePathList & getDatabasePathList () const
void setObjectCacheHint (CacheHintOptions useObjectCache)
CacheHintOptions getObjectCacheHint () const
void setPrecisionHint (PrecisionHint hint)
PrecisionHint getPrecisionHint () const
void setBuildKdTreesHint (BuildKdTreesHint hint)
BuildKdTreesHint getBuildKdTreesHint () const
void setAuthenticationMap (AuthenticationMap *authenticationMap)
const AuthenticationMap * getAuthenticationMap () const
void setPluginData (const std::string &s, void *v) const
void * getPluginData (const std::string &s)
const void * getPluginData (const std::string &s) const
void removePluginData (const std::string &s) const
unsigned int getNumPluginData () const
void setPluginStringData (const std::string &s, const std::string &v) const
std::string & getPluginStringData (const std::string &s)
const std::string getPluginStringData (const std::string &s) const
void removePluginStringData (const std::string &s) const
unsigned int getNumPluginStringData () const
void parsePluginStringData (const std::string &str, char separator1=' ', char separator2='=')
void setFindFileCallback (FindFileCallback *cb)
FindFileCallback * getFindFileCallback () const
void setReadFileCallback (ReadFileCallback *cb)
ReadFileCallback * getReadFileCallback () const
void setWriteFileCallback (WriteFileCallback *cb)
WriteFileCallback * getWriteFileCallback () const
void setFileLocationCallback (FileLocationCallback *cb)
FileLocationCallback * getFileLocationCallback () const
void setFileCache (FileCache *fileCache)
FileCache * getFileCache () const
void setTerrain (osg::observer_ptr< osg::Node > &terrain)
const osg::observer_ptr
< osg::Node > & 
getTerrain () const

Protected Types

typedef std::map< std::string,
void * > 
PluginDataMap
typedef std::map< std::string,
std::string > 
PluginStringDataMap

Protected Member Functions

virtual ~Options ()

Protected Attributes

std::string _str
FilePathList _databasePaths
CacheHintOptions _objectCacheHint
PrecisionHint _precisionHint
BuildKdTreesHint _buildKdTreesHint
osg::ref_ptr< AuthenticationMap > _authenticationMap
PluginDataMap _pluginData
PluginStringDataMap _pluginStringData
osg::ref_ptr< FindFileCallback > _findFileCallback
osg::ref_ptr< ReadFileCallback > _readFileCallback
osg::ref_ptr< WriteFileCallback > _writeFileCallback
osg::ref_ptr
< FileLocationCallback > 
_fileLocationCallback
osg::ref_ptr< FileCache > _fileCache
osg::observer_ptr< osg::Node > _terrain

Detailed Description

Options base class used for passing options into plugins to control their operation.


Member Typedef Documentation

typedef std::map<std::string,void*> osgDB::Options::PluginDataMap [protected]
typedef std::map<std::string,std::string> osgDB::Options::PluginStringDataMap [protected]

Member Enumeration Documentation

range of options of whether to build kdtrees automatically on loading

Enumerator:
NO_PREFERENCE 
DO_NOT_BUILD_KDTREES 
BUILD_KDTREES 

bit mask for setting up which object types get cached by readObject/Image/HeightField/Node(filename) calls

Enumerator:
CACHE_NONE 

do not cache objects of any type

CACHE_NODES 

cache nodes loaded via readNode(filename)

CACHE_IMAGES 

cache images loaded via readImage(filename)

CACHE_HEIGHTFIELDS 

cache heightfield loaded via readHeightField(filename)

CACHE_ARCHIVES 

cache heightfield loaded via readHeightField(filename)

CACHE_OBJECTS 

cache objects loaded via readObject(filename)

CACHE_SHADERS 

cache shaders loaded via readShader(filename)

CACHE_ALL 

cache on all read*(filename) calls

Bit mask for which geometry attributes should be imported with double precision where source data is held in double precision This is useful for data that will be pre-processed before rendering. In general the geometry should be converted to floating point before rendering to ensure good performance.

Enumerator:
FLOAT_PRECISION_ALL 
DOUBLE_PRECISION_VERTEX 
DOUBLE_PRECISION_NORMAL 
DOUBLE_PRECISION_COLOR 
DOUBLE_PRECISION_SECONDARY_COLOR 
DOUBLE_PRECISION_FOG_COORD 
DOUBLE_PRECISION_TEX_COORD 
DOUBLE_PRECISION_VERTEX_ATTRIB 
DOUBLE_PRECISION_ALL 

Constructor & Destructor Documentation

osgDB::Options::Options ( ) [inline]
osgDB::Options::Options ( const std::string &  str) [inline]
osgDB::Options::Options ( const Options &  options,
const osg::CopyOp &  copyop = osg::CopyOp::SHALLOW_COPY 
)
virtual osgDB::Options::~Options ( ) [inline, protected, virtual]

Member Function Documentation

Options* osgDB::Options::cloneOptions ( const osg::CopyOp &  copyop = osg::CopyOp::SHALLOW_COPY) const [inline]

References osg::clone().

const AuthenticationMap* osgDB::Options::getAuthenticationMap ( ) const [inline]

Get the password map to be used by plugins when access files from secure locations.

BuildKdTreesHint osgDB::Options::getBuildKdTreesHint ( ) const [inline]

Get whether the KdTrees should be built for geometry in the loader model.

Referenced by osgDB::Registry::_buildKdTreeIfRequired().

FilePathList& osgDB::Options::getDatabasePathList ( ) [inline]

Get the database path which is used a hint of where to look when loading models.

const FilePathList& osgDB::Options::getDatabasePathList ( ) const [inline]

Get the const database path which is used a hint of where to look when loading models.

FileCache* osgDB::Options::getFileCache ( ) const [inline]

Get the FileCache that is used to manage local storage of files downloaded from the internet.

FileLocationCallback* osgDB::Options::getFileLocationCallback ( ) const [inline]

Get the callback to use inform the DatabasePager whether a file is located on local or remote file system.

FindFileCallback* osgDB::Options::getFindFileCallback ( ) const [inline]

Get the const findFile callback.

Referenced by osgDB::Registry::findDataFile(), and osgDB::Registry::findLibraryFile().

unsigned int osgDB::Options::getNumPluginData ( ) const [inline]

Get number of PluginData values

unsigned int osgDB::Options::getNumPluginStringData ( ) const [inline]

Get number of PluginStrData values

CacheHintOptions osgDB::Options::getObjectCacheHint ( ) const [inline]

Get whether the Registry::ObjectCache should be used by default.

const std::string& osgDB::Options::getOptionString ( ) const [inline]

Get the general Options string.

void* osgDB::Options::getPluginData ( const std::string &  s) [inline]

Get a value from the PluginData

const void* osgDB::Options::getPluginData ( const std::string &  s) const [inline]

Get a value from the PluginData

std::string& osgDB::Options::getPluginStringData ( const std::string &  s) [inline]

Get a string from the PluginStrData

const std::string osgDB::Options::getPluginStringData ( const std::string &  s) const [inline]

Get a value from the PluginData

PrecisionHint osgDB::Options::getPrecisionHint ( ) const [inline]

Get which geometry attributes plugins should import at double precision.

ReadFileCallback* osgDB::Options::getReadFileCallback ( ) const [inline]
const osg::observer_ptr<osg::Node>& osgDB::Options::getTerrain ( ) const [inline]

Get the terrain observer_ptr, use to decorate any osgTerrain subgraphs.

WriteFileCallback* osgDB::Options::getWriteFileCallback ( ) const [inline]
osgDB::Options::META_Object ( osgDB  ,
Options   
)
void osgDB::Options::parsePluginStringData ( const std::string &  str,
char  separator1 = ' ',
char  separator2 = '=' 
)

Parse string into plugin string data. This will be automatically done in Options(const std::string&)

void osgDB::Options::removePluginData ( const std::string &  s) const [inline]

Remove a value from the PluginData

void osgDB::Options::removePluginStringData ( const std::string &  s) const [inline]

Remove a value from the PluginData

void osgDB::Options::setAuthenticationMap ( AuthenticationMap *  authenticationMap) [inline]

Set the password map to be used by plugins when access files from secure locations.

void osgDB::Options::setBuildKdTreesHint ( BuildKdTreesHint  hint) [inline]

Set whether the KdTrees should be built for geometry in the loader model.

void osgDB::Options::setDatabasePath ( const std::string &  str) [inline]

Set the database path to use a hint of where to look when loading models.

void osgDB::Options::setFileCache ( FileCache *  fileCache) [inline]

Set the FileCache that is used to manage local storage of files downloaded from the internet.

void osgDB::Options::setFileLocationCallback ( FileLocationCallback *  cb) [inline]

Set the callback to use inform the DatabasePager whether a file is located on local or remote file system.

void osgDB::Options::setFindFileCallback ( FindFileCallback *  cb) [inline]

Set the find callback to use in place of the default findFile calls.

void osgDB::Options::setObjectCacheHint ( CacheHintOptions  useObjectCache) [inline]

Set whether the Registry::ObjectCache should be used by default.

void osgDB::Options::setOptionString ( const std::string &  str) [inline]

Set the general Options string.

void osgDB::Options::setPluginData ( const std::string &  s,
void *  v 
) const [inline]

Sets a plugindata value PluginData with a string

void osgDB::Options::setPluginStringData ( const std::string &  s,
const std::string &  v 
) const [inline]

Sets a plugindata value PluginData with a string

void osgDB::Options::setPrecisionHint ( PrecisionHint  hint) [inline]

Set which geometry attributes plugins should import at double precision.

void osgDB::Options::setReadFileCallback ( ReadFileCallback *  cb) [inline]

Set the read callback to use in place of the default readFile calls.

void osgDB::Options::setTerrain ( osg::observer_ptr< osg::Node > &  terrain) [inline]

Set the terrain observer_ptr, use to decorate any osgTerrain subgraphs.

void osgDB::Options::setWriteFileCallback ( WriteFileCallback *  cb) [inline]

Set the callback to use in place of the default writeFile calls.


Member Data Documentation

std::string osgDB::Options::_str [protected]

The documentation for this class was generated from the following file: