blob: 4176b5adead2a8a24b56b2c8bea2cd23819294da [file] [log] [blame]
Jean-Michel Trivi04c1e532012-03-02 10:59:56 -08001/*
2 * Copyright (C) 2012 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef ANDROID_EFFECTDOWNMIX_H_
18#define ANDROID_EFFECTDOWNMIX_H_
19
20#include <audio_effects/effect_downmix.h>
21#include <audio_utils/primitives.h>
22#include <system/audio.h>
23
24/*------------------------------------
25 * definitions
26 *------------------------------------
27*/
28
29#define DOWNMIX_OUTPUT_CHANNELS AUDIO_CHANNEL_OUT_STEREO
30
31typedef enum {
32 DOWNMIX_STATE_UNINITIALIZED,
33 DOWNMIX_STATE_INITIALIZED,
34 DOWNMIX_STATE_ACTIVE,
35} downmix_state_t;
36
37/* parameters for each downmixer */
38typedef struct {
39 downmix_state_t state;
40 downmix_type_t type;
41 bool apply_volume_correction;
42 uint8_t input_channel_count;
43} downmix_object_t;
44
45
46typedef struct downmix_module_s {
47 const struct effect_interface_s *itfe;
48 effect_config_t config;
49 downmix_object_t context;
50} downmix_module_t;
51
52
53/*------------------------------------
54 * Effect API
55 *------------------------------------
56*/
57int32_t DownmixLib_QueryNumberEffects(uint32_t *pNumEffects);
58int32_t DownmixLib_QueryEffect(uint32_t index,
59 effect_descriptor_t *pDescriptor);
60int32_t DownmixLib_Create(const effect_uuid_t *uuid,
61 int32_t sessionId,
62 int32_t ioId,
63 effect_handle_t *pHandle);
64int32_t DownmixLib_Release(effect_handle_t handle);
65int32_t DownmixLib_GetDescriptor(const effect_uuid_t *uuid,
66 effect_descriptor_t *pDescriptor);
67
68static int Downmix_Process(effect_handle_t self,
69 audio_buffer_t *inBuffer,
70 audio_buffer_t *outBuffer);
71static int Downmix_Command(effect_handle_t self,
72 uint32_t cmdCode,
73 uint32_t cmdSize,
74 void *pCmdData,
75 uint32_t *replySize,
76 void *pReplyData);
77static int Downmix_GetDescriptor(effect_handle_t self,
78 effect_descriptor_t *pDescriptor);
79
80
81/*------------------------------------
82 * internal functions
83 *------------------------------------
84*/
85int Downmix_Init(downmix_module_t *pDwmModule);
86int Downmix_Configure(downmix_module_t *pDwmModule, effect_config_t *pConfig, bool init);
87int Downmix_Reset(downmix_object_t *pDownmixer, bool init);
88int Downmix_setParameter(downmix_object_t *pDownmixer, int32_t param, size_t size, void *pValue);
89int Downmix_getParameter(downmix_object_t *pDownmixer, int32_t param, size_t *pSize, void *pValue);
90
91void Downmix_foldFromQuad(int16_t *pSrc, int16_t*pDst, size_t numFrames, bool accumulate);
92void Downmix_foldFromSurround(int16_t *pSrc, int16_t*pDst, size_t numFrames, bool accumulate);
93void Downmix_foldFrom5Point1(int16_t *pSrc, int16_t*pDst, size_t numFrames, bool accumulate);
94void Downmix_foldFrom7Point1(int16_t *pSrc, int16_t*pDst, size_t numFrames, bool accumulate);
95
96#endif /*ANDROID_EFFECTDOWNMIX_H_*/