CFx SDK Documentation  2023 SP0
Public Member Functions | List of all members
OdIfcHostAppServices Class Reference

#include <IfcHostAppServices.h>

Inheritance diagram for OdIfcHostAppServices:
OdDAIHostAppServicesBase OdDbBaseHostAppServices OdRxObject

Public Member Functions

 ODRX_DECLARE_MEMBERS (OdIfcHostAppServices)
 
 OdIfcHostAppServices ()
 
virtual OdRxClassdatabaseClass () const
 
virtual OdRxClassmodelClass () const
 
virtual OdIfc::OdIfcFilePtr createDatabase (InitialSchema defaultContent=kScmUndefined) const
 
virtual OdString findFile (const OdString &filename, OdDbBaseDatabase *pDb=0, FindFileHint hint=kDefault)
 
virtual const OdString program ()
 
virtual const OdString product ()
 
virtual const OdString companyName ()
 
virtual const OdString releaseMajorMinorString ()
 
virtual const OdString versionString ()
 
virtual OdString formatMessage (unsigned int errorCode,...)
 
virtual OdString getAlternateFontName () const
 
virtual OdString getFontMapFileName () const
 
virtual OdString getPreferableFont (const OdString &fontName, OdFontType fontType)
 
virtual OdString getSubstituteFont (const OdString &fontName, OdFontType fontType)
 
virtual OdString getSubstituteFontByChar (const OdFont &pFont, OdChar unicodeChar, OdDbBaseDatabase *pDb)
 
virtual OdGsDevicePtr gsBitmapDevice (OdRxObject *pViewObj=NULL, OdDbBaseDatabase *pDb=NULL, OdUInt32 flags=0)
 
virtual OdIfc::OdIfcFilePtr readFile (OdStreamBuf *pFileBuff)
 
virtual OdIfc::OdIfcFilePtr readFile (const OdString &file)
 
virtual OdResult brepBuilder (OdBrepBuilder &bbuilder, BrepType bbType)
 
- Public Member Functions inherited from OdDAIHostAppServicesBase
 ODRX_DECLARE_MEMBERS (OdDAIHostAppServicesBase)
 
OdDAI::OdHeaderSectionPtr getHeaderSection (const OdString &filename)
 
- Public Member Functions inherited from OdDbBaseHostAppServices
 ODRX_DECLARE_MEMBERS (OdDbBaseHostAppServices)
 
 OdDbBaseHostAppServices ()
 
virtual OdDbHostAppProgressMeternewProgressMeter ()
 
virtual void releaseProgressMeter (OdDbHostAppProgressMeter *pProgressMeter)
 
virtual ProdIdCode prodcode ()
 
virtual int releaseMajorVersion ()
 
virtual int releaseMinorVersion ()
 
virtual void warning (const OdString &message)
 
virtual void warning (const char *warnVisGroup, const OdString &message)
 
virtual void warning (OdWarning warningOb)
 
virtual void warning (const char *warnVisGroup, OdWarning warningOb)
 
virtual OdString getErrorDescription (unsigned int errorCode)
 
virtual OdDbUndoControllerPtr newUndoController ()
 
virtual OdStreamBufPtr newUndoStream ()
 
virtual void auditPrintReport (OdAuditInfo *pAuditInfo, const OdString &strLine, int printDest) const
 
virtual bool ttfFileNameByDescriptor (const OdTtfDescriptor &description, OdString &filename)
 
virtual bool getSystemFontFolders (OdStringArray &aDirs)
 
virtual void collectFilePathsInDirectory (OdStringArray &res, const OdString &sPath, const OdString &sFilter=L"*.*")
 
virtual OdString fileDialog (int flags, const OdString &dialogCaption=OdString::kEmpty, const OdString &defExt=OdString::kEmpty, const OdString &defFilename=OdString::kEmpty, const OdString &filter=OdString::kEmpty)
 
virtual OdString getTempPath () const
 
virtual OdInt16 getMtMode () const
 
virtual int numThreads (OdDb::MultiThreadedMode mtMode)
 
- Public Member Functions inherited from OdRxObject
 ODRX_HEAP_OPERATORS ()
 
 OdRxObject ()
 
virtual ~OdRxObject ()
 
virtual OdRxObjectqueryX (const OdRxClass *pClass) const
 
virtual OdRxObjectx (const OdRxClass *pClass) const
 
virtual OdRxClassisA () const
 
virtual void addRef ()=0
 
virtual void release ()=0
 
virtual long numRefs () const
 
bool isKindOf (const OdRxClass *pClass) const
 
virtual OdRxObjectPtr clone () const
 
virtual void copyFrom (const OdRxObject *pSource)
 
virtual OdRx::Ordering comparedTo (const OdRxObject *pOther) const
 
virtual bool isEqualTo (const OdRxObject *pOther) const
 

Additional Inherited Members

- Public Types inherited from OdDbBaseHostAppServices
enum  RemapFileContext { kDrawingOpen = 0 , kXrefResolution = 1 , kRasterResolution = 2 }
 
enum  FindFileHint {
  kDefault = 0 , kFontFile = 1 , kCompiledShapeFile = 2 , kTrueTypeFontFile = 3 ,
  kEmbeddedImageFile = 4 , kXRefDrawing = 5 , kPatternFile = 6 , kTXApplication = 7 ,
  kFontMapFile = 8 , kUnderlayFile = 9 , kTextureMapFile = 10 , kPhotometricWebFile = 11
}
 
enum  GsBitmapDeviceFlags { kUseSoftwareHLR = (1 << 0) , kFor2dExportRender = (1 << 1) , kFor2dExportRenderHLR = (1 << 2) , kForThumbnail = (1 << 3) }
 
- Static Public Member Functions inherited from OdRxObject
static OdRxObjectPtr cast (const OdRxObject *pointer)
 
static OdRxClassdesc ()
 

Detailed Description

Definition at line 38 of file IfcHostAppServices.h.

Constructor & Destructor Documentation

◆ OdIfcHostAppServices()

OdIfcHostAppServices::OdIfcHostAppServices ( )

Creates a platform-specific operation services object for IFC functionality.

Member Function Documentation

◆ brepBuilder()

virtual OdResult OdIfcHostAppServices::brepBuilder ( OdBrepBuilder bbuilder,
BrepType  bbType 
)
virtual

Global setting of B-Rep triangulation.

Global setting of B-Rep triangulation.

Initializes the boundary representation builder with a product-specific implementation.

Parameters
brepBuilder[out] A reference to an instance of the boundary representation builder class to be initialized.
bbType[in] A type of boundary representation.
Returns
Returns eOk if the B-Rep builder was successfully initialized; otherwise the method returns an appropriate error code.
Remarks
The method returns eNotImplementedYet value by default.

Reimplemented from OdDbBaseHostAppServices.

◆ companyName()

virtual const OdString OdIfcHostAppServices::companyName ( )
virtual

Retrieves the current name of the client company.

Returns
Returns a string object containing the current name of the client company.
Remarks
The default implementation of this method returns oddgGetLibraryInfo()->getCompanyName(). This method is typically used for populating information about the client's company.

Implements OdDbBaseHostAppServices.

◆ createDatabase()

virtual OdIfc::OdIfcFilePtr OdIfcHostAppServices::createDatabase ( InitialSchema  defaultContent = kScmUndefined) const
virtual

Creates a new instance of the <link OdIfc::OdIfcFile, OdIfcFile> class.

Parameters
defaultContent[in] A value of the default database content flag.
Returns
Returns a smart pointer to the <link OdIfc::OdIfcFile, OdIfcFile> object that represents the created database instance.
Remarks
The default database content flag determines whether the newly created database is populated with the default set of objects (by default). If the parameter value is equal to kNotInitialized, the database default content is not initialized. The host application services object is associated with the newly created database.

◆ databaseClass()

virtual OdRxClass* OdIfcHostAppServices::databaseClass ( ) const
virtual

Retrieves the IFC database class description.

Returns
Returns the desc() method's result of the <link OdIfc::OdIfcFile, OdIfcFile> object.

Implements OdDAIHostAppServicesBase.

◆ findFile()

virtual OdString OdIfcHostAppServices::findFile ( const OdString filename,
OdDbBaseDatabase pDb = 0,
FindFileHint  hint = kDefault 
)
virtual

Searches for a specified file.

Parameters
filename[in] A name of the file to find.
pDb[in] A pointer to the database context. If the parameter value is equal to NULL, the file search is not related to a database.
hint[in] A hint that indicates the type of file that is required.
Returns
Returns the full path to the found file; if the file was not found, the method returns an empty string.
Remarks
This method is called by IFC SDK when it needs to get access to a file, such as a font file, a template file, etc. If the pDb parameter value is not equal to NULL, it is possible to call the getFilename() method of the database instance to determine the full path to the IFC file associated with the database. The typical search order is the following:

The file name itself.

The current directory.

The drawing directory (for SHX font, image, and xref files).

The Windows fonts directory (only for TTF fonts on Windows platforms).

The hint parameter's value must be one of the following:

Value Description Extension kDefault 0 Any file. any kFontFile 1 Can be either SHX or TTF file. SHX or TTF kCompiledShapeFile 2 SHX file. SHX kTrueTypeFontFile 3 TTF file. TTF kEmbeddedImageFile 4 Image file. ISM kXRefDrawing 5 External reference file. kPatternFile 6 Pattern file (PAT). PAT kDRXApplication 7 DRX application file. DRX kFontMapFile 8 FontMap file. FMP

Implements OdDbBaseHostAppServices.

◆ formatMessage()

virtual OdString OdIfcHostAppServices::formatMessage ( unsigned int  errorCode,
  ... 
)
virtual

details Formats an error message string corresponding to the specified error code(s).

Parameters
errorCode[in] An error code.
Returns
Returns a string with a formatted error message.

Reimplemented from OdDbBaseHostAppServices.

◆ getAlternateFontName()

virtual OdString OdIfcHostAppServices::getAlternateFontName ( ) const
virtual

Retrieves the current default font name.

Returns
Returns the path to the font file to be used when a given font file can not be found by IFC SDK.
Remarks
The default implementation of the method returns an empty string.
See also
<exref target="https://docs.opendesign.com/td/FontHandling.html">Font Handling</exref>

Implements OdDbBaseHostAppServices.

◆ getFontMapFileName()

virtual OdString OdIfcHostAppServices::getFontMapFileName ( ) const
virtual

Retrieves the current font mapping file. This font mapping file is used by the <link OdIfcHostAppServices::getPreferableFont@OdString&@OdFontType, getPreferableFont()> method.

Returns
Returns the name of the font mapping file.
Remarks
The default implementation of this method returns an empty string.
See also
<exref target="https://docs.opendesign.com/td/FontHandling.html">Font Handling</exref>

Implements OdDbBaseHostAppServices.

◆ getPreferableFont()

virtual OdString OdIfcHostAppServices::getPreferableFont ( const OdString fontName,
OdFontType  fontType 
)
virtual

Retrieves the current preferable font name for a specified font name and type.

Parameters
fontName[in] A font name.
fontType[in] A font type.
Returns
Returns a string object containing the preferable font name.
Remarks
The default implementation of this method returns an empty string.

The fontType parameter value must be one of the following:

Value Description kFontTypeUnknown 0 Unknown. kFontTypeShx 1 SHX font. kFontTypeTrueType 2 TrueType font. kFontTypeShape 3 Shape file. kFontTypeBig 4 BigFont file.

See also
<exref target="https://docs.opendesign.com/td/FontHandling.html">Font Handling</exref>

Implements OdDbBaseHostAppServices.

◆ getSubstituteFont()

virtual OdString OdIfcHostAppServices::getSubstituteFont ( const OdString fontName,
OdFontType  fontType 
)
virtual

Retrieves the current substitute font name. The substitute font is used in cases when a specified font is not found.

Parameters
fontName[in] A font name.
fontType[in] A font type.
Returns
Returns a string object that contains the substitute font name.
Remarks
The default implementation of this method returns an empty string. The fontType parameter value must be one of the following:

Value Description kFontTypeUnknown 0 Unknown. kFontTypeShx 1 SHX font. kFontTypeTrueType 2 TrueType font. kFontTypeShape 3 Shape file. kFontTypeBig 4 BigFont file.

See also
<exref target="https://docs.opendesign.com/td/FontHandling.html">Font Handling</exref>

Implements OdDbBaseHostAppServices.

◆ getSubstituteFontByChar()

virtual OdString OdIfcHostAppServices::getSubstituteFontByChar ( const OdFont pFont,
OdChar  unicodeChar,
OdDbBaseDatabase pDb 
)
virtual

Retrieves the typeface name of the TTF font that has the specified character.

Parameters
pFont[in] A TTF font object.
unicodeChar[in] A symbol to find in the substitute font name.
pDb[in] A raw pointer to the database context.
Returns
Returns a string object that contains the substitute font name.
Remarks
The default method implementation uses the Windows API for getting the font.
See also
<exref target="https://docs.opendesign.com/td/FontHandling.html">Font Handling</exref>

Reimplemented from OdDbBaseHostAppServices.

◆ gsBitmapDevice()

virtual OdGsDevicePtr OdIfcHostAppServices::gsBitmapDevice ( OdRxObject pViewObj = NULL,
OdDbBaseDatabase pDb = NULL,
OdUInt32  flags = 0 
)
virtual

Retrieves the current bitmap <exref target="https://docs.opendesign.com/tv/OdGsDevice.html">device</exref> associated with the host application services object.

Parameters
pViewObj[in] A raw pointer to an <exref target="https://docs.opendesign.com/tkernel/OdAbstractViewPE.html">OdAbstractViewPE</exref> compatible object
(<exref target="https://docs.opendesign.com/tv/OdGsView.html">OdGsView</exref>, <exref target="https://docs.opendesign.com/td/OdDbViewport.html">OdDbViewport</exref>, etc).
pDb[in] A raw pointer to the database context.
flags[in] Bitmap device flags.
Returns
Returns a smart pointer to the <exref target="https://docs.opendesign.com/tv/OdGsDevice.html">device</exref> object associated with the host application services object.

Reimplemented from OdDbBaseHostAppServices.

◆ modelClass()

virtual OdRxClass* OdIfcHostAppServices::modelClass ( ) const
virtual

Retrieves the IFC model class description.

Returns
Returns the desc() method's result of the <link OdIfc::OdIfcFile, OdIfcFile> object.

Implements OdDAIHostAppServicesBase.

◆ ODRX_DECLARE_MEMBERS()

OdIfcHostAppServices::ODRX_DECLARE_MEMBERS ( OdIfcHostAppServices  )

◆ product()

virtual const OdString OdIfcHostAppServices::product ( )
virtual

Retrieves the current name of the client product based on ODA IFC SDK.

Returns
Returns a string object containing the current name of the client product.
Remarks
The default implementation of this method returns program(). This method is typically used for populating information about the product.

Implements OdDbBaseHostAppServices.

◆ program()

virtual const OdString OdIfcHostAppServices::program ( )
virtual

Retrieves the current name of the client program based on ODA IFC SDK.

Returns
Returns a string object containing the custom application name.
Remarks
The default implementation of this method returns oddgGetLibraryInfo()->getLibName(). This method is typically used for populating information about the application.

Implements OdDbBaseHostAppServices.

◆ readFile() [1/2]

virtual OdIfc::OdIfcFilePtr OdIfcHostAppServices::readFile ( const OdString file)
virtual

Reads an IFC file content from a specified file and creates an instance of the <link OdIfc::OdIfcFile, OdIfcFile> class.

Parameters
file[in] A full path to the file to read data from.
Returns
Returns a smart pointer to the created <link OdIfc::OdIfcFile, IFC file object>.

◆ readFile() [2/2]

virtual OdIfc::OdIfcFilePtr OdIfcHostAppServices::readFile ( OdStreamBuf pFileBuff)
virtual

Reads an IFC file content from a specified stream and creates an instance of the <link OdIfc::OdIfcFile, OdIfcFile> class.

Parameters
pFileBuff[in] A raw pointer to a stream to read data from.
Returns
Returns a smart pointer to the created <link OdIfc::OdIfcFile, IFC file object>.

◆ releaseMajorMinorString()

virtual const OdString OdIfcHostAppServices::releaseMajorMinorString ( )
virtual

Retrieves the major and minor numbers of the client application's version represented as a string.

Returns
Returns a string object that contains the application's major and minor version numbers.
Remarks
The default implementation of this method returns oddgGetLibraryInfo()->getLibVersion().

Reimplemented from OdDbBaseHostAppServices.

◆ versionString()

virtual const OdString OdIfcHostAppServices::versionString ( )
virtual

Retrieves the release version of the client application represented as a string.

Returns
Returns the release version string of the client application.
Remarks
The default implementation of this method returns oddgGetLibraryInfo()->getLibVersion().

Reimplemented from OdDbBaseHostAppServices.


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