annotate data/fileio/AudioFileReaderFactory.cpp @ 1308:80c77916fe85 mp3-gapless

Update m4a files to exports from CoreAudio, rather than FAAC; update tests accordingly, and add test for spurious data after end of decode

/* -*- 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>

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;

    SVDEBUG << "AudioFileReaderFactory::createReader(\"" << source.getLocation() << "\"): Requested rate: " << targetRate << (targetRate == 0 ? " (use source rate)" : "") << endl;

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

    if (!source.isAvailable()) {
        SVDEBUG << "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))) {

            SVDEBUG << "AudioFileReaderFactory::createReader: WAV file rate: " << reader->getSampleRate() << ", normalised " << normalised << ", seekable " << reader->isQuicklySeekable() << ", in memory " << (cacheMode == CodedAudioFileReader::CacheInMemory) << ", creating decoding reader" << endl;
            
            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, MP3FileReader::Gapless,
             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))) {

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

        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, MP3FileReader::Gapless,
             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) {
        SVDEBUG << "AudioFileReaderFactory::Failed to create a reader for "
                << "url \"" << source.getLocation()
                << "\" (content type \""
                << source.getContentType() << "\")" << endl;
        return nullptr;
    }
    
    return reader;
}