Tutorial Toolkit Function Descriptions > Files > IGES and CAD Access
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
IGES and CAD Access
The following functions are used for IGES access from the File menu.
 
ugi_export_iges_v1
( filnam, start_section, nlpos, nlknt, product_id, author, author_org, model_units, entity_toggle_values, all_groups, ngroups, group_ids, patran_summary, iges_summary )
Description:
Export MSC Patran geometry to the IGES standard.
Input:
STRING
filnam[]
IGES file name to create.
STRING
start_section[]
IGES file start section prolog lines.
INTEGER
nlpos ( )
Array of nlknt values. Each entry is the # of characters for that line of the “IGES file start section prolog” plus the pervious lines.
INTEGER
nlknt
Number of lines in the “IGES file start section prolog”.
STRING
product_id[]
Product Id for receiving system.
STRING
author[]
Author.
STRING
author_org[]
Author’s Organization
STRING
model_units[]
IGES file model units.
LOGICAL
entity_toggle_values(35)
Flags to specify which MSC Patran entity types to export. Only the first 7 flags are used.
LOGICAL
all_groups
TRUE if all groups are to be exported.
INTEGER
ngroups
Number of groups to export.
INTEGER
group_ids ( )
Group ids to export.
Output:
INTEGER
patran_summary (8)
Number of MSC Patran entities processed.
INTEGER
iges_summary (21)
Number of IGES entities created.
INTEGER
<Return Value>
0 if Function was successful.
Example:
Please see ugi_export_iges_v1 (p. 50) in the MSC Acumen Toolkit - Code Examples.
  
ugi_import_iges_v3
(file_name, ipref142, group_name, entity_toggle_values, color_toggle_values, color_method, color_definition, all_layers, layer, number_of_groups, group_entity_ids, group_entity_values, group_color_values, layer_pointers, group_levals, scale, iges_count, patran_count)
Description:
This function imports geometry information from a file in the IGES standard file format into the MSC Patran database.
Input:
STRING
file_name [ ]
Filename and its path which is to be imported.
INTEGER
ipref142
User preference for curve on surface(142) entity representation use flag.
0 = Unspecified, use what is defiened in the IGES file.
1 = S or B is preferred (Parametric space)
2 = C is preferred (Real space)
STRING
group_name[]
Group name in which the imported geometry is added.
LOGICAL ARRAY
entity_toggle_values()
This value specifies the entity type filter status flags to specify which IGES entity types to import.
LOGICAL ARRAY
color_toggle_values()
This value specifies the entity color filter status flags to specify which IGES entity colors to import.
STRING
color_method[ ]
This value is used to specify the color definition entity method used to import color definition entities.
STRING
color_defination[ ]
This value specifies the color definition entities to import.
LOGICAL
all_layers
TRUE if all geometry layers are to be imported.
STRING
layer[ ]
This value specifies a string that is used to specify the geometry layers to be imported.
INTEGER
number_of_groups
Number of groups.
INTEGER
group_entity_ids
(number_of_groups)
ID values for each user group.
LOGICAL ARRAY
group_entity_values
(22,number_of_groups)
This value specifies a 2D array that contains values set to TRUE if an entity is to be included and FALSE if an entity is not to be included in the group being imported. The offset in the first dimension corresponds to the group id in the same offset of the group_entity_ids input value. The offset in the second dimension of the array identifies the entity type.
LOGICAL ARRAY
group_color_values
(10, number_of_groups)
This value specifies a 2D array that contains values set to TRUE if a color value is to be used. The offset in the first dimension of the array corresponds to the group id in the same offset of the group_entity_ids input value. The offset in the second dimension of the array identifies the color type.
INTEGER ARRAY
layer_pointers (number_of_groups)
This value specifies an array that is used by setting a value at an offset that corresponds with the offset into the group_entity_ids input value that lists the group ids. The value at that offset in the array identifies the offset into the group_layers input values where the number of layers values for each group is stored.The maximum value allowed for this array is equal to the number of integers in the group_layers input value.
INTEGER
group_layers
This value specifies an array used to identify the number of layers imported for each group. The size of this array must be equal to or greater than the largest value placed in the layer_pointer input value.
Output:
REAL
scale
This value return the IGES file model space scale.
INTEGER ARRAY
iges_count(50)
Number of IGES entities imported by type.
INTEGER ARRAY
patran_count(8)
Number of MSC Patran entities written to the database by type.
INTEGER
<Return Value>
This function returns a value 0 for success and a non-zero value to indicate a change in status or an error.
Error Conditions:
-1
 
This is an internal status condition. There is no corresponding status message in the message database.
Example:
Please see ugi_import_iges_v3 (p. 52) in the MSC Acumen Toolkit - Code Examples.