VR-Forces Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members | Public Member Functions | Protected Types
makVrv::DtBaseSettingsManager< RecordType > Class Template Referenceabstract

template<typename RecordType>
class makVrv::DtBaseSettingsManager< RecordType >

Base class for (non-shared) settings managers. Extends the functionality provided by the DtCommonBaseSettingsManager, by implementing the initializeBackup method. Since the backups for all non-shared settings are handled the same, new non-shared settings managers should use DtBaseSettingsManager as its base class to make use of the common initializeBackup code.

Inheritance diagram for makVrv::DtBaseSettingsManager< RecordType >:
Inheritance graph
[legend]

Public Member Functions

 DtBaseSettingsManager (DtDe &de, const std::string &name, const std::string &displayName, const std::string &ext)
 
virtual ~DtBaseSettingsManager ()
 
Setting Persistence Methods
virtual void initializeBackup ()
 
virtual void setFromRecord (const RecordType &record)=0
 
virtual void getRecord (RecordType &record) const =0
 
virtual bool applyFactoryOverrides (RecordType &record) const =0
 
virtual bool getOverriddenFactoryRecord (RecordType &record) const
 
- Public Member Functions inherited from makVrv::DtCommonBaseSettingsManager< RecordType >
 DtCommonBaseSettingsManager (DtDe &de, const std::string &name, const std::string &displayName, const std::string &ext)
 
virtual ~DtCommonBaseSettingsManager ()
 
virtual void autoSaveIfNecessary ()
 
virtual void setAutoSave (bool doit)
 
virtual bool autoSave () const
 
virtual void setUseDefaultSettingsRecord (bool useit)
 
virtual bool useDefaultSettingsRecord () const
 
virtual DtDeSettingssettings ()
 
virtual const DtDeSettingssettings () const
 
virtual DtSettingsBackupsettingsBackup ()
 
virtual const DtSettingsBackupsettingsBackup () const
 
virtual void loadDefaults ()
 
virtual void saveDefaultSettings ()
 
virtual void loadDefaultSettings (bool loadOnlyFactorySettings)
 
virtual void importSettings (const std::string &filePath)
 
virtual void exportSettings (const std::string &filePath) const
 
- Public Member Functions inherited from makVrv::DtVirtualBaseClass
 DtVirtualBaseClass ()
 
virtual ~DtVirtualBaseClass ()
 

Protected Types

typedef DtRecordSettingsBackup
< DtBaseSettingsManager
< RecordType >, RecordType > 
RecordBackupType
 

Additional Inherited Members

- Protected Attributes inherited from makVrv::DtCommonBaseSettingsManager< RecordType >
DtSignalConnectionManager myConnections
 
std::string myName
 
std::string myExtension
 
std::string myDisplayName
 
bool myUseDefaultSettingsRecordFlag
 
bool myAutoSaveFlag
 
DtSettingsBackupmySettingsBackup
 
DtDemyDe
 

Member Typedef Documentation

template<typename RecordType>
typedef DtRecordSettingsBackup<DtBaseSettingsManager<RecordType>,RecordType> makVrv::DtBaseSettingsManager< RecordType >::RecordBackupType
protected

Constructor & Destructor Documentation

template<typename RecordType>
makVrv::DtBaseSettingsManager< RecordType >::DtBaseSettingsManager ( DtDe de,
const std::string &  name,
const std::string &  displayName,
const std::string &  ext 
)
inline
template<typename RecordType>
virtual makVrv::DtBaseSettingsManager< RecordType >::~DtBaseSettingsManager ( )
inlinevirtual

Virtual DTOR.

Member Function Documentation

template<typename RecordType>
virtual void makVrv::DtBaseSettingsManager< RecordType >::initializeBackup ( )
inlinevirtual

Creates a backup of the settings' current state.

Implements makVrv::DtCommonBaseSettingsManager< RecordType >.

Reimplemented in makVrv::DtShadowSettingsManager, and makVrv::DtObserverModeManager.

template<typename RecordType>
virtual void makVrv::DtBaseSettingsManager< RecordType >::setFromRecord ( const RecordType &  record)
pure virtual
template<typename RecordType>
virtual void makVrv::DtBaseSettingsManager< RecordType >::getRecord ( RecordType &  record) const
pure virtual
template<typename RecordType>
virtual bool makVrv::DtBaseSettingsManager< RecordType >::applyFactoryOverrides ( RecordType &  record) const
pure virtual

Get overrides to the factory record, if any. If there are overrides, this function returns true. This is an internal utility function used by VR-Vantage engineers to update factory defaults. As a result, this function returns false in releases but can be overriden by toolkit users if desired; however, generally toolkit users can and should use DtDeInitializer::addDefaultSettingsRecord(...) instead.

Implemented in makVrv::DtShadowSettingsManager, makVrv::DtObserverModeManager, makVrv::DtDistributedEnvironmentSettingsManager, makVrv::DtGridLinesSettingsManager, makVrv::DtVirtualRealitySettingsManager, makVrv::DtAudioSettingsManager, makVrv::DtIntervisibilitySettingsManager, makVrv::DtForestSettingsManager, makVrv::DtCloudLayerSettingsManager, and makVrv::DtExampleSettingsManager.

Referenced by makVrv::DtBaseSettingsManager< makArchives::DtOculusSettingsRecord >::getOverriddenFactoryRecord().

template<typename RecordType>
virtual bool makVrv::DtBaseSettingsManager< RecordType >::getOverriddenFactoryRecord ( RecordType &  record) const
inlinevirtual

Get overrides to the factory record, if any. If there are overrides, this function returns true. This is an internal utility function used by VR-Vantage engineers to update factory defaults. As a result, this function returns false in releases but can be overriden by toolkit users if desired; however, generally toolkit users can and should use DtDeInitializer::addDefaultSettingsRecord(...) instead.

Implements makVrv::DtCommonBaseSettingsManager< RecordType >.


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

Document ID: Generated on Thu Oct 23 22:29:17 EDT 2025 from SVN revision 280951
Copyright © 2005-2024 MAK Technologies. All Rights Reserved (www.mak.com)