FOnline Engine
Current master GitHub
Документация Docs/ru/reference/particle-format/renderer.md

Контракт отрисовки частиц

Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите BuildTools/ParticleFormatInterface.json, затем выполните python BuildTools/docs_particle_format.py --write.

Индекс справочника Правила исходников Форматы и backend-ы Отрисовка Инструменты Runtime Интеграция Проверка Каноническая JSON-модель Руководство Инструменты авторинга
Стабильный ID Backend Поле или маршрут По умолчанию Поведение Источник
particle-format.renderer.spark-draw-route spark DrawInScene false Для обычных спрайтов частиц используйте рендеринг в атлас; включайте DrawInScene, когда эффект должен использовать сцену карты и её контур глубины. Source/Client/SparkExtension.cpp
particle-format.renderer.spark-resources spark EffectName / TextureName пусто Выберите запечённый эффект FOnline и путь текстуры, допустимый для исходного ресурса частиц. Source/Client/SparkExtension.cpp
particle-format.renderer.effekseer-direct-scene effekseer GetDrawInScene true Считайте эффекты Effekseer частицами прямого рендеринга в сцену и проверяйте поддерживаемые возможности их рендерера в клиенте FOnline. Source/Client/EffekseerExtension.cpp
particle-format.renderer.effekseer-geometry effekseer Sprite / Ring / Ribbon / Track / Model Рендереры движка Используйте только узлы Root, None, Sprite, Ring, Ribbon, Track и Model; пять рисуемых семейств преобразуются в callback-геометрию движка. Source/Client/EffekseerExtension.cpp
particle-format.renderer.effekseer-material-profile effekseer material / blend / filter / wrap Материал Default; заданный сэмплинг Используйте материал Default, смешивание Normal/Add/Sub, фильтрацию nearest или linear и адресацию Clamp или Repeat. Смешивание Multiply, зеркальная адресация, дополнительные слоты текстур, пользовательские материалы, soft particles, falloff и интерполяция flipbook отклоняются. Source/Client/EffekseerExtension.cpp
particle-format.renderer.effekseer-depth-cull-sort effekseer ZTest / ZWrite / Culling / ZSort задаётся для узла Sprite и Ring могут использовать стабильную сортировку по глубине камеры; Ribbon, Track и Model не допускают Z-sort. ZTest/ZWrite каждого узла выбирают вариант эффекта по глубине, а отсечение граней Model выбирает режим отсечения отрисовки движка. Source/Client/EffekseerExtension.cpp
particle-format.renderer.effekseer-distortion effekseer BackDistortion / DistortionIntensity отключено Используйте искажение сцены только на узлах Sprite с текстурой искажения и конечной интенсивностью; отрисовка читает отложенный снимок фона сцены через BackgroundTex и ParticleSamplingBuf. Source/Client/EffekseerExtension.cpp
Source/Client/ParticleRuntime.h
particle-format.renderer.effekseer-global-exclusions effekseer GPU particles and external resources не поддерживается Не используйте GPU-частицы, normal-текстуры, звуки, пользовательские материалы, внешние кривые или процедурные модели. Ссылочные ресурсы статических моделей должны загружаться и проходить проверку FOnline. Source/Client/EffekseerExtension.cpp
particle-format.renderer.draw-in-scene spark draw in scene false Когда рендерер любой группы включает отрисовку в сцене, весь ParticleSprite использует прямой маршрут сцены карты вместо обновления атласа. Source/Client/SparkExtension.cpp
particle-format.renderer.effect spark effect пусто Укажите запечённый ресурс .fofx, совместимый с EffectUsage::QuadSprite; рендерер загружает его через EffectManager. Source/Client/SparkExtension.cpp
particle-format.renderer.blend-mode spark blend mode не используется Не задавайте blend mode: дескриптор объявляет его, но SparkQuadRenderer не импортирует, не экспортирует и не применяет поле. Выбирайте смешивание в эффекте .fofx. Source/Client/SparkExtension.cpp
particle-format.renderer.texture spark texture пусто Разрешите поддерживаемый ресурс спрайта относительно каталога исходного .spark и загрузите его текстуру атласа через предоставленный загрузчик текстур. Source/Client/SparkExtension.cpp
particle-format.renderer.scale spark scale 1;1 Одно значение изменяет X, сохраняя Y по умолчанию; два значения задают масштаб X и Y четырёхугольника частицы. Source/Client/SparkExtension.cpp
particle-format.renderer.atlas-dimensions spark atlas dimensions 1;1 Одно значение задаёт число ячеек по X, два — по X и Y. Параметр индекса текстуры частицы выбирает ячейки атласа. Source/Client/SparkExtension.cpp
particle-format.renderer.look-orientation spark look orientation LOOK_CAMERA_PLANE Используйте одно из четырёх распознаваемых имён ориентации взгляда; другие строки не меняют ориентацию по умолчанию. Source/Client/SparkExtension.cpp
particle-format.renderer.up-orientation spark up orientation UP_CAMERA Используйте одно из четырёх распознаваемых имён верхней ориентации; другие строки не меняют ориентацию по умолчанию. Source/Client/SparkExtension.cpp
particle-format.renderer.locked-axis spark locked axis LOCK_UP Используйте LOCK_LOOK или LOCK_UP, когда режиму ориентации по оси требуется зафиксировать один вектор. Source/Client/SparkExtension.cpp
particle-format.renderer.locked-look-vector spark locked look vector (0,0,1) Укажите мировой или локальный вектор взгляда для выбранного режима ориентированного четырёхугольника. Source/Client/SparkExtension.cpp
particle-format.renderer.locked-up-vector spark locked up vector (0,1,0) Укажите мировой или локальный вектор вверх для выбранного режима ориентированного четырёхугольника. Source/Client/SparkExtension.cpp
Введите запрос.