Component:BoxEmitter: Difference between revisions

From Resonite Wiki
Automated: update Fields
add needed info
Line 3: Line 3:
|Name=Box Emitter
|Name=Box Emitter
}}
}}
Box emitter is a component that is used in conjunction with [[Component:ParticleSystem|Particle System]] and [[Component:ParticleStyle|Particle Style]]. It allows for adding particles into a Particle system with a rate, and does them inside or along the outside of the box area specified.
Box emitter is a component that is used in conjunction with [[Component:ParticleSystem|Particle System]] and [[Component:ParticleStyle|Particle Style]]. It allows for adding particles into a Particle system with a rate, and does them inside or along the outside of the box area specified. The particle starting colors are lerped based on what corner of the cube the particle generated is closest to.


== Usage ==
== Usage ==
Line 11: Line 11:
|BurstOnActivatedMin|Float| the min value of the range of particles to be emitted when activated.
|BurstOnActivatedMin|Float| the min value of the range of particles to be emitted when activated.
|BurstOnActivatedMax|Float| the max value of the range of particles to be emitted when activated.
|BurstOnActivatedMax|Float| the max value of the range of particles to be emitted when activated.
|BurstOnStart|Bool|
|BurstOnStart|Bool| Shoots a burst of particles when the component is spawned in.
|Size|Float3| The size of this box emitter.
|Size|Float3| The size of this box emitter.
|EmitFromShell|Bool| Enable emitting particles on the outside of the box instead of from any point within the volume.
|EmitFromShell|Bool| Enable emitting particles on the outside of the box instead of from any point within the volume.
|DirectionMode|BoxEmitterDirection|
|DirectionMode|BoxEmitterDirection| What direction to shoot the particles in from the box.
|Direction|Float3| Which direction in local space to shoot particles emitted by this emitter
|Direction|Float3| Which direction in local space to shoot particles emitted by this emitter
|DirectionTransformMode|DirectionTransformMode|
|DirectionTransformMode|DirectionTransformMode| How to determine the transform of the particles
|RandomDirectionWeight|Float| How much random velocity to add to the particles.
|RandomDirectionWeight|Float| How much random velocity to add to the particles.
|DirectionPostTransform|Float3x3|
|DirectionPostTransform|Float3x3| The direction the particles should face as an extra matrix transform after the final particle starting direction has been calculated.
|Color0|ColorX|
|Color0|ColorX| Color of the cube on corner (-x,-z,-y)
|Color1|ColorX|
|Color1|ColorX| Color of the cube on corner (+x,-z,-y)
|Color2|ColorX|
|Color2|ColorX| Color of the cube on corner (+x,+z,-y)
|Color3|ColorX|
|Color3|ColorX| Color of the cube on corner (-x,+z,-y)
|Color4|ColorX|
|Color4|ColorX| Color of the cube on corner (-x,-z,+y)
|Color5|ColorX|
|Color5|ColorX| Color of the cube on corner (+x,-z,+y)
|Color6|ColorX|
|Color6|ColorX| Color of the cube on corner (+x,+z,+y)
|Color7|ColorX|
|Color7|ColorX| Color of the cube on corner (-x,+z,+y)
}}
}}


== Behavior ==
== Usage ==
Used in creations using particle systems as a source of particles.


== Examples ==
== Examples ==
Line 35: Line 36:


== See Also ==
== See Also ==
* [[Component:ParticleSystem]]
* [[Photon Dust]]


[[Category:Components:Rendering:Particle System:Emitters{{#translation:}}|Box Emitter]]
[[Category:Components:Rendering:Particle System:Emitters{{#translation:}}|Box Emitter]]
[[Category:Components{{#translation:}}|Box Emitter]]
[[Category:Components{{#translation:}}|Box Emitter]]
[[Category:ComponentStubs]]

Revision as of 17:29, 2 June 2025

Component image 
Box Emitter component as seen in the Scene Inspector

Box emitter is a component that is used in conjunction with Particle System and Particle Style. It allows for adding particles into a Particle system with a rate, and does them inside or along the outside of the box area specified. The particle starting colors are lerped based on what corner of the cube the particle generated is closest to.

Usage

Fields
Name Type Description
persistent Bool Determines whether or not this item will be saved to the server.
UpdateOrder Int Controls the order in which this component is updated.
Enabled Bool Controls whether or not this component is enabled. Some components stop their functionality when this field is disabled, but some don't.
System ParticleSystem The particle system to get data from like style and particle count limits
Rate Float how fast to emit particles into the system.
BurstOnActivatedMin Float the min value of the range of particles to be emitted when activated.
BurstOnActivatedMax Float the max value of the range of particles to be emitted when activated.
BurstOnStart Bool Shoots a burst of particles when the component is spawned in.
Size Float3 The size of this box emitter.
EmitFromShell Bool Enable emitting particles on the outside of the box instead of from any point within the volume.
DirectionMode BoxEmitterDirection What direction to shoot the particles in from the box.
Direction Float3 Which direction in local space to shoot particles emitted by this emitter
DirectionTransformMode DirectionTransformMode How to determine the transform of the particles
RandomDirectionWeight Float How much random velocity to add to the particles.
DirectionPostTransform Float3x3 The direction the particles should face as an extra matrix transform after the final particle starting direction has been calculated.
Color0 ColorX Color of the cube on corner (-x,-z,-y)
Color1 ColorX Color of the cube on corner (+x,-z,-y)
Color2 ColorX Color of the cube on corner (+x,+z,-y)
Color3 ColorX Color of the cube on corner (-x,+z,-y)
Color4 ColorX Color of the cube on corner (-x,-z,+y)
Color5 ColorX Color of the cube on corner (+x,-z,+y)
Color6 ColorX Color of the cube on corner (+x,+z,+y)
Color7 ColorX Color of the cube on corner (-x,+z,+y)

Usage

Used in creations using particle systems as a source of particles.

Examples

Useful to make fireflies in an area, for a calming nighttime aura. It can also be used to make leaves fall from trees by making a box around the tree leaves, or as wind particles in a breezy field.

See Also