Редактор ресурсов

Первые шаги с Resource Tuner Console

Resource Tuner Console - это консольный редактор ресурсов, управляемый из командной строки при помощи скриптов и .bat файлов. Если вам нужен редактор ресурсов с визуальным графическим интерфейсом, то правильным выбором будет другой продукт - Resource Tuner GUI.

Resource Tuner Console (RTC) получает на вход данные из файла скрипта. RTC читает и исполняет скрипты (сценарии) при помощи Windows Scripting Host (WSH) - независимого от языка скрипт-хоста. По умолчанию, Resource Tuner Console использует язык сценариев VBScript.

Скрипты RTC имеют расширение .RTS (сокращенно от Resource Tuner Script). Это обычные текстовые файлы, которые можно редактировать в любом ASCII текстовом редакторе, например, в Блокноте.

Для того, чтобы вы могли составить себе представление о том, как работает программа, мы подготовили более десятка примеров, демонстрирующих наиболее вероятные варианты применения программы. Образцы скриптов можно увидеть в Сборнике примеров на этом сайте или в дистрибутиве Resource Tuner Console.

Как этим пользоваться?

Использование Resource Tuner Console включает в себя следующие шаги:

1. Пользователь пишет скрипт сценария операций по редактированию ресурсов, следуя спецификациям языка VBScript. Вы можете использовать наши готовые примеры как заготовки для создания своих собственных скриптов. В большинстве случаев вам даже не придётся ничего менять в этих примерах, кроме имён файлов. См. также Иллюстрированное руководство по использованию скриптов RTC.

2. Пользователь указывает имена файлов и пути к входным и выходным файлам (из какой папки файл брать и в какую записывать). После этого запускает программу из .bat файла или непосредственно из командной строки с требуемыми параметрами.

3. Resource Tuner Console, следуя сценарию, открывает файл(ы), производит редактирование ресурсов и записывает файл(ы) в указанное место на диске.

Запуск программы из командной строки

Напечатайте в командной строке rtc.exe без параметров. Появится консольное окно с краткой информацией о программе.

Для выполнения скрипта, напечатайте rtc.exe /F:ScriptName (включая полный путь к скрипту).

Пример: rtc.exe /F:"c:\temp\my_script.rts"

Запуск из .bat файла

Создайте .bat файл и поместите в него строчку rtc.exe /F:ScriptName

После установки Resorce Tuner Console на свой компьютер в директории программы вы найдёте папку Demo Scripts. В ней содержится множество рабочих примеров таких .bat файлов вместе с демо-скриптами.

Примеры скриптов Пошаговое руководство по использованию скриптов

Синтаксис

RTC [опции] /F:ScriptName

Опции:

Параметры

/F:ScriptName
Имя файла скрипта. Обязательный параметр. Задаёт имя файла скрипта. По умолчанию, если параметр не содержит полный путь к файлу, программа ожидает найти файл скрипта в своей директории. Если в имени и/или пути к файлу есть пробелы, указывайте его заключенным в двойные кавычки, например: /F:"c:\temp folder\my script.rts"

Опции

/S
Включает silent-режим. При включённом "режиме молчания" программа во время работы не отображает никаких сообщений на экране.

/L[:LogName]
Включает запись событий в лог и определяет имя лог-файла (включая полный путь к файлу, если нужно). Если имя лог-файла содержит пробелы, обязательно заключайте его в кавычки. При отсутствии аргумента LogName программа будет использовать имя лог-файла по умолчанию RTC.log и создаст лог-файл в директории программы. Если параметр /L отсутствует, запись в лог не производится.

/A
Включает режим дописывания новых событий в конец существующего лог-файла. Если параметр /A отсутствует, программа перезаписывает старый лог-файл новым.

/E
При указании этого параметра программа всегда будет выводить сообщения на английском языке. Если параметр /E отсутствует, программа выводит сообщения на русском, немецком, испанском или французком языках в зависимости от региональных настроек пользователя.

/plhdXX="Value"
Плейсхолдер, передающий значение Value в скрипт. При указании этого параметра программа ищет указанную метку plhdXX в коде скрипта и заменяет её значением из Value, где:

plhd - зарезервированное слово (означающее "placeholder"). Обязательно для использования!
XX - любой идентификатор. Например, /PLHD01 или /plhd_MyData
Value - Любое значение, которое вы хотите передать в код скрипта из командной строки или bat файла, например, путь к файлу или цифра версии файла. Кавычки обязательны!

Правила использования плейсхолдеров

Вы можете использовать любое количество плейсхолдеров (меток-заменителей) в ваших скриптах. Тем самым вы можете написать один общий скрипт и просто вызывать его с разными параметрами, передавая их посредством плейсхолдеров. Каждый плейсхолдер в коде скрипта должен быть заключён между знаками %.

Пример:

rtc /L /plhd_bool="True" /plhd_str="Hello!" /plhd01="10" /F:my_script.rts

Во время исполнения скрипта, следующие строки:

будут заменены на:

Коды выхода (Exit codes)

Resource Tuner Console возвращает следующие зарезервированные коды выхода (для задания пользовательского значения кода возврата используйте свойство UserErrorLevel):

0 - если выполнение скрипта было успешным,
1 - неверные параметры командной строки,
2 - файл скрипта не может быть открыт,
3 - ошибка скрипта или синтаксиса,
4 - не указано имя файла скрипта,
5 - файл скрипта не найден.

	
@echo off  
start /wait rtc.exe /F:"c:\temp\my_script.rts"

 if errorlevel 0 goto 0
 if errorlevel 1 goto 1
 if errorlevel 2 goto 2
 if errorlevel 3 goto 3
 if errorlevel 4 goto 4
 if errorlevel 5 goto 5
 goto done

 :0  
 echo Script finished OK 
 goto done  

 :1 
 echo ERROR: Invalid parameters   
 goto done   
 
 :2   
 echo ERROR: Script file could not be opened
 goto done   
  
 :3
 echo ERROR: Script failed

 :4   
 echo ERROR: Script file name not specified
 goto done   
  
 :5
 echo ERROR: Script file not found
    
 :done

Примеры

   Пример 1

Следующая команда выполняет скрипт и по умолчанию создаёт файл лога rtc.log в директории программы:

   RTC /L /F:"C:\RTC Folder\my test script.rts"

Имя файла скрипта содержит пробелы и поэтому весь путь к файлу заключен в кавычки.

Во время выполнения скрипта Resource Tuner Console параллельно с записью в лог-файл отображает сообщения о всех событиях и ошибках на экране.

   Пример 2

Следующая команда выполняет скрипт в silent-режиме и создаёт или дописывает события в конец уже существующего лог-файла с названием logfile.log в директории, заданной путём к лог-файлу:

   RTC /S /L:"D:\logs\my logfile.log" /A /F:my_script.rts

Имя файла лога содержит пробелы и поэтому путь к лог-файлу заключен в кавычки.

Во время выполнения скрипта Resource Tuner Console не отображает никаких событий на экране. О возникших ошибках вы сможете узнать только из сообщений, записанных в лог-файл, или с помощью обработки кода выхода в bat файле.

Файлы определений

RTC опционально может использовать внешний файл определений для указания значений констант в обрабатываемом исполняемом файле.

Файл определения создаётся в любом ASCII текстовом редакторе в следующем формате:

#define ItemName ItemValue

Пример:

Delphi разработчики могут использовать .DRC файлы, которые генерирует компилятор Delphi Pascal. При включенной опции Detailed Map (Delphi Menu - Project - Options - Linker Tab - Map File - выбрать "detailed" радио кнопку), в них будут содержаться все строки с соответствующими ID.

Подробности и пример использования файла определений смотрите в примере скрипта Edit Strings. Вы можете использовать этот пример в качестве темплейта для написания своего собственного скрипта.

Примеры скриптов
 Скачать 60-дневную пробную версию Resource Tuner Console