Module javafx.media

Class EqualizerBand


  • public final class EqualizerBand
    extends Object
    The EqualizerBand class provides control for each band in the AudioEqualizer.
    Since:
    JavaFX 2.0
    See Also:
    AudioEqualizer
    • Field Detail

      • MIN_GAIN

        public static final double MIN_GAIN
        Minimum possible gain value. In the current implementation this value is -24.0 dB.
        See Also:
        Constant Field Values
      • MAX_GAIN

        public static final double MAX_GAIN
        Maximum possible gain value. In the current implementation this value is 12.0 dB.
        See Also:
        Constant Field Values
    • Constructor Detail

      • EqualizerBand

        public EqualizerBand()
        EqualizerBand default constructor. It creates an instance with centerFrequency, bandwidth and gain set to 0.
      • EqualizerBand

        public EqualizerBand​(double centerFrequency,
                             double bandwidth,
                             double gain)
        Custom EqualizerBand constructor. It creates an instance from the centerFrequency, bandwidth and gain parameters. The gain specifies the amount of amplification (gain > 0.0 dB) or attenuation (gain < 0.0 dB) to be applied to the center frequency of the band. The bandwidth is the frequency spread between the upper and lower edges of the equalizer transfer function which have half the dB gain of the peak (center frequency).
        Parameters:
        centerFrequency - a positive value specifying the center frequency of the band in Hertz.
        bandwidth - a positive value specifying the bandwidth of the band in Hertz.
        gain - the gain in decibels to be applied to the band in the range [MIN_GAINMAX_GAIN] dB.
    • Method Detail

      • setCenterFrequency

        public final void setCenterFrequency​(double value)
        Set the center frequency on the band in Hertz.
        Parameters:
        value - the center frequency which must be a positive value in Hz.
      • getCenterFrequency

        public final double getCenterFrequency()
        Retrieve the center frequency of the band.
        Returns:
        the center frequency on the band in Hertz.
      • setBandwidth

        public final void setBandwidth​(double value)
        Set the bandwidth of the band in Hertz.
        Parameters:
        value - the bandwidth which must be a positive value in Hz.
      • getBandwidth

        public final double getBandwidth()
        Retrieve the bandwidth of the band.
        Returns:
        the bandwidth of the band in Hertz.
      • setGain

        public final void setGain​(double value)
        Set the gain of the band in dB. Gain property is limited to be within the interval MIN_GAIN to MAX_GAIN.
        Parameters:
        value - the gain in the range [MIN_GAINMAX_GAIN].
      • getGain

        public final double getGain()
        Retrieve the gain to be applied to the band.
        Returns:
        the gain of the band in dB.