Inheritance diagram for osg::ApplicationUsage:

Public Types
enum	Type { NO_HELP = 0x0, COMMAND_LINE_OPTION = 0x1, ENVIRONMENTAL_VARIABLE = 0x2, KEYBOARD_MOUSE_BINDING = 0x4, HELP_ALL = KEYBOARD_MOUSE_BINDING\|ENVIRONMENTAL_VARIABLE\|COMMAND_LINE_OPTION }

typedef std::map< std::string, std::string >	UsageMap

Public Member Functions
	ApplicationUsage ()

	ApplicationUsage (const std::string &commandLineUsage)

void	setApplicationName (const std::string &name)
	The ApplicationName is often displayed when logging errors, and frequently incorporated into the Description (below). More...

const std::string &	getApplicationName () const

void	setDescription (const std::string &desc)
	If non-empty, the Description is typically shown by the Help Handler as text on the Help display (which also lists keyboard abbreviations. More...

const std::string &	getDescription () const

void	addUsageExplanation (Type type, const std::string &option, const std::string &explanation)

void	setCommandLineUsage (const std::string &explanation)

const std::string &	getCommandLineUsage () const

void	addCommandLineOption (const std::string &option, const std::string &explanation, const std::string &defaultValue="")

void	setCommandLineOptions (const UsageMap &usageMap)

const UsageMap &	getCommandLineOptions () const

void	setCommandLineOptionsDefaults (const UsageMap &usageMap)

const UsageMap &	getCommandLineOptionsDefaults () const

void	addEnvironmentalVariable (const std::string &option, const std::string &explanation, const std::string &defaultValue="")

void	setEnvironmentalVariables (const UsageMap &usageMap)

const UsageMap &	getEnvironmentalVariables () const

void	setEnvironmentalVariablesDefaults (const UsageMap &usageMap)

const UsageMap &	getEnvironmentalVariablesDefaults () const

void	addKeyboardMouseBinding (const std::string &prefix, int key, const std::string &explanation)

void	addKeyboardMouseBinding (int key, const std::string &explanation)

void	addKeyboardMouseBinding (const std::string &option, const std::string &explanation)

void	setKeyboardMouseBindings (const UsageMap &usageMap)

const UsageMap &	getKeyboardMouseBindings () const

void	getFormattedString (std::string &str, const UsageMap &um, unsigned int widthOfOutput=80, bool showDefaults=false, const UsageMap &ud=UsageMap())

void	write (std::ostream &output, const UsageMap &um, unsigned int widthOfOutput=80, bool showDefaults=false, const UsageMap &ud=UsageMap())

void	write (std::ostream &output, unsigned int type=COMMAND_LINE_OPTION, unsigned int widthOfOutput=80, bool showDefaults=false)

void	writeEnvironmentSettings (std::ostream &output)

Public Member Functions inherited from osg::Referenced
	Referenced ()

	Referenced (bool threadSafeRefUnref)
	Deprecated, Referenced is now always uses thread safe ref/unref, use default Referenced() constructor instead. More...

	Referenced (const Referenced &)

Referenced &	operator= (const Referenced &)

virtual void	setThreadSafeRefUnref (bool)
	Deprecated, Referenced is always theadsafe so there method now has no effect and does not need to be called. More...

bool	getThreadSafeRefUnref () const
	Get whether a mutex is used to ensure ref() and unref() are thread safe. More...

OpenThreads::Mutex *	getRefMutex () const
	Get the mutex used to ensure thread safety of ref()/unref(). More...

int	ref () const
	Increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

int	unref () const
	Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. More...

int	unref_nodelete () const
	Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. More...

int	referenceCount () const
	Return the number of pointers currently referencing this object. More...

ObserverSet *	getObserverSet () const
	Get the ObserverSet if one is attached, otherwise return NULL. More...

ObserverSet *	getOrCreateObserverSet () const
	Get the ObserverSet if one is attached, otherwise create an ObserverSet, attach it, then return this newly created ObserverSet. More...

void	addObserver (Observer *observer) const
	Add a Observer that is observing this object, notify the Observer when this object gets deleted. More...

void	removeObserver (Observer *observer) const
	Remove Observer that is observing this object. More...

Static Public Member Functions
static ApplicationUsage *	instance ()

Static Public Member Functions inherited from osg::Referenced
static OpenThreads::Mutex *	getGlobalReferencedMutex ()
	Get the optional global Referenced mutex, this can be shared between all osg::Referenced. More...

static void	setDeleteHandler (DeleteHandler *handler)
	Set a DeleteHandler to which deletion of all referenced counted objects will be delegated. More...

static DeleteHandler *	getDeleteHandler ()
	Get a DeleteHandler. More...

Protected Member Functions
virtual	~ApplicationUsage ()

Protected Member Functions inherited from osg::Referenced
virtual	~Referenced ()

void	signalObserversAndDelete (bool signalDelete, bool doDelete) const

void	deleteUsingDeleteHandler () const

Protected Attributes
std::string	_applicationName

std::string	_description

std::string	_commandLineUsage

UsageMap	_commandLineOptions

UsageMap	_environmentalVariables

UsageMap	_keyboardMouse

UsageMap	_environmentalVariablesDefaults

UsageMap	_commandLineOptionsDefaults

Protected Attributes inherited from osg::Referenced
OpenThreads::AtomicPtr	_observerSet

OpenThreads::Atomic	_refCount

Member Typedef Documentation

◆ UsageMap

typedef std::map<std::string,std::string> osg::ApplicationUsage::UsageMap

Member Enumeration Documentation

◆ Type

enum osg::ApplicationUsage::Type

Enumerator
NO_HELP
COMMAND_LINE_OPTION
ENVIRONMENTAL_VARIABLE
KEYBOARD_MOUSE_BINDING
HELP_ALL

Constructor & Destructor Documentation

◆ ApplicationUsage() [1/2]

osg::ApplicationUsage::ApplicationUsage ( )

inline

◆ ApplicationUsage() [2/2]

osg::ApplicationUsage::ApplicationUsage ( const std::string & commandLineUsage )

◆ ~ApplicationUsage()

virtual osg::ApplicationUsage::~ApplicationUsage ( )

inlineprotectedvirtual

Member Function Documentation

◆ addCommandLineOption()

void osg::ApplicationUsage::addCommandLineOption	(	const std::string &	option,
		const std::string &	explanation,
		const std::string &	defaultValue = `""`
	)

◆ addEnvironmentalVariable()

void osg::ApplicationUsage::addEnvironmentalVariable	(	const std::string &	option,
		const std::string &	explanation,
		const std::string &	defaultValue = `""`
	)

◆ addKeyboardMouseBinding() [1/3]

void osg::ApplicationUsage::addKeyboardMouseBinding	(	const std::string &	prefix,
		int	key,
		const std::string &	explanation
	)

◆ addKeyboardMouseBinding() [2/3]

void osg::ApplicationUsage::addKeyboardMouseBinding	(	int	key,
		const std::string &	explanation
	)

◆ addKeyboardMouseBinding() [3/3]

void osg::ApplicationUsage::addKeyboardMouseBinding	(	const std::string &	option,
		const std::string &	explanation
	)

◆ addUsageExplanation()

void osg::ApplicationUsage::addUsageExplanation	(	Type	type,
		const std::string &	option,
		const std::string &	explanation
	)

Referenced by osg::ApplicationUsageProxy::ApplicationUsageProxy().

◆ getApplicationName()

const std::string& osg::ApplicationUsage::getApplicationName ( ) const

inline

◆ getCommandLineOptions()

const UsageMap& osg::ApplicationUsage::getCommandLineOptions ( ) const

inline

◆ getCommandLineOptionsDefaults()

const UsageMap& osg::ApplicationUsage::getCommandLineOptionsDefaults ( ) const

inline

◆ getCommandLineUsage()

const std::string& osg::ApplicationUsage::getCommandLineUsage ( ) const

inline

◆ getDescription()

const std::string& osg::ApplicationUsage::getDescription ( ) const

inline

◆ getEnvironmentalVariables()

const UsageMap& osg::ApplicationUsage::getEnvironmentalVariables ( ) const

inline

◆ getEnvironmentalVariablesDefaults()

const UsageMap& osg::ApplicationUsage::getEnvironmentalVariablesDefaults ( ) const

inline

◆ getFormattedString()

void osg::ApplicationUsage::getFormattedString	(	std::string &	str,
		const UsageMap &	um,
		unsigned int	widthOfOutput = `80`,
		bool	showDefaults = `false`,
		const UsageMap &	ud = `UsageMap()`
	)

◆ getKeyboardMouseBindings()

const UsageMap& osg::ApplicationUsage::getKeyboardMouseBindings ( ) const

inline

◆ instance()

static ApplicationUsage* osg::ApplicationUsage::instance ( )

static

Referenced by osg::ApplicationUsageProxy::ApplicationUsageProxy().

◆ setApplicationName()

void osg::ApplicationUsage::setApplicationName ( const std::string & name )

inline

The ApplicationName is often displayed when logging errors, and frequently incorporated into the Description (below).

◆ setCommandLineOptions()

void osg::ApplicationUsage::setCommandLineOptions ( const UsageMap & usageMap )

inline

◆ setCommandLineOptionsDefaults()

void osg::ApplicationUsage::setCommandLineOptionsDefaults ( const UsageMap & usageMap )

inline

◆ setCommandLineUsage()

void osg::ApplicationUsage::setCommandLineUsage ( const std::string & explanation )

inline

◆ setDescription()

void osg::ApplicationUsage::setDescription ( const std::string & desc )

inline

If non-empty, the Description is typically shown by the Help Handler as text on the Help display (which also lists keyboard abbreviations.

◆ setEnvironmentalVariables()

void osg::ApplicationUsage::setEnvironmentalVariables ( const UsageMap & usageMap )

inline

◆ setEnvironmentalVariablesDefaults()

void osg::ApplicationUsage::setEnvironmentalVariablesDefaults ( const UsageMap & usageMap )

inline

◆ setKeyboardMouseBindings()

void osg::ApplicationUsage::setKeyboardMouseBindings ( const UsageMap & usageMap )

inline

◆ write() [1/2]

void osg::ApplicationUsage::write	(	std::ostream &	output,
		const UsageMap &	um,
		unsigned int	widthOfOutput = `80`,
		bool	showDefaults = `false`,
		const UsageMap &	ud = `UsageMap()`
	)

◆ write() [2/2]

void osg::ApplicationUsage::write	(	std::ostream &	output,
		unsigned int	type = `COMMAND_LINE_OPTION`,
		unsigned int	widthOfOutput = `80`,
		bool	showDefaults = `false`
	)

◆ writeEnvironmentSettings()

void osg::ApplicationUsage::writeEnvironmentSettings ( std::ostream & output )

Member Data Documentation

◆ _applicationName

std::string osg::ApplicationUsage::_applicationName

protected

◆ _commandLineOptions

UsageMap osg::ApplicationUsage::_commandLineOptions

protected

◆ _commandLineOptionsDefaults

UsageMap osg::ApplicationUsage::_commandLineOptionsDefaults

protected

◆ _commandLineUsage

std::string osg::ApplicationUsage::_commandLineUsage

protected

◆ _description

std::string osg::ApplicationUsage::_description

protected

◆ _environmentalVariables

UsageMap osg::ApplicationUsage::_environmentalVariables

protected

◆ _environmentalVariablesDefaults

UsageMap osg::ApplicationUsage::_environmentalVariablesDefaults

protected

◆ _keyboardMouse

UsageMap osg::ApplicationUsage::_keyboardMouse

protected

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

osg/ApplicationUsage

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Member Typedef Documentation

◆ UsageMap

Member Enumeration Documentation

◆ Type

Constructor & Destructor Documentation

◆ ApplicationUsage() [1/2]

◆ ApplicationUsage() [2/2]

◆ ~ApplicationUsage()

Member Function Documentation

◆ addCommandLineOption()

◆ addEnvironmentalVariable()

◆ addKeyboardMouseBinding() [1/3]

◆ addKeyboardMouseBinding() [2/3]

◆ addKeyboardMouseBinding() [3/3]

◆ addUsageExplanation()

◆ getApplicationName()

◆ getCommandLineOptions()

◆ getCommandLineOptionsDefaults()

◆ getCommandLineUsage()

◆ getDescription()

◆ getEnvironmentalVariables()

◆ getEnvironmentalVariablesDefaults()

◆ getFormattedString()

◆ getKeyboardMouseBindings()

◆ instance()

◆ setApplicationName()

◆ setCommandLineOptions()

◆ setCommandLineOptionsDefaults()

◆ setCommandLineUsage()

◆ setDescription()

◆ setEnvironmentalVariables()

◆ setEnvironmentalVariablesDefaults()

◆ setKeyboardMouseBindings()

◆ write() [1/2]

◆ write() [2/2]

◆ writeEnvironmentSettings()

Member Data Documentation

◆ _applicationName

◆ _commandLineOptions

◆ _commandLineOptionsDefaults

◆ _commandLineUsage

◆ _description

◆ _environmentalVariables

◆ _environmentalVariablesDefaults

◆ _keyboardMouse