Документация
Docs/ru/reference/particle-format/tooling.md
Контракт инструментов частиц
Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите
BuildTools/ParticleFormatInterface.json, затем выполнитеpython BuildTools/docs_particle_format.py --write.
| Индекс справочника | Правила исходников | Форматы и backend-ы | Отрисовка | Инструменты | Runtime | Интеграция | Проверка | Каноническая JSON-модель | Руководство | Инструменты авторинга |
| Стабильный ID | Правило | Требование | Причина | Источник |
|---|---|---|---|---|
particle-format.tooling.mapper-preview |
Независимый от подсистемы предпросмотр в Mapper | Просматривайте запечённые ресурсы .spk и .efk через окно частиц Mapper, явно задавая размещение, seed, масштаб, смещение и необязательный prewarm. | Предпросмотр использует тот же фасад ParticleSystem и те же runtime-расширения, что и игра. | Source/Tools/ParticleEditor.cpp |
particle-format.tooling.spark-editor |
Редактор SPARK в Mapper | Редактируйте исходные ресурсы .spark в Mapper, сохраняйте их через XML-сериализатор SPARK, затем повторно запекайте и пересоздавайте предпросмотр .spk. | Редактор читает исходные ресурсы, а предпросмотр показывает запечённую runtime-форму. | Source/Tools/SparkParticleEditor.cpp |
particle-format.tooling.effekseer-editor |
Отдельный Effekseer Editor | Собирайте и размещайте Windows-инструмент авторинга Effekseer командой buildtools.py build-auxiliary; не поставляйте его как runtime-зависимость игры. | У редактора изолированная вспомогательная сборка и отдельный размещаемый payload. | BuildTools/buildtools.py BuildTools/EffekseerEditor/build.ps1 |
particle-format.tooling.incremental-effekseer |
Кеш зависимостей Effekseer | Позвольте ParticleBaker отслеживать сообщаемые компилятором снимки зависимостей; после изменения поведения компилятора принудительно выполните полный повторный бейкинг. | Кеш инвалидирует эффект при изменении его проекта или зависимостей. | Source/Tools/ParticleBaker.cpp |
particle-format.tooling.normalized-round-trip |
Нормализованный сериализатором round trip | Учитывайте, что Save переписывает порядок объектов, необязательные поля и поля по умолчанию, вложенность, ссылки и форматирование по правилам сериализатора графа SPARK; проверяйте семантический diff. | Редактор сохраняет граф объектов, а не сохраняющее токены синтаксическое дерево XML. | ThirdParty/spark/spark/src/Extensions/IOConverters/SPK_IO_XMLSaver.cpp |