341 lines
11 KiB
C
341 lines
11 KiB
C
/***************************************************************************\
|
|
*
|
|
* (C) copyright Fraunhofer - IIS (2001)
|
|
* All Rights Reserved
|
|
*
|
|
* $Header: /cvs/root/winamp/aacdec/incs/mp4dec_helpers/cubuffer_c.h,v 1.3 2012/05/08 20:16:50 audiodsp Exp $
|
|
* project : MPEG-4 Audio Decoder
|
|
* contents/description: composition unit module public interface
|
|
*
|
|
* This software and/or program is protected by copyright law and
|
|
* international treaties. Any reproduction or distribution of this
|
|
* software and/or program, or any portion of it, may result in severe
|
|
* civil and criminal penalties, and will be prosecuted to the maximum
|
|
* extent possible under law.
|
|
*
|
|
\***************************************************************************/
|
|
|
|
#ifndef __CUBUFFER_C_H__
|
|
#define __CUBUFFER_C_H__
|
|
|
|
#include "mp4dec_helpers/err_code.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum {
|
|
CUBUFFER_MAXCHANNELS = 100,
|
|
CUBUFFER_MAXSAMPLESPERCHANNEL = 8192,
|
|
CUBUFFER_MAXANCBYTES = 65536
|
|
} __cubuffer_constants;
|
|
|
|
|
|
typedef enum {
|
|
CUBUFFER_PCMTYPE_FLOAT = 0x55,
|
|
CUBUFFER_PCMTYPE_INT32,
|
|
CUBUFFER_PCMTYPE_INT24,
|
|
/* CUBUFFER_PCMTYPE_INT20, */
|
|
CUBUFFER_PCMTYPE_INT16
|
|
/* ,CUBUFFER_PCMTYPE_INT8 */
|
|
} CUBUFFER_PCMTYPE;
|
|
|
|
typedef enum {
|
|
ANCDATA_IS_INVALID = 0x00, /* default after calloc */
|
|
|
|
ANCDATA_IS_COMPLETE_MP2FRAME,
|
|
ANCDATA_IS_MP2ANCILLARYDATA,
|
|
ANCDATA_IS_MP3ANCILLARYDATA,
|
|
ANCDATA_IS_MP3SCF,
|
|
ANCDATA_IS_MPEGS_AU,
|
|
|
|
ANCDATA_IS_AAC_EXT_DRC,
|
|
ANCDATA_IS_AAC_EXT_SAC,
|
|
ANCDATA_IS_AAC_EXT_LDSAC,
|
|
ANCDATA_IS_AAC_EXT_SAOC,
|
|
ANCDATA_IS_AAC_EXT_SCESBR,
|
|
ANCDATA_IS_AAC_EXT_CPESBR,
|
|
ANCDATA_IS_AAC_EXT_SCESBRCRC,
|
|
ANCDATA_IS_AAC_EXT_CPESBRCRC,
|
|
ANCDATA_IS_AAC_ELD_SCESBR,
|
|
ANCDATA_IS_AAC_ELD_CPESBR,
|
|
ANCDATA_IS_AAC_ELD_SCESBRCRC,
|
|
ANCDATA_IS_AAC_ELD_CPESBRCRC,
|
|
ANCDATA_IS_AAC_EXT_FILLDATA, /* is always 10100101 */
|
|
ANCDATA_IS_AAC_EXT_DATAELEMENT_ANCDATA,
|
|
ANCDATA_IS_AAC_EXT_DATAELEMENT_DEFAULT,
|
|
ANCDATA_IS_AAC_EXT_FIL,
|
|
ANCDATA_IS_AAC_EXT_DEFAULT,
|
|
|
|
ANCDATA_IS_AAC_DSE_TAG0 = 0x80,
|
|
ANCDATA_IS_AAC_DSE_TAG1,
|
|
ANCDATA_IS_AAC_DSE_TAG2,
|
|
ANCDATA_IS_AAC_DSE_TAG3,
|
|
ANCDATA_IS_AAC_DSE_TAG4,
|
|
ANCDATA_IS_AAC_DSE_TAG5,
|
|
ANCDATA_IS_AAC_DSE_TAG6,
|
|
ANCDATA_IS_AAC_DSE_TAG7,
|
|
ANCDATA_IS_AAC_DSE_TAG8,
|
|
ANCDATA_IS_AAC_DSE_TAG9,
|
|
ANCDATA_IS_AAC_DSE_TAG10,
|
|
ANCDATA_IS_AAC_DSE_TAG11,
|
|
ANCDATA_IS_AAC_DSE_TAG12,
|
|
ANCDATA_IS_AAC_DSE_TAG13,
|
|
ANCDATA_IS_AAC_DSE_TAG14,
|
|
ANCDATA_IS_AAC_DSE_TAG15,
|
|
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG0 = 0x90,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG1,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG2,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG3,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG4,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG5,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG6,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG7,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG8,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG9,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG10,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG11,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG12,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG13,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG14,
|
|
ANCDATA_IS_AAC_PCE_COMMENTFIELD_TAG15,
|
|
|
|
ANCDATA_IS_INCOMPLETE = 0x0fd,
|
|
BUFFER_IS_TOOSMALL_WITH_CLIPPED_DATA = 0xfe,
|
|
BUFFER_IS_TOOSMALL_NOMORE_DATA = 0x0ff
|
|
} __cubuffer_ancDataBufTags;
|
|
|
|
|
|
typedef enum {
|
|
CUBUFFER_CHANNEL_IS_INVALID = 0x0000, /* default after init/calloc */ /* todo: we shouldn't name this INVALID, but DEFAULT or NOT_MAPPED or so ... */
|
|
|
|
CUBUFFER_CHANNEL_IS_NOTMAPPED = 0x0001, /* a valid pcm channel is here, but could not be mapped to a valid position */
|
|
CUBUFFER_CHANNEL_IS_ELSEWHERE, /* position is out of z-plane */
|
|
|
|
CUBUFFER_CHANNEL_IS_CENTER = 0x0008,
|
|
CUBUFFER_CHANNEL_IS_REARCENTER,
|
|
|
|
CUBUFFER_CHANNEL_IS_LEFT0 = 0x0010,
|
|
CUBUFFER_CHANNEL_IS_LEFT1,
|
|
CUBUFFER_CHANNEL_IS_LEFT2,
|
|
CUBUFFER_CHANNEL_IS_LEFT3,
|
|
CUBUFFER_CHANNEL_IS_LEFT4,
|
|
CUBUFFER_CHANNEL_IS_LEFT5,
|
|
CUBUFFER_CHANNEL_IS_LEFT6,
|
|
CUBUFFER_CHANNEL_IS_LEFT7,
|
|
CUBUFFER_CHANNEL_IS_LEFT8,
|
|
CUBUFFER_CHANNEL_IS_LEFT9,
|
|
CUBUFFER_CHANNEL_IS_LEFT10,
|
|
CUBUFFER_CHANNEL_IS_LEFT11,
|
|
CUBUFFER_CHANNEL_IS_LEFT12,
|
|
CUBUFFER_CHANNEL_IS_LEFT13,
|
|
CUBUFFER_CHANNEL_IS_LEFT14,
|
|
CUBUFFER_CHANNEL_IS_LEFT15,
|
|
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE0 = 0x0020,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE1,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE2,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE3,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE4,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE5,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE6,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE7,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE8,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE9,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE10,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE11,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE12,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE13,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE14,
|
|
CUBUFFER_CHANNEL_IS_LEFTSIDE15,
|
|
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK0 = 0x0030,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK1,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK2,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK3,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK4,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK5,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK6,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK7,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK8,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK9,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK10,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK11,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK12,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK13,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK14,
|
|
CUBUFFER_CHANNEL_IS_LEFTBACK15,
|
|
|
|
CUBUFFER_CHANNEL_IS_RIGHT0 = 0x0050,
|
|
CUBUFFER_CHANNEL_IS_RIGHT1,
|
|
CUBUFFER_CHANNEL_IS_RIGHT2,
|
|
CUBUFFER_CHANNEL_IS_RIGHT3,
|
|
CUBUFFER_CHANNEL_IS_RIGHT4,
|
|
CUBUFFER_CHANNEL_IS_RIGHT5,
|
|
CUBUFFER_CHANNEL_IS_RIGHT6,
|
|
CUBUFFER_CHANNEL_IS_RIGHT7,
|
|
CUBUFFER_CHANNEL_IS_RIGHT8,
|
|
CUBUFFER_CHANNEL_IS_RIGHT9,
|
|
CUBUFFER_CHANNEL_IS_RIGHT10,
|
|
CUBUFFER_CHANNEL_IS_RIGHT11,
|
|
CUBUFFER_CHANNEL_IS_RIGHT12,
|
|
CUBUFFER_CHANNEL_IS_RIGHT13,
|
|
CUBUFFER_CHANNEL_IS_RIGHT14,
|
|
CUBUFFER_CHANNEL_IS_RIGHT15,
|
|
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE0 = 0x0060,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE1,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE2,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE3,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE4,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE5,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE6,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE7,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE8,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE9,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE10,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE11,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE12,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE13,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE14,
|
|
CUBUFFER_CHANNEL_IS_RIGHTSIDE15,
|
|
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK0 = 0x0070,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK1,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK2,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK3,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK4,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK5,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK6,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK7,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK8,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK9,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK10,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK11,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK12,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK13,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK14,
|
|
CUBUFFER_CHANNEL_IS_RIGHTBACK15,
|
|
|
|
CUBUFFER_CHANNEL_IS_SUB0 = 0x0090,
|
|
CUBUFFER_CHANNEL_IS_SUB1,
|
|
CUBUFFER_CHANNEL_IS_SUB2,
|
|
CUBUFFER_CHANNEL_IS_SUB3,
|
|
CUBUFFER_CHANNEL_IS_SUB4,
|
|
CUBUFFER_CHANNEL_IS_SUB5,
|
|
CUBUFFER_CHANNEL_IS_SUB6,
|
|
CUBUFFER_CHANNEL_IS_SUB7,
|
|
CUBUFFER_CHANNEL_IS_SUB8,
|
|
CUBUFFER_CHANNEL_IS_SUB9,
|
|
CUBUFFER_CHANNEL_IS_SUB10,
|
|
CUBUFFER_CHANNEL_IS_SUB11,
|
|
CUBUFFER_CHANNEL_IS_SUB12,
|
|
CUBUFFER_CHANNEL_IS_SUB13,
|
|
CUBUFFER_CHANNEL_IS_SUB14,
|
|
CUBUFFER_CHANNEL_IS_SUB15,
|
|
|
|
CUBUFFER_CHANNELMAPPING_LAST_ELEMENT
|
|
} __cubuffer_channelMappingTagTypes;
|
|
|
|
|
|
typedef enum {
|
|
CUBUFFER_INVALID_VALUE = -1,
|
|
|
|
__cubuffer_flags_start = 10000,
|
|
CUBUFFER_VALIDCHANNELS,
|
|
CUBUFFER_CHANNELSMAPPED,
|
|
CUBUFFER_VALIDSAMPLES,
|
|
CUBUFFER_SAMPLERATE,
|
|
CUBUFFER_NROFLAYERS,
|
|
CUBUFFER_CURRENTBITRATE,
|
|
CUBUFFER_AVGBITRATE,
|
|
CUBUFFER_DECODERDELAY,
|
|
/* CUBUFFER_TIMESTAMP, */
|
|
CUBUFFER_PCMTYPE_PROP,
|
|
|
|
CUBUFFER_HAS_SBR,
|
|
CUBUFFER_HAS_PS,
|
|
CUBUFFER_HAS_EBCC,
|
|
CUBUFFER_HAS_MPEG_SURROUND,
|
|
CUBUFFER_HAS_BLINDUPMIX,
|
|
/* CUBUFFER_HAS_IMPLICIT, */
|
|
|
|
/* CUBUFFER_CONFIGCHANGED, */
|
|
CUBUFFER_WAS_CONCEALED,
|
|
CUBUFFER_TDL_GAINREDUCTION,
|
|
CUBUFFER_IS_LOSSLESS,
|
|
CUBUFFER_HAS_BEEP,
|
|
CUBUFFER_HAS_SBRSYNCPOINT,
|
|
|
|
|
|
/* special property: warning/message. All warnings and messages are or'd with CUBUFFER_MESSAGE */
|
|
CUBUFFER_MESSAGE = 0x8000000,
|
|
|
|
__cubuffer_flags_end
|
|
} __cubuffer_properties;
|
|
|
|
|
|
|
|
#if defined(WIN32) || defined(WIN64)
|
|
#pragma pack(push, 8)
|
|
#endif
|
|
|
|
|
|
/* Opaque declaration of cubuffer handle */
|
|
struct CCompositionUnit;
|
|
typedef struct CCompositionUnit* CCompositionUnitPtr;
|
|
|
|
|
|
/* mandatory interface */
|
|
CCompositionUnitPtr MP4AUDIODECAPI CCompositionUnit_Create(
|
|
const unsigned int channels,
|
|
const unsigned int samplesPerChannel,
|
|
const unsigned int samplingRate,
|
|
const unsigned int sizeAncData,
|
|
const CUBUFFER_PCMTYPE cutype
|
|
);
|
|
|
|
CCompositionUnitPtr MP4AUDIODECAPI CCompositionUnit_CreateExt(
|
|
const unsigned int channels,
|
|
const unsigned int samplesPerChannel,
|
|
const unsigned int samplingRate,
|
|
const unsigned int sizeAncData,
|
|
const CUBUFFER_PCMTYPE pcmtype,
|
|
void* pcmBuf,
|
|
const unsigned int pcmBufSize
|
|
);
|
|
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_Destroy(CCompositionUnitPtr *self);
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_Reset(CCompositionUnitPtr self);
|
|
|
|
/* for signalling channel mapping of the (interleaved) pcm output channels */
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetChannelMapping(CCompositionUnitPtr self, const unsigned int channelNr, unsigned int* tag);
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetInvChannelMapping(CCompositionUnitPtr self, const unsigned int tagType, unsigned int* channel);
|
|
|
|
/* anc data handling */
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetAncDataCount(CCompositionUnitPtr self, unsigned int* nFields, unsigned int* nBytes);
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetAncDataByPos(CCompositionUnitPtr self, const unsigned int nr, unsigned char** ptr, unsigned int* size, unsigned int* tag);
|
|
|
|
/* retrieve cu-buffer parameters */
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetChannels(CCompositionUnitPtr self, unsigned int* nchannels);
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetSamplesPerChannel(CCompositionUnitPtr self, unsigned int* samplesPerChannel);
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetSamplingRate(CCompositionUnitPtr self, unsigned int* fs);
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetPcmPtr(CCompositionUnitPtr self, void* buf);
|
|
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetProperty(CCompositionUnitPtr self, const unsigned int prop, int* value);
|
|
|
|
MP4_RESULT MP4AUDIODECAPI CCompositionUnit_GetNextMessage(CCompositionUnitPtr self, int* value);
|
|
|
|
|
|
#if defined(WIN32) || defined(WIN64)
|
|
#pragma pack(pop)
|
|
#endif
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __CUBUFFER_C_H__ */
|