Документация
Docs/ru/reference/particle-format/integration.md
Контракт интеграции частиц
Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите
BuildTools/ParticleFormatInterface.json, затем выполнитеpython BuildTools/docs_particle_format.py --write.
| Индекс справочника | Правила исходников | Форматы и backend-ы | Отрисовка | Инструменты | Runtime | Интеграция | Проверка | Каноническая JSON-модель | Руководство | Инструменты авторинга |
| Стабильный ID | Правило | Требование | Причина | Источник |
|---|---|---|---|---|
particle-format.integration.sprite |
Интеграция спрайтов | Загружайте спрайты частиц через ParticleSpriteFactory и позволяйте подсистеме выбирать рендеринг через атлас или напрямую в сцену. | Фабрика предоставляет включённые runtime-расширения и создаёт ParticleSprite из ParticleManager. | Source/Client/ParticleSprites.cpp |
particle-format.integration.model |
Привязка к модели | Используйте AttachParticles с запечённым runtime-ресурсом и допустимой костью модели, затем проверяйте трансформации и время жизни в видимой сцене. | Бейкер модели проверяет ресурс, а runtime создаёт частицу на целевом сочленении. | Source/Tools/ModelInfoBaker.cpp Source/Client/ModelInstance.cpp |
particle-format.integration.client-script |
Клиентское управление из скрипта | Используйте клиентский API для воспроизведения с seed, prewarm, масштаба или активных эффектов на кости криттера и обрабатывайте результат false там, где API его возвращает. | Экспортированные методы сужают универсальные спрайты до спрайтов частиц перед применением независимого от подсистемы управления. | Source/Scripting/ClientGlobalScriptMethods.cpp Source/Scripting/ClientCritterScriptMethods.cpp |
particle-format.integration.project-boundary |
Ответственность встраивающего проекта | Храните каталоги частиц, визуальную политику, выбор подсистем, происхождение ресурсов, бюджеты производительности и приёмочные сцены в документации проекта. | Движок документирует переиспользуемую механику, но не может определять игровые ресурсы или производственные цели. | Source/Client/ParticleRuntime.h |
particle-format.integration.critter-run-particle |
Частица на модели криттера | Critter.RunParticle создаёт именованную частицу на кости модели только в сборках FO_ENABLE_3D; иначе экспорт ничего не делает. | Скриптовый метод требует активный ModelInstance и не является запасным маршрутом для 2D-спрайта криттера. | Source/Scripting/ClientCritterScriptMethods.cpp |
particle-format.integration.model-attachment |
AttachParticles в .fo3d | Выбранная слоем и значением связь .fo3d хранит глобальный путь запечённого .spk или .efk и требует допустимую целевую кость; частица существует, только пока выбранная связь активна. | ModelInfoBaker проверяет ресурс и кость, а runtime создаёт и удаляет частицу вместе с композицией модели. | Source/Tools/ModelInfoBaker.cpp Source/Client/ModelInstance.cpp |