| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You 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. |
| */ |
| |
| package javax.imageio.plugins.jpeg; |
| |
| /** |
| * The JPEGHuffmanTable class represents a single JPEG Huffman table. It |
| * contains the standard tables from the JPEG specification. |
| * |
| * @since Android 1.0 |
| */ |
| public class JPEGHuffmanTable { |
| |
| /** |
| * The standard DC luminance Huffman table . |
| */ |
| public static final JPEGHuffmanTable StdDCLuminance = new JPEGHuffmanTable(new short[] { |
| 0, 1, 5, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0 |
| }, new short[] { |
| 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0x0A, 0x0B |
| }, false); |
| |
| /** |
| * The standard DC chrominance Huffman table. |
| */ |
| public static final JPEGHuffmanTable StdDCChrominance = new JPEGHuffmanTable(new short[] { |
| 0, 3, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0 |
| }, new short[] { |
| 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0x0A, 0x0B |
| }, false); |
| |
| /** |
| * The standard AC luminance Huffman table. |
| */ |
| public static final JPEGHuffmanTable StdACLuminance = new JPEGHuffmanTable(new short[] { |
| 0, 2, 1, 3, 3, 2, 4, 3, 5, 5, 4, 4, 0, 0, 1, 0x7D |
| }, new short[] { |
| 0x01, 0x02, 0x03, 0x00, 0x04, 0x11, 0x05, 0x12, 0x21, 0x31, 0x41, 0x06, 0x13, 0x51, |
| 0x61, 0x07, 0x22, 0x71, 0x14, 0x32, 0x81, 0x91, 0xA1, 0x08, 0x23, 0x42, 0xB1, 0xC1, |
| 0x15, 0x52, 0xD1, 0xF0, 0x24, 0x33, 0x62, 0x72, 0x82, 0x09, 0x0A, 0x16, 0x17, 0x18, |
| 0x19, 0x1A, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2A, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, |
| 0x3A, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x4A, 0x53, 0x54, 0x55, 0x56, 0x57, |
| 0x58, 0x59, 0x5A, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6A, 0x73, 0x74, 0x75, |
| 0x76, 0x77, 0x78, 0x79, 0x7A, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89, 0x8A, 0x92, |
| 0x93, 0x94, 0x95, 0x96, 0x97, 0x98, 0x99, 0x9A, 0xA2, 0xA3, 0xA4, 0xA5, 0xA6, 0xA7, |
| 0xA8, 0xA9, 0xAA, 0xB2, 0xB3, 0xB4, 0xB5, 0xB6, 0xB7, 0xB8, 0xB9, 0xBA, 0xC2, 0xC3, |
| 0xC4, 0xC5, 0xC6, 0xC7, 0xC8, 0xC9, 0xCA, 0xD2, 0xD3, 0xD4, 0xD5, 0xD6, 0xD7, 0xD8, |
| 0xD9, 0xDA, 0xE1, 0xE2, 0xE3, 0xE4, 0xE5, 0xE6, 0xE7, 0xE8, 0xE9, 0xEA, 0xF1, 0xF2, |
| 0xF3, 0xF4, 0xF5, 0xF6, 0xF7, 0xF8, 0xF9, 0xFA |
| }, false); |
| |
| /** |
| * The standard AC chrominance Huffman table. |
| */ |
| public static final JPEGHuffmanTable StdACChrominance = new JPEGHuffmanTable(new short[] { |
| 0, 2, 1, 2, 4, 4, 3, 4, 7, 5, 4, 4, 0, 1, 2, 0x77 |
| }, new short[] { |
| 0x00, 0x01, 0x02, 0x03, 0x11, 0x04, 0x05, 0x21, 0x31, 0x06, 0x12, 0x41, 0x51, 0x07, |
| 0x61, 0x71, 0x13, 0x22, 0x32, 0x81, 0x08, 0x14, 0x42, 0x91, 0xA1, 0xB1, 0xC1, 0x09, |
| 0x23, 0x33, 0x52, 0xF0, 0x15, 0x62, 0x72, 0xD1, 0x0A, 0x16, 0x24, 0x34, 0xE1, 0x25, |
| 0xF1, 0x17, 0x18, 0x19, 0x1A, 0x26, 0x27, 0x28, 0x29, 0x2A, 0x35, 0x36, 0x37, 0x38, |
| 0x39, 0x3A, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x4A, 0x53, 0x54, 0x55, 0x56, |
| 0x57, 0x58, 0x59, 0x5A, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6A, 0x73, 0x74, |
| 0x75, 0x76, 0x77, 0x78, 0x79, 0x7A, 0x82, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89, |
| 0x8A, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98, 0x99, 0x9A, 0xA2, 0xA3, 0xA4, 0xA5, |
| 0xA6, 0xA7, 0xA8, 0xA9, 0xAA, 0xB2, 0xB3, 0xB4, 0xB5, 0xB6, 0xB7, 0xB8, 0xB9, 0xBA, |
| 0xC2, 0xC3, 0xC4, 0xC5, 0xC6, 0xC7, 0xC8, 0xC9, 0xCA, 0xD2, 0xD3, 0xD4, 0xD5, 0xD6, |
| 0xD7, 0xD8, 0xD9, 0xDA, 0xE2, 0xE3, 0xE4, 0xE5, 0xE6, 0xE7, 0xE8, 0xE9, 0xEA, 0xF2, |
| 0xF3, 0xF4, 0xF5, 0xF6, 0xF7, 0xF8, 0xF9, 0xFA |
| }, false); |
| |
| /** |
| * The lengths. |
| */ |
| private short lengths[]; |
| |
| /** |
| * The values. |
| */ |
| private short values[]; |
| |
| /** |
| * Instantiates a new jPEG huffman table. |
| * |
| * @param lengths |
| * the lengths |
| * @param values |
| * the values |
| * @param copy |
| * the copy |
| */ |
| JPEGHuffmanTable(short[] lengths, short[] values, boolean copy) { |
| // Construction of standard tables without checks |
| // The third param is dummy |
| // Could be also used for copying of the existing tables |
| this.lengths = lengths; |
| this.values = values; |
| } |
| |
| /** |
| * Instantiates a new JPEGHuffmanTable. |
| * |
| * @param lengths |
| * the array of shorts lengths. |
| * @param values |
| * the array of shorts containing the values in order of |
| * increasing code length. |
| */ |
| public JPEGHuffmanTable(short[] lengths, short[] values) { |
| if (lengths == null) { |
| throw new IllegalArgumentException("lengths array is null!"); |
| } |
| if (values == null) { |
| throw new IllegalArgumentException("values array is null!"); |
| } |
| if (lengths.length > 16) { // According to the spec |
| throw new IllegalArgumentException("lengths array is too long!"); |
| } |
| if (values.length > 256) { // According to the spec |
| throw new IllegalArgumentException("values array is too long"); |
| } |
| for (short length : lengths) { |
| if (length < 0) { |
| throw new IllegalArgumentException("Values in lengths array must be non-negative."); |
| } |
| } |
| for (short value : values) { |
| if (value < 0) { |
| throw new IllegalArgumentException("Values in values array must be non-negative."); |
| } |
| } |
| |
| checkHuffmanTable(lengths, values); |
| |
| this.lengths = new short[lengths.length]; |
| this.values = new short[values.length]; |
| System.arraycopy(lengths, 0, this.lengths, 0, lengths.length); |
| System.arraycopy(values, 0, this.values, 0, values.length); |
| } |
| |
| /** |
| * Gets an array of lengths in the Huffman table. |
| * |
| * @return the array of short values representing the length values in the |
| * Huffman table. |
| */ |
| public short[] getLengths() { |
| short newLengths[] = new short[lengths.length]; |
| System.arraycopy(lengths, 0, newLengths, 0, lengths.length); |
| return newLengths; |
| } |
| |
| /** |
| * Gets an array of values represented by increasing length of their codes. |
| * |
| * @return the array of values. |
| */ |
| public short[] getValues() { |
| short newValues[] = new short[values.length]; |
| System.arraycopy(values, 0, newValues, 0, values.length); |
| return newValues; |
| } |
| |
| /** |
| * Check huffman table. |
| * |
| * @param lengths |
| * the lengths. |
| * @param values |
| * the values. |
| */ |
| private static void checkHuffmanTable(short[] lengths, short[] values) { |
| int numLeaves = 0; |
| int possibleLeaves = 2; |
| for (short length : lengths) { |
| numLeaves += length; |
| possibleLeaves -= length; |
| if (possibleLeaves < 0) { |
| throw new IllegalArgumentException( |
| "Invalid Huffman table provided, lengths are incorrect."); |
| } |
| possibleLeaves <<= 1; |
| } |
| |
| if (values.length != numLeaves) { |
| throw new IllegalArgumentException( |
| "Invalid Huffman table provided, sum of lengths != values."); |
| } |
| } |
| |
| /** |
| * Returns the string representation of this JPEGHuffmanTable object. |
| * |
| * @return the string representation of this JPEGHuffmanTable object. |
| */ |
| @Override |
| public String toString() { |
| StringBuffer sb = new StringBuffer(); |
| |
| sb.append("JPEGHuffmanTable:\nlengths:"); |
| for (short length : lengths) { |
| sb.append(' ').append(length); |
| } |
| |
| sb.append("\nvalues:"); |
| for (short value : values) { |
| sb.append(' ').append(value); |
| } |
| |
| return sb.toString(); |
| } |
| } |
