Enum Class AudioConfig.Virtualization

java.lang.Object
java.lang.Enum<AudioConfig.Virtualization>
de.pottgames.tuningfork.AudioConfig.Virtualization
All Implemented Interfaces:
Serializable, Comparable<AudioConfig.Virtualization>, Constable
Enclosing class:
AudioConfig
public static enum AudioConfig.Virtualization extends Enum<AudioConfig.Virtualization>
Holds different options for enabling/disabling the virtualization that is performed when playing non-mono audio.

  • Enum Constant Details

    • ON

      public static final AudioConfig.Virtualization ON
      Virtualization is on. Input channels will not be mapped to the corresponding output channels, instead OpenAL decides where to play each channel based on the spatialization algorithm. Applies only when playing non-mono audio.

    • OFF_DROP_CHANNELS

      public static final AudioConfig.Virtualization OFF_DROP_CHANNELS
      Virtualizations is off. Input channels are routed to output channels as-is, input channels that don't match an output channel will be dropped.
      An example: You try to play a 4-channel sound file on a stereo system. With this setting, only channel 1 and 2 are played, channel 3 and 4 will be ignored. Applies only when playing non-mono audio.

    • OFF_REMIX_CHANNELS

      public static final AudioConfig.Virtualization OFF_REMIX_CHANNELS
      Virtualization is off. Input channels are routed to output channels as-is, input channels that do not match an output channel are mixed into the closest available output channel.
      An example: You try to play a 4-channel sound file on a stereo system. With this setting, channel 1 and 3 are mapped to the left speaker, channel 2 and 4 to the right speaker. Applies only when playing non-mono audio.

      Warning: The non-matching channels are mixed-in at a super low volume, I don't know why OpenAL does it this way but there's probably a reason. However, it is not what I'd expect it to be, hence the experimental feature flag until I have sorted this out.

  • Method Details

    • values

      public static AudioConfig.Virtualization[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static AudioConfig.Virtualization valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null