Exported APIs for CatiaV5 Write Library. More...
Namespaces | |
Pmi | |
Data Structures | |
class | FileDescription |
This class provides several informations about a CatiaV5 File. It can be used with catiav5w::InitPart and catiav5w::InitProduct functions to specify file properties. More... | |
class | Material |
This is the wrapper class handling V5 write material data. More... | |
class | WriteOptions |
This class provides several options to tunes CatiaV5 Writter. It must be provided to catiav5w::InitWrite method. More... | |
Typedefs | |
typedef Dtk_ID | MaterialId |
typedef Dtk_tab< Dtk_ID > | PathID |
Enumerations | |
enum | NodeType { NodeTypeUnknown = 0, NodeTypeGeometricSet = 1, NodeTypePartBody = 2, NodeTypeMechanicalTool = 3 } |
Type of Specification Tree Node used into a CATPart file. More... | |
Functions | |
Dtk_ErrorStatus | AddBooleanParameter (const Dtk_string &inParameterName, const Dtk_bool &inValue) |
Adds a boolean paramater. More... | |
Dtk_ErrorStatus | AddDoubleParameter (const Dtk_string &inParameterName, const Dtk_Double64 &inValue) |
Adds a double paramater. More... | |
Dtk_ErrorStatus | AddInstance (const Dtk_ID &inDocId, const Dtk_string &inInstanceName, const Dtk_transfo &inTransfo, Dtk_ID &outInstanceId) |
Add an instance to a DocID into the Current (Sub/Root) CATProduct. More... | |
Dtk_ErrorStatus | AddIntegerParameter (const Dtk_string &inParameterName, const Dtk_Int32 &inValue) |
Adds a integer paramater. More... | |
Dtk_ErrorStatus | AddMaterial (const Material &inMaterial, MaterialId &outMaterialId) |
Add a Material in a CATPart context. More... | |
Dtk_ErrorStatus | AddStringParameter (const Dtk_string &inParameterName, const Dtk_string &inValue) |
Adds a string paramater. More... | |
Dtk_ErrorStatus | AddVirtualComponentInstance (const Dtk_ID &inDocId, const Dtk_string &inInstanceName, const Dtk_transfo &inTransfo, Dtk_ID &outInstanceId) |
Add an instance to a DocID into the Current (Sub/Root) CATProduct. More... | |
Dtk_ErrorStatus | CloseCurrentNode () |
close the current node previously created by catiav5w::CreateNode. More... | |
Dtk_ErrorStatus | CreateCGRDocId (const Dtk_string &inCGRFileName, const Dtk_string &inCGRName, Dtk_ID &outDocId) |
Create a CGR Reference and DocID related to a given CGR File. More... | |
Dtk_ErrorStatus | CreateNode (const NodeType &inNodeType, const Dtk_InfoPtr &inInfos) |
Create a node in the Specification Tree. More... | |
Dtk_ErrorStatus | CreateNode (const NodeType &inNodeType, const Dtk_string &inNodeName=Dtk_string()) |
Create a node in the Specification Tree. More... | |
Dtk_ErrorStatus | CreatePartDocId (const Dtk_string &inPartFileName, const Dtk_string &inPartName, Dtk_ID &outDocId) |
Create a Part Reference and DocID related to a given CATPart. More... | |
Dtk_ErrorStatus | CreateProductDocId (const Dtk_string &inPartFileName, const Dtk_string &inPartName, Dtk_ID &outDocId) |
Create a Product Reference and DocID related to a given CATProduct. More... | |
Dtk_ErrorStatus | CreateV4ModelDocId (const Dtk_string &inV4ModelFileName, const Dtk_string &inV4ModelName, Dtk_ID &outDocId) |
Create a V4 Model Reference and DocID related to a given V4 Model File. More... | |
Dtk_ErrorStatus | EndPart () |
Free data allocated by catiav5w::InitPart More... | |
Dtk_ErrorStatus | EndProduct (Dtk_ID &outDocId) |
Write effectively the Sub Product initialized by catiav5w::InitProduct. More... | |
Dtk_ErrorStatus | EndVirtualComponent (Dtk_ID &outDocId) |
End - and write - the virtual component initialized by catiav5w::InitVirtualComponent. More... | |
Dtk_ErrorStatus | EndWrite () |
Free the Catia V5 Writer More... | |
Dtk_bool | GetWriteHybridBodies () |
Dtk_ErrorStatus | InitPart (const Dtk_string &inOutputFile, const Dtk_string &inReferenceName, Dtk_UUID &outPartUUID, const catiav5w::FileDescription &inFileDescription=catiav5w::FileDescription()) |
Initialize the part More... | |
Dtk_ErrorStatus | InitProduct (const Dtk_string &inFileName, const Dtk_string &inReferenceName, const catiav5w::FileDescription &inFileDescription=catiav5w::FileDescription()) |
Initialize a sub Product during CATProduct process. More... | |
Dtk_ErrorStatus | InitVirtualComponent (const Dtk_string &inReferenceName, const catiav5w::FileDescription &inFileDescription=catiav5w::FileDescription()) |
Initialize a virtual component during CATProduct process. More... | |
Dtk_ErrorStatus | InitWrite (const Dtk_string &inLogFile, Licence_dtk inLicFct, const WriteOptions &inOptions=WriteOptions()) |
Initialize the Catia V5 Writer More... | |
Dtk_bool | IsWriteInitialized () |
Tells if the Write Module has been initialized or not. More... | |
Dtk_ErrorStatus | OverrideBlankedStatusWithPathID (const PathID &inInstancePathId, const Dtk_bool inBlankedStatus) |
Override the Blanked Status of an instance in a Sub Product. More... | |
Dtk_ErrorStatus | OverrideInstanceAlphaWithPathID (const PathID &inInstancePathId, const Dtk_UChar8 inInstanceAlpha) |
Override the Alpha of an instance in a Sub Product. More... | |
Dtk_ErrorStatus | OverrideInstanceColorWithPathID (const PathID &inInstancePathId, const Dtk_RGB &inInstanceColor) |
Override the Color of an instance in a Sub Product. More... | |
SetAsDeprecated ("2023.4", "Use catiav5w::AddInstance( const Dtk_ID&, const Dtk_string&, const Dtk_transfo&, Dtk_ID& ) method instead.") Dtk_ErrorStatus AddInstance(const Dtk_ID &inDocId | |
Add an instance to a DocID into the Current (Sub/Root) CATProduct. More... | |
SetAsDeprecated ("2023.4", "Use catiav5w::AddVirtualComponentInstance( const Dtk_ID&, const Dtk_string&, const Dtk_transfo&, Dtk_ID& ) method instead.") Dtk_ErrorStatus AddVirtualComponentInstance(const Dtk_ID &inDocId | |
Add an instance to a DocID into the Current (Sub/Root) CATProduct. More... | |
SetAsDeprecated ("2024.2", "Use Dtk_ErrorStatus catiav5w::AddMaterial( const Material&, MaterialId& ) method instead.") MaterialId AddMaterial(const Material &inMaterial) | |
Add a Material in a CATPart context. More... | |
SetAsDeprecated ("2024.2", "Use Dtk_ErrorStatus catiav5w::InitPart( const Dtk_string&, const Dtk_string&, Dtk_UUID&, const catiav5w::FileDescription& ) method instead.") Dtk_UUID InitPart(const Dtk_string &inOutputFile | |
Initialize the part More... | |
Dtk_ErrorStatus | SetLayerData (const Dtk_LayerInfosSetPtr &inLayerDataSet) |
Set Layer and LayerFilter Data in a CATPart context. More... | |
void | SetWriteReferencePlanesAsHidden (const Dtk_bool &inVal) |
Dtk_ErrorStatus | WriteEntity (const Dtk_EntityPtr &inEntity) |
Write the entity provided in parameter. More... | |
Dtk_ErrorStatus | WriteNamedView (const Dtk_ModelDisplayPtr &inNamedView) |
Write the given ModelDisplay as NamedView - V5 camera -. More... | |
Variables | |
const Dtk_string const Dtk_transfo const Dtk_bool | inBlankedStatus = 0 |
const Dtk_string const catiav5w::FileDescription & | inFileDescription = catiav5w::FileDescription() ) |
const Dtk_string const Dtk_transfo const Dtk_bool const Dtk_RGB & | inInstanceColorAlpha = Dtk_RGB() ) |
const Dtk_string & | inInstanceName |
const Dtk_string & | inReferenceName |
const Dtk_string const Dtk_transfo & | inTransfo |
Exported APIs for CatiaV5 Write Library.
typedef Dtk_ID catiav5w::MaterialId |
typedef Dtk_tab< Dtk_ID > catiav5w::PathID |
enum catiav5w::NodeType |
Type of Specification Tree Node used into a CATPart file.
The type of geometrical entities depends of the Node Type.Type of Specification Tree Node used into a CATPart file.
You can create Bodies into a NodeTypePartBody (Hybrid Body) node and into NodeTypeMechanicalTool nodes.
You can create Surfacic entities into NodeTypeGeometricSet nodes and into NodeTypePartBody (Hybrid Body) nodes.
Enumerator | |
---|---|
NodeTypeUnknown | |
NodeTypeGeometricSet | |
NodeTypePartBody | |
NodeTypeMechanicalTool |
Dtk_ErrorStatus catiav5w::AddBooleanParameter | ( | const Dtk_string & | inParameterName, |
const Dtk_bool & | inValue | ||
) |
Adds a boolean paramater.
[in] | inParameterName | : The parameter name. |
[in] | inValue | : The parameter value. |
Dtk_ErrorStatus catiav5w::AddDoubleParameter | ( | const Dtk_string & | inParameterName, |
const Dtk_Double64 & | inValue | ||
) |
Adds a double paramater.
[in] | inParameterName | : The parameter name. |
[in] | inValue | : The parameter value. |
Dtk_ErrorStatus catiav5w::AddInstance | ( | const Dtk_ID & | inDocId, |
const Dtk_string & | inInstanceName, | ||
const Dtk_transfo & | inTransfo, | ||
Dtk_ID & | outInstanceId | ||
) |
Add an instance to a DocID into the Current (Sub/Root) CATProduct.
[in] | inDocId | : DocID of an already written file provided by catiav5w::CreatePartDocId / catiav5w::CreateCGRDocId / catiav5w::CreateV4ModelDocId / catiav5w::EndProduct functions-. |
[in] | inInstanceName | : Instance Name. |
[in] | inTransfo | : Transformation Matrix applicated to the instance. |
[out] | outInstanceId | : returned Instance ID or 0 in case of error. |
Dtk_ErrorStatus catiav5w::AddIntegerParameter | ( | const Dtk_string & | inParameterName, |
const Dtk_Int32 & | inValue | ||
) |
Adds a integer paramater.
[in] | inParameterName | : The parameter name. |
[in] | inValue | : The parameter value. |
Dtk_ErrorStatus catiav5w::AddMaterial | ( | const Material & | inMaterial, |
MaterialId & | outMaterialId | ||
) |
Add a Material in a CATPart context.
[in] | inMaterial | : Material to be added. |
[out] | outMaterialId | : ID of the Material. It must be set in the Node or Body by calling Dtk_Info::SetRenderInfosId method |
Dtk_ErrorStatus catiav5w::AddStringParameter | ( | const Dtk_string & | inParameterName, |
const Dtk_string & | inValue | ||
) |
Adds a string paramater.
[in] | inParameterName | : The parameter name. |
[in] | inValue | : The parameter value. |
Dtk_ErrorStatus catiav5w::AddVirtualComponentInstance | ( | const Dtk_ID & | inDocId, |
const Dtk_string & | inInstanceName, | ||
const Dtk_transfo & | inTransfo, | ||
Dtk_ID & | outInstanceId | ||
) |
Add an instance to a DocID into the Current (Sub/Root) CATProduct.
[in] | inDocId | : DocID of an already created Component provided by catiav5w::EndVirtualComponent function-. |
[in] | inInstanceName | : Instance Name. |
[in] | inTransfo | : Transformation Matrix applicated to the instance. |
Dtk_ErrorStatus catiav5w::CloseCurrentNode | ( | ) |
close the current node previously created by catiav5w::CreateNode.
Dtk_ErrorStatus catiav5w::CreateCGRDocId | ( | const Dtk_string & | inCGRFileName, |
const Dtk_string & | inCGRName, | ||
Dtk_ID & | outDocId | ||
) |
Create a CGR Reference and DocID related to a given CGR File.
[in] | inCGRFileName | : Name of the CGR to be linked. |
[in] | inCGRName | : CGR Reference. |
[out] | outDocId | : Resulting CGR DocId - used by catiav5w::AddInstance -. |
Dtk_ErrorStatus catiav5w::CreateNode | ( | const NodeType & | inNodeType, |
const Dtk_InfoPtr & | inInfos | ||
) |
Create a node in the Specification Tree.
[in] | inNodeType | : The Node Type. |
[in] | inInfos | : The Node Infos including Name/layer. |
Dtk_ErrorStatus catiav5w::CreateNode | ( | const NodeType & | inNodeType, |
const Dtk_string & | inNodeName = Dtk_string() |
||
) |
Create a node in the Specification Tree.
[in] | inNodeType | : The Node Type. |
[in] | inNodeName | : The Node Name. |
Dtk_ErrorStatus catiav5w::CreatePartDocId | ( | const Dtk_string & | inPartFileName, |
const Dtk_string & | inPartName, | ||
Dtk_ID & | outDocId | ||
) |
Create a Part Reference and DocID related to a given CATPart.
[in] | inPartFileName | : Name of the CATPart to be linked. |
[in] | inPartName | : CATPart Reference. |
[out] | outDocId | : Resulting CATPart DocId - used by catiav5w::AddInstance -. |
Dtk_ErrorStatus catiav5w::CreateProductDocId | ( | const Dtk_string & | inPartFileName, |
const Dtk_string & | inPartName, | ||
Dtk_ID & | outDocId | ||
) |
Create a Product Reference and DocID related to a given CATProduct.
[in] | inPartFileName | : Name of the CATProduct to be linked. |
[in] | inPartName | : CATProduct Reference. |
[out] | outDocId | : Resulting CATProduct DocId - used by catiav5w::AddInstance -. |
Dtk_ErrorStatus catiav5w::CreateV4ModelDocId | ( | const Dtk_string & | inV4ModelFileName, |
const Dtk_string & | inV4ModelName, | ||
Dtk_ID & | outDocId | ||
) |
Create a V4 Model Reference and DocID related to a given V4 Model File.
[in] | inV4ModelFileName | : Name of the V4 Model to be linked. |
[in] | inV4ModelName | : V4 Model Reference. |
[out] | outDocId | : Resulting V4 Model DocId - used by catiav5w::AddInstance -. |
Dtk_ErrorStatus catiav5w::EndPart | ( | ) |
Free data allocated by catiav5w::InitPart
Dtk_ErrorStatus catiav5w::EndProduct | ( | Dtk_ID & | outDocId | ) |
Write effectively the Sub Product initialized by catiav5w::InitProduct.
This function also retrieve the resulting Sub CATProduct DocID
[out] | outDocId | : The resulting CATProduct DocId - used by catiav5w::AddInstance -. |
Dtk_ErrorStatus catiav5w::EndVirtualComponent | ( | Dtk_ID & | outDocId | ) |
End - and write - the virtual component initialized by catiav5w::InitVirtualComponent.
This function also retrieve the resulting Sub CATProduct DocID
[out] | outDocId | : The resulting Component DocId - used by catiav5w::AddVirtualComponentInstance -. |
Dtk_ErrorStatus catiav5w::EndWrite | ( | ) |
Free the Catia V5 Writer
Dtk_bool catiav5w::GetWriteHybridBodies | ( | ) |
Dtk_ErrorStatus catiav5w::InitPart | ( | const Dtk_string & | inOutputFile, |
const Dtk_string & | inReferenceName, | ||
Dtk_UUID & | outPartUUID, | ||
const catiav5w::FileDescription & | inFileDescription = catiav5w::FileDescription() |
||
) |
Initialize the part
[in] | inOutputFile | : Name of the CATPart to be Written. |
[in] | inReferenceName | : Reference Name - visible at the Specification Tree Root - |
[out] | outPartUUID | : The Dtk_UUID of the created CATPart. |
[in] | inFileDescription | : Description File |
Dtk_ErrorStatus catiav5w::InitProduct | ( | const Dtk_string & | inFileName, |
const Dtk_string & | inReferenceName, | ||
const catiav5w::FileDescription & | inFileDescription = catiav5w::FileDescription() |
||
) |
Initialize a sub Product during CATProduct process.
[in] | inFileName | : Name of the CATProduct to be written. |
[in] | inReferenceName | : Reference Name - visible at the Specification Tree Root - |
[in] | inFileDescription | : Description File |
Dtk_ErrorStatus catiav5w::InitVirtualComponent | ( | const Dtk_string & | inReferenceName, |
const catiav5w::FileDescription & | inFileDescription = catiav5w::FileDescription() |
||
) |
Initialize a virtual component during CATProduct process.
[in] | inReferenceName | : Component Reference Name - visible at the Specification Tree Root - |
[in] | inFileDescription | : Description File |
Dtk_ErrorStatus catiav5w::InitWrite | ( | const Dtk_string & | inLogFile, |
Licence_dtk | inLicFct, | ||
const WriteOptions & | inOptions = WriteOptions() |
||
) |
Initialize the Catia V5 Writer
[in] | inLogFile | : Log file |
[in] | inLicFct | : Licence fuction or Null |
Dtk_bool catiav5w::IsWriteInitialized | ( | ) |
Tells if the Write Module has been initialized or not.
Dtk_ErrorStatus catiav5w::OverrideBlankedStatusWithPathID | ( | const PathID & | inInstancePathId, |
const Dtk_bool | inBlankedStatus | ||
) |
Override the Blanked Status of an instance in a Sub Product.
[in] | inInstanceId | : InstanceID of an already created instance provided by catiav5w::AddInstance or catiav5w::AddVirtualComponentInstance functions. |
[in] | inBlankedStatus | : Blankeds Status - 0 = Visible / 1 = Blanked -. Default value: 0. |
Dtk_ErrorStatus catiav5w::OverrideInstanceAlphaWithPathID | ( | const PathID & | inInstancePathId, |
const Dtk_UChar8 | inInstanceAlpha | ||
) |
Override the Alpha of an instance in a Sub Product.
[in] | inInstanceId | : InstanceID of an already created instance provided by catiav5w::AddInstance or catiav5w::AddVirtualComponentInstance functions. |
[in] | inInstanceAlpha | : Instance Alpha. |
Dtk_ErrorStatus catiav5w::OverrideInstanceColorWithPathID | ( | const PathID & | inInstancePathId, |
const Dtk_RGB & | inInstanceColor | ||
) |
Override the Color of an instance in a Sub Product.
[in] | inInstanceId | : InstanceID of an already created instance provided by catiav5w::AddInstance or catiav5w::AddVirtualComponentInstance functions. |
[in] | inInstanceColor | : Instance Color. |
catiav5w::SetAsDeprecated | ( | "2023.4" | , |
"Use catiav5w::AddInstance( const Dtk_ID&, const Dtk_string&, const Dtk_transfo&, Dtk_ID& ) method instead." | |||
) | const & |
Add an instance to a DocID into the Current (Sub/Root) CATProduct.
[in] | inDocId | : DocID of an already written file provided by catiav5w::CreatePartDocId / catiav5w::CreateCGRDocId / catiav5w::CreateV4ModelDocId / catiav5w::EndProduct functions-. |
[in] | inInstanceName | : Instance Name. |
[in] | inTransfo | : Transformation Matrix applicated to the instance. |
[in] | inBlankedStatus | : Blankeds Status - 0 = Visible / 1 = Blanked -. Default value: 0. |
[in] | inInstanceColorAlpha | : Instance ColorAlpha. Default Value: No Color/Alpha. |
catiav5w::SetAsDeprecated | ( | "2023.4" | , |
"Use catiav5w::AddVirtualComponentInstance( const Dtk_ID&, const Dtk_string&, const Dtk_transfo&, Dtk_ID& ) method instead." | |||
) | const & |
Add an instance to a DocID into the Current (Sub/Root) CATProduct.
[in] | inDocId | : DocID of an already created Component provided by catiav5w::EndVirtualComponent function-. |
[in] | inInstanceName | : Instance Name. |
[in] | inTransfo | : Transformation Matrix applicated to the instance. |
catiav5w::SetAsDeprecated | ( | "2024.2" | , |
"Use Dtk_ErrorStatus catiav5w::AddMaterial( const Material&, MaterialId& ) method instead." | |||
) | const & |
Add a Material in a CATPart context.
[in] | inMaterial | : Material to be added. |
catiav5w::SetAsDeprecated | ( | "2024.2" | , |
"Use Dtk_ErrorStatus catiav5w::InitPart( const Dtk_string&, const Dtk_string&, Dtk_UUID&, const catiav5w::FileDescription& ) method instead." | |||
) | const & |
Initialize the part
[in] | inOutputFile | : Name of the CATPart to be Written. |
[in] | inReferenceName | : Reference Name - visible at the Specification Tree Root - |
[in] | inFileDescription | : Description File |
Dtk_ErrorStatus catiav5w::SetLayerData | ( | const Dtk_LayerInfosSetPtr & | inLayerDataSet | ) |
Set Layer and LayerFilter Data in a CATPart context.
[in] | inLayerDataSet | : Layer and LayerFilter Data. |
void catiav5w::SetWriteReferencePlanesAsHidden | ( | const Dtk_bool & | inVal | ) |
Dtk_ErrorStatus catiav5w::WriteEntity | ( | const Dtk_EntityPtr & | inEntity | ) |
Write the entity provided in parameter.
[in] | inEntity | : The Entity to be written |
Dtk_ErrorStatus catiav5w::WriteNamedView | ( | const Dtk_ModelDisplayPtr & | inNamedView | ) |
Write the given ModelDisplay as NamedView - V5 camera -.
[in] | inNamedView | : The NamedViewntity to be written |
const Dtk_string const Dtk_transfo const Dtk_bool catiav5w::inBlankedStatus = 0 |
const Dtk_string const catiav5w::FileDescription& catiav5w::inFileDescription = catiav5w::FileDescription() ) |
const Dtk_string const Dtk_transfo const Dtk_bool const Dtk_RGB& catiav5w::inInstanceColorAlpha = Dtk_RGB() ) |
const Dtk_string & catiav5w::inInstanceName |
const Dtk_string& catiav5w::inReferenceName |
const Dtk_string const Dtk_transfo & catiav5w::inTransfo |