xref: /aosp_15_r20/system/media/audio_utils/spdif/BitFieldParser.h (revision b9df5ad1c9ac98a7fefaac271a55f7ae3db05414)
1*b9df5ad1SAndroid Build Coastguard Worker /*
2*b9df5ad1SAndroid Build Coastguard Worker  * Copyright 2015, The Android Open Source Project
3*b9df5ad1SAndroid Build Coastguard Worker  *
4*b9df5ad1SAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*b9df5ad1SAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*b9df5ad1SAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*b9df5ad1SAndroid Build Coastguard Worker  *
8*b9df5ad1SAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*b9df5ad1SAndroid Build Coastguard Worker  *
10*b9df5ad1SAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*b9df5ad1SAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*b9df5ad1SAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*b9df5ad1SAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*b9df5ad1SAndroid Build Coastguard Worker  * limitations under the License.
15*b9df5ad1SAndroid Build Coastguard Worker  */
16*b9df5ad1SAndroid Build Coastguard Worker 
17*b9df5ad1SAndroid Build Coastguard Worker #ifndef ANDROID_AUDIO_BIT_FIELD_PARSER_H
18*b9df5ad1SAndroid Build Coastguard Worker #define ANDROID_AUDIO_BIT_FIELD_PARSER_H
19*b9df5ad1SAndroid Build Coastguard Worker 
20*b9df5ad1SAndroid Build Coastguard Worker #include <stdint.h>
21*b9df5ad1SAndroid Build Coastguard Worker 
22*b9df5ad1SAndroid Build Coastguard Worker namespace android {
23*b9df5ad1SAndroid Build Coastguard Worker 
24*b9df5ad1SAndroid Build Coastguard Worker /**
25*b9df5ad1SAndroid Build Coastguard Worker  * Extract bit fields from a byte array.
26*b9df5ad1SAndroid Build Coastguard Worker  */
27*b9df5ad1SAndroid Build Coastguard Worker class BitFieldParser {
28*b9df5ad1SAndroid Build Coastguard Worker public:
29*b9df5ad1SAndroid Build Coastguard Worker 
30*b9df5ad1SAndroid Build Coastguard Worker     explicit BitFieldParser(uint8_t *data);
31*b9df5ad1SAndroid Build Coastguard Worker     virtual ~BitFieldParser();
32*b9df5ad1SAndroid Build Coastguard Worker 
33*b9df5ad1SAndroid Build Coastguard Worker     /**
34*b9df5ad1SAndroid Build Coastguard Worker      * Read numBits bits from the data array.
35*b9df5ad1SAndroid Build Coastguard Worker      * Fields may span byte boundaries but may not exceed 32-bits.
36*b9df5ad1SAndroid Build Coastguard Worker      * Note that the caller must ensure that there is suffcient data.
37*b9df5ad1SAndroid Build Coastguard Worker      * Assume data is organized as BigEndian format.
38*b9df5ad1SAndroid Build Coastguard Worker      */
39*b9df5ad1SAndroid Build Coastguard Worker     uint32_t readBits(uint32_t numBits);
40*b9df5ad1SAndroid Build Coastguard Worker 
41*b9df5ad1SAndroid Build Coastguard Worker     /*
42*b9df5ad1SAndroid Build Coastguard Worker      * When the cursor is zero it points to a position right before
43*b9df5ad1SAndroid Build Coastguard Worker      * the most significant bit.
44*b9df5ad1SAndroid Build Coastguard Worker      * When the cursor is seven it points to a position right before
45*b9df5ad1SAndroid Build Coastguard Worker      * the least significant bit.
46*b9df5ad1SAndroid Build Coastguard Worker      */
getBitCursor()47*b9df5ad1SAndroid Build Coastguard Worker     uint32_t getBitCursor() const { return mBitCursor; }
48*b9df5ad1SAndroid Build Coastguard Worker 
49*b9df5ad1SAndroid Build Coastguard Worker private:
50*b9df5ad1SAndroid Build Coastguard Worker     uint8_t *mData;
51*b9df5ad1SAndroid Build Coastguard Worker     uint32_t mBitCursor;
52*b9df5ad1SAndroid Build Coastguard Worker };
53*b9df5ad1SAndroid Build Coastguard Worker 
54*b9df5ad1SAndroid Build Coastguard Worker 
55*b9df5ad1SAndroid Build Coastguard Worker }  // namespace android
56*b9df5ad1SAndroid Build Coastguard Worker 
57*b9df5ad1SAndroid Build Coastguard Worker #endif  // ANDROID_AUDIO_BIT_FIELD_PARSER_H
58