view data/fileio/AudioFileReaderFactory.cpp @ 1196:c7b9c902642f spectrogram-minor-refactor

Fix threshold in spectrogram -- it wasn't working in the last release.
There is a new protocol for this. Formerly the threshold parameter had a
range from -50dB to 0 with the default at -50, and -50 treated internally
as "no threshold". However, there was a hardcoded, hidden internal threshold
for spectrogram colour mapping at -80dB with anything below this being rounded
to zero. Now the threshold parameter has range -81 to -1 with the default
at -80, -81 is treated internally as "no threshold", and there is no hidden
internal threshold. So the default behaviour is the same as before, an
effective -80dB threshold, but it is now possible to change this in both
directions. Sessions reloaded from prior versions may look slightly different
because, if the session says there should be no threshold, there will now
actually be no threshold instead of having the hidden internal one.

Still need to do something in the UI to make it apparent that the -81dB
setting removes the threshold entirely. This is at least no worse than the
previous, also obscured, magic -50dB setting.

/* -*- 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 and QMUL.
    
    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.
*/

#include "AudioFileReaderFactory.h"

#include "WavFileReader.h"
#include "DecodingWavFileReader.h"
#include "OggVorbisFileReader.h"
#include "MP3FileReader.h"
#include "QuickTimeFileReader.h"
#include "CoreAudioFileReader.h"
#include "AudioFileSizeEstimator.h"

#include "base/StorageAdviser.h"

#include <QString>
#include <QFileInfo>
#include <iostream>

//#define DEBUG_AUDIO_FILE_READER_FACTORY 1

QString
AudioFileReaderFactory::getKnownExtensions()
{
    std::set<QString> extensions;

    WavFileReader::getSupportedExtensions(extensions);
#ifdef HAVE_MAD
    MP3FileReader::getSupportedExtensions(extensions);
#endif
#ifdef HAVE_OGGZ
#ifdef HAVE_FISHSOUND
    OggVorbisFileReader::getSupportedExtensions(extensions);
#endif
#endif
#ifdef HAVE_QUICKTIME
    QuickTimeFileReader::getSupportedExtensions(extensions);
#endif
#ifdef HAVE_COREAUDIO
    CoreAudioFileReader::getSupportedExtensions(extensions);
#endif

    QString rv;
    for (std::set<QString>::const_iterator i = extensions.begin();
         i != extensions.end(); ++i) {
        if (i != extensions.begin()) rv += " ";
        rv += "*." + *i;
    }

    return rv;
}

AudioFileReader *
AudioFileReaderFactory::createReader(FileSource source, 
                                     sv_samplerate_t targetRate,
                                     bool normalised,
                                     ProgressReporter *reporter)
{
    return create(source, targetRate, normalised, false, reporter);
}

AudioFileReader *
AudioFileReaderFactory::createThreadingReader(FileSource source, 
                                              sv_samplerate_t targetRate,
                                              bool normalised,
                                              ProgressReporter *reporter)
{
    return create(source, targetRate, normalised, true, reporter);
}

AudioFileReader *
AudioFileReaderFactory::create(FileSource source, 
                               sv_samplerate_t targetRate, 
                               bool normalised,
                               bool threading,
                               ProgressReporter *reporter)
{
    QString err;

#ifdef DEBUG_AUDIO_FILE_READER_FACTORY
    cerr << "AudioFileReaderFactory::createReader(\"" << source.getLocation() << "\"): Requested rate: " << targetRate << endl;
#endif

    if (!source.isOK()) {
        cerr << "AudioFileReaderFactory::createReader(\"" << source.getLocation() << "\": Failed to retrieve source (transmission error?): " << source.getErrorString() << endl;
        return 0;
    }

    if (!source.isAvailable()) {
        cerr << "AudioFileReaderFactory::createReader(\"" << source.getLocation() << "\": Source not found" << endl;
        return 0;
    }

    AudioFileReader *reader = 0;

    sv_frame_t estimatedSamples = 
        AudioFileSizeEstimator::estimate(source, targetRate);
    
    CodedAudioFileReader::CacheMode cacheMode =
        CodedAudioFileReader::CacheInTemporaryFile;

    if (estimatedSamples > 0) {
        size_t kb = (estimatedSamples * sizeof(float)) / 1024;
        StorageAdviser::Recommendation rec =
            StorageAdviser::recommend(StorageAdviser::SpeedCritical, kb, kb);
        if (rec == StorageAdviser::UseMemory ||
            rec == StorageAdviser::PreferMemory) {
            cacheMode = CodedAudioFileReader::CacheInMemory;
        }
    }
    
    CodedAudioFileReader::DecodeMode decodeMode =
        (threading ?
         CodedAudioFileReader::DecodeThreaded :
         CodedAudioFileReader::DecodeAtOnce);
    
    // Try to construct a preferred reader based on the extension or
    // MIME type.

#define CHECK(reader) if (!reader->isOK()) { delete reader; reader = 0; }

    if (WavFileReader::supports(source)) {

        reader = new WavFileReader(source);

        sv_samplerate_t fileRate = reader->getSampleRate();

        if (reader->isOK() &&
            (!reader->isQuicklySeekable() ||
             normalised ||
             (cacheMode == CodedAudioFileReader::CacheInMemory) ||
             (targetRate != 0 && fileRate != targetRate))) {

#ifdef DEBUG_AUDIO_FILE_READER_FACTORY
            cerr << "AudioFileReaderFactory::createReader: WAV file rate: " << reader->getSampleRate() << ", normalised " << normalised << ", seekable " << reader->isQuicklySeekable() << ", in memory " << (cacheMode == CodedAudioFileReader::CacheInMemory) << ", creating decoding reader" << endl;
#endif
            
            delete reader;
            reader = new DecodingWavFileReader
                (source,
                 decodeMode, cacheMode,
                 targetRate ? targetRate : fileRate,
                 normalised,
                 reporter);
            CHECK(reader);
        }
    }
    
#ifdef HAVE_OGGZ
#ifdef HAVE_FISHSOUND
    if (!reader && OggVorbisFileReader::supports(source)) {
        reader = new OggVorbisFileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif
#endif

#ifdef HAVE_MAD
    if (!reader && MP3FileReader::supports(source)) {
        reader = new MP3FileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif

#ifdef HAVE_QUICKTIME
    if (!reader && QuickTimeFileReader::supports(source)) {
        reader = new QuickTimeFileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif

#ifdef HAVE_COREAUDIO
    if (!reader && CoreAudioFileReader::supports(source)) {
        reader = new CoreAudioFileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif

    if (reader) {
        // The happy case: a reader recognised the file extension &
        // succeeded in opening the file
        return reader;
    }
    
    // If none of the readers claimed to support this file extension,
    // perhaps the extension is missing or misleading.  Try again,
    // ignoring it.  We have to be confident that the reader won't
    // open just any old text file or whatever and pretend it's
    // succeeded

    reader = new WavFileReader(source);

    sv_samplerate_t fileRate = reader->getSampleRate();

    if (reader->isOK() &&
        (!reader->isQuicklySeekable() ||
         normalised ||
         (cacheMode == CodedAudioFileReader::CacheInMemory) ||
         (targetRate != 0 && fileRate != targetRate))) {

#ifdef DEBUG_AUDIO_FILE_READER_FACTORY
        cerr << "AudioFileReaderFactory::createReader: WAV file rate: " << reader->getSampleRate() << ", normalised " << normalised << ", seekable " << reader->isQuicklySeekable() << ", in memory " << (cacheMode == CodedAudioFileReader::CacheInMemory) << ", creating decoding reader" << endl;
#endif

        delete reader;
        reader = new DecodingWavFileReader
            (source,
             decodeMode, cacheMode,
             targetRate ? targetRate : fileRate,
             normalised,
             reporter);
    }

    CHECK(reader);
    
#ifdef HAVE_OGGZ
#ifdef HAVE_FISHSOUND
    if (!reader) {
        reader = new OggVorbisFileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif
#endif

#ifdef HAVE_MAD
    if (!reader) {
        reader = new MP3FileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif

#ifdef HAVE_QUICKTIME
    if (!reader) {
        reader = new QuickTimeFileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif

#ifdef HAVE_COREAUDIO
    if (!reader) {
        reader = new CoreAudioFileReader
            (source, decodeMode, cacheMode, targetRate, normalised, reporter);
        CHECK(reader);
    }
#endif

    if (!reader) {
        cerr << "AudioFileReaderFactory::Failed to create a reader for "
             << "url \"" << source.getLocation()
             << "\" (content type \""
             << source.getContentType() << "\")" << endl;
        return nullptr;
    }
    
    return reader;
}