-
Notifications
You must be signed in to change notification settings - Fork 39
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
файл, то список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 SD
K в папкеrawdata\objects
. Из этой папки аддон может считывать только*.object
и*.skls
файлы. Данную папку используют не все плагины. Её используют толькоobject
плагин для исходных объектов и.level
плагин для списка объектов сцены. Так же этот параметр используют некоторые операторы, например,Skls File Browser
(если его запускать изMotion Refs
свитка, режимLoad Active Motion Refs
). В этой папке находятся исходные модели и анимации в форматах, которые хранят данные без потерь информации (без сжатия).
Defaults
Данный свиток хранит значения по-умолчанию для плагинов. Для получения подробной информации по каждому параметру, перейдите в раздел документации, который посвящён конкретному плагину. На данной странице даётся общее описание. Некоторые свитки могут хранить два типа параметров: Import
для импорта и Export
для экспорта. При вызове операторов импорта/экспорта, их настройки всегда будут установлены в те значения, которые указаны в этом Defaults
разделе настроек. Настройки из предыдущего вызова оператора не сохраняются в последующих вызовах.
-
Common
Хранит общие параметры, которые используются в нескольких плагинах.-
SDK Version
Устанавливает значения по-умолчанию для этих параметров операторов: Format Version (для импорта *.object) -
Texture Names From Image Paths
Устанавливает значения по-умолчанию для этих параметров операторов: TODO -
Motion Prefix Name
Устанавливает значения по-умолчанию для этих параметров операторов: Motion Prefix Name (для импорта *.object)
-
SDK Version
-
Source Object (.object)
Хранит параметры*.object
плагина. Доступны два раздела настроек:Import
иExport
.-
Import
-
Import Motions
Устанавливает значения по-умолчанию для этих параметров операторов: Import Motions (для импорта *.object) -
Split Mesh By Materials
Устанавливает значения по-умолчанию для этих параметров операторов: Split Mesh By Materials (для импорта *.object) -
Custom Shapes For Bones
Устанавливает значения по-умолчанию для этих параметров операторов: Custom Shapes For Bones (для импорта *.object)
-
Import Motions
-
Export
TODO
-
Import
-
Skeletal Animation (.skl, .skls)
TODO
-
Animation (.anm)
TODO
-
Details (.dm, .details)
TODO
-
Game Motion (.omf)
TODO
Keymap
Данный свиток хранит настройки для горячих клавиш, которые вызывают операторы импорт/экспорта. Единственные операторы, которые поддерживают назначение горячих клавиш это Import Object
(для импорта *.object
) и Export Object
(для экспорта в *.object
). Для других плагинов горячие клавиши отсутствуют, в виду их редкого использования. Для них горячие клавиши нужно настраивать вручную. Подробнее о ручной настройке можно прочитать здесь: issues #304 (комментарий). В качестве основных клавиш можно указать только следующие: F5
, F6
, F7
, F8
, F9
. В качестве клавиш-модификаторов можно указать только Shift
. Горячие клавиши ограничены небольшим набором для того, чтобы не возникало конфликтов с уже существующими. Это сделано специально, чтобы в настройках аддона невозможно было перезаписать уже имеющиеся горячие клавиши. Клавиши добавляются в контекст 3D View
. Это означает, что для вызова оператора, нужно курсор мыши переместить в 3D окно. Вызов оператора не будет работать из других окон. Свиток Keymap
содержит следующие параметры:
-
Import Object Key
Данный параметр указывает основную клавишу для вызова плагина импорта*.object
.
-
Export Object Key
Данный параметр указывает основную клавишу для вызова плагина экспорта*.object
.
-
Import Object Shift
Требуется ли нажатие клавишиShift
для вызова оператора импорта*.object
.
-
Export Object Shift
Требуется ли нажатие клавишиShift
для вызова оператора экспорта*.object
.
Enable/Disable Plugins
В данном свитке можно включить или отключить определённые плагины импорта/экспорта. В первой колонке включаются/отключаются плагины импорта, а во второй - плагины экспорта. Если плагин выключен, то оператор импорта/экспорта данного плагина не будет добавлен в меню импорта/экспорта.
Примеры использования: можно отключить редко используемые плагины, чтобы не загромождать меню импорта/экспорта.
- Главная
- Скачать
- Установка
- Поддерживаемые Форматы
- Версии Форматов
- Не Поддерживается
- Параметры Импорта/Экспорта
- Импортёры/Экспортёры
- Массовый Импорт/Экспорт
- Работа с Анимациями
- Root-Объекты
- Масштабирование
- Редактирование Форм Костей
- Редактирование Центров Масс Костей
- Редактирование Bone Parts
- Сглаживание
- Перевод
- Используемые Параметры
- Используемые Настройки
- Лог
- Статистика
- Ошибки
- Предупреждения
- Ограничения
- Панели
- Операторы
- Настройки
- Сообщество
- История