Import Keyword

To enter the Import keyword in the command line, use one of the options:

• Type Import
• Type the shortcut I

Description

Import is a function keyword to incorporate small portions of exported show file data, available as .xml files, into the current show file.

The Import command loads data into the specified destination or the current command line destination after any previously occupied objects.

By default, files will be imported from the relevant folder within the library folder structure, either on the local drive of the console or onPC station, or on a selected USB drive. For more information about this folder structure, see the Folder Structure topic.

Syntax

Import [Object Type] Library "File Name.xml" (If Drive [Drive Number]) (At [Object Type] [Object Number]) (/Option) ("Option Value")

Options

• /Path:
  Further defines the folder path where the source .xml file is saved.
  Enter a path beginning with a letter or number if the path is incorporated with the default folder structure.
  Enter a path beginning with the forward-slash (/) character if the path begins at the root of the device.
• /Type:
  When importing, the desired file may be either a "User" file, which has been previously exported; or a "System" file, which is predefined and included with the system software. If this option is not defined within the import syntax, the console will first search the user library for the specified file name. If the file does not exist within the user library, the console will then search within the system files.
  /Type "User" restricts the console to only search within the user library of the selected drive.
  /Type "System" restricts the console to only search within the system files, ignoring the user library.
• /NoRefresh:
  When listing the library files of a certain type and/or path, it may take a while to type the path and the options into the command line. When a file shall be imported after a type and/or path has been specified during a previous command, the type and/or path will typically need to be entered again as part of the import command. Using the /NoRefresh option, it is not necessary to re-enter /Type and/or /Path as part of the import command.
• /Gaps:
  Retains or suppresses empty spaces when importing a range of pool objects, which were previously exported using the /Gaps option.
  /Gaps "Yes" or omitting the /Gaps option retains empty spaces included in the file when importing a range of pool objects.
  /Gaps "No" suppresses empty spaces when importing a range of pool objects.

Examples

Requirements: Destination is changed to fixture types.

• To import, for example, a MAC Aura XB as a new fixture type in the show file, type:

 

Requirements: Destination is changed to macros.

• To import the macro color.xml to the pool object following the macro occupied last, type:

• To import the same macro to macro 42 in the macro pool without changing the command line destination, type:

 

 Requirements: Destination is changed to macros.

• To import all macros from the library into the show file, type:

 

• To use the /NoRefresh option to avoid reentering drive and path specifications:

List all macro libraries within a specific path on a specific drive:

To import the second library from the list without reentering the drive and path, type:

Without the /NoRefreshOption, the command must also include the same drive and path specifications: