Taos API Reference
    Preparing search index...

    Interface SplitNode

    Sub-emitter: when a parent particle hits the trigger, atomically appends count spawn requests (parent state + inheritance) into a GPU queue. The child pass's queue-spawn shader consumes the queue each frame.

    Each split owns a fixed-size queue (queueCapacity entries); requests beyond capacity in a single frame are silently dropped.

    interface SplitNode {
        trigger: "on_death" | "on_alive";
        rate?: number;
        count: number;
        inherit: { velocity?: number; color?: boolean };
        child: ParticleGraphConfig;
        queueCapacity?: number;
    }
    Index

    Properties

    trigger: "on_death" | "on_alive"

    on_alive fires per frame with probability rate*dt; on_death fires once in the death branch before the particle slot is recycled.

    rate?: number

    Average splits per second per parent particle (Poisson-like via probability per dt). Required for on_alive; ignored for on_death.

    count: number

    Number of child particles spawned per fire event.

    inherit: { velocity?: number; color?: boolean }

    What the child inherits from the parent. Position is always inherited (the child's emitter origin is parent_pos + emitter.position, world-axes). velocity in [0, 1+] scales the parent's velocity and adds it to the child's initial velocity. color replaces the child emitter's initialColor with the parent's current color.

    Child subsystem to spawn from. Its emitter.position is treated as a world-axes offset from the parent particle's position. The child's emitter.spawnRate still drives normal CPU-rate spawning in addition to queue spawns.

    queueCapacity?: number

    Maximum spawn requests per frame (defaults to 1024). Overflow is silent.