USC Interpreter

The following example demonstrates how to assign values of the command-line arguments to the script variables:

#!/usr/bin/env usc

// declare variables
int value1 = 0;
int value2 = 0;

/*
 */
void main() {
	// parce arguments
	for(int i = 0; i < getNumArgs(); i++) {
		// get the argument value
		string arg = getArg(i);
		
		// process all required arguments
		if(arg == "-set_value_1") {
			if(i + 1 >= getNumArgs()) {
				continue;
			}
			// assign an argument value to the variable
			value1 = int(getArg(++i));
			continue;
		}
		
		if(arg == "-set_value_2") {
			if(i + 1 >= getNumArgs()) {
				continue;
			}
			// assign an argument value to the variable
			value2 = int(getArg(++i));
			continue;
		}
	}
	
	// print the variables
	log.message("value1: %d\nvalue2: %d\n",value1,value2);
}

usc_x64.exe my_script.usc -set_value_1 3 -set_value_2 7

value1: 3
value2: 7

The following example demonstrates how to print all command-line arguments passed to the USC script:

#!/usr/bin/env usc

void main() {
	forloop(int i = 0; getNumArgs()) {
		log.message("Arg [%d]: %s\n",i,getArg(i));
	}
}

usc_x64.exe my_script.usc -arg1 -arg2

Arg [0]: my_script.usc
Arg [1]: -arg1
Arg [2]: -arg2

For more examples see the *.usc scripts in the following folders:

• <UnigineSDK>/utils/Upgrade
• <UnigineSDK>/source/tools/Interpreter/scripts (available only in the full source version of Unigine SDK)

To run a USC script on Windows:

1. Add a path to <UnigineSDK>/bin/usc_*.exe binary executable to environment variables. Depending on the postfix, it can be either 32-bit (_86) or 64-bit, debug (d) or release (no postfix) version of the USC interpreter.
   Notice

   You can also associate the *.usc file with the <UnigineSDK>/bin/usc_*.exe binary executable. In this case, you will run the script by double-clicking it.
2. In the command prompt, go to the folder with the *.usc file and run it by the USC interpreter with all required arguments, for example:
   Shell commands

   C:\Windows\system32>d:
   D:\>cd my_project\usc_scripts
   D:\my_project\usc_scripts>usc_x64.exe my_script.usc -define USE_DEFINE -arg1 4

To run a USC script on Linux or Mac OS X, follow the instructions:

1. In the first line of your script, specify the following:
   Shell commands

   #!/usr/bin/env usc

2. Add a path to the <UnigineSDK>/bin/usc_* binary executable to environment variables. Depending on the postfix, you can use either 32-bit (_86) or 64-bit, debug (d) or release (no postfix) version of the USC interpreter.
   Notice

   Make sure that your terminal takes environment variables into account.
3. In the terminal, go to the folder with the *.usc file and run it by the USC interpreter with all required arguments, for example:

   On Linux:

   Shell commands

   username@pc-name:~$ cd my_project/usc_script
   username@pc-name:~/my_project/usc_script$ usc_x64 my_script.usc

   On Mac OS X:

   Shell commands

   mac-name:~ username$ cd ~/my_project/utils
   mac-name:usc_scripts username$ usc my_script.usc