Imports an ASCII file containing frames into the current job based on a predefined format as a Frame Set.
0 |
File Path or Embedded File |
ASCII File Path |
The path to the ASCII file to import. |
1 |
File Format |
File Format |
The format of the source ASCII file. |
2 |
Units |
Units |
The units of the source ASCII file. |
3 |
Angular Units |
Angular Units |
The angular units of the source ASCII file. |
4 |
Collection Object Name |
Frame Set Container Name |
The name of the resulting Frame Set |
5 |
Boolean |
Ensure Unique Name |
TRUE checks to ensure the name is unique. |
None
SUCCESS |
The file was successfully imported. |
FAILURE |
The source file could not be found. |
This command supports both absolute paths (ex. C:\test.xit) and relative paths (ex. .\test.xit). If a relative path is provided and the MP is embedded, the path will be relative to the current SA file location.
Note that this command will not fail if the specified file did not match the prescribed format. In that case, data will not be imported. Upon import, values will be converted from the source units of the file (Argument 2) to the units of the current SA file. When a format contains a group name, it will override the group name provided in the arguments.