Category 3D interface, Object ProOutput

Function ProOutputFileMdlnameWrite


Description
Exports a file from Creo Parametric onto the disk. The file format is the same as the one created by an interactive Creo Parametric session. Note: In Creo 3 this function does not support names longer than 31 characters. It will return PRO_TK_BAD_INPUTS for longer names. The support for ProMdlFileName will be added in a future release.
Replacement in Object TOOLKIT: pfcModel::Export
Synopsis
#include <ProUtil.h>
ProErrorProOutputFileMdlnameWrite(
ProMdl model
/* (In)
A pointer to the model.
*/
ProMdlFileName name
/* (In)
The name of the file to be created (with the extension, but not the version). Must not be NULL or an empty string. If file_type is PRO_IGES_FILE or PRO_DXF_FILE, do not include the extension; it is added automatically.
*/
ProImportExportFile file_type
/* (In)
The type of file to be created. The valid values are as follows:
*/
ProAppData arg1
/* (In)
If file_type is PRO_RENDER_FILE, PRO_INVENTOR_FILE, PRO_CATIAFACETS_FILE, PRO_SLA_ASCII_FILE or PRO_SLA_BINARY_FILE arg1 is a wchar_t* to a coordinate system name. If this is NULL, the function uses the default coordinate system. If file_type is PRO_SPOOL_FILE, arg1 is a wchar_t* to the spool name. If file_type is PRO_CONNECTOR_PARAMS_FILE, arg1 is a int* pointing to a ProIdTable (ProIdTable is an integer array of component identifiers). If file_type is PRO_CABLE_PARAMS_FILE, arg1 is the ProSolid (part pointer).
*/
ProAppData arg2
/* (In)
If file_type is PRO_FEAT_INFO, PRO_MFG_OPER_CL or PRO_MFG_FEAT_CL arg2 is a int* to the feature ID. If file_type is PRO_RELATION_FILE, arg2 is a int* to the feature ID, to get the relations contained in the feature. Pass NULL to get relations contained in the model. If file_type is PRO_IGES_3D_FILE, PRO_STEP_FILE, PRO_VDA_FILE, PRO_FIAT_FILE, PRO_CATIA_DIRECT_FILE or PRO_ACIS_FILE arg2 is a int* pointing to the number. If file_type is PRO_CGM_FILE, arg2 is a int* pointing to the export type (PROCGMTYPE_CLEAR_TEXT or PROCGMTYPE_MIL_SPEC ie 1 or 2). If file_type is PRO_CONNECTOR_PARAMS_FILE, arg2 is a int* pointing to the number, which is equal to the number of component identifier(s). If file_type is PRO_CABLE_PARAMS_FILE, arg2 is the wchar_t* pointing to the cable name.

Please note that the previous use of arg2 and arg3 for quality

*/
ProAppData arg3
/* (In)
If file_type is PRO_CGM_FILE, arg3 is a int* pointing to the scale type (PROCGMTYPE_ABSTRACT or PROCGMTYPE_METRIC ie 3 or 4)
*/
ProAppData arg4
/* (In)
If file_type is PRO_DIFF_REPORT_FILE, this is the model to which the input model will be compared for generation of the difference report.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully exported the file.
PRO_TK_GENERAL_ERRORThe function failed.
PRO_TK_E_NOT_FOUNDAn entity named in arg1 or arg2 does not exist.
PRO_TK_BAD_INPUTSSome input was incorrect. e.g.:
  • file_type was PRO_CGM_FILE but mdl was not a drawing;
  • assembly did not contain specified part;
  • quality was outside limits.
PRO_TK_OBSOLETE_FUNCThe file format selected is no longer supported on this platform.
PRO_TK_BAD_CONTEXTThe function is not available in Design Test Mode.

Manual References:

  1. Pro/DEVELOP to Creo Toolkit Function Mapping: Equivalent Pro/DEVELOP Functions
  2. Production Applications: Cabling: Managing Spools
  3. Production Applications: Cabling: Connectors Parameters
  4. Production Applications: Cabling: Connectors Parameters
  5. Production Applications: Cabling: Connectors Parameters
  6. Production Applications: Cabling: Cable Parameters
  7. Production Applications: Cabling: Cable Parameters
  8. Drawings: Drawing Setup
  9. Drawings: Drawing Setup
  10. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  11. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  12. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  13. Interface: Data Exchange: Exporting Information Files
  14. Interface: Data Exchange: Exporting 2D Models

Sample Code References:

  1. pt_examples ( TestInterface.c )
  2. pt_wc_server ( PTWCServerUpdateDXF.c )