Просмотр исходного текста страницы X-Ray Universal Compiler

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''X-Ray Universal Compiler'''

<span class="plainlinks">[https://postimg.cc/hXCj5fNy https://i.postimg.cc/hXCj5fNy/compiler-menu-png-f317cf39cb1243265d8c81d5fef1e345.png]</span>
|-
| '''Разработчик'''
| GSC Game World
|-
| '''Модифицировал'''
| [[SkyLoader]]
|-
| '''Версия'''
| 1.6 beta от 20 июля 2024 года
|-
| '''Тип'''
| компиляторы
|-
| '''Платформа'''
|
* [[X-Ray SDK 0.4]]
* [[X-Ray SDK 0.5]]
* [[X-Ray SDK 0.7]]
|-
| colspan=2| [[Версии X-Ray Universal Compiler|История версий]]
|}

'''X-Ray Universal Compiler'''<ref>[https://ap-pro.ru/forums/topic/3341-universalnye-kompilyatory-urovney-h64/ Пост пользователя "SkyLoader" на форуме AP Production]</ref> — это набор модифицированных (в 64-битные версии) на основе X-Ray SDK [[X-Ray SDK 0.7|0.4]]/[[X-Ray SDK 0.5|0.5]]/[[X-Ray SDK 0.7|0.7]] компиляторов '''xrLC''', '''xrDO''' и '''xrAI''', использующихся для сборки уровней, травы и освещения детальных объектов одиночной игры и мультиплеера, а также компонентов искусственного интеллекта уровней только одиночной игры.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| X-Ray Universal Compiler
| https://drive.google.com/file/d/1k3u_8PXyfKmsmF7sJ4mMGjswsRN4d0Rw/view?usp=sharing
https://disk.yandex.ru/d/6aLA9HwoIdiXWA
|-
| Visual C++ 2017 Redistributable
|
'''x86'''<br>
https://aka.ms/vs/15/release/VC_redist.x86.exe

'''x64'''<br>
https://go.microsoft.com/fwlink/?LinkId=746572
|}

== Особенности ==
* Поддержка x64
* Поддержка основных игр серии
* Все компиляторы объединены в одно приложение
* Интерфейс полностью переписан на WinForms
* Добавлено меню компилятора, в котором можно выбрать проект уровня, выставить определенные настройки и запустить компиляцию
* Добавлена система сохранения и загрузки настроек последних проектов
* Создаваемое количество потоков теперь не фиксировано, а зависит от количества ядер процессора
* Произведен переход на библиотеку DirectXTex на замену устаревшим FreeImage и nvDXT
* Убран просчет RGB и Sun компонентов освещения и оставлен только Hemi
* Проведена работа по распоточиванию некоторых фаз компиляции и распоточиванию кода сторонних библиотек
* Интегрирован Discord Rich Presence для возможности следить за статусом компиляции на удаленном ПК
* Добавлена возможность автоматически выключить ПК после компиляции
* Реализован прогресс бар на панели задач для отображения состояния текущей фазы компиляции при свернутом приложении
* Добавлены ключи для ускоренной компиляции уровней в целях тестирования
* Добавлены экспериментальные ключи для отключения некоторых фаз компиляции и установки параметров в обход параметров СДК
* Добавлены основные изменения прошлых компиляторов
* Расширен вывод информации по некоторым ошибкам
* Исправлены некоторые вылеты оригинальных компиляторов

{| class="wikitable" style="float:left; margin-right:0.8em; clear:left; width: 250px;"
|-
| style="text-align:center" | <span class="plainlinks">[https://postimg.cc/HrWnzQv8 https://i.postimg.cc/HrWnzQv8/compiler-process-png-5f97b5ea56d82fddceee4273fd3cac11.png]</span>
|-
| Интерфейс
|}
<br clear="all" />

'''Внимание''': в данном компиляторе по умолчанию отключено запекание статического света и статических теней солнца.

Для включения запекания этих компонентов необходимо использовать соответствующий ключ, указанный в описании.

{| class="mw-collapsible mw-collapsed wikitable"
!colspan="4" align="center"|Описание ключей компиляторов
|-
! Компилятор!! Ключ!! Описание !! Пример
|-
| xrLC || <code>-geometry</code> || Компиляция геометрии уровня || start bin\compilers_sky_x64\xrCompiler.exe -geometry -f имя_уровня -version название_версии (shoc/cs/cop)
|-
| xrDO || <code>-details</code> || Компиляция детейлов (травы) || start bin\compilers_sky_x64\xrCompiler.exe -details -f имя_уровня -version название_версии (shoc/cs/cop)
|-
| xrAI || <code>-aispawn</code> || Компиляция АИ-сетки || start bin\compilers_sky_x64\xrCompiler.exe -aispawn -f имя_уровня -version название_версии (shoc/cs/cop)
|-
| xrAI || <code>-aispawn</code> || Сборка спавна || start bin\compilers_sky_x64\xrCompiler.exe -aispawn -s имя_уровня1,имя_уровня2,имя_уровня3 -out all
|-
| xrLC || <code>-noimpl</code> || Пропуск стадии LIGHT: Implicit (запекание освещения для террейна) || 
|-
| xrLC || <code>-nocform</code> || Пропуск создания level.cform || 
|-
| xrLC || <code>-noresize</code> || Отключить уменьшение размеров загружаемых текстур высокого разрешения || 
|-
| xrLC || <code>-skipthm</code> || Не прерывать компиляцию при отсутствующих текстурах и файлах thm || 
|-
| xrLC || <code>-removeinvalid</code> || Не прерывать компиляцию при найденных invalid faces и удалять их || 
|-
| xrLC || <code>-skipinvalid</code> || Не прерывать компиляцию при найденных invalid faces и пропускать их || 
|-
| xrLC || <code>-tex_rgba</code> || Не использовать сжатие для сохраняемых текстур || 
|-
| xrLC || <code>-tex_bc7</code> || Использовать BC7 сжатие для сохраняемых текстур (формат поддерживается только на DX11) || 
|-
| xrLC || <code>-silent</code> || Автоматически закрыть приложение после завершения компиляции || 
|-
| xrLC || <code>-sleep</code> || Выключить компьютер после завершения компиляции || 
|-
| xrLC || <code>-nohemi</code> || Отключить запекание освещения. Значительно ускоряет компиляцию. Предназначен для тестирования геометрии || 
|-
| xrLC || <code>-underground</code> || Компилировать уровень как подземный. Ускоряет компиляцию || 
|-
| xrLC || <code>-static</code> || Запекать статическое освещение (не работает с ключом -nohemi) || 
|-
| xrLC || <code>-cform</code> || Экспортировать только коллизию уровня || 
|-
| xrLC || <code>-noise</code> || Отключить создание Progressive геометрии. Ускоряет компиляцию, но не создает упрощенную геометрию для уровня и Multiple Usage объектов || 
|-
| xrLC || <code>-nosmg</code> || Не использовать группы сглаживания. В зависимости от конкретной геометрии помогает избежать ломаных фейсов/теней, или наоборот добавит их || 
|-
| xrLC || <code>-notess</code> || Не тесселировать геометрию. В некоторых случаях может повышать fps в зависимости от конкретной локации. Проверять на практике || 
|-
| xrLC || <code>-noweld</code> || Отключить сшивание маленьких треугольников. В некоторых случаях помогает избежать глюков на некоторых типах геометрии || 
|-
| xrLC || <code>-nomerge</code> || Пропустить стадию Merging geometry || 
|-
| xrLC || <code>-nostrip</code> || Отключить оптимизацию и стрипификацию геометрии || 
|-
| xrLC || <code>-dx_opt</code> || Включить оптимизацию геометрии средствами D3DX optimizer вместо NvTriStrip || 
|-
| xrLC || <code>-old_bcform</code> || Создавать build.cform в старом формате || 
|-
| xrLC || <code>-gi</code> || Включить фазу Radiosity || 
|-
| xrLC || <code>-no_mt_mu</code> || Не запускать расчет освещения для Multiple Usage объектов параллельно основной компиляции || 
|-
| xrLC || <code>-high</code> || Более высокий приоритет для потоков || 
|-
| xrLC || <code>-saveobj_base</code> || Сохранить всю геометрию уровня в модели с расширением .obj (базовая развертка) || 
|-
| xrLC || <code>-saveobj_lmap</code> || Сохранить всю геометрию уровня в модели с расширением .obj (лайтмап развертка) || 
|-
| xrLC || <code>-saveobj_cform</code> || Сохранить всю коллизию уровня в модель с расширением .obj || 
|-
| xrLC || <code>-qual_draft</code> || Установить качество сцены в Draft (не влияет на выставленные шейдеры) || 
|-
| xrLC || <code>-qual_high</code> || Установить качество сцены в High (не влияет на выставленные шейдеры) || 
|-
| xrLC || <code>-force_default_shader</code> || Принудительно заменять шейдеры материалов с вершинного освещения на лайтмапное (def_vertex->default) || 
|-
| xrLC || <code>-force_vertex_shader</code> || Принудительно заменять шейдеры материалов с лайтмапного освещения на вершинное (default->def_vertex) || 
|-
| xrLC || <code>-ppm число</code> || Установить качество лайтмапов вместо значения в СДК || 
|-
| xrLC || <code>-weld_dist число</code> || Установить Weld distance вместо значения в СДК || 
|-
| xrLC || <code>-hemi_bias число</code> || Установить смещение позиции луча при запекании хеми (по умолчанию: 0.1, в оригинале: 0.001) || 
|-
| xrDO || <code>-skipthm</code> || Не прерывать компиляцию при отсутствующих текстурах и файлах thm || 
|-
| xrDO || <code>-silent</code> || Автоматически закрыть приложение после завершения компиляции || 
|-
| xrDO || <code>-sleep</code> || Выключить компьютер после завершения компиляции || 
|-
| xrDO || <code>-nohemi</code> || Отключить запекание освещения || 
|-
| xrDO || <code>-static</code> || Запекать статическое освещение (не работает с ключом -nohemi) || 
|-
| xrAI || <code>-draft</code> || Не просчитывать укрытия для АИ-сетки || 
|-
| xrAI || <code>-verify</code> || Проверить АИ-сетку на ошибки || 
|-
| xrAI || <code>-noverbose</code> || Не выводить информацию об одиночных нодах (при ключе -verify) || 
|-
| xrAI || <code>-skipthm</code> || Не прерывать компиляцию при отсутствующих текстурах и файлах thm || 
|-
| xrAI || <code>-silent</code> || Автоматически закрыть приложение после завершения компиляции || 
|-
| xrAI || <code>-sleep</code> || Выключить компьютер после завершения компиляции || 
|-
| xrAI || <code>-s имя_уровня1,имя_уровня2,имя_уровня3...</code> || Собрать спавн из перечисленных уровней (перечисление через запятую без пробела) || -s zaton,labx8,jupiter,jupiter_underground,pripyat
|-
| xrAI || <code>-out имя</code> || Выбрать имя выходного файла спавна || -out all
|-
| xrAI || <code>-no_separator_check</code> || Отключить конфликты спейс рестрикторов и АИ-сетки, а также другие ошибки || 
|-
| xrAI || <code>-insert_graph</code> || Осуществлять сборку спавна со вшитыми в спавн графами для ТЧ спавна || 
|-
| xrAI || <code>-large_aimap</code> || Собрать спавн для уровней с расширенной АИ-сеткой. Все уровни должны иметь такой формат сетки || 
|-
| xrLC, xrDO, xrAI || <code>-help</code> || Вызов справки со списком всех ключей запуска || 
|-
| xrLC, xrDO, xrAI || <code>-t число</code> || Установить количество потоков для многопоточных операций (не работает с ключом -tbb) || 
|-
| xrLC, xrDO, xrAI || <code>-fsltx имя_файла</code> || Использовать свой ltx вместо fsgame.ltx || 
|-
| xrLC, xrDO, xrAI || <code>-log_name имя_файла</code> || Создать файл лога с данным именем. Полезно для компиляции локаций очередью || 
|-
| xrLC, xrDO, xrAI || <code>-discord</code> || Включить Discord Rich Presence с выводом имени уровня и статуса компиляции || 
|-
| xrLC, xrDO, xrAI || <code>-discord_s</code> || Включить Discord Rich Presence с выводом только статуса компиляции || 
|-
| xrLC, xrDO, xrAI || <code>-tbb</code> || Использовать TBB многопоточность (не рекомендуется) || 
|-
| xrLC, xrDO, xrAI || <code>-both_texture_pathes </code> || Загрузка текстур и thm файлов по обоим путям ($game_textures$ и $textures$) || 
|}
{| class="mw-collapsible mw-collapsed wikitable"
!colspan="4" align="center"|Примеры команд
|-
! Описание !! Пример команды 
|-
| Ускоренная компиляция уровня для тестирования геометрии без запеченного освещения ||
<code>start bin\compilers_sky_x64\xrCompiler.exe -geometry -f zaton -nohemi -noise</code><br>
<code>start bin\compilers_sky_x64\xrCompiler.exe -details -f zaton -nohemi</code><br>
<code>start bin\compilers_sky_x64\xrCompiler.exe -aispawn -f zaton -draft</code>
|-
| Компиляция подземного уровня, полностью закрытого nosun геометрией ||
<code>start bin\compilers_sky_x64\xrCompiler.exe -geometry -f labx8 -underground</code>
|-
| Компиляция только коллизии ||
<code>start bin\compilers_sky_x64\xrCompiler.exe -geometry -f zaton -cform</code>
|-
| Компиляция локаций очередью с последующим выключением ПК || 
<code>start /wait bin\compilers_sky_x64\xrCompiler.exe -geometry -f zaton -log_name zaton_geometry -silent

start /wait bin\compilers_sky_x64\xrCompiler.exe -details -f zaton -log_name zaton_detail -silent

start /wait bin\compilers_sky_x64\xrCompiler.exe -aispawn -f zaton -log_name zaton_aimap -silent

start /wait bin\compilers_sky_x64\xrCompiler.exe -geometry -f jupiter -log_name jupiter_geometry -silent

start /wait bin\compilers_sky_x64\xrCompiler.exe -details -f jupiter -log_name jupiter_detail -silent

start /wait bin\compilers_sky_x64\xrCompiler.exe -aispawn -f jupiter -log_name jupiter_aimap -silent -sleep</code>
|}

{| class="mw-collapsible mw-collapsed wikitable"
!align="center"|Ньюансы и советы
|-
|
Можно не устанавливать ключ -version. В таком случае выходной формат данных будет следующим: для уровня из ТЧ СДК – ТЧ формат, для уровня ЧН/ЗП СДК – ЗП формат.

Для уровней, собранных ТЧ СДК, будет автоматически применяться ТЧ сглаживание, а значит нет необходимости использовать ключ -nosmg (за исключением модифицированных ТЧ СДК, добавляющих группы сглаживания).

При активном ключе -both_texture_pathes на этапе загрузки .thm файлов сначала производится попытка открыть файл по пути $game_textures$ (gamedata\textures), при его отсутствии – по пути $textures$ (rawdata\textures). По умолчанию, для ЧН/ЗП проектов используется только путь $game_textures$, для ТЧ проектов - $textures$.

Для частичного исправления часто встречающейся проблемы с появлением черных полигонов было изменено смещение позиции лучей при запекании затенений от хемисферы. В связи с этим, при моделировании геометрии зданий рекомендуется не создавать ту-сайд геометрию для стен (как, например, у кораблей на Затоне), а выдерживать определенную их толщину. Если же требуется оставить геометрию как есть, то можно вернуть смещение луча на оригинальное значение с помощью ключа -hemi_bias 0.001, но тогда количество черных треугольников будет как при использовании старых компиляторов. 

Увеличение значения -hemi_bias (например, на значение от 1.0 до 10.0) в определенных случаях позволяет избавиться от черных треугольников, оставшихся после запекания освещения.

В продакшен версии уровня не рекомендуется использовать ключ -skipthm, поскольку из-за отсутствующих текстур и файлов thm на поверхностях может неправильно запечься свет.

Не следует выставлять Weld distance в ноль. Иногда это провоцирует создание кривых фейковых теней от некоторой геометрии. Лучше поставить небольшое значение, но больше нуля.

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

Для анализа того, как компилятор изменил геометрию уровня под игру, можно воспользоваться ключами -saveobj_base, -saveobj_lmap и -saveobj_cform. Геометрия будет сохранена по пути temp\geom… в файлы с расширением obj для дальнейшего просмотра их в 3д редакторе. Также ключ -saveobj_lmap может помочь в ручном редактировании лайтмап текстур, если на них были обнаружены проблемы.
|}

== Установка ==
Переместите файлы из архива в:
* ''X-Ray_SDK_SoC\level_editor''
* ''X-Ray_SDK_CS\editors''
* ''X-Ray_SDK_CoP\editors''

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]