File Extraction

SRC File Extraction

NetLinx Studio can generate a compressed version of NetLinx program files anytime they are compiled or transferred. The compressed NetLinx files are called Source Files, and have the extension .src.

To generate NetLinx Source Files at compile time, enable the Build With Source option in the NetLinx Compiler tab of the

Preferences dialog (FIG. 304).

FIG. 304 Preferences dialog - NetLinx Compiler tab - Build With Source option

If this option is not enabled, a dummy file is zipped and named "NOSOURCE.txt".

NOTE: The Build With Source option also allows you later send the Source f iles to another Master with the ability to debug the code.

The Extract From SRC File command allows you to extract these files:

1. Select Tools > File Extraction > Extract From SRC File to open the Select SRC File for Extraction dialog.
2. Locate and select the SRC file you want to extract, and click Open.

NOTE: This is the directory containing the actual program f ile (.AXS). Source f iles only exist in the directory if the program f ile has been successfully compiled (using the Build With Source option).

1. In the Extract NetLinx Source From a SRC File dialog, the selected file (with full directory path) is indicated in the SRC File To Extract From field.
2. In the Extract To field, specify the target directory for the extracted NetLinx Source files, and click Extract to extract the files.
   • When extracted, the program will always replicate the directory paths associated with the compressed files when the file was created. To use the original directory paths, enter C:\ as the destination directory. For example if you enter C:\ as the destination directory, you know that the NetLinx.axi file will be copied into the proper directory for compiling (C:\Program Files\Common Files\AMXShare\AXIs).
   • If a file with the same name already exists in the specified target directory, the program alerts you, and prompts you to overwrite it or pick a different target directory.
   • If you enter non-existent folders, the program will create them for you.

NOTE: The error "DynaZip Unzip Error: Bad or missing decryption key (Problem extracting f ile(s))" indicates a mismatch between the password assigned to the f ile (via the Build With Password option), and the NetLinx password entered in the NetLinx Compiler tab of the Preferences dialog (Password f ield). If you receive this error message, click OK in the error message dialog to access the Enter Password dialog, and re-enter the password exactly as it was entered when the f ile was compiled.

ZIP File Extraction

NetLinx Studio allows you to export an entire Workspace (including all contained Projects, Systems and System Files) as a .ZIP file. The Extract From ZIP File command allows you to extract these files:

1. Select Tools > File Extraction > Extract From ZIP File to access the Select ZIP File For Extraction dialog.
2. Locate and select the ZIP file you want to extract, and click Open.

NOTE: While this feature exists primarily to allow you to unzip exported Workspace f iles, you can use this feature to unzip any

.ZIP f ile.

1. In the Files From a ZIP File dialog, the selected file (with full directory path) is indicated in the ZIP File To Extract From field. Select the Extract using original directory path(s) option to preserve the original directory paths of the files (default = disabled).
2. In the Extract To field, specify the target directory for the extracted Workspace files, and click Extract to extract the files.

NOTE: If a f ile with the same name already exists in the specified target directory, the program alerts you, and prompts you to overwrite it or pick a different target directory.