Overview | Statement List | Example
obj = RPATTG/'filespec'[{,matrix|,csys,scale}][,LAYER][,PLMODS,value][,NOVIEW][,RETCAM,number][,IFERR,label:]
Imports an existing archive format part file into the currently displayed part as a group. This statement is referred to as an object-valued function because the resulting group is a singular object which may be assigned to a previously declared object variable. In addition, the group automatically assumes the filename portion of the filespec parameter as its object name.
Parameter |
Description |
'filespec' |
The filespec parameter contains the file specification data for the file to be imported. |
matrix |
A previously defined matrix which determines the location and orientation, or orientation and scale, of the part being imported. |
csys,scale |
A previously defined coordinate system and a scale factor which determine the orientation and scale of the part being imported. The scale factor must be a positive value. |
LAYER |
Minor word that causes the part to be imported onto the same layers as when it was created. |
PLMODS |
Minor word which indicates that a parts list parameter is to be specified. |
value |
Integer between 1 and 4 inclusive which specifies how the system handles parts list data associated with the part being imported. These values are as follows: 1 - Indicates that no parts list information is imported. This is the default. 2 - Indicates that the default parts list format data is imported. When this happens, the default data replaces the parts list format data of the current part. 3 - Indicates that the imported part is added to the parts list as a single group (one-object entry). 4 - Indicates that all parts list entries on the imported part are added individually to the parts list data of the current part. The parts list format data is also imported. |
NOVIEW |
Minor word which indicates that no views are imported when the part is imported. The geometry is imported into the existing views based on the current model mode (MODEL or VIEW DEPENDENT). If NOVIEW is omitted, the views in the part being imported are also imported. |
RETCAM |
Minor word which controls how manufacturing data (tools, parameter sets, and operations) is handled. |
number |
Integer between 1 and 3 inclusive which specifies how the system handles duplicate manufacturing object names in both the current and the imported part. These values are as follows: 1 - Indicates that no manufacturing data is imported. This is the default. 2 - Indicates that the operation terminates and no objects are imported when duplicate manufacturing names occur. 3 - Indicates that the operation continues and duplicate manufacturing objects are renamed when duplicate manufacturing names occur. |
IFERR,label: |
The IFERR parameter specifies a label to which the program jumps if an error occurs. |