xref: /aosp_15_r20/hardware/interfaces/audio/effect/2.0/IBassBoostEffect.hal (revision 4d7e907c777eeecc4c5bd7cf640a754fac206ff7)
1*4d7e907cSAndroid Build Coastguard Worker/*
2*4d7e907cSAndroid Build Coastguard Worker * Copyright (C) 2016 The Android Open Source Project
3*4d7e907cSAndroid Build Coastguard Worker *
4*4d7e907cSAndroid Build Coastguard Worker * Licensed under the Apache License, Version 2.0 (the "License");
5*4d7e907cSAndroid Build Coastguard Worker * you may not use this file except in compliance with the License.
6*4d7e907cSAndroid Build Coastguard Worker * You may obtain a copy of the License at
7*4d7e907cSAndroid Build Coastguard Worker *
8*4d7e907cSAndroid Build Coastguard Worker *      http://www.apache.org/licenses/LICENSE-2.0
9*4d7e907cSAndroid Build Coastguard Worker *
10*4d7e907cSAndroid Build Coastguard Worker * Unless required by applicable law or agreed to in writing, software
11*4d7e907cSAndroid Build Coastguard Worker * distributed under the License is distributed on an "AS IS" BASIS,
12*4d7e907cSAndroid Build Coastguard Worker * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*4d7e907cSAndroid Build Coastguard Worker * See the License for the specific language governing permissions and
14*4d7e907cSAndroid Build Coastguard Worker * limitations under the License.
15*4d7e907cSAndroid Build Coastguard Worker */
16*4d7e907cSAndroid Build Coastguard Worker
17*4d7e907cSAndroid Build Coastguard Workerpackage [email protected];
18*4d7e907cSAndroid Build Coastguard Worker
19*4d7e907cSAndroid Build Coastguard Workerimport [email protected];
20*4d7e907cSAndroid Build Coastguard Workerimport IEffect;
21*4d7e907cSAndroid Build Coastguard Worker
22*4d7e907cSAndroid Build Coastguard Workerinterface IBassBoostEffect extends IEffect {
23*4d7e907cSAndroid Build Coastguard Worker    /**
24*4d7e907cSAndroid Build Coastguard Worker     * Returns whether setting bass boost strength is supported.
25*4d7e907cSAndroid Build Coastguard Worker     */
26*4d7e907cSAndroid Build Coastguard Worker    isStrengthSupported() generates (Result retval, bool strengthSupported);
27*4d7e907cSAndroid Build Coastguard Worker
28*4d7e907cSAndroid Build Coastguard Worker    enum StrengthRange : uint16_t {
29*4d7e907cSAndroid Build Coastguard Worker        MIN = 0,
30*4d7e907cSAndroid Build Coastguard Worker        MAX = 1000
31*4d7e907cSAndroid Build Coastguard Worker    };
32*4d7e907cSAndroid Build Coastguard Worker
33*4d7e907cSAndroid Build Coastguard Worker    /**
34*4d7e907cSAndroid Build Coastguard Worker     * Sets bass boost strength.
35*4d7e907cSAndroid Build Coastguard Worker     *
36*4d7e907cSAndroid Build Coastguard Worker     * @param strength strength of the effect. The valid range for strength
37*4d7e907cSAndroid Build Coastguard Worker     *                 strength is [0, 1000], where 0 per mille designates the
38*4d7e907cSAndroid Build Coastguard Worker     *                 mildest effect and 1000 per mille designates the
39*4d7e907cSAndroid Build Coastguard Worker     *                 strongest.
40*4d7e907cSAndroid Build Coastguard Worker     * @return retval operation completion status.
41*4d7e907cSAndroid Build Coastguard Worker     */
42*4d7e907cSAndroid Build Coastguard Worker    setStrength(uint16_t strength) generates (Result retval);
43*4d7e907cSAndroid Build Coastguard Worker
44*4d7e907cSAndroid Build Coastguard Worker    /**
45*4d7e907cSAndroid Build Coastguard Worker     * Gets virtualization strength.
46*4d7e907cSAndroid Build Coastguard Worker     */
47*4d7e907cSAndroid Build Coastguard Worker    getStrength() generates (Result retval, uint16_t strength);
48*4d7e907cSAndroid Build Coastguard Worker};
49