Редактирование: Resource copier

== Описание ==

Скрипт предназначается для копирования исходников локации из SDK в произвольную директорию для последующей отправки на компиляцию или доработку другому мапперу.

Копирует:
* уровень из <code>X:\rawdata\levels</code>
* объекты уровня из <code>X:\rawdata\objects\levels</code>
* текстуры (.dds/.tga, _bump и _bump#), файлы описания текстур (.thm)
* звуки (.ogg)
Ведется запись лог-файла (<code>X:\logs\copy.log</code>) со списком копируемых текстур, звуков и объектов вместе со статусом копирования (скопировано или нет; если нет, то почему).


== Установка ==

# Установите [http://www.activestate.com/activeperl/downloads ActivePerl].
# Распакуйте [http://files.xray-engine.org/k.d./perl_scripts/maintenance/resource_copier_v.0.6.rar архив со скриптом] в нужную папку.
# Скопируйте [http://files.xray-engine.org/k.d./perl_scripts/stkutils/stkutils_01_09_2012.rar библиотеку модулей <code>stkutils</code>] в папку с библиотеками Perl (например, <code>C:\Perl\lib</code>) или в папку со скриптом.


== Использование ==

Для начала нужно загрузить карту в LevelEditor и "полетать" по ней мышкой, чтобы редактор подгрузил все используемые текстуры. После этого можно свернуть LE и перейти к копированию ресурсов.

Команда:
<syntaxhighlight lang="winbatch">perl rc.pl -c <level_name> -o <out_dir> [-tga] [-soc]</syntaxhighlight>

Описание параметров:
* '''-c <level_name>''' <br />Имя копируемого уровня.
* '''-o <out_dir>'''	<br />Целевая папка для копируемого уровня.
* '''-tga'''		<br />Копировать также tga-текстуры.
* '''-soc'''		<br />Режим работы с локациями ТЧ.
* '''-mtime <yyyy:mm:dd:hr:mn:sc>''' <br />Фильтрация по дате последнего изменения файла. Будут копироваться только текстуры, измененные позднее.

В файле <code>ignore.ini</code> можно указать игнорируемые объекты, звуки и текстуры. Формат записи:
<syntaxhighlight lang="ini">[objects]
editor\artefakt_ah

[game_textures]
act\act_corp_military

[game_sounds]
ambient\air_2</syntaxhighlight>

'''Важные замечания'''
* Должен быть смонтирован диск <code>X:</code> для SDK.
* В папке <code>X:\logs</code> должен быть лог от LevelEditor, причем только текущего пользователя. Если в папке лежат логи разных пользователей LE, скрипт будет читать имена текстур из всех логов.
* Указывая путь для копирования локации, не забывайте ставить обратную косую черту, например:
<syntaxhighlight lang="winbatch">perl rc.pl -c имя_уровня -o X:\buld_copy\имя_уровня\</syntaxhighlight>


== История версий ==

'''v.0.6'''
* [+] Добавлена фильтрация копируемых текстур по дате последнего изменения.

'''v.0.5'''
* [f] Выкинут лишний код.
* [+] Адаптирован новый отладочный модуль.

'''v.0.4'''
* [f] Исправлено копирование файла .level
* [+] Добавлена возможность игнорирования объектов из rawdata\objects. 
* [+] Добавлен вывод игнорируемых объектов в лог скрипта.
* [+] Добавлено копирование *.thm для объектов, если таковые thm присутствуют.
* [m] Отключение копирования стандартных текстур переделано на ignore.ini. 
* [m] Имена текстур и прочего в ignore.ini теперь можно вводить без расширений.
* [m] Изменены названия секций в ignore.ini.
	
'''0.3'''
* [+] Добавлена поддержка scene_object.part ТЧ.
* [+] Добавлено копирование звуков, список звуков берется из sound_src.part.
* [+] Отключено копирование стандартных текстур и объектов SDK (<code>rawdata/objects/editor</code> и <code>gamedata/textures/ed</code>).
* [+] Добавлен конфиг-файл, в который можно добавлять игнорируемые файлы.
  
'''0.2'''
* [+] Из <code>rawdata\objects</code> копируются только те объекты, которые есть в scene_object.part (только для ЧН/ЗП).

'''0.1'''
* Первый релиз.

[[Категория:Инструментарий]][[Категория:Утилиты на Perl]]
@@ Строка 1: / Строка 1: @@
-<div style="padding: .5em 1em; float: right; background: #f2f2f2; border: 1px solid #aaaaaa;">
+== Описание ==
-<big>'''Resource copier'''</big>
-----
-{| style="border: none"
-| '''Тип'''              || Служебный скрипт
-|-
-| '''Автор'''            || K.D.
-|-
-| '''Последняя версия''' || [https://files.xray-engine.org/k.d./perl_scripts/maintenance/resource_copier_v.0.6.rar 0.6 (9.09.2012)]
-|-
-| '''Написан на'''       || Perl 5
-|-
-| '''Обратная связь'''   || [https://www.amk-team.ru/forum/index.php?showtopic=11568 AMK форум]
-|}
-</div>
-Скрипт предназначается для полуавтоматического копирования исходников локации из SDK в произвольную директорию для последующей отправки на компиляцию или доработку другому мапперу.
+Скрипт предназначается для копирования исходников локации из SDK в произвольную директорию для последующей отправки на компиляцию или доработку другому мапперу.
 Копирует:
@@ Строка 27: / Строка 13: @@
 == Установка ==
-# Установите [[ActivePerl]].
+# Установите [http://www.activestate.com/activeperl/downloads ActivePerl].
-# Распакуйте [https://files.xray-engine.org/k.d./perl_scripts/maintenance/resource_copier_v.0.6.rar архив со скриптом] в нужную папку.
+# Распакуйте [http://files.xray-engine.org/k.d./perl_scripts/maintenance/resource_copier_v.0.6.rar архив со скриптом] в нужную папку.
-# Скопируйте библиотеку модулей [[stkutils]] в папку с библиотеками Perl (например, <code>C:\Perl\lib</code>) или в папку со скриптом.
+# Скопируйте [http://files.xray-engine.org/k.d./perl_scripts/stkutils/stkutils_01_09_2012.rar библиотеку модулей <code>stkutils</code>] в папку с библиотеками Perl (например, <code>C:\Perl\lib</code>) или в папку со скриптом.
 == Использование ==
-Для начала нужно загрузить карту в LevelEditor и "полетать" по ней мышкой, чтобы редактор подгрузил все используемые текстуры и записал их список в лог-файл. После этого можно свернуть LE и перейти к копированию ресурсов.
+Для начала нужно загрузить карту в LevelEditor и "полетать" по ней мышкой, чтобы редактор подгрузил все используемые текстуры. После этого можно свернуть LE и перейти к копированию ресурсов.
 Команда:
@@ Строка 93: / Строка 79: @@
 * Первый релиз.
-[[Категория:Perl]][[Категория:Текстуры]]
+[[Категория:Инструментарий]][[Категория:Утилиты на Perl]]