Skip to content

Preferences

Jump to bottom
Pavel_Blend edited this page Jan 23, 2021 · 67 revisions

Данная страница описывает настройки аддона 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 файл, то список GameMtl у материалов и костей будет пустым. Из gamemtl.xr файла считываются только имена, текстовые описания и целочисленные идентификаторы материалов.

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

  • CShader File
    Путь к shaders_xrlc.xr файлу. Обычно хранится в gamedata\shaders_xrlc.xr. Данный файл содержит описания настроек, которые использует компилятор геометрии уровней (xrLC.exe). CShader - compile shader (шейдер компилятора), указывающий компилятору уровней свойства конечной (игровой) геометрии уровня. Исходная геометрия, в зависимости от компиляторного шейдера, может не иметь видимой или осязаемой (для столкновений) геометрии, иметь различный способ хранения освещения и т. д. Если данный путь ссылается на shaders_xrlc.xr файл, то список CShader у материалов blender заполнится именами шейдеров из этого файла и можно будет указать из списка любое имя компиляторного шейдера. Из 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 разделе настроек. Настройки из предыдущего вызова оператора не сохраняются в последующих вызовах.

Keymap

Горячие клавиши

Описание

Данный свиток хранит настройки для горячих клавиш, которые вызывают операторы импорт/экспорта. Единственные операторы, которые поддерживают указание горячих клавиш это следующие:

Import Object - для импорта Source Object (*.object)

Export Object - для экспорта Source Object (*.object)

Для других плагинов горячие клавиши отсутствуют, в виду их редкого использования. Для них горячие клавиши нужно настраивать вручную. Подробнее о ручной настройке можно прочитать здесь: issues 304 (комментарий). В качестве основных клавиш можно указать только следующие:

F5

F6

F7

F8

F9

В качестве клавиш-модификаторов можно указать только Shift.

Горячие клавиши ограничены небольшим набором для того, чтобы не возникало конфликтов с уже существующими. Это сделано специально, чтобы в настройках аддона невозможно было перезаписать уже имеющиеся горячие клавиши. Клавиши добавляются в контекст 3D View. Это означает, что для вызова оператора, нужно курсор мыши переместить в 3D окно. Вызов оператора не будет работать из других окон.



Параметры

Import Object Key

Данный параметр указывает основную клавишу для вызова плагина импорта *.object.

Export Object Key

Данный параметр указывает основную клавишу для вызова плагина экспорта *.object.

Import Object Shift

Требуется ли нажатие клавиши Shift для вызова оператора импорта *.object.

Export Object Shift

Требуется ли нажатие клавиши Shift для вызова оператора экспорта *.object.



Enable or Disable Plugins

Включение/октлючение плагинов

Описание

В данном свитке можно включить или отключить определённые плагины импорта/экспорта. В первой колонке включаются/отключаются плагины импорта, а во второй - плагины экспорта. Если плагин выключен, то оператор импорта или экспорта данного плагина не будет добавлен в меню импорта/экспорта.

Примеры использования

Можно отключить редко используемые плагины, чтобы не загромождать меню импорта/экспорта.

Содержание

Clone this wiki locally