HDB
-
class
HDB The
HDBclass serves as a wrapper/utility class to manage an instance of the HOOPS/3dGS scene-graph.HDBStores the information of how many and which type of HOOPS driver instances the associated objectHBaseViewcreates.Index
Methods
DecrementInstanceCount()DisableErrorManager()EnableErrorManager()GetCleanInclude()GetDriverType()GetHDB()GetHImManager()GetHIOManager()GetHTManager()GetInstanceBase()GetInstanceCount()GetIsolatedDrivers()GetMaterialLibrary()GetNextCookie()GetOwnsSystem()GetPublishExchangeLicenseSet()GetPublishInitialized()GetRetainIOManager()GetUniqueID()GetUniqueIncludeKey()HDB()IncrementInstanceCount()Init()Lock()ReleaseIOManager()ReportError()SetCleanInclude()SetDriverType()SetHImManager()SetHIOManager()SetHTManager()SetInstanceBase()SetInstanceCount()SetIsolatedDrivers()SetMaterialLibrary()SetModuleDirectory()SetOwnsSystem()SetPublishExchangeLicenseSet()SetPublishInitialized()SetRetainIOManager()UnLock()~HDB()
Variables
include_counterm_bCleanIncludem_bIsolatedDriversm_bOwnsSystemm_bPublishExchangeLicenseSetm_bPublishInitializedm_bRetainIOManagerm_bUsingErrorManagerm_InstanceCountm_module_directorym_Mutexm_nextUIDm_pDriverTypem_pHDBm_pHImManagerm_pHIOManagerm_pHMaterialLibrarym_pHTManagerm_pInstanceBasenext_cookie
Methods
-
virtual void
HDB::Init() virtual
Init()initializes the HOOPS attributes for driver type and unsets the default HOOPS alias”?Picture”for the root segment of the given driver. The function also sets up a default color map and registers the HOOPS I.M. callbacks that are listed in HDB::RegisterHoopsIMCallbacks().
-
static void
HDB::IncrementInstanceCount() static
This method augments the number of instances of a driver by one.
-
static void
HDB::DecrementInstanceCount() static
This method decrements the number of instances of a driver by one.
-
static void
HDB::SetInstanceBase(char const *s) static
This method sets the base name for driver instances.
-
static void
HDB::SetDriverType(char const *s) static
This method sets the base driver type for the driver instances.
-
static char const *
HDB::GetDriverType() static
Returns
The base driver type for the driver instances.
-
static bool
HDB::GetCleanInclude() static
Returns
True if global includes should be moved to model specific includes during reading.
-
static void
HDB::SetCleanInclude(bool value) static
This method determines whether global includes should be moved to model specific includes during reading.
Parameters
value: Pass true to have global includes move to model specific includes during reading or false to keep the includes.
-
static int
HDB::GetInstanceCount() static
Returns
An integer denoting the number of instances of a driver.
-
static int
HDB::GetUniqueID() static
Returns
An integer that will be unique during the runtime of the application.
-
static void
HDB::SetInstanceCount(int count) static
This method sets the number of instances of a driver.
Parameters
count: The number of driver instances.
-
static HImManager *
HDB::GetHImManager() static
Returns
A pointer to the currentHImManagerobject (the HOOPS/3dGS I.M. manager). This method creates one if none exists.
-
static HImManager *
HDB::SetHImManager(HImManager *manager) static
This method replaces the HOOPS/3dGS I.M. manager.
Parameters
manager: A pointer to anHImManagerobject.Returns
A pointer to the replacedHImManager.
-
static HIOManager *
HDB::GetHIOManager() static
Returns
A pointer to the current HIOManager object (the input/output manager). This method creates one if none exists.
-
static HIOManager *
HDB::SetHIOManager(HIOManager *manager) static
This method replaces the input/output manager.
Parameters
manager: A pointer to an HIOManager object.Returns
A pointer to the replaced HIOManager.
-
static HMaterialLibrary *
HDB::GetMaterialLibrary() static
Returns
A pointer to the currentHMaterialLibraryobject (which manages materials resources from disk). Return value is NULL if none exists.
-
static void
HDB::SetMaterialLibrary(HMaterialLibrary *library) static
Returns
Sets the pointer to the material library.
-
static HTManager *
HDB::GetHTManager() static
Returns
A pointer to the currentHTManagerobject (the timer manager). This method creates one if none exists.
-
static HTManager *
HDB::SetHTManager(HTManager *manager) static
This method replaces the timer manager.
Parameters
manager: A pointer to anHTManagerobject.Returns
A pointer to the replacedHTManager.
-
static void
HDB::ReportError(char const *message, int severity = 1, int category = 0, int specific = 0) static
This method generates a HOOPS error. Using this method, allows the error to go through HOOPS so that it will be intercepted by whatever error handlers the app might have registered, and will use the reporting mechanism appropriate to the specific platform.
Parameters
message: The text to be posted.
severity: If the value is 0, the message is informational. If the value is 1, the message is a warning. If the value is 2, then the message is an error. If the value is 3 or greater, the error is fatal.
category: The category that this error falls under as described in #HC_Define_Error_Handler.
specific: The specific error under the category as described in #HC_Define_Error_Handler.
-
static void
HDB::EnableErrorManager() static
This method initializes the error manager and puts it in use.
-
static void
HDB::DisableErrorManager() static
This method cleans up the error manager and then disables it.
-
static void
HDB::SetIsolatedDrivers(bool isolated) static
Sets the “isolated” driver option. Allows a driver to be spawned on a separate thread. Used for background printing or multiple views.
-
static void
HDB::SetRetainIOManager(bool retain) static
Determines whether the IO Manager is retained when an
HDBis deleted. Normally it is not retained, but if a program needs to create and destroy multiple HDBs, and also uses HIO modules like DWG that can only be loaded once per process, it will need to activate retaining (and manually request the release)
-
static void
HDB::ReleaseIOManager() static
Turns off the retain state and requests the immediate release of the IO Manager if there are no active GDNs.
-
static void
HDB::SetModuleDirectory(char const *module_directory) static
Set the directory where the module is located. This is used to find the location of the module’s resources. Useful for Java application where the available location return the VM location and not the module location. Has to be set before the first call to
HDB::GetHIOManager()or it will throw.Parameters
module_directory: The directory where the module is located
Variables
-
bool
HDB::m_bCleanInclude private static
boolmove global includes to model specific include segments
-
HImManager *
HDB::m_pHImManager private static
-
HIOManager *
HDB::m_pHIOManager private static
HIOManager
-
HMaterialLibrary *
HDB::m_pHMaterialLibrary private static