This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Mix Effects

The MixEffectComponent and all 22 mix effect types — named effect chains, order-independent wiring, local and global routing, and the runtime control surface.

Base — ships in GS_Audio.

Mix effects are the DSP processing layer of the free tier. You build a chain of effects on a component, give it a name, and point sources at that name.

Twenty-two effects are available. They are the same processors Audio Pro exposes as graph nodes — one processor, two authoring surfaces. Choosing the free tier does not reduce what you can do to a signal; it changes how you author it.

For usage guides and setup examples, see The Basics: GS_Audio.

 

Contents


MixEffectComponent

Drop it on an entity and it holds an ordered chain of effects — a polymorphic list where each entry’s concrete type is chosen from a dropdown.

FieldValue
TypeId{9F2A6C13-4D85-4E70-B1C6-3A8E5D7F2049}
Authored fieldMeaning
NameThe routing name registered for the head of the chain. Sources and other chains target this.
EffectsThe ordered chain. Index 0 receives the input; each effect feeds the next.
Output TargetWhere the tail of the chain feeds — another chain’s Name, or a volume channel.

The chain runs top to bottom. Index 0 is what gets registered under Name; the last entry feeds Output Target.

Setup is idempotent, and teardown unwires and destroys the nodes while keeping the authored list — so the component re-activates cleanly.


How Chains Route

Sources route in by name. An audio event’s Mixing Channel field can name either a volume channel or a mix effect chain. They share one namespace, so a source does not need to know which kind of thing it is pointing at.

Any number of chains can live on one entity, each with its own Name. Point one chain’s Output Target at another chain’s Name to compose them.

Wiring is order-independent. If a chain’s target does not exist yet, the connection is deferred and resolves when the target registers. You do not have to think about component activation order, and a missing target is not an error — it is a connection waiting to be made.

Routing catches up with sounds that already exist. When a chain registers after events have preloaded, already-pooled voices are re-pointed at the new target. Adding a MixEffectComponent at runtime works, and the sounds that were already playing through that channel follow it.

Local and global routing

Both patterns are supported and they coexist:

  • Global named channels — everything funnels through shared, named mix targets. Best for project-wide treatments.
  • Local chains on the emitting entity — the component lives on the emitter, scoping its effects to that one emission. Best for per-character or per-object colour.

The 22 Effects

Biquad filters

EffectDescription
Low PassAttenuates frequencies above the cutoff. Muffling, distance, underwater.
High PassAttenuates frequencies below the cutoff. Thinning, radio and telephone effects.
Band PassPasses only a band, attenuating everything outside it.
NotchAttenuates a narrow band while passing everything else. The inverse of band pass.
Peaking EQBoosts or cuts around a centre frequency with configurable bandwidth.
Low ShelfBoosts or cuts everything below a threshold by a fixed amount. Bass adjustment.
High ShelfBoosts or cuts everything above a threshold by a fixed amount. Treble adjustment.

Time and space

EffectDescription
EchoFeedback delay — repeats that decay over time.
ReverbSimulated room ambience.
BinauralFixed-direction HRTF placement. See the caution below.

Character and modulation

EffectDescription
Wave ShaperNon-linear distortion and saturation.
LofiBit depth and sample rate reduction.
RobotizeVocoder-style robotic character.
FlangerSweeping comb filtering from a modulated short delay.
ChorusThickening from multiple detuned delayed copies.
Ring ModRing modulation — metallic, inharmonic tones.
TremoloRhythmic amplitude modulation.
PitchPitch shifting that preserves tempo.

Utility

EffectDescription
PannerStereo placement.
CompressorDynamic range compression.
DC RemovalRemoves DC offset from a signal.
AmplifyStraight gain.

Runtime Control

Chains are drivable at runtime through AudioManagerRequestBus, so ScriptCanvas can change a treatment while it is playing.

MethodEffect
RerouteMixEffectRe-point a chain’s tail at a new output target.
SetMixEffectParamSet a parameter on the chain head.
SetMixEffectParamOnSet a parameter on a named effect inside the chain.
ResolveMixTargetResolve a name to its node.
RegisterMixEffect / UnregisterMixEffectManual node registration. Advanced.
WireMixSource / UnwireMixSourceManual wiring. Advanced.
RegisterMixEffectControl / UnregisterMixEffectControlControl-surface registry.

Environmental treatment is per-emission and rapidly modifiable by design. A character moving through a space changes its effects continuously, and that change isolates to the environmental portion of the signal regardless of which volume channel the sound belongs to.


Two Cautions


See Also

For related systems:

For conceptual overviews and usage guides:


Get GS_Audio

GS_Audio — Explore this gem on the product page and add it to your project.