sox_source.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019 Roc Streaming authors
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
 
//! @file roc_sndio/target_sox/roc_sndio/sox_source.h
//! @brief SoX source.
 
#ifndef ROC_SNDIO_SOX_SOURCE_H_
#define ROC_SNDIO_SOX_SOURCE_H_
 
#include <sox.h>
 
#include "roc_audio/sample_spec.h"
#include "roc_core/array.h"
#include "roc_core/iarena.h"
#include "roc_core/noncopyable.h"
#include "roc_core/stddefs.h"
#include "roc_core/string_buffer.h"
#include "roc_packet/units.h"
#include "roc_sndio/config.h"
#include "roc_sndio/isource.h"
 
namespace roc {
namespace sndio {
 
//! SoX source.
//! @remarks
//!  Reads samples from input file or device.
//!  Supports multiple drivers for different file types and audio systems.
class SoxSource : public ISource, private core::NonCopyable<> {
public:
    //! Initialize.
    SoxSource(core::IArena& arena, const Config& config);
 
    virtual ~SoxSource();
 
    //! Check if the object was successfully constructed.
    bool is_valid() const;
 
    //! Open input file or device.
    //!
    //! @b Parameters
    //!  - @p driver is input driver name;
    //!  - @p path is input file or device name, "-" for stdin.
    //!
    //! @remarks
    //!  If @p driver or @p path are NULL, defaults are used.
    bool open(const char* driver, const char* path);
 
    //! Get device type.
    virtual DeviceType type() const;
 
    //! Get device state.
    virtual DeviceState state() const;
 
    //! Pause reading.
    virtual void pause();
 
    //! Resume paused reading.
    virtual bool resume();
 
    //! Restart reading from the beginning.
    virtual bool restart();
 
    //! Get sample specification of the source.
    virtual audio::SampleSpec sample_spec() const;
 
    //! Get latency of the source.
    virtual core::nanoseconds_t latency() const;
 
    //! Check if the source supports latency reports.
    virtual bool has_latency() const;
 
    //! Check if the source has own clock.
    virtual bool has_clock() const;
 
    //! Adjust source clock to match consumer clock.
    virtual void reclock(core::nanoseconds_t timestamp);
 
    //! Read frame.
    virtual bool read(audio::Frame&);
 
private:
    bool setup_names_(const char* driver, const char* path);
    bool setup_buffer_();
 
    bool open_();
    void close_();
 
    bool seek_(uint64_t offset);
 
    core::StringBuffer driver_name_;
    core::StringBuffer input_name_;
 
    core::Array<sox_sample_t> buffer_;
    size_t buffer_size_;
    core::nanoseconds_t frame_length_;
    audio::SampleSpec sample_spec_;
 
    sox_format_t* input_;
    sox_signalinfo_t in_signal_;
 
    bool is_file_;
    bool eof_;
    bool paused_;
    bool valid_;
};
 
} // namespace sndio
} // namespace roc
 
#endif // ROC_SNDIO_SOX_SOURCE_H_