/*
* 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 org.apache.commons.imaging.common;
/**
* Convenience methods for converting data types to and from
* byte arrays.
*/
public class ByteConversions {
public static byte[] toBytes(final short value, final ByteOrder byteOrder) {
final byte[] result = new byte[2];
toBytes(value, byteOrder, result, 0);
return result;
}
public static byte[] toBytes(final short[] values, final ByteOrder byteOrder) {
return toBytes(values, 0, values.length, byteOrder);
}
public static byte[] toBytes(final short[] values, final int length,
final ByteOrder byteOrder) {
return toBytes(values, 0, length, byteOrder);
}
public static byte[] toBytes(final short[] values, final int offset,
final int length, final ByteOrder byteOrder) {
final byte[] result = new byte[length * 2];
for (int i = 0; i < length; i++) {
toBytes(values[offset + i], byteOrder, result, i * 2);
}
return result;
}
public static void toBytes(final short[] values, final ByteOrder byteOrder,
final byte[] result, final int resultOffset) {
toBytes(values, 0, values.length, byteOrder, result, resultOffset);
}
public static void toBytes(final short[] values, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
toBytes(values, 0, valuesLength, byteOrder, result, resultOffset);
}
public static void toBytes(final short[] values, final int valuesOffset, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
for (int i = 0; i < valuesLength; i++) {
toBytes(values[valuesOffset + i], byteOrder, result, resultOffset + i*2);
}
}
public static void toBytes(final short value, final ByteOrder byteOrder,
final byte[] result, final int offset) {
if (byteOrder == ByteOrder.BIG_ENDIAN) {
result[offset + 0] = (byte) (value >> 8);
result[offset + 1] = (byte) (value >> 0);
} else {
result[offset + 1] = (byte) (value >> 8);
result[offset + 0] = (byte) (value >> 0);
}
}
public static byte[] toBytes(final int value, final ByteOrder byteOrder) {
final byte[] result = new byte[4];
toBytes(value, byteOrder, result, 0);
return result;
}
public static byte[] toBytes(final int[] values, final ByteOrder byteOrder) {
return toBytes(values, 0, values.length, byteOrder);
}
public static byte[] toBytes(final int[] values, final int length,
final ByteOrder byteOrder) {
return toBytes(values, 0, length, byteOrder);
}
public static byte[] toBytes(final int[] values, final int offset,
final int length, final ByteOrder byteOrder) {
final byte[] result = new byte[length * 4];
for (int i = 0; i < length; i++) {
toBytes(values[offset + i], byteOrder, result, i * 4);
}
return result;
}
public static void toBytes(final int[] values, final ByteOrder byteOrder,
final byte[] result, final int resultOffset) {
toBytes(values, 0, values.length, byteOrder, result, resultOffset);
}
public static void toBytes(final int[] values, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
toBytes(values, 0, valuesLength, byteOrder, result, resultOffset);
}
public static void toBytes(final int[] values, final int valuesOffset, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
for (int i = 0; i < valuesLength; i++) {
toBytes(values[valuesOffset + i], byteOrder, result, resultOffset + i*4);
}
}
public static void toBytes(final int value, final ByteOrder byteOrder,
final byte[] result, final int offset) {
if (byteOrder == ByteOrder.BIG_ENDIAN) {
result[offset + 0] = (byte) (value >> 24);
result[offset + 1] = (byte) (value >> 16);
result[offset + 2] = (byte) (value >> 8);
result[offset + 3] = (byte) (value >> 0);
} else {
result[offset + 3] = (byte) (value >> 24);
result[offset + 2] = (byte) (value >> 16);
result[offset + 1] = (byte) (value >> 8);
result[offset + 0] = (byte) (value >> 0);
}
}
public static byte[] toBytes(final float value, final ByteOrder byteOrder) {
final byte[] result = new byte[4];
toBytes(value, byteOrder, result, 0);
return result;
}
public static byte[] toBytes(final float[] values, final ByteOrder byteOrder) {
return toBytes(values, 0, values.length, byteOrder);
}
public static byte[] toBytes(final float[] values, final int length,
final ByteOrder byteOrder) {
return toBytes(values, 0, length, byteOrder);
}
public static byte[] toBytes(final float[] values, final int offset,
final int length, final ByteOrder byteOrder) {
final byte[] result = new byte[length * 4];
for (int i = 0; i < length; i++) {
toBytes(values[offset + i], byteOrder, result, i * 4);
}
return result;
}
public static void toBytes(final float[] values, final ByteOrder byteOrder,
final byte[] result, final int resultOffset) {
toBytes(values, 0, values.length, byteOrder, result, resultOffset);
}
public static void toBytes(final float[] values, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
toBytes(values, 0, valuesLength, byteOrder, result, resultOffset);
}
public static void toBytes(final float[] values, final int valuesOffset, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
for (int i = 0; i < valuesLength; i++) {
toBytes(values[valuesOffset + i], byteOrder, result, resultOffset + i*4);
}
}
public static void toBytes(final float value, final ByteOrder byteOrder,
final byte[] result, final int offset) {
final int bits = Float.floatToRawIntBits(value);
if (byteOrder == ByteOrder.LITTLE_ENDIAN) {
result[offset + 0] = (byte) (0xff & (bits >> 0));
result[offset + 1] = (byte) (0xff & (bits >> 8));
result[offset + 2] = (byte) (0xff & (bits >> 16));
result[offset + 3] = (byte) (0xff & (bits >> 24));
} else {
result[offset + 3] = (byte) (0xff & (bits >> 0));
result[offset + 2] = (byte) (0xff & (bits >> 8));
result[offset + 1] = (byte) (0xff & (bits >> 16));
result[offset + 0] = (byte) (0xff & (bits >> 24));
}
}
public static byte[] toBytes(final double value, final ByteOrder byteOrder) {
final byte[] result = new byte[8];
toBytes(value, byteOrder, result, 0);
return result;
}
public static byte[] toBytes(final double[] values, final ByteOrder byteOrder) {
return toBytes(values, 0, values.length, byteOrder);
}
public static byte[] toBytes(final double[] values, final int length,
final ByteOrder byteOrder) {
return toBytes(values, 0, length, byteOrder);
}
public static byte[] toBytes(final double[] values, final int offset,
final int length, final ByteOrder byteOrder) {
final byte[] result = new byte[length * 8];
for (int i = 0; i < length; i++) {
toBytes(values[offset + i], byteOrder, result, i * 8);
}
return result;
}
public static void toBytes(final double[] values, final ByteOrder byteOrder,
final byte[] result, final int resultOffset) {
toBytes(values, 0, values.length, byteOrder, result, resultOffset);
}
public static void toBytes(final double[] values, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
toBytes(values, 0, valuesLength, byteOrder, result, resultOffset);
}
public static void toBytes(final double[] values, final int valuesOffset, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
for (int i = 0; i < valuesLength; i++) {
toBytes(values[valuesOffset + i], byteOrder, result, resultOffset + i*8);
}
}
public static void toBytes(final double value, final ByteOrder byteOrder,
final byte[] result, final int offset) {
final long bits = Double.doubleToRawLongBits(value);
if (byteOrder == ByteOrder.INTEL) {
result[offset + 0] = (byte) (0xff & (bits >> 0));
result[offset + 1] = (byte) (0xff & (bits >> 8));
result[offset + 2] = (byte) (0xff & (bits >> 16));
result[offset + 3] = (byte) (0xff & (bits >> 24));
result[offset + 4] = (byte) (0xff & (bits >> 32));
result[offset + 5] = (byte) (0xff & (bits >> 40));
result[offset + 6] = (byte) (0xff & (bits >> 48));
result[offset + 7] = (byte) (0xff & (bits >> 56));
} else {
result[offset + 7] = (byte) (0xff & (bits >> 0));
result[offset + 6] = (byte) (0xff & (bits >> 8));
result[offset + 5] = (byte) (0xff & (bits >> 16));
result[offset + 4] = (byte) (0xff & (bits >> 24));
result[offset + 3] = (byte) (0xff & (bits >> 32));
result[offset + 2] = (byte) (0xff & (bits >> 40));
result[offset + 1] = (byte) (0xff & (bits >> 48));
result[offset + 0] = (byte) (0xff & (bits >> 56));
}
}
public static byte[] toBytes(final RationalNumber value, final ByteOrder byteOrder) {
final byte[] result = new byte[8];
toBytes(value, byteOrder, result, 0);
return result;
}
public static byte[] toBytes(final RationalNumber[] values, final ByteOrder byteOrder) {
return toBytes(values, 0, values.length, byteOrder);
}
public static byte[] toBytes(final RationalNumber[] values, final int length,
final ByteOrder byteOrder) {
return toBytes(values, 0, length, byteOrder);
}
public static byte[] toBytes(final RationalNumber[] values, final int offset,
final int length, final ByteOrder byteOrder) {
final byte[] result = new byte[length * 8];
for (int i = 0; i < length; i++) {
toBytes(values[offset + i], byteOrder, result, i * 8);
}
return result;
}
public static void toBytes(final RationalNumber[] values, final ByteOrder byteOrder,
final byte[] result, final int resultOffset) {
toBytes(values, 0, values.length, byteOrder, result, resultOffset);
}
public static void toBytes(final RationalNumber[] values, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
toBytes(values, 0, valuesLength, byteOrder, result, resultOffset);
}
public static void toBytes(final RationalNumber[] values, final int valuesOffset, final int valuesLength,
final ByteOrder byteOrder, final byte[] result, final int resultOffset) {
for (int i = 0; i < valuesLength; i++) {
toBytes(values[valuesOffset + i], byteOrder, result, resultOffset + i*8);
}
}
public static void toBytes(final RationalNumber value, final ByteOrder byteOrder,
final byte[] result, final int offset) {
if (byteOrder == ByteOrder.MOTOROLA) {
result[offset + 0] = (byte) (value.numerator >> 24);
result[offset + 1] = (byte) (value.numerator >> 16);
result[offset + 2] = (byte) (value.numerator >> 8);
result[offset + 3] = (byte) (value.numerator >> 0);
result[offset + 4] = (byte) (value.divisor >> 24);
result[offset + 5] = (byte) (value.divisor >> 16);
result[offset + 6] = (byte) (value.divisor >> 8);
result[offset + 7] = (byte) (value.divisor >> 0);
} else {
result[offset + 3] = (byte) (value.numerator >> 24);
result[offset + 2] = (byte) (value.numerator >> 16);
result[offset + 1] = (byte) (value.numerator >> 8);
result[offset + 0] = (byte) (value.numerator >> 0);
result[offset + 7] = (byte) (value.divisor >> 24);
result[offset + 6] = (byte) (value.divisor >> 16);
result[offset + 5] = (byte) (value.divisor >> 8);
result[offset + 4] = (byte) (value.divisor >> 0);
}
}
public static short toShort(final byte[] bytes, final ByteOrder byteOrder) {
return toShort(bytes, 0, byteOrder);
}
public static short toShort(final byte[] bytes, final int offset, final ByteOrder byteOrder) {
return (short) toUInt16(bytes, offset, byteOrder);
}
public static short[] toShorts(final byte[] bytes, final ByteOrder byteOrder) {
return toShorts(bytes, 0, bytes.length, byteOrder);
}
public static short[] toShorts(final byte[] bytes, final int length,
final ByteOrder byteOrder) {
return toShorts(bytes, 0, length, byteOrder);
}
public static short[] toShorts(final byte[] bytes, final int offset,
final int length, final ByteOrder byteOrder) {
final short[] result = new short[length / 2];
for (int i = 0; i < result.length; i++) {
result[i] = toShort(bytes, offset + 2 * i, byteOrder);
}
return result;
}
public static int toUInt16(final byte[] bytes, final ByteOrder byteOrder) {
return toUInt16(bytes, 0, byteOrder);
}
public static int toUInt16(final byte[] bytes, final int offset, final ByteOrder byteOrder) {
final int byte0 = 0xff & bytes[offset + 0];
final int byte1 = 0xff & bytes[offset + 1];
if (byteOrder == ByteOrder.MOTOROLA) {
return ((byte0 << 8) | byte1);
} else {
return ((byte1 << 8) | byte0);
}
}
public static int[] toUInt16s(final byte[] bytes, final ByteOrder byteOrder) {
return toUInt16s(bytes, 0, bytes.length, byteOrder);
}
public static int[] toUInt16s(final byte[] bytes, final int length,
final ByteOrder byteOrder) {
return toUInt16s(bytes, 0, length, byteOrder);
}
public static int[] toUInt16s(final byte[] bytes, final int offset, final int length,
final ByteOrder byteOrder) {
final int[] result = new int[length / 2];
for (int i = 0; i < result.length; i++) {
result[i] = toUInt16(bytes, offset + 2 * i, byteOrder);
}
return result;
}
public static int toInt(final byte[] bytes, final ByteOrder byteOrder) {
return toInt(bytes, 0, byteOrder);
}
public static int toInt(final byte[] bytes, final int offset, final ByteOrder byteOrder) {
final int byte0 = 0xff & bytes[offset + 0];
final int byte1 = 0xff & bytes[offset + 1];
final int byte2 = 0xff & bytes[offset + 2];
final int byte3 = 0xff & bytes[offset + 3];
if (byteOrder == ByteOrder.MOTOROLA) {
return (byte0 << 24) | (byte1 << 16) | (byte2 << 8) | byte3;
} else {
return (byte3 << 24) | (byte2 << 16) | (byte1 << 8) | byte0;
}
}
public static int[] toInts(final byte[] bytes, final ByteOrder byteOrder) {
return toInts(bytes, 0, bytes.length, byteOrder);
}
public static int[] toInts(final byte[] bytes, final int length,
final ByteOrder byteOrder) {
return toInts(bytes, 0, length, byteOrder);
}
public static int[] toInts(final byte[] bytes, final int offset, final int length,
final ByteOrder byteOrder) {
final int[] result = new int[length / 4];
for (int i = 0; i < result.length; i++) {
result[i] = toInt(bytes, offset + 4 * i, byteOrder);
}
return result;
}
public static float toFloat(final byte[] bytes, final ByteOrder byteOrder) {
return toFloat(bytes, 0, byteOrder);
}
public static float toFloat(final byte[] bytes, final int offset, final ByteOrder byteOrder) {
final int byte0 = 0xff & bytes[offset + 0];
final int byte1 = 0xff & bytes[offset + 1];
final int byte2 = 0xff & bytes[offset + 2];
final int byte3 = 0xff & bytes[offset + 3];
final int bits;
if (byteOrder == ByteOrder.MOTOROLA) {
bits = (byte0 << 24) | (byte1 << 16) | (byte2 << 8) | (byte3 << 0);
} else {
bits = (byte3 << 24) | (byte2 << 16) | (byte1 << 8) | (byte0 << 0);
}
return Float.intBitsToFloat(bits);
}
public static float[] toFloats(final byte[] bytes, final ByteOrder byteOrder) {
return toFloats(bytes, 0, bytes.length, byteOrder);
}
public static float[] toFloats(final byte[] bytes, final int length,
final ByteOrder byteOrder) {
return toFloats(bytes, 0, length, byteOrder);
}
public static float[] toFloats(final byte[] bytes, final int offset,
final int length, final ByteOrder byteOrder) {
final float[] result = new float[length / 4];
for (int i = 0; i < result.length; i++) {
result[i] = toFloat(bytes, offset + 4 * i, byteOrder);
}
return result;
}
public static double toDouble(final byte[] bytes, final ByteOrder byteOrder) {
return toDouble(bytes, 0, byteOrder);
}
public static double toDouble(final byte[] bytes, final int offset, final ByteOrder byteOrder) {
final long byte0 = 0xffL & bytes[offset + 0];
final long byte1 = 0xffL & bytes[offset + 1];
final long byte2 = 0xffL & bytes[offset + 2];
final long byte3 = 0xffL & bytes[offset + 3];
final long byte4 = 0xffL & bytes[offset + 4];
final long byte5 = 0xffL & bytes[offset + 5];
final long byte6 = 0xffL & bytes[offset + 6];
final long byte7 = 0xffL & bytes[offset + 7];
final long bits;
if (byteOrder == ByteOrder.MOTOROLA) {
bits = (byte0 << 56) | (byte1 << 48) | (byte2 << 40)
| (byte3 << 32) | (byte4 << 24) | (byte5 << 16)
| (byte6 << 8) | (byte7 << 0);
} else {
bits = (byte7 << 56) | (byte6 << 48) | (byte5 << 40)
| (byte4 << 32) | (byte3 << 24) | (byte2 << 16)
| (byte1 << 8) | (byte0 << 0);
}
return Double.longBitsToDouble(bits);
}
public static double[] toDoubles(final byte[] bytes, final ByteOrder byteOrder) {
return toDoubles(bytes, 0, bytes.length, byteOrder);
}
public static double[] toDoubles(final byte[] bytes, final int length,
final ByteOrder byteOrder) {
return toDoubles(bytes, 0, length, byteOrder);
}
public static double[] toDoubles(final byte[] bytes, final int offset,
final int length, final ByteOrder byteOrder) {
final double[] result = new double[length / 8];
for (int i = 0; i < result.length; i++) {
result[i] = toDouble(bytes, offset + 8 * i, byteOrder);
}
return result;
}
public static RationalNumber toRational(final byte[] bytes, final ByteOrder byteOrder) {
return toRational(bytes, 0, byteOrder);
}
public static RationalNumber toRational(final byte[] bytes, final int offset,
final ByteOrder byteOrder) {
final int byte0 = 0xff & bytes[offset + 0];
final int byte1 = 0xff & bytes[offset + 1];
final int byte2 = 0xff & bytes[offset + 2];
final int byte3 = 0xff & bytes[offset + 3];
final int byte4 = 0xff & bytes[offset + 4];
final int byte5 = 0xff & bytes[offset + 5];
final int byte6 = 0xff & bytes[offset + 6];
final int byte7 = 0xff & bytes[offset + 7];
final int numerator;
final int divisor;
if (byteOrder == ByteOrder.MOTOROLA) {
numerator = (byte0 << 24) | (byte1 << 16) | (byte2 << 8) | byte3;
divisor = (byte4 << 24) | (byte5 << 16) | (byte6 << 8) | byte7;
} else {
numerator = (byte3 << 24) | (byte2 << 16) | (byte1 << 8) | byte0;
divisor = (byte7 << 24) | (byte6 << 16) | (byte5 << 8) | byte4;
}
return new RationalNumber(numerator, divisor);
}
public static RationalNumber[] toRationals(final byte[] bytes,
final ByteOrder byteOrder) {
return toRationals(bytes, 0, bytes.length, byteOrder);
}
public static RationalNumber[] toRationals(final byte[] bytes,
final int length, final ByteOrder byteOrder) {
return toRationals(bytes, 0, length, byteOrder);
}
public static RationalNumber[] toRationals(final byte[] bytes,
final int offset, final int length, final ByteOrder byteOrder) {
final RationalNumber[] result = new RationalNumber[length / 8];
for (int i = 0; i < result.length; i++) {
result[i] = toRational(bytes, offset + 8 * i, byteOrder);
}
return result;
}
}