Документация
Docs/ru/reference/particle-format/objects.md
Форматы и backend-ы частиц
Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите
BuildTools/ParticleFormatInterface.json, затем выполнитеpython BuildTools/docs_particle_format.py --write.
| Индекс справочника | Правила исходников | Форматы и backend-ы | Отрисовка | Инструменты | Runtime | Интеграция | Проверка | Каноническая JSON-модель | Руководство | Инструменты авторинга |
Backend-ы
| Стабильный ID | Backend | Форматы | Требование | Источник |
|---|---|---|---|---|
particle-format.family.spark |
SPARK backend | .spark, .spk |
Включите FO_SPARK_PARTICLES, чтобы собрать бейкер SPARK, runtime-подсистему и встроенный редактор частиц в Mapper. | BuildTools/cmake/ProjectInterface.json BuildTools/cmake/stages/Init.cmake Source/Client/ParticleRuntime.cpp |
particle-format.family.effekseer |
Effekseer backend | .efkproj, .efk |
Включите FO_EFFEKSEER_PARTICLES, чтобы собрать компилятор проектов с фиксированным профилем и runtime-подсистему Effekseer. | BuildTools/cmake/ProjectInterface.json BuildTools/cmake/stages/Init.cmake Source/Client/ParticleRuntime.cpp |
Формы ресурсов
| Стабильный ID | Формат | Backend | Роль | Требование | Источник |
|---|---|---|---|---|---|
particle-format.object.spark-source |
.spark |
spark |
authored |
Создавайте системы SPARK как XML в файлах .spark, а из игрового контента ссылайтесь на соответствующий путь .spk. | Source/Tools/ParticleBaker.cpp |
particle-format.object.spark-runtime |
.spk |
spark |
generated |
Считайте .spk сгенерированным результатом бейкинга и никогда не помещайте его в исходные авторские ресурсы. | Source/Tools/ParticleBaker.cpp Source/Client/SparkExtension.cpp |
particle-format.object.effekseer-source |
.efkproj |
effekseer |
authored |
Создавайте эффекты Effekseer как текстовые проекты .efkproj, а из игрового контента ссылайтесь на соответствующий путь .efk. | Source/Tools/ParticleBaker.cpp Source/Tools/EffekseerCompiler.cpp |
particle-format.object.effekseer-runtime |
.efk |
effekseer |
generated |
Считайте .efk сгенерированным результатом бейкинга и никогда не помещайте его в исходные авторские ресурсы. | Source/Tools/ParticleBaker.cpp Source/Client/EffekseerExtension.cpp |
Семейства объектов SPARK
| Стабильный ID | Семейство | Теги объектов | Требование | Источник |
|---|---|---|---|---|
particle-format.family.core |
Core | System, Group |
Создавайте ровно один корневой объект System и включайте под его атрибутом groups один или несколько объектов Group. | ThirdParty/spark/spark/src/Core/IO/SPK_IO_Manager.cpp |
particle-format.family.interpolators |
Interpolators | FloatDefaultInitializer, ColorDefaultInitializer, FloatRandomInitializer, ColorRandomInitializer, FloatSimpleInterpolator, ColorSimpleInterpolator, FloatRandomInterpolator, ColorRandomInterpolator, FloatGraphInterpolator, ColorGraphInterpolator |
Для изменения параметров частиц используйте только зарегистрированные теги инициализаторов и интерполяторов типов float и color. | ThirdParty/spark/spark/src/Core/IO/SPK_IO_Manager.cpp |
particle-format.family.zones |
Zones | Point, Sphere, Plane, Ring, Box, Cylinder |
Ссылки эмиттеров и зональных модификаторов могут использовать шесть зарегистрированных тегов геометрических зон. | ThirdParty/spark/spark/src/Core/IO/SPK_IO_Manager.cpp |
particle-format.family.emitters |
Emitters | StaticEmitter, RandomEmitter, StraightEmitter, SphericEmitter, NormalEmitter |
Группы могут содержать пять зарегистрированных тегов эмиттеров. | ThirdParty/spark/spark/src/Core/IO/SPK_IO_Manager.cpp |
particle-format.family.modifiers |
Modifiers | Gravity, Friction, Obstacle, Rotator, Collider, Destroyer, Vortex, EmitterAttacher, PointMass, RandomForce, LinearForce |
Группы могут содержать одиннадцать зарегистрированных тегов модификаторов. | ThirdParty/spark/spark/src/Core/IO/SPK_IO_Manager.cpp |
particle-format.family.actions |
Actions | ActionSet, SpawnParticlesAction |
Ссылки действий рождения и смерти могут использовать ActionSet и SpawnParticlesAction. | ThirdParty/spark/spark/src/Core/IO/SPK_IO_Manager.cpp |
particle-format.family.renderer |
Renderer | SparkQuadRenderer |
Для рендеринга частиц используйте принадлежащий движку тег SparkQuadRenderer. | Source/Client/SparkExtension.cpp |
Каталог объектов SPARK
| Стабильный ID | XML-тег | Семейство | Требование | Источник |
|---|---|---|---|---|
particle-format.object.system |
System |
Core | XML-тег <System> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Core/SPK_System.h |
particle-format.object.group |
Group |
Core | XML-тег <Group> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Core/SPK_Group.h |
particle-format.object.float-default-initializer |
FloatDefaultInitializer |
Interpolators | XML-тег <FloatDefaultInitializer> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_DefaultInitializer.h |
particle-format.object.color-default-initializer |
ColorDefaultInitializer |
Interpolators | XML-тег <ColorDefaultInitializer> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_DefaultInitializer.h |
particle-format.object.float-random-initializer |
FloatRandomInitializer |
Interpolators | XML-тег <FloatRandomInitializer> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_RandomInitializer.h |
particle-format.object.color-random-initializer |
ColorRandomInitializer |
Interpolators | XML-тег <ColorRandomInitializer> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_RandomInitializer.h |
particle-format.object.float-simple-interpolator |
FloatSimpleInterpolator |
Interpolators | XML-тег <FloatSimpleInterpolator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_SimpleInterpolator.h |
particle-format.object.color-simple-interpolator |
ColorSimpleInterpolator |
Interpolators | XML-тег <ColorSimpleInterpolator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_SimpleInterpolator.h |
particle-format.object.float-random-interpolator |
FloatRandomInterpolator |
Interpolators | XML-тег <FloatRandomInterpolator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_RandomInterpolator.h |
particle-format.object.color-random-interpolator |
ColorRandomInterpolator |
Interpolators | XML-тег <ColorRandomInterpolator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_RandomInterpolator.h |
particle-format.object.float-graph-interpolator |
FloatGraphInterpolator |
Interpolators | XML-тег <FloatGraphInterpolator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_GraphInterpolator.h |
particle-format.object.color-graph-interpolator |
ColorGraphInterpolator |
Interpolators | XML-тег <ColorGraphInterpolator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Interpolators/SPK_GraphInterpolator.h |
particle-format.object.point |
Point |
Zones | XML-тег <Point> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Zones/SPK_Point.h |
particle-format.object.sphere |
Sphere |
Zones | XML-тег <Sphere> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Zones/SPK_Sphere.h |
particle-format.object.plane |
Plane |
Zones | XML-тег <Plane> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Zones/SPK_Plane.h |
particle-format.object.ring |
Ring |
Zones | XML-тег <Ring> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Zones/SPK_Ring.h |
particle-format.object.box |
Box |
Zones | XML-тег <Box> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Zones/SPK_Box.h |
particle-format.object.cylinder |
Cylinder |
Zones | XML-тег <Cylinder> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Zones/SPK_Cylinder.h |
particle-format.object.static-emitter |
StaticEmitter |
Emitters | XML-тег <StaticEmitter> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Emitters/SPK_StaticEmitter.h |
particle-format.object.random-emitter |
RandomEmitter |
Emitters | XML-тег <RandomEmitter> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Emitters/SPK_RandomEmitter.h |
particle-format.object.straight-emitter |
StraightEmitter |
Emitters | XML-тег <StraightEmitter> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Emitters/SPK_StraightEmitter.h |
particle-format.object.spheric-emitter |
SphericEmitter |
Emitters | XML-тег <SphericEmitter> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Emitters/SPK_SphericEmitter.h |
particle-format.object.normal-emitter |
NormalEmitter |
Emitters | XML-тег <NormalEmitter> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Emitters/SPK_NormalEmitter.h |
particle-format.object.gravity |
Gravity |
Modifiers | XML-тег <Gravity> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_BasicModifiers.h |
particle-format.object.friction |
Friction |
Modifiers | XML-тег <Friction> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_BasicModifiers.h |
particle-format.object.obstacle |
Obstacle |
Modifiers | XML-тег <Obstacle> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_Obstacle.h |
particle-format.object.rotator |
Rotator |
Modifiers | XML-тег <Rotator> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_Rotator.h |
particle-format.object.collider |
Collider |
Modifiers | XML-тег <Collider> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_Collider.h |
particle-format.object.destroyer |
Destroyer |
Modifiers | XML-тег <Destroyer> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_Destroyer.h |
particle-format.object.vortex |
Vortex |
Modifiers | XML-тег <Vortex> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_Vortex.h |
particle-format.object.emitter-attacher |
EmitterAttacher |
Modifiers | XML-тег <EmitterAttacher> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_EmitterAttacher.h |
particle-format.object.point-mass |
PointMass |
Modifiers | XML-тег <PointMass> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_PointMass.h |
particle-format.object.random-force |
RandomForce |
Modifiers | XML-тег <RandomForce> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_RandomForce.h |
particle-format.object.linear-force |
LinearForce |
Modifiers | XML-тег <LinearForce> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Modifiers/SPK_LinearForce.h |
particle-format.object.action-set |
ActionSet |
Actions | XML-тег <ActionSet> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Actions/SPK_ActionSet.h |
particle-format.object.spawn-particles-action |
SpawnParticlesAction |
Actions | XML-тег <SpawnParticlesAction> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | ThirdParty/spark/spark/include/Extensions/Actions/SPK_SpawnParticlesAction.h |
particle-format.object.spark-quad-renderer |
SparkQuadRenderer |
Renderer | XML-тег <SparkQuadRenderer> зарегистрирован и доступен для редактирования в штатном редакторе частиц. | Source/Client/SparkExtension.h |