public final Class SOFTEffectTarget

Class Inheritance

extends Object

java.lang.Object
org.lwjgl.openal.SOFTEffectTarget

Native bindings to the SOFT_effect_target extension.

This extension provides a method to reroute the output of an auxiliary effect slot to the input of another auxiliary effect slot. By default, an effect slot's output is added to the main output along side other effect slots and each source's direct path. This makes it impossible to, for example, apply an equalizer effect to the output of a chorus effect since the chorus and equalizer effects are processed separately.

Retargeting an effect slot's output to another effect slot allows chaining multiple effects to create results that aren't possible with standard EFX.

Field Summary

Modifier and Type	Field and Description
public static final int	AL_EFFECTSLOT_TARGET_SOFT Specifies the target effect slot for this effect slot's output.

Constructor Summary

Access	Constructor and Description
private	SOFTEffectTarget()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

AL_EFFECTSLOT_TARGET_SOFT back to summary

AL_EFFECTSLOT_TARGET_SOFT	back to summary
public static final int AL_EFFECTSLOT_TARGET_SOFT Specifies the target effect slot for this effect slot's output. The rendered output of this effect slot is added to the input of the specified target effect slot, which will be subsequently processed by the target effect slot's effect. Specifying `EFFECTSLOT_NULL` for the ID reverts the effect slot's output back to the main output. An effect slot that is the target of another effect slot cannot be deleted or an `INVALID_OPERATION` error will be generated. An effect slot cannot be set as a target if it would feed its own input through 0 or more other effect slots, or an `AL_INVALID_OPERATION` error will be generated.

public static final int AL_EFFECTSLOT_TARGET_SOFT

Specifies the target effect slot for this effect slot's output.

The rendered output of this effect slot is added to the input of the specified target effect slot, which will be subsequently processed by the target effect slot's effect. Specifying EFFECTSLOT_NULL for the ID reverts the effect slot's output back to the main output.

An effect slot that is the target of another effect slot cannot be deleted or an INVALID_OPERATION error will be generated. An effect slot cannot be set as a target if it would feed its own input through 0 or more other effect slots, or an AL_INVALID_OPERATION error will be generated.

Constructor Detail

SOFTEffectTarget	back to summary
private SOFTEffectTarget()