lbajardsilogic@0: /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */
lbajardsilogic@0: 
lbajardsilogic@0: /*
lbajardsilogic@0:     Sonic Visualiser
lbajardsilogic@0:     An audio file viewer and annotation editor.
lbajardsilogic@0:     Centre for Digital Music, Queen Mary, University of London.
lbajardsilogic@0:     
lbajardsilogic@0:     This program is free software; you can redistribute it and/or
lbajardsilogic@0:     modify it under the terms of the GNU General Public License as
lbajardsilogic@0:     published by the Free Software Foundation; either version 2 of the
lbajardsilogic@0:     License, or (at your option) any later version.  See the file
lbajardsilogic@0:     COPYING included with this distribution for more information.
lbajardsilogic@0: */
lbajardsilogic@0: 
lbajardsilogic@0: /*
lbajardsilogic@0:    This is a modified version of a source file from the 
lbajardsilogic@0:    Rosegarden MIDI and audio sequencer and notation editor.
lbajardsilogic@0:    This file copyright 2000-2006 Chris Cannam.
lbajardsilogic@0: */
lbajardsilogic@0: 
lbajardsilogic@0: #ifndef _AUDIO_LEVEL_H_
lbajardsilogic@0: #define _AUDIO_LEVEL_H_
lbajardsilogic@0: 
lbajardsilogic@0: /**
lbajardsilogic@0:  * AudioLevel converts audio sample levels between various scales:
lbajardsilogic@0:  *
lbajardsilogic@0:  *   - dB values (-inf -> 0dB)
lbajardsilogic@0:  *   - floating-point values (-1.0 -> 1.0) such as used for a
lbajardsilogic@0:  *     multiplier for gain or in floating-point WAV files
lbajardsilogic@0:  *   - integer values intended to correspond to pixels on a fader
lbajardsilogic@0:  *     or vu level scale.
lbajardsilogic@0:  */
lbajardsilogic@0: 
lbajardsilogic@0: class AudioLevel
lbajardsilogic@0: {
lbajardsilogic@0: public:
lbajardsilogic@0: 
lbajardsilogic@0:     static const float DB_FLOOR;
lbajardsilogic@0: 
lbajardsilogic@0:     enum FaderType {
lbajardsilogic@0: 	     ShortFader = 0, // -40 -> +6  dB
lbajardsilogic@0:               LongFader = 1, // -70 -> +10 dB
lbajardsilogic@0:             IEC268Meter = 2, // -70 ->  0  dB
lbajardsilogic@0:         IEC268LongMeter = 3, // -70 -> +10 dB (0dB aligns with LongFader)
lbajardsilogic@0: 	   PreviewLevel = 4
lbajardsilogic@0:     };
lbajardsilogic@0: 
lbajardsilogic@0:     static float multiplier_to_dB(float multiplier);
lbajardsilogic@0:     static float dB_to_multiplier(float dB);
lbajardsilogic@0: 
lbajardsilogic@0:     static float fader_to_dB(int level, int maxLevel, FaderType type);
lbajardsilogic@0:     static int   dB_to_fader(float dB, int maxFaderLevel, FaderType type);
lbajardsilogic@0: 
lbajardsilogic@0:     static float fader_to_multiplier(int level, int maxLevel, FaderType type);
lbajardsilogic@0:     static int   multiplier_to_fader(float multiplier, int maxFaderLevel,
lbajardsilogic@0: 				     FaderType type);
lbajardsilogic@0: 
lbajardsilogic@0:     // fast if "levels" doesn't change often -- for audio segment previews
lbajardsilogic@0:     static int   multiplier_to_preview(float multiplier, int levels);
lbajardsilogic@0:     static float preview_to_multiplier(int level, int levels);
lbajardsilogic@0: };
lbajardsilogic@0: 
lbajardsilogic@0: 
lbajardsilogic@0: #endif
lbajardsilogic@0: