diff options
Diffstat (limited to 'src/VBox/Devices/Audio/AudioMixBuffer.h')
| -rw-r--r-- | src/VBox/Devices/Audio/AudioMixBuffer.h | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/src/VBox/Devices/Audio/AudioMixBuffer.h b/src/VBox/Devices/Audio/AudioMixBuffer.h new file mode 100644 index 00000000..f2c77688 --- /dev/null +++ b/src/VBox/Devices/Audio/AudioMixBuffer.h @@ -0,0 +1,93 @@ +/* $Id: AudioMixBuffer.h $ */ +/** @file + * Audio Mixing bufer convert audio samples to/from different rates / formats. + */ + +/* + * Copyright (C) 2014-2019 Oracle Corporation + * + * This file is part of VirtualBox Open Source Edition (OSE), as + * available from http://www.virtualbox.org. This file is free software; + * you can redistribute it and/or modify it under the terms of the GNU + * General Public License (GPL) as published by the Free Software + * Foundation, in version 2 as it comes in the "COPYING" file of the + * VirtualBox OSE distribution. VirtualBox OSE is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. + */ + +#ifndef VBOX_INCLUDED_SRC_Audio_AudioMixBuffer_h +#define VBOX_INCLUDED_SRC_Audio_AudioMixBuffer_h +#ifndef RT_WITHOUT_PRAGMA_ONCE +# pragma once +#endif + +#include <iprt/cdefs.h> +#include <VBox/vmm/pdmaudioifs.h> + +/** Constructs 32 bit value for given frequency, number of channels, bits per sample and signed bit. + * Note: This currently matches 1:1 the VRDE encoding -- this might change in the future, so better don't rely on this fact! */ +#define AUDMIXBUF_AUDIO_FMT_MAKE(freq, c, bps, s) ((((s) & 0x1) << 28) + (((bps) & 0xFF) << 20) + (((c) & 0xF) << 16) + ((freq) & 0xFFFF)) + +/** Decodes frequency (Hz). */ +#define AUDMIXBUF_FMT_SAMPLE_FREQ(a) ((a) & 0xFFFF) +/** Decodes number of channels. */ +#define AUDMIXBUF_FMT_CHANNELS(a) (((a) >> 16) & 0xF) +/** Decodes signed bit. */ +#define AUDMIXBUF_FMT_SIGNED(a) (((a) >> 28) & 0x1) +/** Decodes number of bits per sample. */ +#define AUDMIXBUF_FMT_BITS_PER_SAMPLE(a) (((a) >> 20) & 0xFF) +/** Decodes number of bytes per sample. */ +#define AUDMIXBUF_FMT_BYTES_PER_SAMPLE(a) ((AUDMIXBUF_AUDIO_FMT_BITS_PER_SAMPLE(a) + 7) / 8) + +/** Converts frames to bytes. */ +#define AUDIOMIXBUF_F2B(pBuf, frames) ((frames) << (pBuf)->cShift) +/** Converts frames to bytes, respecting the conversion ratio to + * a linked buffer. */ +#define AUDIOMIXBUF_F2B_RATIO(pBuf, frames) ((((int64_t) frames << 32) / (pBuf)->iFreqRatio) << (pBuf)->cShift) +/** Converts bytes to frames, *not* taking the conversion ratio + * into account. */ +#define AUDIOMIXBUF_B2F(pBuf, cb) (cb >> (pBuf)->cShift) +/** Converts number of frames according to the buffer's ratio. */ +#define AUDIOMIXBUF_F2F_RATIO(pBuf, frames) (((int64_t) frames << 32) / (pBuf)->iFreqRatio) + + +inline uint32_t AudioMixBufBytesToSamples(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufClear(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufDestroy(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufFinish(PPDMAUDIOMIXBUF pMixBuf, uint32_t cFramesToClear); +uint32_t AudioMixBufFree(PPDMAUDIOMIXBUF pMixBuf); +uint32_t AudioMixBufFreeBytes(PPDMAUDIOMIXBUF pMixBuf); +int AudioMixBufInit(PPDMAUDIOMIXBUF pMixBuf, const char *pszName, PPDMAUDIOPCMPROPS pProps, uint32_t cFrames); +bool AudioMixBufIsEmpty(PPDMAUDIOMIXBUF pMixBuf); +int AudioMixBufLinkTo(PPDMAUDIOMIXBUF pMixBuf, PPDMAUDIOMIXBUF pParent); +uint32_t AudioMixBufLive(PPDMAUDIOMIXBUF pMixBuf); +int AudioMixBufMixToParent(PPDMAUDIOMIXBUF pMixBuf, uint32_t cSrcFrames, uint32_t *pcSrcMixed); +int AudioMixBufMixToParentEx(PPDMAUDIOMIXBUF pMixBuf, uint32_t cSrcOffset, uint32_t cSrcFrames, uint32_t *pcSrcMixed); +int AudioMixBufPeek(PPDMAUDIOMIXBUF pMixBuf, uint32_t cFramesToRead, PPDMAUDIOFRAME paSampleBuf, uint32_t cSampleBuf, uint32_t *pcFramesRead); +int AudioMixBufPeekMutable(PPDMAUDIOMIXBUF pMixBuf, uint32_t cFramesToRead, PPDMAUDIOFRAME *ppvSamples, uint32_t *pcFramesRead); +uint32_t AudioMixBufUsed(PPDMAUDIOMIXBUF pMixBuf); +uint32_t AudioMixBufUsedBytes(PPDMAUDIOMIXBUF pMixBuf); +int AudioMixBufReadAt(PPDMAUDIOMIXBUF pMixBuf, uint32_t offSamples, void *pvBuf, uint32_t cbBuf, uint32_t *pcbRead); +int AudioMixBufReadAtEx(PPDMAUDIOMIXBUF pMixBuf, PDMAUDIOMIXBUFFMT enmFmt, uint32_t offSamples, void *pvBuf, uint32_t cbBuf, uint32_t *pcbRead); +int AudioMixBufAcquireReadBlock(PPDMAUDIOMIXBUF pMixBuf, void *pvBuf, uint32_t cbBuf, uint32_t *pcBlock); +int AudioMixBufAcquireReadBlockEx(PPDMAUDIOMIXBUF pMixBuf, PDMAUDIOMIXBUFFMT enmFmt, void *pvBuf, uint32_t cbBuf, uint32_t *pcBlock); +void AudioMixBufReleaseReadBlock(PPDMAUDIOMIXBUF pMixBuf, uint32_t cBlock); +uint32_t AudioMixBufReadPos(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufReset(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufSetVolume(PPDMAUDIOMIXBUF pMixBuf, PPDMAUDIOVOLUME pVol); +uint32_t AudioMixBufSize(PPDMAUDIOMIXBUF pMixBuf); +uint32_t AudioMixBufSizeBytes(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufUnlink(PPDMAUDIOMIXBUF pMixBuf); +int AudioMixBufWriteAt(PPDMAUDIOMIXBUF pMixBuf, uint32_t offSamples, const void *pvBuf, uint32_t cbBuf, uint32_t *pcWritten); +int AudioMixBufWriteAtEx(PPDMAUDIOMIXBUF pMixBuf, PDMAUDIOMIXBUFFMT enmFmt, uint32_t offSamples, const void *pvBuf, uint32_t cbBuf, uint32_t *pcWritten); +int AudioMixBufWriteCirc(PPDMAUDIOMIXBUF pMixBuf, const void *pvBuf, uint32_t cbBuf, uint32_t *pcWritten); +int AudioMixBufWriteCircEx(PPDMAUDIOMIXBUF pMixBuf, PDMAUDIOMIXBUFFMT enmFmt, const void *pvBuf, uint32_t cbBuf, uint32_t *pcWritten); +uint32_t AudioMixBufWritePos(PPDMAUDIOMIXBUF pMixBuf); + +#ifdef DEBUG +void AudioMixBufDbgPrint(PPDMAUDIOMIXBUF pMixBuf); +void AudioMixBufDbgPrintChain(PPDMAUDIOMIXBUF pMixBuf); +#endif + +#endif /* !VBOX_INCLUDED_SRC_Audio_AudioMixBuffer_h */ + |