FLACFile.h

Go to the documentation of this file.

#ifndef __EO_UTILS_FLACFILE_H__
#define __EO_UTILS_FLACFILE_H__
 
#include <cstdint>
 
#include "MetadataAudioFile.h"
#include "FLACFileInfo.h"
#include "AudioFileResultType.h"
#include "EOUtils.h"
 
#include <string>
#include <fstream>
#include <vector>
 
namespace EOUtils
{
        class FLACFile : public MetadataAudioFile
        {
                public:
                        FLACFile(const std::string& pFilename);

                        FLACFile(const std::string& pFilenam, uint32_t pCompressionLevel);

                        FLACFile(const std::string& pFilename, const FLACFileInfo& pFLACFileInfo);

                        FLACFile(const std::string& pFilename, AudioFileModes pFileMode);

                        FLACFile(const FLACFile& pFLACFile);

                        FLACFile(FLACFile&& pFLACFile) noexcept;
 
                        ~FLACFile();

                        void setAudioFileInfo(const AudioFileInfo& pAudioFileInfo) override;

                        uint32_t CompressionLevel() const;

                        void CompressionLevel(uint32_t pCompressionLevel);

                        AudioFileResultType open(AudioFileModes pOpenMode) override;

                        void close() override;

                        bool isOpen() const override;

                        const FLACFileInfo& getFileInfo() const;

                        AudioFileResultType getNextSample_int64(int64_t& pAudioSample) override;

                        AudioFileResultType writeSample_int64(int64_t pAudioSample) override;

                        AudioFileResultType getHighestSampleValue_int64(int64_t& pHighestAudioSample) override;

                        AudioFileResultType goToAudioDataPos() override;

                        size_t numSamples() const override;

                        int64_t maxValueForSampleSize() const override;

                        void seekOutputToSampleNum(size_t pSampleNum) override;

                        AudioFileInfo getAudioFileInfo() const override;
 
                        // MetadataAudioFile overrides for FLAC Vorbis Comment metadata
                        AudioFileResultType setTitle(const std::string& pTitle) override;
                        AudioFileResultType setArtist(const std::string& pArtist) override;
                        AudioFileResultType setAlbum(const std::string& pAlbum) override;
                        AudioFileResultType setGenre(const std::string& pGenre) override;
                        AudioFileResultType setTrackNumber(uint32_t pTrackNumber, uint32_t pTotalTracks = 0) override;
                        AudioFileResultType setYear(const std::string& pYear) override;
                        AudioFileResultType setComment(const std::string& pComment) override;
 
                        AudioFileResultType getTitle(std::string& pTitle) const override;
                        AudioFileResultType getArtist(std::string& pArtist) const override;
                        AudioFileResultType getAlbum(std::string& pAlbum) const override;
                        AudioFileResultType getGenre(std::string& pGenre) const override;
                        AudioFileResultType getTrackNumber(uint32_t& pTrackNumber, uint32_t& pTotalTracks) const override;
                        AudioFileResultType getYear(std::string& pYear) const override;
                        AudioFileResultType getComment(std::string& pComment) const override;

                        struct DecoderClientData {
                                std::fstream* stream = nullptr;
                                FLACFileInfo* fileInfo = nullptr;
                                std::vector<std::vector<int32_t>>* readBuffer = nullptr;
                                size_t* readChannel = nullptr;
                                size_t* readSample = nullptr;
                                AudioFileResultType* result = nullptr;
                        };
 
                private:
                        FLACFileInfo mFLACFileInfo;
 
                        // FLAC decoder/encoder state (opaque pointers, avoid including FLAC headers in .h)
                        void* mDecoder = nullptr;
                        void* mEncoder = nullptr;
 
                        // Sample buffer for reading (decoder outputs frames, we output samples one-by-one)
                        // FLAC uses 32-bit signed samples; we store channels separately
                        std::vector<std::vector<int32_t>> mReadBuffer;
                        size_t mReadBufferChannel;
                        size_t mReadBufferSample;
 
                        // Write buffer for encoding (encoder expects interleaved blocks)
                        std::vector<int32_t> mWriteBuffer;
 
                        // For seeking in read mode
                        uint64_t mDecodePosition;
 
                        // Persistent client data for FLAC decoder callbacks (must outlive open())
                        DecoderClientData mDecoderClientData;
 
                        // Helpers for reading/writing FLAC Vorbis Comment metadata
                        AudioFileResultType setVorbisComment(const std::string& pTagName, const std::string& pValue);
                        AudioFileResultType getVorbisComment(const std::string& pTagName, std::string& pValue) const;
                };
}
 
#endif