annotate base/LogRange.h @ 280:daf89d31f45c

* Restore Scale setting which had mistakenly disappeared from spectrum
* Some tweaks to spectrum peaks
* Make spectrum default to 4096/75%... or is that overdoing it?
* Show harmonic cursor even during playback if in measure mode and mouse in
  relevant pane
* Avoid crash when trying to measure a non-layer
* Various adjustments to some icons to make them look better in white-on-black
  schemes

/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */

/*
    Sonic Visualiser
    An audio file viewer and annotation editor.
    Centre for Digital Music, Queen Mary, University of London.
    This file copyright 2006 Chris Cannam.
    
    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of the
    License, or (at your option) any later version.  See the file
    COPYING included with this distribution for more information.
*/

#ifndef _LOG_RANGE_H_
#define _LOG_RANGE_H_

class LogRange
{
public:
    /**
     * Map a linear range onto a logarithmic range.  min and max are
     * passed as the extents of the linear range and returned as the
     * extents of the logarithmic range.  thresh is the minimum value
     * for the log range, to be used if the linear range spans zero.
     */
    static void mapRange(float &min, float &max, float thresh = -10);

    /**
     * Map a value onto a logarithmic range.  This just means taking
     * the base-10 log of the absolute value, or using the threshold
     * value if the absolute value is zero.
     */
    static float map(float value, float thresh = -10);

    /**
     * Map a value from the logarithmic range back again.  This just
     * means taking the value'th power of ten.
     */
    static float unmap(float value);
};

#endif