How To Get Started With Resource Tuner Console
Resource Tuner Console is a command-line tool. It's a scriptable program
runnable from the console, and is intended to be used from scripts. If you need a
resource editor with GUI, you might want to use Resource Tuner GUI.
Resource Tuner Console (RTC) accepts input from a script file. It reads and executes
scripts using the Windows Scripting Host engine. RTC uses VBScript as a general scripting language. RTC scripts have an .RTS (meaning Resource Tuner Script) extension. Script files are usually edited in any ASCII text editor.
Usage
From the command prompt, type rtc.exe.
Invoking the program from the command prompt
From the command prompt, type rtc.exe /F:ScriptName (including the full path, if any).
Example: rtc.exe /F:"c:\temp\my_script.rts"
Running from the .bat file
Create a .bat file and put rtc.exe /F:ScriptName in it.
Have a look in the Resource Tuner Console directory for some .bat file examples.
 Sample Scripts
Syntax
RTC [options] /F:ScriptName
Options:
/S |
Silent On. |
/L[:LogName] |
Logging On. |
/A |
Append Log. |
/plhdXX="Value" |
Pass Value using a Placeholder. |
/E |
User Language Override. |
Parameters
/F:ScriptName
Script File Name. Required. Specifies the name of a script file. By default, the program expects to find the
script file under the same directory the program is located if this parameter does not contain a fully qualified pathname.
If a file name and/or pathnames contain a space, they must be enclosed in double quotes.
Options
/S
Silent On. Optional. Instructs the program to be silent. No events will be displayed on the screen.
/L[:LogName]
Logging On. Optional. Specifies the name of a log file (including the full path, if any) and causes
the program to create a log file detailing all events and actions taken during the editing process. If you suspect a script
does not produce the desired results the log file will tell you every little detail. Don't forget to use quotes if the log
name contains spaces.
If the LogName argument is omitted, the program will use the default RTC.log name and creates a log file in the same directory
the program is located. If the /L parameter is omitted, the program will not output to file.
/A
Append Log. Optional. Instructs the program to append a log to the existing log file. If the /A parameter is omitted, the program will overwrite the existing log file.
/E
User Language Override. Optional. Instructs the program to always use English for its output. If the /E parameter is omitted, RTC outputs messages in either English, German, Spanish or French, depending upon the user's locale.
/plhdXX="Value"
Pass Value. Optional. Instructs the program to find a specified placeholder plhdXX within your script and replace it with the Value, where:
plhd - The reserved word (meaning "placeholder"). Required!
XX - Any id. For example, /PLHD01 or /plhd_MyData
Value - Any value you wish to pass into the script. Quotes are required!
Placeholder Usage Guidelines
You can use multiple placeholders in your scripts. You can write one generic script and
just invoke it with different parameters. Every placeholder in the script body must be enclosed by % signs.
Example:
rtc /L /plhd_bool="True" /plhd_str="Hello!" /plhd01="10" /F:my_script.rts
During script execution, the following lines:
...........
MainFlag = %plhd_bool%
HelloStr = "%plhd_str%"
Counter = %plhd01%
........... |
will be replaced with:
...........
MainFlag = True
HelloStr = "Hello!"
Counter = 10
........... |
Exit Codes
Resource Tuner Console will return an exit code of 0 if the script was successful, 1 if the command line parameters were invalid, 2 if the script file could not be opened, and 3 if the script failed, or a syntax error occurred.
Examples
Example 1
The following command runs the script and creates a log file named rtc.log by default in the same directory the program is located:
RTC /L /F:"C:\RTC Folder\my test script.rts"
As shown in the example above, filenames that include spaces must be enclosed in quotes.
In response, Resource Tuner Console displays in details all events and actions taken during the editing process. Any syntax errors and/or errors encountered during compilation will be reported for you to correct.
Example 2
The following command silently runs the script and creates or appends a log to the existing log file named my logfile.log in the user defined directory:
RTC /S /L:"D:\logs\my logfile.log" /A /F:my_script.rts
As shown in the example above, filenames that include spaces must be enclosed in quotes.
In response, Resource Tuner Console displays no events on the console screen.
Download Resource Tuner Console and learn how it can make you more productive. |
Windows 98, ME, NT4, 2000, XP, 2003, Vista
