Overview

Sample Code

Programming Guide

API Reference

Support

HPS::World Class Reference

#include <hps.h>

Inheritance diagram for HPS::World:
HPS::Object

Public Member Functions

HPS::Type ObjectType () const
 
WorldSetDriverConfigFile (char const *in_filename)
 
WorldSetExchangeLibraryDirectory (char const *in_directory)
 
WorldSetFontDirectories (size_t in_count, UTF8 const in_directories[])
 
WorldSetFontDirectories (UTF8Array const &in_directories)
 
WorldSetFontDirectory (char const *in_directory)
 
WorldSetMaterialLibraryDirectory (char const *in_directory)
 
WorldSetParasolidBodyshopDirectory (char const *in_directory)
 
WorldSetParasolidSchemaDirectory (char const *in_directory)
 
WorldSetPublishResourceDirectory (char const *in_directory)
 
WorldSetRealDWGDirectory (char const *in_directory)
 
WorldSetRealDWGDirectory (char const *in_directory, UTF8Array const &in_object_enabler_directories)
 
bool ShowDriverConfigFile (UTF8 &out_filename) const
 
bool ShowExchangeLibraryDirectory (UTF8 &out_directory) const
 
bool ShowFontDirectories (UTF8Array &out_directories) const
 
bool ShowLicense (UTF8 &out_license) const
 
bool ShowMaterialLibraryDirectory (UTF8 &out_directory) const
 
bool ShowParasolidBodyshopDirectory (UTF8 &out_directory) const
 
bool ShowParasolidSchemaDirectory (UTF8 &out_directory) const
 
bool ShowPublishResourceDirectory (UTF8 &out_directory) const
 
bool ShowRealDWGDirectory (UTF8 &out_directory, UTF8Array &out_object_enabler_directories) const
 
WorldUnsetDriverConfigFile ()
 
WorldUnsetExchangeLibraryDirectory ()
 
WorldUnsetFontDirectories ()
 
WorldUnsetMaterialLibraryDirectory ()
 
WorldUnsetParasolidBodyshopDirectory ()
 
WorldUnsetParasolidSchemaDirectory ()
 
WorldUnsetPublishResourceDirectory ()
 
WorldUnsetRealDWGDirectory ()
 
 World (char const *in_license)
 
 ~World ()
 
- Public Member Functions inherited from HPS::Object
virtual bool Empty () const
 
intptr_t GetClassID () const
 
intptr_t GetInstanceID () const
 
bool HasType (HPS::Type in_mask) const
 
 Object (Object const &that)
 
 Object (Object &&in_that)
 
Objectoperator= (Object const &other_object)
 
Objectoperator= (Object &&in_that)
 
HPS::Type Type () const
 

Additional Inherited Members

- Static Public Member Functions inherited from HPS::Object
template<typename T >
static intptr_t ClassID ()
 

Detailed Description

The World class is a special object that must be constructed prior to making any database calls and must exist for the life of the application.

Constructor & Destructor Documentation

HPS::World::World ( char const *  in_license)

This constructor creates a new World object with the given license. The license string determines what functionality is available in Visualize. There should only be one World object that is constructed during the life of the application.

Parameters
in_licenseUTF8-encoded license string for Visualize.
HPS::World::~World ( )

The destructor will shutdown the database and invalidate all objects within it.

Member Function Documentation

HPS::Type HPS::World::ObjectType ( ) const
inlinevirtual

This function returns the type the object, as declared. This does not necessarily give the true type of the underlying object.

Returns
The declared type of the object in question, which may differ from the true, underlying type.

Reimplemented from HPS::Object.

World& HPS::World::SetDriverConfigFile ( char const *  in_filename)

Sets the driver configuration file (i.e., a plain text file which can force device specific behavior) for Visualize. To ensure the settings within the configuration file take effect, this file must be specified prior to creating a driver which will be affected by the settings.

Parameters
in_filenameUTF8-encoded file name.
Returns
A reference to this World object.
World& HPS::World::SetExchangeLibraryDirectory ( char const *  in_directory)

Sets the directory which contains the Exchange and Publish libraries. If this is set, the Exchange and Publish Visualize modules will try to load the libraries from this directory. If this is not set, those modules will try to load the libraries from the directories in the application's PATH. Note that this function will append the given directory to the PATH.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetFontDirectories ( size_t  in_count,
UTF8 const  in_directories[] 
)

Sets the directories which contain fonts for use by Visualize. This must be specified for Visualize to make use of any fonts beyond those Visualize defines itself.

Parameters
in_countSize of the following array.
in_directoriesArray of UTF8-encoded directory names.
Returns
A reference to this World object.
World& HPS::World::SetFontDirectories ( UTF8Array const &  in_directories)

Sets the directories which contain fonts for use by Visualize. This must be specified for Visualize to make use of any fonts beyond those Visualize defines itself.

Parameters
in_directoriesArray of UTF8-encoded directory names.
Returns
A reference to this World object.
World& HPS::World::SetFontDirectory ( char const *  in_directory)

Sets the directory which contains fonts for use by Visualize. This must be specified for Visualize to make use of any fonts beyond those Visualize defines itself.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetMaterialLibraryDirectory ( char const *  in_directory)

Sets the directory which contains the material library for Visualize. This must be specified to ensure any files which use the material library display correctly.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetParasolidBodyshopDirectory ( char const *  in_directory)

Sets the Parasolid Bodyshop directory. If this directory is specified, Exchange will use the Parasolid Bodyshop to translate files to Parasolid parts.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetParasolidSchemaDirectory ( char const *  in_directory)

Sets the schema directory for Parasolid. This directory must be specified to make use of the Parasolid module.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetPublishResourceDirectory ( char const *  in_directory)

Sets the resource directory for Publish. This is not the directory which contains the libraries (see World::SetExchangeLibraryDirectory), but rather the directory which contains fonts and associated mappings and files used during PDF generation. This directory must be specified to make use of the Publish module.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetRealDWGDirectory ( char const *  in_directory)

Sets the RealDWG directory. This directory must be specified to make use of the DWG module.

Parameters
in_directoryUTF8-encoded directory name.
Returns
A reference to this World object.
World& HPS::World::SetRealDWGDirectory ( char const *  in_directory,
UTF8Array const &  in_object_enabler_directories 
)

Sets the RealDWG directory and its related Object Enabler directories. This RealDWG directory must be specified to make use of the DWG module.

Parameters
in_directoryUTF8-encoded directory name.
in_object_enabler_directoriesA list of UTF8-encoded directory names.
Returns
A reference to this World object.
bool HPS::World::ShowDriverConfigFile ( UTF8 out_filename) const

Shows the driver configuration file for Visualize.

Parameters
out_filenameUTF8-encoded file names.
Returns
true if font directories were specified, false otherwise.
bool HPS::World::ShowExchangeLibraryDirectory ( UTF8 out_directory) const

Shows the Exchange and Publish library directory.

Parameters
out_directoryUTF8-encoded directory name.
Returns
true if an Exchange and Publish directory was specified, false otherwise.
bool HPS::World::ShowFontDirectories ( UTF8Array &  out_directories) const

Shows the font directories for Visualize.

Parameters
out_directoriesArray of UTF8-encoded directory names.
Returns
true if font directories were specified, false otherwise.
bool HPS::World::ShowLicense ( UTF8 out_license) const

Shows the license passed to the World constructor.

Parameters
out_licenseUTF8-encoded license string.
Returns
true if a license was specified, false otherwise.
bool HPS::World::ShowMaterialLibraryDirectory ( UTF8 out_directory) const

Shows the material library directory for Visualize.

Parameters
out_directoryUTF8-encoded directory name.
Returns
true if a material library directory was specified, false otherwise.
bool HPS::World::ShowParasolidBodyshopDirectory ( UTF8 out_directory) const

Shows the Parasolid Bodyshop directory.

Parameters
out_directoryUTF8-encoded directory name.
Returns
true if a Parasolid Bodyshop directory was specified, false otherwise.
bool HPS::World::ShowParasolidSchemaDirectory ( UTF8 out_directory) const

Shows the Parasolid schema directory.

Parameters
out_directoryUTF8-encoded directory name.
Returns
true if a Parasolid schema directory was specified, false otherwise.
bool HPS::World::ShowPublishResourceDirectory ( UTF8 out_directory) const

Shows the Publish resource directory.

Parameters
out_directoryUTF8-encoded directory name.
Returns
true if a Publish resource directory was specified, false otherwise.
bool HPS::World::ShowRealDWGDirectory ( UTF8 out_directory,
UTF8Array &  out_object_enabler_directories 
) const

Shows the RealDWG directory and any related Object Enabler directories.

Parameters
out_directoryUTF8-encoded directory name.
out_object_enabler_directoriesA list of UTF8-encoded directory names.
Returns
true if a RealDWG directory was specified, false otherwise.
World& HPS::World::UnsetDriverConfigFile ( )

Removes the driver configuration file for Visualize.

Returns
A reference to this World object.
World& HPS::World::UnsetExchangeLibraryDirectory ( )

Removes the Exchange and Publish library directory. Note, this will remove the previously specified directory from the PATH.

Returns
A reference to this World object.
World& HPS::World::UnsetFontDirectories ( )

Removes the font directories for Visualize.

Returns
A reference to this World object.
World& HPS::World::UnsetMaterialLibraryDirectory ( )

Removes the material library directory for Visualize.

Returns
A reference to this World object.
World& HPS::World::UnsetParasolidBodyshopDirectory ( )

Removes the Parasolid Bodyshop directory.

Returns
A reference to this World object.
World& HPS::World::UnsetParasolidSchemaDirectory ( )

Removes the Parasolid schema directory.

Returns
A reference to this World object.
World& HPS::World::UnsetPublishResourceDirectory ( )

Removes the Publish resource directory.

Returns
A reference to this World object.
World& HPS::World::UnsetRealDWGDirectory ( )

Removes the RealDWG directory and any Object Enabler directories.

Returns
A reference to this World object.

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