Документация
Docs/ru/reference/particle-format/index.md
Сгенерированный справочник форматов частиц
Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите
BuildTools/ParticleFormatInterface.json, затем выполнитеpython BuildTools/docs_particle_format.py --write.
| Индекс справочника | Правила исходников | Форматы и backend-ы | Отрисовка | Инструменты | Runtime | Интеграция | Проверка | Каноническая JSON-модель | Руководство | Инструменты авторинга |
Этот справочник описывает контракт необязательных backend-ов SPARK и Effekseer: авторинг, запекание, runtime, Mapper, интеграцию и проверку.
Состояние контракта
| Поле | Значение |
|---|---|
| Стабильность | experimental |
| Политика поддержки | SPARK и Effekseer являются независимыми необязательными backend-ами. Подключаемые проекты должны закреплять ревизию Engine и явно включать, проверять и поддерживать поставляемые ими форматы. |
| Исходный манифест | BuildTools/ParticleFormatInterface.json |
| Дайджест контракта | d8a598e648a8e2b9b491c2596a565606f770f32b6c9836c84cf8e0f5fa4efdfb |
| Авторские расширения | spark, efkproj |
| Расширения runtime | spk, efk |
| Сторона runtime | client |
| Справочник | Записи | Назначение |
|---|---|---|
| Source rules | 12 | Границы авторского XML и зависимостей. |
| Formats and backends | 4 | Необязательные backend-ы и формы source-to-runtime. |
| Rendering | 19 | Маршруты и поля отрисовки backend-ов. |
| Tooling | 5 | Процессы авторинга в Mapper и отдельных инструментах. |
| Runtime | 14 | Компоновка, маршрутизация, seed, масштаб и prewarm. |
| Integration | 6 | Границы спрайтов, моделей, скриптов и проекта. |
| Validation | 7 | Gate документации, native-кода, запекания и видимой проверки. |
Граница ответственности
Включено:
- авторинг SPARK .spark и доставка запечённых .spk
- авторинг Effekseer .efkproj и доставка запечённых .efk
- независимый от backend runtime частиц и интеграция спрайтов
- предпросмотр Mapper и инструменты авторинга SPARK
- интеграция ресурсов, моделей и клиентских скриптов
- основанные на исходниках проверки и production-gate
Исключено:
- каталоги частиц, имена файлов, визуальная политика и бюджеты подключаемого проекта
- выбранные проектом эффекты, текстуры, модели и сцены приёмки
- неподдерживаемые семейства renderer-ов и расширенные возможности Effekseer
- поведение upstream-редакторов, отсутствующее в поставляемых инструментах
- сгенерированные файлы .spk и .efk как авторские исходники