Руководство Pixor

Pixor превращает 3D-графику в пиксель-арт. Результат выглядит нарисованным вручную, детерминирован (один и тот же проект каждый раз дает те же пиксели, а на другой машине — почти всегда: см. вопросы и ответы) и не использует генеративный ИИ.

Приложение — это четыре шага слева направо: Сцена (настройка 3D-объектов), Действие (создание действий в виде узлов с плавным воспроизведением в 3D), Стиль (выбор того, как создаются пиксели) и Ассет (нарезка действий на кадры спрайтов и упаковка их в листы и файлы). Простая работа проходит их по порядку; более крупная ходит туда и обратно по мере надобности. Рядом с вкладками рабочих пространств селекторы заголовка Камера, Действие, Стиль и Ассет выбирают, что показывает каждый шаг; Экспорт рядом с «Импортом» открывает окно, которое записывает конвейер ассета в папку.

Рабочее пространство каждого шага несет свои панели и ничего больше. «Структура», 3D-вид и граф сцены относятся к шагу «Сцена»; список действий, 3D-вид, граф действия, таймлайн, который их проигрывает и ставит ключи, и редактор клипов — к шагу «Действие»; список стилей, 2D-вид и граф стиля (его библиотека узлов слева) — к шагу «Стиль»; список ассетов, 2D-вид и граф ассета, который режет действия на списки спрайтов и упаковывает их в файлы (за ним — таймлайн для ручного выбора кадров), — к шагу «Ассет». Инспектор и «История» есть во всех четырех, и Инспектор показывает то, чему посвящен шаг. Меню «Панели» добавляет любую панель, которую обслуживает шаг, а любую панель можно перетащить куда угодно — Сбросить панели вернет их на место.

Это руководство описывает Pixor в том виде, в каком он собран сегодня. План — это docs/roadmap.md; руководство следует за приложением, а не за планом.

• Быстрый старт: от модели до спрайт-листа за пять минут.
• Сцена: четыре шага и их рабочие пространства, перемещение в 3D, камеры, свет и фигуры, действия и ключи, история отмен.
• Граф сцены и шаблоны проектов: толпы и массивы в виде графа, все в сцене как узел и рецепт, который можно применить к любой модели.
• Изображения и слова: картинки и текст в сцене, 3D-буквы и палитра, взятая из изображения.
• Объемы: дым, огонь и жидкости из файлов .vdb или встроенные.
• Миры: рельеф, трава, листва, вода, облака, ветер, лучи света, время суток и большие карты по чанкам.
• Параметры: каждый параметр Инспектора с изображениями «до» и «после».
• Граф стиля: от рендера камеры до кадра, каждый этап — узел, который можно перестроить, ограничить маской и смешать.
• Граф ассета: узлы «Спрайты», которые нарезают действия на кадры, а кадры — на файлы в виде графа: несколько листов из одного рендера, линии рядом с цветами и текстовые файлы по шаблону.
• Экспорт в движки: Godot, Unity, GameMaker, Aseprite и простые листы с JSON.
• Командная строка: pxr render, pxr batch, проекты, эталонные тесты.
• FAQ: мерцание, крошечные спрайты, палитры, особенности FBX.

Один файл, чтобы поделиться частью проекта. Группа любого графа, Стиль, пресет и конвейер ассета — все переносятся как набор (.pixorkit), и файл сообщает, что в нем: «Сохранить набор…» записывает его, а «Использовать набор…» применяет — везде, где они предлагаются. pxr kit show FILE.pixorkit показывает, что в наборе.

Изображения в этом руководстве рендерит scripts/docs_images.sh: параметры — на тестовом рыцаре, снимки приложения — с гоблином из библиотеки, поэтому они всегда показывают то, что выдает текущая версия.