Import ASCII: Predefined Frame Set Formats

Imports an ASCII file containing frames into the current job based on a predefined format as a Frame Set.

 

Input Arguments

 

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.

Return Arguments

None

 

Returned Status

 

SUCCESS

The file was successfully imported.

FAILURE

The source file could not be found.

Remarks

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.