One Logo Pool Ball
RealityFoundation · IOS API REFERENCE

ParticleEmitterComponent.ParticleEmitter

struct · iOS 18.0+ · SDK 27.1

struct ParticleEmitter

Members (67)

get · iOS 18.0+

noiseScale

TypeScript
get noiseScale(): number
Swift declaration
var noiseScale: Float

Scale of the noise (turbulence) patterns. Defaults to 1.

set · iOS 18.0+

noiseScale

TypeScript
set noiseScale(value: number)
Swift declaration
var noiseScale: Float

Scale of the noise (turbulence) patterns. Defaults to 1.

get · iOS 18.0+

acceleration

TypeScript
get acceleration(): SDKHandle
Swift declaration
var acceleration: SIMD3<Float>

The constant acceleration vector, in meters per second squared, applied to all particles in the system.

set · iOS 18.0+

acceleration

TypeScript
set acceleration(value: SDKHandle)
Swift declaration
var acceleration: SIMD3<Float>

The constant acceleration vector, in meters per second squared, applied to all particles in the system.

get · iOS 18.0+

angularSpeed

TypeScript
get angularSpeed(): number
Swift declaration
var angularSpeed: Float

The initial spin rate, in radians per second, of newly spawned particles. Defaults to 0.

set · iOS 18.0+

angularSpeed

TypeScript
set angularSpeed(value: number)
Swift declaration
var angularSpeed: Float

The initial spin rate, in radians per second, of newly spawned particles. Defaults to 0.

get · iOS 18.0+

opacityCurve

TypeScript
get opacityCurve(): ParticleEmitterComponent_ParticleEmitter_OpacityCurve
Swift declaration
var opacityCurve: ParticleEmitterComponent.ParticleEmitter.OpacityCurve

The curve of opacity change over the lifetime of the particle. Defaults to `quickFadeInOut`.

set · iOS 18.0+

opacityCurve

TypeScript
set opacityCurve(value: ParticleEmitterComponent_ParticleEmitter_OpacityCurve)
Swift declaration
var opacityCurve: ParticleEmitterComponent.ParticleEmitter.OpacityCurve

The curve of opacity change over the lifetime of the particle. Defaults to `quickFadeInOut`.

get · iOS 18.0+

billboardMode

TypeScript
get billboardMode(): ParticleEmitterComponent_ParticleEmitter_BillboardMode
Swift declaration
var billboardMode: ParticleEmitterComponent.ParticleEmitter.BillboardMode

The mode defining whether and how particles orient towards the camera. Defaults to `billboardYAligned`.

set · iOS 18.0+

billboardMode

TypeScript
set billboardMode(value: ParticleEmitterComponent_ParticleEmitter_BillboardMode)
Swift declaration
var billboardMode: ParticleEmitterComponent.ParticleEmitter.BillboardMode

The mode defining whether and how particles orient towards the camera. Defaults to `billboardYAligned`.

get · iOS 18.0+

dampingFactor

TypeScript
get dampingFactor(): number
Swift declaration
var dampingFactor: Float

A factor that slows particles relative to their velocity. Defaults to 0.

set · iOS 18.0+

dampingFactor

TypeScript
set dampingFactor(value: number)
Swift declaration
var dampingFactor: Float

A factor that slows particles relative to their velocity. Defaults to 0.

get · iOS 18.0+

imageSequence

TypeScript
get imageSequence(): (ParticleEmitterComponent_ParticleEmitter_ImageSequence) | null
Swift declaration
var imageSequence: ParticleEmitterComponent.ParticleEmitter.ImageSequence?

Determines if the particle image is a sprite sheet (used for animation).

set · iOS 18.0+

imageSequence

TypeScript
set imageSequence(value: (ParticleEmitterComponent_ParticleEmitter_ImageSequence) | null)
Swift declaration
var imageSequence: ParticleEmitterComponent.ParticleEmitter.ImageSequence?

Determines if the particle image is a sprite sheet (used for animation).

get · iOS 18.0+

massVariation

TypeScript
get massVariation(): number
Swift declaration
var massVariation: Float

Defines a plus/minus range (in grams) from which a value is randomly selected to offset `mass`.

set · iOS 18.0+

massVariation

TypeScript
set massVariation(value: number)
Swift declaration
var massVariation: Float

Defines a plus/minus range (in grams) from which a value is randomly selected to offset `mass`.

get · iOS 18.0+

noiseStrength

TypeScript
get noiseStrength(): number
Swift declaration
var noiseStrength: Float

Strength of the noise (turbulence) fields affecting particle motion. Defaults to 0.

set · iOS 18.0+

noiseStrength

TypeScript
set noiseStrength(value: number)
Swift declaration
var noiseStrength: Float

Strength of the noise (turbulence) fields affecting particle motion. Defaults to 0.

get · iOS 18.0+

sizeVariation

TypeScript
get sizeVariation(): number
Swift declaration
var sizeVariation: Float

Defines a plus/minus range from which a value is randomly selected to offset `size`.

set · iOS 18.0+

sizeVariation

TypeScript
set sizeVariation(value: number)
Swift declaration
var sizeVariation: Float

Defines a plus/minus range from which a value is randomly selected to offset `size`.

get · iOS 18.0+

stretchFactor

TypeScript
get stretchFactor(): number
Swift declaration
var stretchFactor: Float

How much a particle's shape is stretched along its velocity direction (Billboard particles only).

set · iOS 18.0+

stretchFactor

TypeScript
set stretchFactor(value: number)
Swift declaration
var stretchFactor: Float

How much a particle's shape is stretched along its velocity direction (Billboard particles only).

get · iOS 18.0+

angleVariation

TypeScript
get angleVariation(): number
Swift declaration
var angleVariation: Float

Defines a plus/minus range (in radians) from which a value is randomly selected to offset `angle`.

set · iOS 18.0+

angleVariation

TypeScript
set angleVariation(value: number)
Swift declaration
var angleVariation: Float

Defines a plus/minus range (in radians) from which a value is randomly selected to offset `angle`.

get · iOS 18.0+

spreadingAngle

TypeScript
get spreadingAngle(): number
Swift declaration
var spreadingAngle: Float

The range, in radians, of randomized initial particle directions as radians describing the size of the spreading cone. Defaults to 0.

set · iOS 18.0+

spreadingAngle

TypeScript
set spreadingAngle(value: number)
Swift declaration
var spreadingAngle: Float

The range, in radians, of randomized initial particle directions as radians describing the size of the spreading cone. Defaults to 0.

get · iOS 18.0+

vortexStrength

TypeScript
get vortexStrength(): number
Swift declaration
var vortexStrength: Float

Strength of the vortex forces affecting particle motion. Defaults to 0.

set · iOS 18.0+

vortexStrength

TypeScript
set vortexStrength(value: number)
Swift declaration
var vortexStrength: Float

Strength of the vortex forces affecting particle motion. Defaults to 0.

get · iOS 18.0+

vortexDirection

TypeScript
get vortexDirection(): SDKHandle
Swift declaration
var vortexDirection: SIMD3<Float>

Direction vector of the vortex axis. Defaults to (0, 1, 0).

set · iOS 18.0+

vortexDirection

TypeScript
set vortexDirection(value: SDKHandle)
Swift declaration
var vortexDirection: SIMD3<Float>

Direction vector of the vortex axis. Defaults to (0, 1, 0).

get · iOS 18.0+

attractionCenter

TypeScript
get attractionCenter(): SDKHandle
Swift declaration
var attractionCenter: SIMD3<Float>

The spot that the particles are attracted to. In local space. Defaults to (1, 1, 0).

set · iOS 18.0+

attractionCenter

TypeScript
set attractionCenter(value: SDKHandle)
Swift declaration
var attractionCenter: SIMD3<Float>

The spot that the particles are attracted to. In local space. Defaults to (1, 1, 0).

get · iOS 18.0+

isLightingEnabled

TypeScript
get isLightingEnabled(): boolean
Swift declaration
var isLightingEnabled: Bool

Determines if particles are affected by scene lighting.

set · iOS 18.0+

isLightingEnabled

TypeScript
set isLightingEnabled(value: boolean)
Swift declaration
var isLightingEnabled: Bool

Determines if particles are affected by scene lighting.

get · iOS 18.0+

lifeSpanVariation

TypeScript
get lifeSpanVariation(): number
Swift declaration
var lifeSpanVariation: Double

Defines a plus/minus range (in seconds) from which a value is randomly selected to offset `lifeSpan`. Defaults to 0.2.

set · iOS 18.0+

lifeSpanVariation

TypeScript
set lifeSpanVariation(value: number)
Swift declaration
var lifeSpanVariation: Double

Defines a plus/minus range (in seconds) from which a value is randomly selected to offset `lifeSpan`. Defaults to 0.2.

get · iOS 18.0+

attractionStrength

TypeScript
get attractionStrength(): number
Swift declaration
var attractionStrength: Float

The particles are attracted to the `attractionCenter` by this amount. Defaults to 0.

set · iOS 18.0+

attractionStrength

TypeScript
set attractionStrength(value: number)
Swift declaration
var attractionStrength: Float

The particles are attracted to the `attractionCenter` by this amount. Defaults to 0.

get · iOS 18.0+

birthRateVariation

TypeScript
get birthRateVariation(): number
Swift declaration
var birthRateVariation: Float

Defines a plus/minus range from which a value is randomly selected to offset `birthRate`.

set · iOS 18.0+

birthRateVariation

TypeScript
set birthRateVariation(value: number)
Swift declaration
var birthRateVariation: Float

Defines a plus/minus range from which a value is randomly selected to offset `birthRate`.

get · iOS 18.0+

colorEvolutionPower

TypeScript
get colorEvolutionPower(): number
Swift declaration
var colorEvolutionPower: Float

How quickly the color evolves from its start to its end color — a value of 1 is a linear transition, values below 1 transition quicker, values over 1 transition slower.

set · iOS 18.0+

colorEvolutionPower

TypeScript
set colorEvolutionPower(value: number)
Swift declaration
var colorEvolutionPower: Float

How quickly the color evolves from its start to its end color — a value of 1 is a linear transition, values below 1 transition quicker, values over 1 transition slower.

get · iOS 18.0+

noiseAnimationSpeed

TypeScript
get noiseAnimationSpeed(): number
Swift declaration
var noiseAnimationSpeed: Float

Determines how fast the noise field changes over time. Defaults to 0.

set · iOS 18.0+

noiseAnimationSpeed

TypeScript
set noiseAnimationSpeed(value: number)
Swift declaration
var noiseAnimationSpeed: Float

Determines how fast the noise field changes over time. Defaults to 0.

get · iOS 18.0+

angularSpeedVariation

TypeScript
get angularSpeedVariation(): number
Swift declaration
var angularSpeedVariation: Float

Defines a plus/minus range (in radians per second) from which a value is randomly selected to offset `angularSpeed`.

set · iOS 18.0+

angularSpeedVariation

TypeScript
set angularSpeedVariation(value: number)
Swift declaration
var angularSpeedVariation: Float

Defines a plus/minus range (in radians per second) from which a value is randomly selected to offset `angularSpeed`.

get · iOS 18.0+

sizeMultiplierAtEndOfLifespan

TypeScript
get sizeMultiplierAtEndOfLifespan(): number
Swift declaration
var sizeMultiplierAtEndOfLifespan: Float

At the end of the particle lifespan, the particle's size will be it's initial size times this multiplier. Defaults to 0.1.

set · iOS 18.0+

sizeMultiplierAtEndOfLifespan

TypeScript
set sizeMultiplierAtEndOfLifespan(value: number)
Swift declaration
var sizeMultiplierAtEndOfLifespan: Float

At the end of the particle lifespan, the particle's size will be it's initial size times this multiplier. Defaults to 0.1.

get · iOS 18.0+

sizeMultiplierAtEndOfLifespanPower

TypeScript
get sizeMultiplierAtEndOfLifespanPower(): number
Swift declaration
var sizeMultiplierAtEndOfLifespanPower: Float

How quickly or slowly particle size changes over its lifetime — a value of 1 is linear, values below 1 transition quicker, values above 1 transition slower.

set · iOS 18.0+

sizeMultiplierAtEndOfLifespanPower

TypeScript
set sizeMultiplierAtEndOfLifespanPower(value: number)
Swift declaration
var sizeMultiplierAtEndOfLifespanPower: Float

How quickly or slowly particle size changes over its lifetime — a value of 1 is linear, values below 1 transition quicker, values above 1 transition slower.

get · iOS 18.0+

mass

TypeScript
get mass(): number
Swift declaration
var mass: Float

The mass, in grams, of each particle in the system. Defaults to 1.

set · iOS 18.0+

mass

TypeScript
set mass(value: number)
Swift declaration
var mass: Float

The mass, in grams, of each particle in the system. Defaults to 1.

get · iOS 18.0+

size

TypeScript
get size(): number
Swift declaration
var size: Float

The rendered size, in units of the scene’s world coordinate space, of the particle image. Value is the half-extent of the particle's quad. Defaults to 0.02.

set · iOS 18.0+

size

TypeScript
set size(value: number)
Swift declaration
var size: Float

The rendered size, in units of the scene’s world coordinate space, of the particle image. Value is the half-extent of the particle's quad. Defaults to 0.02.

get · iOS 18.0+

angle

TypeScript
get angle(): number
Swift declaration
var angle: Float

The rotation angle, in radians, of newly spawned particles. Defaults to 0.

set · iOS 18.0+

angle

TypeScript
set angle(value: number)
Swift declaration
var angle: Float

The rotation angle, in radians, of newly spawned particles. Defaults to 0.

get · iOS 18.0+

image

TypeScript
get image(): (TextureResource) | null
Swift declaration
var image: TextureResource?

The image that each particle will use (requires pre-multiplied RGB values). Defaults to a white circular texture.

set · iOS 18.0+

image

TypeScript
set image(value: (TextureResource) | null)
Swift declaration
var image: TextureResource?

The image that each particle will use (requires pre-multiplied RGB values). Defaults to a white circular texture.

get · iOS 18.0+

lifeSpan

TypeScript
get lifeSpan(): number
Swift declaration
var lifeSpan: Double

The duration, in seconds, for which each particle is rendered before being removed from the scene. Defaults to 1.

set · iOS 18.0+

lifeSpan

TypeScript
set lifeSpan(value: number)
Swift declaration
var lifeSpan: Double

The duration, in seconds, for which each particle is rendered before being removed from the scene. Defaults to 1.

get · iOS 18.0+

birthRate

TypeScript
get birthRate(): number
Swift declaration
var birthRate: Float

The number of particles emitted over the emission duration. Defaults to 100.

set · iOS 18.0+

birthRate

TypeScript
set birthRate(value: number)
Swift declaration
var birthRate: Float

The number of particles emitted over the emission duration. Defaults to 100.

get · iOS 18.0+

blendMode

TypeScript
get blendMode(): ParticleEmitterComponent_ParticleEmitter_BlendMode
Swift declaration
var blendMode: ParticleEmitterComponent.ParticleEmitter.BlendMode

How overlapping particles are composited together. Defaults to `alpha`.

set · iOS 18.0+

blendMode

TypeScript
set blendMode(value: ParticleEmitterComponent_ParticleEmitter_BlendMode)
Swift declaration
var blendMode: ParticleEmitterComponent.ParticleEmitter.BlendMode

How overlapping particles are composited together. Defaults to `alpha`.

get · iOS 18.0+

sortOrder

TypeScript
get sortOrder(): ParticleEmitterComponent_ParticleEmitter_SortOrder
Swift declaration
var sortOrder: ParticleEmitterComponent.ParticleEmitter.SortOrder

How overlapping particles are sorted before rendering. Defaults to `increasingDepth`.

set · iOS 18.0+

sortOrder

TypeScript
set sortOrder(value: ParticleEmitterComponent_ParticleEmitter_SortOrder)
Swift declaration
var sortOrder: ParticleEmitterComponent.ParticleEmitter.SortOrder

How overlapping particles are sorted before rendering. Defaults to `increasingDepth`.

init · iOS 18.0+

init

TypeScript
static init(): ParticleEmitterComponent_ParticleEmitter
Swift declaration
init()

Skipped declarations

No declarations were skipped in this snapshot.

All RealityFoundation types →