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 Parametric TOOLKIT Function Mapping: Equivalent Pro/DEVELOP Functions
  2. Interface: Data Exchange: Exporting Information Files
  3. Interface: Data Exchange: Exporting 2D Models
  4. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  5. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  6. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  7. Technical Summary of Changes for Creo 4.0 F000: Data Exchange
  8. Technical Summary of Changes for Creo 4.0 F000: Data Exchange
  9. Production Applications: Cabling: Managing Spools
  10. Production Applications: Cabling: Connectors Parameters
  11. Production Applications: Cabling: Connectors Parameters
  12. Production Applications: Cabling: Connectors Parameters
  13. Production Applications: Cabling: Cable Parameters
  14. Production Applications: Cabling: Cable Parameters
  15. Drawings: Drawing Setup
  16. Drawings: Drawing Setup

Sample Code References:

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