Preferences

Данная страница описывает настройки аддона blender-xray.

Введение
Для того, чтобы открыть настройки аддона, нужно зайти в меню File > User Preferences (для blender 2.7x) или в меню Edit > Preferences (для blender 2.8x-2.9x). Перейти во вкладку Add-ons и в поиске найти аддон X-Ray Engine Tools. Либо перейти в категорию Import\Export и в списке найти аддон. Настройки будут отображаться, если аддон активирован. Все настройки находятся ниже информации об аддоне, в рамке Preferences. Параметры настроек аддона описаны ниже на данной странице.

Общие настройки
В этом разделе описаны общие настройки аддона.

Settings Presets
Предустановки настроек аддона. Предназначены для сохранения настроек, с возможностью переключения между ними. Для создания новой предустановки, в первую очередь нужно настроить параметры аддона (см. описание параметров ниже), после чего нажать на кнопку справа с изображённым плюсом. В появившемся окне указать имя предустановки и нажать кнопку OK. Для удаления предустановки, нужно её выбрать из списка и нажать на кнопку с изображённым минусом. Файлы предустановки сохраняются в следующую папку (для windows): C:\Users\<USER_NAME>\AppData\Roaming\Blender Foundation\Blender\<BLENDER-VERSION>\scripts\presets\io_scene_xray\preferences\.
Примеры использования: можно создать настройки для разных версий X-Ray SDK, разных версий билдов и разных частей игры (SoC, CS, CoP) и перед импортом моделей использовать нужную предустановку.
Expert Mode
Данный параметр включает отображение в интерфейсе дополнительных свойств аддона. Это те свойства, которые не желательно изменять, так как в большинстве случаев они настроены правильно. Данные свойства предназначены для опытных пользователей. Если не правильно их установить, то это может привести к проблемам в X-Ray SDK (к примеру, меш может быть невидимым). На данный момент, если включить Expert Mode, в интерфейс blender будут добавлены следующие параметры:
Окно Properties > Вкладка Object Data (только для меш объектов) > Панель X-Ray Engine: Mesh > параметр Flags, который имеет опции Visible, Locked, SGMask.
Compact Import/Export Menus
Если данный параметр включён, то в меню импорта/экспорта операторы будут находится в компактном виде и будут сгруппированы в одном подменю X-Ray. Операторы будут иметь примерно такой путь: File > Import > X-Ray > Source Object (*.object). Если выключен, то операторы будут добавляться в меню Import/Export, как стандартные операторы (без подменю). И путь к ним будет примерно таким: File > Import > X-Ray object (*.object).
Примеры использования: если включить компактный режим меню, то можно уменьшить загромождение меню импорта/экспорта и облегчить поиск X-Ray операторов.

Настройки путей
Данные настройки указывают пути ко внешним файлам или директориям X-Ray Engine или X-Ray SDK. Доступны следующие параметры:

Есть возможность установить пути автоматически, на основе одного параметра. К примеру, если указать папку gamedata в параметре Gamedata Folder, то пустые пути (кроме, fs.ltx File) будут заполнены автоматически. Автоматически заполненные пути имеют текст (auto) в конце названия. Чтобы изменить путь вручную, нужно нажать на кнопку с изображённым гаечным ключом. Кнопка с ключом исчезнет и вместо неё будет отображаться кнопка с иконкой папки. После этого можно открыть файловый браузер с помощью кнопки с изображённой папкой. В браузере выбрать нужную папку или файл. Либо можно изменить путь в текстовом поле, напечатав его с клавиатуры. Если путь задан вручную, то его значение не будет изменяться аддоном автоматически. Для того, чтобы вернуть автоматическое указание пути, нужно очистить поле ввода пути. Автоматически аддон устанавливает такие значения:

Параметр	Значение
fs.ltx File	-
Gamedata Folder	.
Textures Folder	.textures\
GameMtl File	.gamemtl.xr
EShader File	.shaders.xr
CShader File	.shaders_xrlc.xr
Objects Folder	..rawdata\objects

- - означает, что автоматическая установка значения не работает для этого параметра. Автоматическая установка пути будет работать, если первым указать любой параметр, кроме Objects Folder.

fs.ltx File
Путь к fs.ltx файлу. Данный файл находится в X-Ray SDK и хранит пути к директориям. Аддон использует fs.ltx файл только для того, чтобы автоматически установить следующие пути: Gamedata Folder, Textures Folder, GameMtl File, EShader File, CShader File, Objects Folder. Используются только эти переменные из файла: $game_data$ , $game_textures$ , $objects$ . Поиск файлов gamemtl.xr, shaders.xr, shaders_xrlc.xr производится в директории, которая указана в $game_data$ . Если параметры Gamedata Folder, Textures Folder, GameMtl File, EShader File, CShader File, Objects Folder уже настроены, то указывать fs.ltx File не обязательно.
Примеры использования: данный параметр нужен для корректной автоматической установки путей, если fs.ltx файл был отредактирован и X-Ray SDK использует пути, которые отличаются от gamedata, gamedata\textures, rawdata\objects.
Gamedata Folder
Путь, который должен ссылаться на gamedata папку (или на папку, которая указана в $game_data$ , если fs.ltx был изменён). Данный путь используется только для автоматической установки следующих параметров: Textures Folder, GameMtl File, EShader File, CShader File, Objects Folder. Пути автоматически устанавливаются, путём прибавления Gamedata Folder и заранее установленных значений. Значения устанавливаются следующим образом: Textures Folder - textures, GameMtl File - gamemtl.xr, EShader File - shaders.xr, CShader File - shaders_xrlc.xr, Objects Folder - ..rawdata\objects, где .. вначале Objects Folder означают перейти в пути на одну папку назад. То есть путь к Objects Folder будет выглядеть так: c:\programs\xray_sdk\rawdata\objects\, если Gamedata Folder имеет следующее значение: c:\programs\xray_sdk\gamedata\.
Textures Folder
Путь, который должен ссылаться на $game_textures$ . Обычно это папка gamedata\textures, которая содержит текстуры. Поддерживается загрузка только dds формата. Данный путь используется только теми плагинами, которые импортируют/экспортируют форматы, поддерживающие использование текстур (например, *.object, *.dm, *.ogf...). Некоторые плагины не используют данный путь (например, *.err, *.skls...). При импорте некоторых форматов, аддон ищет dds текстуры по этому пути и загружает их в blender.
GameMtl File
Путь к gamemtl.xr файлу. Обычно хранится в gamedata\gamemtl.xr. Данный файл хранит материалы поверхностей. В X-Ray Engine материалом является физическое свойство поверхности, и не влияет на визуальное представление (не путать с материалам в blender, которые влияют на внешний вид). Для изменения внешнего вида поверхности в X-Ray Engine используются шейдеры. От материала зависят звуки шагов, wallmark-текстуры от выстрелов, трение, эффекты частиц при попадании пуль, способность получать отбрасываемые тени от динамических объектов... Если данный путь ссылается на gamemtl.xr файл, то список параметра GameMtl у материалов и костей заполнится именами материалов из gamemtl.xr файла и из этого списка можно будет указать любое имя материала. Из gamemtl.xr файла считываются только имена, текстовые описания и целочисленные идентификаторы материалов.

EShader File

Описание

Путь к shaders.xr файлу. Обычно хранится в gamedata\shaders.xr. Данный файл содержит описания настроек шейдеров. EShader - это Engine Shader, который отвечает за внешний вид поверхности или частиц в игре. Если данный путь ссылается на shaders.xr файл, то в параметрах материалов blender можно будет указать любое имя engine shader из этого файла. Из shaders.xr файла считываются только имена шейдеров.

CShader File

Описание

Путь к shaders_xrlc.xr файлу. Обычно хранится в gamedata\shaders_xrlc.xr. Данный файл содержит описания настроек, которые использует компилятор геометрии уровней (xrLC.exe). CShader - Compile Shader, указывающий компилятору уровней свойства конечной (игровой) геометрии уровня. Исходная геометрия, в зависимости от cshader, может не иметь видимой или осязаемой (для столкновений) геометрии, иметь различный способ хранения освещения и т. д. Если данный путь ссылается на shaders_xrlc.xr файл, то в параметрах материалов blender можно будет указать любое имя compile shader из этого файла. Из shaders_xrlc.xr файла считываются только имена шейдеров.

Objects Folder

Описание

Путь к папке с исходными 3D объектами и анимациями. Обычно находится в X-Ray SDK в папке rawdata\objects. Из этой папки аддон может считывать только *.object и *.skls файлы. Данную папку используют не все плагины. Её используют только object плагин для исходных объектов и .level плагин для списка объектов сцены. Так же этот параметр используют некоторые операторы, например, Skls File Browser (если его запускать из Motion Refs свитка, режим Load Active Motion Refs). В этой папке находятся исходные модели и анимации в форматах, которые хранят данные без потерь информации (без сжатия).

Defaults

Настройки плагинов по умолчанию

Описание

Данный свиток хранит значения по-умолчанию для плагинов. Для получения подробной информации по каждому параметру, перейдите в раздел документации, который посвящён конкретному плагину. На данной странице даётся общее описание. Некоторые свитки могут хранить два типа параметров: Import для импорта и Export для экспорта. При вызове операторов импорта/экспорта, их настройки всегда будут установлены в те значения, которые указаны в этом Defaults разделе настроек. Настройки из предыдущего вызова оператора не сохраняются в последующих вызовах.