/* * Copyright (C) 2025 Linux Studio Plugins Project * (C) 2025 Vladimir Sadovnikov * * This file is part of lsp-runtime-lib * Created on: 16 апр. 2020 г. * * lsp-runtime-lib is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation, either version 3 of the License, or * any later version. * * lsp-runtime-lib 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 Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with lsp-runtime-lib. If not, see . */ #ifndef LSP_PLUG_IN_MM_IOUTAUDIOSTREAM_H_ #define LSP_PLUG_IN_MM_IOUTAUDIOSTREAM_H_ #include #include #include namespace lsp { namespace mm { class IOutAudioStream { public: static const size_t IO_BUF_SIZE = 0x1000; protected: wssize_t nOffset; // Offset from beginning, negative if closed status_t nErrorCode; // Last error code uint8_t *pBuffer; // Buffer for sample format conversion size_t nBufSize; // Size of buffer audio_stream_t sFormat; // Audio stream format void *pUserData; // User data user_data_deleter_t pDeleter; // User data deleter protected: void do_close(); inline status_t set_error(status_t error) { return nErrorCode = error; } /** * Ensure that internal buffer has enough capacity to keep specified number of bytes * @param bytes number of bytes * @return status of operation */ status_t ensure_capacity(size_t bytes); /** * Perform direct write of sample data * * @param src buffer with frame data. * @param nframes number of frames to write * @param fmt actual sample format that should be written * @return number of frames actually written or negative error code */ virtual ssize_t direct_write(const void *src, size_t nframes, size_t fmt); /** * Perform write with conversion * @param src source buffer with frame data * @param nframes number of frames to write * @param fmt sample format * @return status if operation */ virtual ssize_t conv_write(const void *src, size_t nframes, size_t fmt); /** * Select preferred sample format depending on the actual sample format * @param rfmt requested format * @return preferred sample format, by default 0 (unsupported format) */ virtual size_t select_format(size_t rfmt); public: explicit IOutAudioStream(); IOutAudioStream (const IOutAudioStream &) = delete; IOutAudioStream (IOutAudioStream &&) = delete; virtual ~IOutAudioStream(); IOutAudioStream & operator = (const IOutAudioStream &) = delete; IOutAudioStream & operator = (IOutAudioStream &&) = delete; public: /** * Check whether audio stream is closed * @return true if audio stream is closed */ inline bool is_closed() const { return nOffset < 0; } /** Get last I/O error code * * @return last I/O error code */ inline status_t last_error() const { return nErrorCode; }; /** * Obtain the information about audio stream * @param dst destination to store the audio stream information * @return status of operation */ status_t info(audio_stream_t *dst) const; /** * Get sample rate * @return sample rate */ inline size_t sample_rate() const { return sFormat.srate; } /** * Get number of channels * @return number of channels */ inline size_t channels() const { return sFormat.channels; } /** * Get overall duration * @return overall number of frames available in audio stream, * negative if number of frames can not be estimated */ inline wssize_t length() const { return sFormat.frames; } /** * Get sample format * @return sample format */ inline size_t format() const { return sFormat.format; } /** * Flush audio stream * @return status of operations */ virtual status_t flush(); /** * Close audio stream * @return status of operations */ virtual status_t close(); /** * Get actual position in frames from beginning of the stream * @return number of frames from beginning of the stream or negative error code */ virtual wssize_t position(); /** * Try to seek stream at the specified position * @return actual position in frames from beginnin of the stream * or negative error code on error (STATUS_NOT_SUPPORTED if stream * positioning is not supported) */ virtual wssize_t seek(wsize_t nframes); /** * Different reads * @param dst destination buffer to perform read * @param nframes number of frames to read * @return number of frames actually read or negative status fo operation */ virtual ssize_t write(const uint8_t *dst, size_t nframes); virtual ssize_t write(const int8_t *dst, size_t nframes); virtual ssize_t write(const uint16_t *dst, size_t nframes); virtual ssize_t write(const int16_t *dst, size_t nframes); virtual ssize_t write(const uint32_t *dst, size_t nframes); virtual ssize_t write(const int32_t *dst, size_t nframes); virtual ssize_t write(const f32_t *dst, size_t nframes); virtual ssize_t write(const f64_t *dst, size_t nframes); /** * Strict type reads * @param dst destination buffer to perform read * @param nframes number of frames to read */ inline ssize_t write_u8(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_s8(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_u16(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_s16(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_u32(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_s32(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_f32(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } inline ssize_t write_f64(const void *dst, size_t nframes) { return write(static_cast(dst), nframes); } public: /** * Set user data. If previous user data has been set, it will be removed * if the deleter was provided * @param data data to set * @param deleter deleter to remove the data */ void set_user_data(void *data, user_data_deleter_t deleter = NULL); /** Get user data * @return user data currently bound to the object */ inline void *user_data() { return pUserData; } }; } /* namespace mm */ } /* namespace lsp */ #endif /* LSP_PLUG_IN_MM_IOUTAUDIOSTREAM_H_ */