Category 3D interface, Object ProIntfimport

Function ProIntfimportModelWithOptionsMdlnameCreate


Description
Imports an external file using profile, creating a new model, or a set of new models as required, with a representation as required.

Note: Once a profile is set, it remains valid for the entire session unless it is reset with another profile. Note: In Creo 3 this function does not differ in behavior from superseded ProIntfimportModelWithOptionsCreate. In particular, new_model_name can be only of ProName length. This function is reserved for future use.

Replacement in Object TOOLKIT: pfcBaseSession::ImportNewModel
wfcWSession::ImportAsModel
Synopsis
#include <ProIntfimport.h>
ProErrorProIntfimportModelWithOptionsMdlnameCreate(
ProPath import_file
/* (In)
Full path to the file to be imported. Note: When importing CADDS models, ensure that the path is specified in lower case.
*/
ProPath profile
/* (In)
Profile path. May be NULL.
*/
ProIntfImportType type
/* (In)
The type of file to be imported.
*/
ProMdlType create_type
/* (In)
The type of model to create. This could be part, assembly, or drawing (for STEP associative drawings). Pass PRO_MDL_UNUSED to let Creo Parametric decide on the model type to be created.
*/
ProImportRepType rep_type
/* (In)
The representation type. Use PRO_IMPORTREP_MASTER to import without special representations applied.
*/
ProMdlName new_model_name
/* (In)
The name of the new top level import model.
*/
ProIntfimportLayerFilter filter_func
/* (In)
Callback to a function that determines how to display and map layers from the imported model. If this is NULL, the default layer handling will take place.
*/
ProAppData application_data
/* (In)
The application data to be passed to the filter function. Can be NULL.
*/
ProMdl* created_model
/* (Out)
The handle to the created model. For an assembly, the handle to the top assembly. If this is NULL the model will be created anyway.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully created the new import feature.
PRO_TK_BAD_INPUTSOne or more of the input arguments are invalid.
PRO_TK_CANT_OPENimport_file can't be opened.
PRO_TK_UNSUPPORTEDCreo Parametric does not support import of the indicated file.
PRO_TK_NOT_EXISTNo profile found.
PRO_TK_INVALID_FILEprofile is not readable.
PRO_TK_INVALID_TYPEThis combination of arguments is invalid.
PRO_TK_LINE_TOO_LONGName length of new model is more than 31 chars.
PRO_TK_NO_LICENSEMissing the required license to perform this import operation.
PRO_TK_E_FOUNDAlready a model with same name exists in the Creo session.

Manual References:

  1. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  2. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  3. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  4. Technical Summary of Changes for Creo 11.0.0.0: Functions superseded from Creo 1.0 to Creo 11.0
  5. Interface: Data Exchange: Importing 3D Models
  6. Interface: Data Exchange: Importing 3D Models

Sample Code References:

  1. pt_userguide ( UgInterfaceImport.c )