All Frameworks  Class Hierarchy  This Framework  Indexes

Material Global Function GetCurrentMaterialCatalog


CATDocument* GetCurrentMaterialCatalog()
Returns the current material catalog document.
Role: This is the document used by the interactive command "Apply Material". It will be searched for first with the path defined in Tools/Options / Infrastructure/Material Library, and if it not found with the path defined using the CATStartupPath environment variable.
The function checks whether the catalog is not currently opened in session and otherwise loads it .
Note: Do not forget to close the material document using the CATDocument.Remove method at the end of usage.
Lifecycle rules deviation: This method doesn't AddRef the returned CATDocument pointer.
Returns:
The material catalog document.
Returned value is NULL if the catalog cannot be found.

This object is included in the file: CATMaterialServices.h

Copyright © 2003, Dassault Systèmes. All rights reserved.