decoder.hpp

Go to the documentation of this file.

/*
* eDSP, A cross-platform Digital Signal Processing library written in modern C++.
* Copyright (C) 2018 Mohammed Boujemaoui Boulaghmoudi, All rights reserved.
*
* 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 3 of the License, or (at your option)
* any later version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along width
* this program.  If not, see <http://www.gnu.org/licenses/>
*
* Filename: decoder.hpp
* Author: Mohammed Boujemaoui
* Date: 07/10/18
*/

#ifndef EDSP_DECODER_HPP
#define EDSP_DECODER_HPP

#include <edsp/types/string_view.hpp>
#include <edsp/io/internal/codec/decoder_impl.hpp>

namespace edsp { namespace io {

    template <typename T, std::size_t N = 1024>
    class decoder {
    public:
        using index_type = std::ptrdiff_t;
        using value_type = T;

        explicit decoder() = default;
        ~decoder()         = default;

        bool open(const edsp::string_view& file_path) {
            return impl_.open(file_path);
        }

        void close() {
            impl_.close();
        }

        bool is_open() const noexcept {
            return impl_.is_open();
        }

        index_type samples() const noexcept {
            return impl_.samples();
        }

        /*
         * @brief Returns the number of frames in the audio file.
         *
         * Each sample frame of audio consists of a fixed number of samples (equal to the number of audio channels in
         * the track. For monaural data, a sample frame consists of one audio sample. For stereophonic data, a sample
         * frame consists of a stereo pair.
         *
         * @returns Number of frames in the audio file.
         */
        index_type frames() const noexcept {
            return impl_.frames();
        }

        index_type channels() const noexcept {
            return impl_.channels();
        }

        double duration() const noexcept {
            return impl_.duration();
        }

        double samplerate() const noexcept {
            return impl_.samplerate();
        }

        bool seekable() const noexcept {
            return impl_.seekable();
        }

        index_type seek(index_type position) noexcept {
            return impl_.seek(position);
        }

        index_type current() const noexcept {
            return impl_.current();
        }

        template <typename OutputIt>
        index_type read(OutputIt d_first, OutputIt d_last) {
            return impl_.read(d_first, d_last);
        }

    private:
        decoder_impl<T, N> impl_;
    };
}} // namespace edsp::io

#endif //EDSP_DECODER_HPP