zui docs v0.0.5
GitHub ↗
Drawing and interaction Native Qt

Particle System

A configurable native particle emitter with motion, gravity, turbulence, bursts, and lifecycle events.

Usage

Ruby example

Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.

Ruby
particle_system width: 640, height: 360, running: true, emit_rate: 90, life_span: 1_800, size: 9, end_size: 1, color: "#b7ff5a", gravity: 24
API

Component properties

46 component-specific values, plus shared item and layout properties.

widthWidth configuration for Particle System.property
heightHeight configuration for Particle System.property
runningRunning configuration for Particle System.property
pausedPaused configuration for Particle System.property
emit_rateEmit rate configuration for Particle System.property
life_spanLife span configuration for Particle System.property
life_span_variationLife span variation configuration for Particle System.property
maximum_emittedMaximum emitted configuration for Particle System.property
sizeSize configuration for Particle System.property
end_sizeEnd size configuration for Particle System.property
size_variationSize variation configuration for Particle System.property
sourceSource configuration for Particle System.property
colorColor configuration for Particle System.property
color_variationColor variation configuration for Particle System.property
alphaAlpha configuration for Particle System.property
alpha_variationAlpha variation configuration for Particle System.property
rotationRotation configuration for Particle System.property
rotation_variationRotation variation configuration for Particle System.property
rotation_velocityRotation velocity configuration for Particle System.property
rotation_velocity_variationRotation velocity variation configuration for Particle System.property
auto_rotationAuto rotation configuration for Particle System.property
emitter_xEmitter x configuration for Particle System.property
emitter_yEmitter y configuration for Particle System.property
emitter_widthEmitter width configuration for Particle System.property
emitter_heightEmitter height configuration for Particle System.property
velocity_angleVelocity angle configuration for Particle System.property
velocityVelocity configuration for Particle System.property
velocity_angle_variationVelocity angle variation configuration for Particle System.property
velocity_variationVelocity variation configuration for Particle System.property
acceleration_angleAcceleration angle configuration for Particle System.property
accelerationAcceleration configuration for Particle System.property
acceleration_angle_variationAcceleration angle variation configuration for Particle System.property
acceleration_variationAcceleration variation configuration for Particle System.property
gravityGravity configuration for Particle System.property
gravity_angleGravity angle configuration for Particle System.property
turbulenceTurbulence configuration for Particle System.property
turbulence_xTurbulence x configuration for Particle System.property
turbulence_yTurbulence y configuration for Particle System.property
turbulence_widthTurbulence width configuration for Particle System.property
turbulence_heightTurbulence height configuration for Particle System.property
particle_shapeParticle shape configuration for Particle System.property
burst_countBurst count configuration for Particle System.property
burst_xBurst x configuration for Particle System.property
burst_yBurst y configuration for Particle System.property
burst_revisionBurst revision configuration for Particle System.property
visibleVisible configuration for Particle System.property
Show 13 shared item properties
enabledopacityscalezfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

Subscribe with on widget, :event and keep behavior in Ruby.

startNative event payload
stopNative event payload
pauseNative event payload
resumeNative event payload
emptyNative event payload
burstNative event payload