| // SPDX-License-Identifier: Apache-2.0 | |
| // ---------------------------------------------------------------------------- | |
| // Copyright 2011-2020 Arm Limited | |
| // | |
| // 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. | |
| // ---------------------------------------------------------------------------- | |
| /** | |
| * @brief Functions for encoding/decoding Bounded Integer Sequence Encoding. | |
| */ | |
| #include "astc_codec_internals.h" | |
| // unpacked quint triplets <low,middle,high> for each packed-quint value | |
| static const uint8_t quints_of_integer[128][3] = { | |
| {0, 0, 0}, {1, 0, 0}, {2, 0, 0}, {3, 0, 0}, | |
| {4, 0, 0}, {0, 4, 0}, {4, 4, 0}, {4, 4, 4}, | |
| {0, 1, 0}, {1, 1, 0}, {2, 1, 0}, {3, 1, 0}, | |
| {4, 1, 0}, {1, 4, 0}, {4, 4, 1}, {4, 4, 4}, | |
| {0, 2, 0}, {1, 2, 0}, {2, 2, 0}, {3, 2, 0}, | |
| {4, 2, 0}, {2, 4, 0}, {4, 4, 2}, {4, 4, 4}, | |
| {0, 3, 0}, {1, 3, 0}, {2, 3, 0}, {3, 3, 0}, | |
| {4, 3, 0}, {3, 4, 0}, {4, 4, 3}, {4, 4, 4}, | |
| {0, 0, 1}, {1, 0, 1}, {2, 0, 1}, {3, 0, 1}, | |
| {4, 0, 1}, {0, 4, 1}, {4, 0, 4}, {0, 4, 4}, | |
| {0, 1, 1}, {1, 1, 1}, {2, 1, 1}, {3, 1, 1}, | |
| {4, 1, 1}, {1, 4, 1}, {4, 1, 4}, {1, 4, 4}, | |
| {0, 2, 1}, {1, 2, 1}, {2, 2, 1}, {3, 2, 1}, | |
| {4, 2, 1}, {2, 4, 1}, {4, 2, 4}, {2, 4, 4}, | |
| {0, 3, 1}, {1, 3, 1}, {2, 3, 1}, {3, 3, 1}, | |
| {4, 3, 1}, {3, 4, 1}, {4, 3, 4}, {3, 4, 4}, | |
| {0, 0, 2}, {1, 0, 2}, {2, 0, 2}, {3, 0, 2}, | |
| {4, 0, 2}, {0, 4, 2}, {2, 0, 4}, {3, 0, 4}, | |
| {0, 1, 2}, {1, 1, 2}, {2, 1, 2}, {3, 1, 2}, | |
| {4, 1, 2}, {1, 4, 2}, {2, 1, 4}, {3, 1, 4}, | |
| {0, 2, 2}, {1, 2, 2}, {2, 2, 2}, {3, 2, 2}, | |
| {4, 2, 2}, {2, 4, 2}, {2, 2, 4}, {3, 2, 4}, | |
| {0, 3, 2}, {1, 3, 2}, {2, 3, 2}, {3, 3, 2}, | |
| {4, 3, 2}, {3, 4, 2}, {2, 3, 4}, {3, 3, 4}, | |
| {0, 0, 3}, {1, 0, 3}, {2, 0, 3}, {3, 0, 3}, | |
| {4, 0, 3}, {0, 4, 3}, {0, 0, 4}, {1, 0, 4}, | |
| {0, 1, 3}, {1, 1, 3}, {2, 1, 3}, {3, 1, 3}, | |
| {4, 1, 3}, {1, 4, 3}, {0, 1, 4}, {1, 1, 4}, | |
| {0, 2, 3}, {1, 2, 3}, {2, 2, 3}, {3, 2, 3}, | |
| {4, 2, 3}, {2, 4, 3}, {0, 2, 4}, {1, 2, 4}, | |
| {0, 3, 3}, {1, 3, 3}, {2, 3, 3}, {3, 3, 3}, | |
| {4, 3, 3}, {3, 4, 3}, {0, 3, 4}, {1, 3, 4} | |
| }; | |
| // unpacked trit quintuplets <low,_,_,_,high> for each packed-quint value | |
| static const uint8_t trits_of_integer[256][5] = { | |
| {0, 0, 0, 0, 0}, {1, 0, 0, 0, 0}, {2, 0, 0, 0, 0}, {0, 0, 2, 0, 0}, | |
| {0, 1, 0, 0, 0}, {1, 1, 0, 0, 0}, {2, 1, 0, 0, 0}, {1, 0, 2, 0, 0}, | |
| {0, 2, 0, 0, 0}, {1, 2, 0, 0, 0}, {2, 2, 0, 0, 0}, {2, 0, 2, 0, 0}, | |
| {0, 2, 2, 0, 0}, {1, 2, 2, 0, 0}, {2, 2, 2, 0, 0}, {2, 0, 2, 0, 0}, | |
| {0, 0, 1, 0, 0}, {1, 0, 1, 0, 0}, {2, 0, 1, 0, 0}, {0, 1, 2, 0, 0}, | |
| {0, 1, 1, 0, 0}, {1, 1, 1, 0, 0}, {2, 1, 1, 0, 0}, {1, 1, 2, 0, 0}, | |
| {0, 2, 1, 0, 0}, {1, 2, 1, 0, 0}, {2, 2, 1, 0, 0}, {2, 1, 2, 0, 0}, | |
| {0, 0, 0, 2, 2}, {1, 0, 0, 2, 2}, {2, 0, 0, 2, 2}, {0, 0, 2, 2, 2}, | |
| {0, 0, 0, 1, 0}, {1, 0, 0, 1, 0}, {2, 0, 0, 1, 0}, {0, 0, 2, 1, 0}, | |
| {0, 1, 0, 1, 0}, {1, 1, 0, 1, 0}, {2, 1, 0, 1, 0}, {1, 0, 2, 1, 0}, | |
| {0, 2, 0, 1, 0}, {1, 2, 0, 1, 0}, {2, 2, 0, 1, 0}, {2, 0, 2, 1, 0}, | |
| {0, 2, 2, 1, 0}, {1, 2, 2, 1, 0}, {2, 2, 2, 1, 0}, {2, 0, 2, 1, 0}, | |
| {0, 0, 1, 1, 0}, {1, 0, 1, 1, 0}, {2, 0, 1, 1, 0}, {0, 1, 2, 1, 0}, | |
| {0, 1, 1, 1, 0}, {1, 1, 1, 1, 0}, {2, 1, 1, 1, 0}, {1, 1, 2, 1, 0}, | |
| {0, 2, 1, 1, 0}, {1, 2, 1, 1, 0}, {2, 2, 1, 1, 0}, {2, 1, 2, 1, 0}, | |
| {0, 1, 0, 2, 2}, {1, 1, 0, 2, 2}, {2, 1, 0, 2, 2}, {1, 0, 2, 2, 2}, | |
| {0, 0, 0, 2, 0}, {1, 0, 0, 2, 0}, {2, 0, 0, 2, 0}, {0, 0, 2, 2, 0}, | |
| {0, 1, 0, 2, 0}, {1, 1, 0, 2, 0}, {2, 1, 0, 2, 0}, {1, 0, 2, 2, 0}, | |
| {0, 2, 0, 2, 0}, {1, 2, 0, 2, 0}, {2, 2, 0, 2, 0}, {2, 0, 2, 2, 0}, | |
| {0, 2, 2, 2, 0}, {1, 2, 2, 2, 0}, {2, 2, 2, 2, 0}, {2, 0, 2, 2, 0}, | |
| {0, 0, 1, 2, 0}, {1, 0, 1, 2, 0}, {2, 0, 1, 2, 0}, {0, 1, 2, 2, 0}, | |
| {0, 1, 1, 2, 0}, {1, 1, 1, 2, 0}, {2, 1, 1, 2, 0}, {1, 1, 2, 2, 0}, | |
| {0, 2, 1, 2, 0}, {1, 2, 1, 2, 0}, {2, 2, 1, 2, 0}, {2, 1, 2, 2, 0}, | |
| {0, 2, 0, 2, 2}, {1, 2, 0, 2, 2}, {2, 2, 0, 2, 2}, {2, 0, 2, 2, 2}, | |
| {0, 0, 0, 0, 2}, {1, 0, 0, 0, 2}, {2, 0, 0, 0, 2}, {0, 0, 2, 0, 2}, | |
| {0, 1, 0, 0, 2}, {1, 1, 0, 0, 2}, {2, 1, 0, 0, 2}, {1, 0, 2, 0, 2}, | |
| {0, 2, 0, 0, 2}, {1, 2, 0, 0, 2}, {2, 2, 0, 0, 2}, {2, 0, 2, 0, 2}, | |
| {0, 2, 2, 0, 2}, {1, 2, 2, 0, 2}, {2, 2, 2, 0, 2}, {2, 0, 2, 0, 2}, | |
| {0, 0, 1, 0, 2}, {1, 0, 1, 0, 2}, {2, 0, 1, 0, 2}, {0, 1, 2, 0, 2}, | |
| {0, 1, 1, 0, 2}, {1, 1, 1, 0, 2}, {2, 1, 1, 0, 2}, {1, 1, 2, 0, 2}, | |
| {0, 2, 1, 0, 2}, {1, 2, 1, 0, 2}, {2, 2, 1, 0, 2}, {2, 1, 2, 0, 2}, | |
| {0, 2, 2, 2, 2}, {1, 2, 2, 2, 2}, {2, 2, 2, 2, 2}, {2, 0, 2, 2, 2}, | |
| {0, 0, 0, 0, 1}, {1, 0, 0, 0, 1}, {2, 0, 0, 0, 1}, {0, 0, 2, 0, 1}, | |
| {0, 1, 0, 0, 1}, {1, 1, 0, 0, 1}, {2, 1, 0, 0, 1}, {1, 0, 2, 0, 1}, | |
| {0, 2, 0, 0, 1}, {1, 2, 0, 0, 1}, {2, 2, 0, 0, 1}, {2, 0, 2, 0, 1}, | |
| {0, 2, 2, 0, 1}, {1, 2, 2, 0, 1}, {2, 2, 2, 0, 1}, {2, 0, 2, 0, 1}, | |
| {0, 0, 1, 0, 1}, {1, 0, 1, 0, 1}, {2, 0, 1, 0, 1}, {0, 1, 2, 0, 1}, | |
| {0, 1, 1, 0, 1}, {1, 1, 1, 0, 1}, {2, 1, 1, 0, 1}, {1, 1, 2, 0, 1}, | |
| {0, 2, 1, 0, 1}, {1, 2, 1, 0, 1}, {2, 2, 1, 0, 1}, {2, 1, 2, 0, 1}, | |
| {0, 0, 1, 2, 2}, {1, 0, 1, 2, 2}, {2, 0, 1, 2, 2}, {0, 1, 2, 2, 2}, | |
| {0, 0, 0, 1, 1}, {1, 0, 0, 1, 1}, {2, 0, 0, 1, 1}, {0, 0, 2, 1, 1}, | |
| {0, 1, 0, 1, 1}, {1, 1, 0, 1, 1}, {2, 1, 0, 1, 1}, {1, 0, 2, 1, 1}, | |
| {0, 2, 0, 1, 1}, {1, 2, 0, 1, 1}, {2, 2, 0, 1, 1}, {2, 0, 2, 1, 1}, | |
| {0, 2, 2, 1, 1}, {1, 2, 2, 1, 1}, {2, 2, 2, 1, 1}, {2, 0, 2, 1, 1}, | |
| {0, 0, 1, 1, 1}, {1, 0, 1, 1, 1}, {2, 0, 1, 1, 1}, {0, 1, 2, 1, 1}, | |
| {0, 1, 1, 1, 1}, {1, 1, 1, 1, 1}, {2, 1, 1, 1, 1}, {1, 1, 2, 1, 1}, | |
| {0, 2, 1, 1, 1}, {1, 2, 1, 1, 1}, {2, 2, 1, 1, 1}, {2, 1, 2, 1, 1}, | |
| {0, 1, 1, 2, 2}, {1, 1, 1, 2, 2}, {2, 1, 1, 2, 2}, {1, 1, 2, 2, 2}, | |
| {0, 0, 0, 2, 1}, {1, 0, 0, 2, 1}, {2, 0, 0, 2, 1}, {0, 0, 2, 2, 1}, | |
| {0, 1, 0, 2, 1}, {1, 1, 0, 2, 1}, {2, 1, 0, 2, 1}, {1, 0, 2, 2, 1}, | |
| {0, 2, 0, 2, 1}, {1, 2, 0, 2, 1}, {2, 2, 0, 2, 1}, {2, 0, 2, 2, 1}, | |
| {0, 2, 2, 2, 1}, {1, 2, 2, 2, 1}, {2, 2, 2, 2, 1}, {2, 0, 2, 2, 1}, | |
| {0, 0, 1, 2, 1}, {1, 0, 1, 2, 1}, {2, 0, 1, 2, 1}, {0, 1, 2, 2, 1}, | |
| {0, 1, 1, 2, 1}, {1, 1, 1, 2, 1}, {2, 1, 1, 2, 1}, {1, 1, 2, 2, 1}, | |
| {0, 2, 1, 2, 1}, {1, 2, 1, 2, 1}, {2, 2, 1, 2, 1}, {2, 1, 2, 2, 1}, | |
| {0, 2, 1, 2, 2}, {1, 2, 1, 2, 2}, {2, 2, 1, 2, 2}, {2, 1, 2, 2, 2}, | |
| {0, 0, 0, 1, 2}, {1, 0, 0, 1, 2}, {2, 0, 0, 1, 2}, {0, 0, 2, 1, 2}, | |
| {0, 1, 0, 1, 2}, {1, 1, 0, 1, 2}, {2, 1, 0, 1, 2}, {1, 0, 2, 1, 2}, | |
| {0, 2, 0, 1, 2}, {1, 2, 0, 1, 2}, {2, 2, 0, 1, 2}, {2, 0, 2, 1, 2}, | |
| {0, 2, 2, 1, 2}, {1, 2, 2, 1, 2}, {2, 2, 2, 1, 2}, {2, 0, 2, 1, 2}, | |
| {0, 0, 1, 1, 2}, {1, 0, 1, 1, 2}, {2, 0, 1, 1, 2}, {0, 1, 2, 1, 2}, | |
| {0, 1, 1, 1, 2}, {1, 1, 1, 1, 2}, {2, 1, 1, 1, 2}, {1, 1, 2, 1, 2}, | |
| {0, 2, 1, 1, 2}, {1, 2, 1, 1, 2}, {2, 2, 1, 1, 2}, {2, 1, 2, 1, 2}, | |
| {0, 2, 2, 2, 2}, {1, 2, 2, 2, 2}, {2, 2, 2, 2, 2}, {2, 1, 2, 2, 2} | |
| }; | |
| void find_number_of_bits_trits_quints( | |
| int quantization_level, | |
| int* bits, | |
| int* trits, | |
| int* quints | |
| ) { | |
| *bits = 0; | |
| *trits = 0; | |
| *quints = 0; | |
| switch (quantization_level) | |
| { | |
| case QUANT_2: | |
| *bits = 1; | |
| break; | |
| case QUANT_3: | |
| *bits = 0; | |
| *trits = 1; | |
| break; | |
| case QUANT_4: | |
| *bits = 2; | |
| break; | |
| case QUANT_5: | |
| *bits = 0; | |
| *quints = 1; | |
| break; | |
| case QUANT_6: | |
| *bits = 1; | |
| *trits = 1; | |
| break; | |
| case QUANT_8: | |
| *bits = 3; | |
| break; | |
| case QUANT_10: | |
| *bits = 1; | |
| *quints = 1; | |
| break; | |
| case QUANT_12: | |
| *bits = 2; | |
| *trits = 1; | |
| break; | |
| case QUANT_16: | |
| *bits = 4; | |
| break; | |
| case QUANT_20: | |
| *bits = 2; | |
| *quints = 1; | |
| break; | |
| case QUANT_24: | |
| *bits = 3; | |
| *trits = 1; | |
| break; | |
| case QUANT_32: | |
| *bits = 5; | |
| break; | |
| case QUANT_40: | |
| *bits = 3; | |
| *quints = 1; | |
| break; | |
| case QUANT_48: | |
| *bits = 4; | |
| *trits = 1; | |
| break; | |
| case QUANT_64: | |
| *bits = 6; | |
| break; | |
| case QUANT_80: | |
| *bits = 4; | |
| *quints = 1; | |
| break; | |
| case QUANT_96: | |
| *bits = 5; | |
| *trits = 1; | |
| break; | |
| case QUANT_128: | |
| *bits = 7; | |
| break; | |
| case QUANT_160: | |
| *bits = 5; | |
| *quints = 1; | |
| break; | |
| case QUANT_192: | |
| *bits = 6; | |
| *trits = 1; | |
| break; | |
| case QUANT_256: | |
| *bits = 8; | |
| break; | |
| } | |
| } | |
| // routine to read up to 8 bits | |
| static inline int read_bits( | |
| int bitcount, | |
| int bitoffset, | |
| const uint8_t* ptr | |
| ) { | |
| int mask = (1 << bitcount) - 1; | |
| ptr += bitoffset >> 3; | |
| bitoffset &= 7; | |
| int value = ptr[0] | (ptr[1] << 8); | |
| value >>= bitoffset; | |
| value &= mask; | |
| return value; | |
| } | |
| void decode_ise( | |
| int quantization_level, | |
| int elements, | |
| const uint8_t* input_data, | |
| uint8_t* output_data, | |
| int bit_offset | |
| ) { | |
| int i; | |
| // note: due to how the trit/quint-block unpacking is done in this function, | |
| // we may write more temporary results than the number of outputs | |
| // The maximum actual number of results is 64 bit, but we keep 4 additional elements | |
| // of padding. | |
| uint8_t results[68]; | |
| uint8_t tq_blocks[22]; // trit-blocks or quint-blocks | |
| int bits, trits, quints; | |
| find_number_of_bits_trits_quints(quantization_level, &bits, &trits, &quints); | |
| int lcounter = 0; | |
| int hcounter = 0; | |
| // trit-blocks or quint-blocks must be zeroed out before we collect them in the loop below. | |
| for (i = 0; i < 22; i++) | |
| tq_blocks[i] = 0; | |
| // collect bits for each element, as well as bits for any trit-blocks and quint-blocks. | |
| for (i = 0; i < elements; i++) | |
| { | |
| results[i] = read_bits(bits, bit_offset, input_data); | |
| bit_offset += bits; | |
| if (trits) | |
| { | |
| static const int bits_to_read[5] = { 2, 2, 1, 2, 1 }; | |
| static const int block_shift[5] = { 0, 2, 4, 5, 7 }; | |
| static const int next_lcounter[5] = { 1, 2, 3, 4, 0 }; | |
| static const int hcounter_incr[5] = { 0, 0, 0, 0, 1 }; | |
| int tdata = read_bits(bits_to_read[lcounter], bit_offset, input_data); | |
| bit_offset += bits_to_read[lcounter]; | |
| tq_blocks[hcounter] |= tdata << block_shift[lcounter]; | |
| hcounter += hcounter_incr[lcounter]; | |
| lcounter = next_lcounter[lcounter]; | |
| } | |
| if (quints) | |
| { | |
| static const int bits_to_read[3] = { 3, 2, 2 }; | |
| static const int block_shift[3] = { 0, 3, 5 }; | |
| static const int next_lcounter[3] = { 1, 2, 0 }; | |
| static const int hcounter_incr[3] = { 0, 0, 1 }; | |
| int tdata = read_bits(bits_to_read[lcounter], bit_offset, input_data); | |
| bit_offset += bits_to_read[lcounter]; | |
| tq_blocks[hcounter] |= tdata << block_shift[lcounter]; | |
| hcounter += hcounter_incr[lcounter]; | |
| lcounter = next_lcounter[lcounter]; | |
| } | |
| } | |
| // unpack trit-blocks or quint-blocks as needed | |
| if (trits) | |
| { | |
| int trit_blocks = (elements + 4) / 5; | |
| for (i = 0; i < trit_blocks; i++) | |
| { | |
| const uint8_t *tritptr = trits_of_integer[tq_blocks[i]]; | |
| results[5 * i] |= tritptr[0] << bits; | |
| results[5 * i + 1] |= tritptr[1] << bits; | |
| results[5 * i + 2] |= tritptr[2] << bits; | |
| results[5 * i + 3] |= tritptr[3] << bits; | |
| results[5 * i + 4] |= tritptr[4] << bits; | |
| } | |
| } | |
| if (quints) | |
| { | |
| int quint_blocks = (elements + 2) / 3; | |
| for (i = 0; i < quint_blocks; i++) | |
| { | |
| const uint8_t *quintptr = quints_of_integer[tq_blocks[i]]; | |
| results[3 * i] |= quintptr[0] << bits; | |
| results[3 * i + 1] |= quintptr[1] << bits; | |
| results[3 * i + 2] |= quintptr[2] << bits; | |
| } | |
| } | |
| for (i = 0; i < elements; i++) | |
| output_data[i] = results[i]; | |
| } | |
| int compute_ise_bitcount( | |
| int items, | |
| quantization_method quant | |
| ) { | |
| switch (quant) | |
| { | |
| case QUANT_2: | |
| return items; | |
| case QUANT_3: | |
| return (8 * items + 4) / 5; | |
| case QUANT_4: | |
| return 2 * items; | |
| case QUANT_5: | |
| return (7 * items + 2) / 3; | |
| case QUANT_6: | |
| return (13 * items + 4) / 5; | |
| case QUANT_8: | |
| return 3 * items; | |
| case QUANT_10: | |
| return (10 * items + 2) / 3; | |
| case QUANT_12: | |
| return (18 * items + 4) / 5; | |
| case QUANT_16: | |
| return items * 4; | |
| case QUANT_20: | |
| return (13 * items + 2) / 3; | |
| case QUANT_24: | |
| return (23 * items + 4) / 5; | |
| case QUANT_32: | |
| return 5 * items; | |
| case QUANT_40: | |
| return (16 * items + 2) / 3; | |
| case QUANT_48: | |
| return (28 * items + 4) / 5; | |
| case QUANT_64: | |
| return 6 * items; | |
| case QUANT_80: | |
| return (19 * items + 2) / 3; | |
| case QUANT_96: | |
| return (33 * items + 4) / 5; | |
| case QUANT_128: | |
| return 7 * items; | |
| case QUANT_160: | |
| return (22 * items + 2) / 3; | |
| case QUANT_192: | |
| return (38 * items + 4) / 5; | |
| case QUANT_256: | |
| return 8 * items; | |
| default: | |
| return 100000; | |
| } | |
| } |