Редактор карт MERadiant

Некоторые функции в дальнейшем могут измениться.

MERadiant — это специализированный классический редактор уровней (level editor),
разработан на основе GtkRadiant. Программа адаптирована под нужды проекта Motion Engine 2, включает улучшения интерфейса в виде перетаскивания окон, тем оформления, и много другого функционала.

Этот редактор сохраняет знакомый интерфейс GtkRadiant, но расширяет его новыми инструментами, заменяя устаревшие инструменты BSP и убранную компиляцию карт (т.е. сборку карт).

1. Заголовок окна - выводится название уровня;
2. Главное меню - при нажатии раскрываются списки для выбора операций - описание тут;
3. Панель инструментов - описание тут;
4. Встроенный игровой движок;
5. Проекция Z;
6. Проекция XY Top/XZ/YZ;
7. Код;

• Рекомендуем ознакомится с интерфейсом программы - тут
• Для запуска необходимо открыть папку «Bin32», запустите редактор карт «MERadiant.exe»;

При первом запуске может потребоваться указать файл проекта:
укажите файл project.prj находится в папке «Bin32»

• Нажмите в главном меню: File (Файл) → New map (Новая карта);

• Введите название карты: на английском языке, без пробелов. Например: newlevel;
• Нажмите на кнопку «ОК»;

• Карта успешно создана, для демонстрации размещена 3д-модель телевизора;
  

Созданы следующие файлы уровня:

1. «Contents/levels/newlevel/level.json»
2. «Contents/levels/newlevel/objects.json»
3. «Lua/map_newlevel_general.lua»

• Для создания групп, нажмите ПКМ по проекции XY:

• Нажмите «info» → «info group»
• Затем введите название группы, оно должно быть: кратким, английскими буквами

• В Инспекторе выглядит теперь следующим образом:

• Для вставки модели на уровень, нажмите ПКМ по проекции XY:

• Нажмите «misc» → «misc_model»;

• Нажмите Open для открытия;
• Выделите вашу модель «[зажмите SHIFT] + ЛКМ»;
• Для того чтобы увидеть объект в игровом движке. Необходимо указать модели группу, для этого нажмите в панели инструментах: «Assign a group», выберите нужную группу. Нажмите «ОК»;

группа с «идентификатором = 0» является по умолчанию, создается автоматически при создании уровня
другие группы можно создать, подробнее тут

• Затем выберите интересующую вас 3д-модель, откроется окно выбора модели - см. подробности тут
• Теперь видно модель в игровом движке;

Для вызова настроек мира ПКМ по проекции XY → Properties map, откроется Инспектор с настройками уровня.

Окно «Inspector» для настройки энтити. Энтити - объекты на уровне (к примеру: могут быть 3д-модели, а также служебные объекты понимаемые для игрового движка).

Вызывается тремя способами:
(сначала выделяем нужный энтити-объект)

1. Нажмите кнопку «N»;
2. Главное меню: «View → Inspector (Entity)»;
3. В панели инструментов: «Entity inspector»;

Состоит из:

• Списка с типами энтити;
• Описание с выделенным типом энтити;
• Флаги для энтити;
• Список с «ключами:значениями»;
• Текстовые поля Key (ключ), Value (значение), для создания пары ключа:значения (кнопка «ENTER» создает новую пару);
• Кнопка «Delete key/pair» удаляет выбранную пару «ключа:значения»;
• Кнопка «Close» (Закрыть), для закрытия окна

Окно для настроек редактора карт MERadiant

• Выбирается в главном меню: «Edit» → «Preferences» или кнопкой «P»;

Подробнее о параметрах:

Внешний вид и язык:
Выбирается основное оформление:

1. «Dark» → темное оформление;
2. «Light» → светлое оформление;
3. «Classic» → классическое оформление Q3Radiant;

• галочка «Log console to Radiant.log», при включенном: после перезапуска редактора карт, включается режим отладки с выводом в лог файл «Radiant.log»;
• «Reset Registry», для полного сброса настроек, необходимо редактор карт перезапустить;

Операции с объектами:
Некоторые галочки дублируются в пунктах главного меню: «View» → «Show»;
в проекции XY:

• «Right click to drop entitie» → возможность использования меню ПКМ по проекции XY;
• «Paint sizing info» → отображает размеры выделенного объекта;
• «Light drawing» → отображает свет (окружность) на уровне;
• «Show Names» → показывает у энтити тип;
• «Show Blocks» → показывает регионы;
• «Show Coordinates» → показывает координаты;
• «Show Path» → показывает линкому (пути) между энтитиями;
• «Show Lights» → показывает свет;
• «Show Angles» → показывает направление энтити;
• «Show Workzone» → показывает рабочее место…;

Производительность и Оптимизация работы:

• «Auto save every» → автоматическое сохранение уровня через N минут;
• «Solid selection boxes» → показывает при выделении энтити бокс по центру (ось);
• «ALT + multi-drag» → (не известно);
• «Mouse chaser» → (не известно);
• «Vertex editing splits face» → (не известно);
• «Undo Levels» → количество попыток для отмены;
• «Status point size» → (не известно);

Окно «Convert tool ME2» (Инструмент конвертации в ME2) для импорта 3д-моделей формата .DAE [Collada-DAE] с преобразованием в *.ME2, а также конвертацией текстур в *.gi

Сначала выбираете модели в формате *.dae (если заново открыть диалоговое окно «Открытие», кнопкой «Re-Open»), затем нажимаете поочередно: «2. Convert ME2», заполняете поля Автор (Author), Date (Дата публикации, в формате «ГГГГ.ММ.ДД»), нажимаете «3. Create/Edit MEP-file», работаете со скином/скинами (при 2x-клике по текстуре: предлагает выбрать новый файл для конвертации или использовать *.gi файл текстуры). После работ нажимаете на кнопку «4. Verify Paths model» для проверки путей модели (при успешном высветится: «All paths are correctly defined!»).

Окно для выбора модели. Слева располагается список 3д-моделей, справа предосмотр. Ниже можно выбрать скин.

• Для навигации есть вкладка «ALL» - содержит иконки моделей, «Prefix» поиск по префиксам (выбирать можно префикс и выбрать конкретную модель);

пример: выбора с включенной вкладкой «ALL»:

пример: выбора с включенной вкладкой «Prefix»:

Окно «Print Setup» для печати проекции окна - расположен см. 6 - тут

Вызывается с помощью главного меню: «Misc → Print XY View»
Внизу слева памятка: в ней перечислены обычные форматы для печати (А2, А3, А4) в мм.

Указываются в полях: размеры, положение, масштаб, DPI.
Действия:

1. Refresh image (Обновить изображение для печати);
2. Rotate image (Повернуть изображение), после поворота изображения необходимо нажать кнопку Refresh image;
3. Copy image to clipboard (Копировать изображение в буфер обмена);
4. Settings and Print… (Настройки печати и печать);

Пример изображения печати:

1. File (Файл) пункт:
   1. New map → (Создать новую карту);
   2. Open… → (Открыть уровень);
   3. Save → (Сохранить текущий уровень);
   4. Load project… → (Открыть файл *.prj), обычно спрашивает в первый раз при запуске редактора карт;
   5. Project settings… → (Настройки проекта), трогать настройки не рекомендуем;
   6. Exit → (Выход);
2. Edit (Редактирование) пункт:
   1. Undo → (Отменить);
   2. Redo → (Повторить);
   3. Copy → (Копировать выделенный объект);
   4. Paste → (Вставить);
   5. Delete → (Удалить);
   6. Map Info… → (Информация об уровне), показывает окно с подсчетом энтити на уровне;
   7. Entity Info… → (Информация об энтити), показывает окно с всеми объектами и группами;
   8. Preferences… → (Настройки программы - подробнее тут);
3. «View» (Вид) пункт:
   1. Active Viewport: (Активная проекция) (управлением окном, см. 6 - тут)
      1. 1 (Top - XY) → Вид сверху;
      2. 2 (Side - YZ) → Вид сбоку;
      3. 3 (Front - XZ) → Вид фронтальный;
   2. Inspector (Entity) → (Инспектор энтити - подробнее тут), отображаются характеристики выделенного объекта в формате (ключ:значение);
   3. Next (XY, YZ, XY) → (Следующий вид) (управлением окном, см. 6 - тут);
   4. Zoom: (Масштаб) (управлением окном, см. 6 - тут);
   5. Show: (Показать на сетке)
      1. Show Names → отображает название типа;
      2. Show Blocks → отображает регионы;
      3. Show Coordinates → отображает координаты;
      4. Show Path → отображает линковку объектов между собой;
      5. Show Lights → отображает освещение;
      6. Show Angles → отображает направление объекта стрелкой;
      7. Show Workzone → отображает рабочую область…;
   6. Hide/Show: (Скрыть/Показать), можно выделенные объекты скрывать, потом показывать все;
      1. Hide Selected → (Скрыть выделенное)
      2. Show Hidden → (Показать скрытое)
   7. Selection (Выделение) пункт:
      1. Clone → (Клонирование);
      2. Deselect → (Убрать выделение);
      3. Invert → (Инвертировать выделение);
      4. Show info position (log) → (В режиме отладки: выводит в лог файл информацию о местоположении объекта);
      5. Rotate: (Вращение)
         1. Rotate X → (Вращение по X);
         2. Rotate Y → (Вращение по Y);
         3. Rotate Z → (Вращение по Z);
         4. Arbitrary rotation… → (Произвольное вращение), показывается отдельное окно для вращение по осям;
   8. Grid (Сетка) пункт:
      1. Grid 1 → (сетка 1) самая маленькая;
      2. Grid 2 → (сетка 2);
      3. Grid 4 → (сетка 4);
      4. Grid 8 → (сетка 8);
      5. Grid 16 → (сетка 16);
      6. Grid 32 → (сетка 32);
      7. Grid 64 → (сетка 64);
      8. Snap to grid → (Привязать к сетке);
   9. Misc (Разное) пункт:
      1. Themes: (Темы оформления)
         1. Windows → (Окна), выбирается основное оформление окон;
         2. Grid → (Сетка), выбирается оформление для сетки;
         3. Code → (Код), выбирается оформление для окна: код;
      2. Print XY View → (Печать окна сетки XY) - подробнее тут;
      3. Select Entity Color… → (не работает);
      4. Profiles → (Профили настроек), сохранение текущих настроек в определенный слот;
      5. Load slot 1-5 → (Загрузить настройки из определенного слота);
      6. Reset Settings → (Сбросить все настрйки);
      7. Show Windows → (Показать все окна) которые были скрыты или закрыты;
      8. Find brush… → (Найти браш или энтити), открывается отдельное окно;
      9. Go to position… → (Телепорт камеры к точке), открывается диалоговое окно для ввода координат в формате: «X Y Z»;
      10. Import 3d-model [collada *.DAE] → (Импорт 3д-моделей файла/файлов), открывается отдельное окно для работы - подробнее тут;
      11. 3d-models → (все 3d-модели) (не работает);
   10. Help (Помощь) пункт:
       1. Help → (Помощь), введет на страницу «links.htm»;
       2. Command list… → (Описание команд) (не работает);
       3. About… → (О программе);
       4. Links… → (Помощь ссылки), введет на страницу «links.htm»;

1. Open → открыть уровень;
2. Save → сохранить текущий уровень;
3. x-axis flip → (функция не работает);
4. x-axis rotate → вращать выделенный объект по оси x;
5. y-axis flip → (функция не работает);
6. y-axis rotate → вращать выделенный объект по оси y;
7. z-axis flip → (функция не работает);
8. z-axis rotate → вращать выделенный объект по оси z;
9. Selection → (функция не работает);
10. Popup menu → альтернативный вызов контекстного меню создания объекта (обычно вызывается на проекции, см. 6 - тут);
11. Hollow → (функция не работает);
12. Change views → переключение проекций по осям;
13. Texture view mode → (функция не работает);
14. Camera preview → (функция не работает);
15. Update Camera → (функция не работает);
16. Wireframe/solid objects the camera view → (функция не работает);
17. Entity inspector → (функция не работает);
18. Clipper → (функция не работает);
19. Free Rotation → свободное вращение объекта;
20. Free Scaling → (функция не работает);
21. Scale X → (функция не работает);
22. Scale Y → (функция не работает);
23. Scale Z → (функция не работает);
24. Entities → вызывает окно Энтити со списком объектов всех на уровне и групп;
25. Change name group → Изменить название группы. Для этого выделите объект с типом info_group, нажмите на данную кнопку в инструментах, затем можно изменить название группы;
26. Assign a group → Назначить группу для объекта-модели;
27. Remove Object → Удалить выделенный объект или сочетанием клавиш: «Backspace»;
28. Update Object → Выделенный объект-модель обновляется трансформация в игровом движке;
29. Select object → Включить режим выделения в игровом движке;
30. Rotate X → в режиме выделения: переключает ось вращения X;
31. Rotate Y → в режиме выделения: переключает ось вращения Y;
32. Rotate Z → в режиме выделения: переключает ось вращения Z;
33. Lua → окно для управления окна код (см. 7 - тут);