1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
/*
* Copyright (c) 2017-2018, The Linux Foundation. All rights reserved.
* Not a Contribution.
*
* Copyright (C) 2011 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef QAHW_EFFECT_VIRTUALIZER_H_
#define QAHW_EFFECT_VIRTUALIZER_H_
#include <qahw_effect_api.h>
#ifdef __cplusplus
extern "C" {
#endif
#define QAHW_EFFECT_VIRTUALIZER_LIBRARY "libqcompostprocbundle.so"
static const qahw_effect_uuid_t SL_IID_VIRTUALIZER_ = { 0x37cc2c00, 0xdddd, 0x11db, 0x8577,
{ 0x00, 0x02, 0xa5, 0xd5, 0xc5, 0x1b } };
static const qahw_effect_uuid_t * const SL_IID_VIRTUALIZER = &SL_IID_VIRTUALIZER_;
static const qahw_effect_uuid_t SL_IID_VIRTUALIZER_UUID_ = { 0x509a4498, 0x561a, 0x4bea, 0xb3b1,
{ 0x00, 0x02, 0xa5, 0xd5, 0xc5, 0x1b } };
static const qahw_effect_uuid_t * const SL_IID_VIRTUALIZER_UUID = &SL_IID_VIRTUALIZER_UUID_;
/* enumerated parameter settings for virtualizer effect */
/* to keep in sync with frameworks/base/media/java/android/media/audiofx/Virtualizer.java */
typedef enum
{
VIRTUALIZER_PARAM_STRENGTH_SUPPORTED,
VIRTUALIZER_PARAM_STRENGTH,
// used with EFFECT_CMD_GET_PARAM
// format:
// parameters int32_t VIRTUALIZER_PARAM_VIRTUAL_SPEAKER_ANGLES
// audio_channel_mask_t input channel mask
// audio_devices_t audio output device
// output int32_t* an array of length 3 * the number of channels in the mask
// where entries are the succession of the channel mask
// of each speaker (i.e. a single bit is selected in the
// channel mask) followed by the azimuth and the
// elevation angles.
// status int -EINVAL if configuration is not supported or invalid or not forcing
// 0 if configuration is supported and the mode is forced
// notes:
// - all angles are expressed in degrees and are relative to the listener,
// - for azimuth: 0 is the direction the listener faces, 180 is behind the listener, and
// -90 is to her/his left,
// - for elevation: 0 is the horizontal plane, +90 is above the listener, -90 is below.
VIRTUALIZER_PARAM_VIRTUAL_SPEAKER_ANGLES,
// used with EFFECT_CMD_SET_PARAM
// format:
// parameters int32_t VIRTUALIZER_PARAM_FORCE_VIRTUALIZATION_MODE
// audio_devices_t audio output device
// status int -EINVAL if the device is not supported or invalid
// 0 if the device is supported and the mode is forced, or forcing
// was disabled for the AUDIO_DEVICE_NONE audio device.
VIRTUALIZER_PARAM_FORCE_VIRTUALIZATION_MODE,
// used with EFFECT_CMD_GET_PARAM
// format:
// parameters int32_t VIRTUALIZER_PARAM_VIRTUALIZATION_MODE
// output audio_device_t audio device reflecting the current virtualization mode,
// AUDIO_DEVICE_NONE when not virtualizing
// status int -EINVAL if an error occurred
// 0 if the output value is successfully retrieved
VIRTUALIZER_PARAM_VIRTUALIZATION_MODE,
// Internal paramter specific to qahw.
// Used to get latency introduced by virtuaizer effect.
VIRTUALIZER_PARAM_LATENCY = 0x80000000
} qahw_virtualizer_params;
#ifdef __cplusplus
} // extern "C"
#endif
#endif /*QAHW_EFFECT_VIRTUALIZER_H_*/
|
