Документация Docs/ru/reference/particle-format/validation.md

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

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

Индекс справочника

Правила исходников

Каноническая JSON-модель

Руководство

Инструменты авторинга

Стабильный ID	Gate	Требование	Причина	Источник
`particle-format.validation.documentation`	Контракт документации	После изменения форматов частиц, подсистем, инструментов или интеграций запускайте docs_particle_format.py –check и его сфокусированный модульный тест.	Манифест проверяет каждый якорь исходника и сгенерированную страницу.	BuildTools/ParticleFormatInterface.json
`particle-format.validation.baker-tests`	Тесты бейкера частиц	После изменения исходных форматов, трансформаций, проверки путей, вывода компилятора или инвалидации зависимостей запускайте модульные тесты ParticleBaker.	Нативный набор проверяет границы бейкинга обеих подсистем.	Source/Tests/Test_ParticleBaker.cpp
`particle-format.validation.effekseer-runtime`	Runtime-тесты Effekseer	После изменения геометрии компилятора или runtime, сортировки, пакетирования, текстур, seed или масштаба запускайте сфокусированные runtime-тесты Effekseer.	Набор проверяет детерминированную callback-геометрию и поддерживаемое runtime-поведение.	Source/Tests/Test_EffekseerParticleRuntime.cpp
`particle-format.validation.project-bake`	Бейкинг встраивающего проекта	Повторно запеките затронутый встраивающий проект и отклоняйте авторские .spk/.efk, некорректные исходники, отсутствующие зависимости и устаревшие сгенерированные ресурсы.	Только проектный бейкинг видит полный граф ресурсов и выбранные возможности проекта.	Source/Tools/ParticleBaker.cpp
`particle-format.validation.visible-scene`	Видимая runtime-проверка	Проверяйте каждую затронутую подсистему и маршрут интеграции в Mapper и репрезентативной клиентской сцене, включая глубину, отсечение, время жизни, трансформации и производительность.	Успешная компиляция не доказывает визуальную корректность или правильное игровое время.	Source/Tools/ParticleEditor.cpp
`particle-format.validation.render-routes`	Оба маршрута рендеринга	Визуально проверяйте частицы в атласе и непосредственно в сцене с реальным порядком отрисовки, углом камеры, масштабом, перекрывающей геометрией глубины и поддерживаемыми backend-рендерерами.	Headless-разбор не доказывает правильность кадрирования, альфа-канала, смешивания, глубины, ориентации или мирового масштаба.	Source/Client/ParticleSprites.cpp Source/Client/SparkExtension.cpp
`particle-format.validation.model-route`	Маршрут привязки к модели	Для изменений AttachParticles или Critter.RunParticle визуально проверяйте целевую кость, смещение, время жизни активного слоя, анимацию и профиль FO_ENABLE_3D.	Тесты ParticleSprite не проверяют владение привязкой к кости модели или проекцию.	Source/Tests/Test_ModelBaker.cpp Source/Client/ModelInstance.cpp

Команды проверки

python BuildTools\docs_particle_format.py --check
python -m unittest BuildTools.tests.test_docs_particle_format
cmake --build <build-dir> --config RelWithDebInfo --target RunUnitTests

Подключаемый проект также должен повторно запечь ресурсы и визуально проверить каждый затронутый backend и маршрут интеграции.