From cae1502304faac54fb6673ed31eb1493e8388497 Mon Sep 17 00:00:00 2001 From: Sven Gothel <sgothel@jausoft.com> Date: Wed, 17 Oct 2012 18:00:04 +0200 Subject: Buffers: Add normalized put methods, i.e. incl. value range conversion; New util. ValueConv for primitive type value conversion --- src/java/com/jogamp/common/nio/Buffers.java | 110 ++++++++++++++++- src/java/com/jogamp/common/util/ValueConv.java | 161 +++++++++++++++++++++++++ 2 files changed, 269 insertions(+), 2 deletions(-) create mode 100644 src/java/com/jogamp/common/util/ValueConv.java (limited to 'src/java/com/jogamp/common') diff --git a/src/java/com/jogamp/common/nio/Buffers.java b/src/java/com/jogamp/common/nio/Buffers.java index 5b5f83b..07a73b1 100755 --- a/src/java/com/jogamp/common/nio/Buffers.java +++ b/src/java/com/jogamp/common/nio/Buffers.java @@ -41,6 +41,8 @@ package com.jogamp.common.nio; import java.nio.*; +import com.jogamp.common.util.ValueConv; + /** * Utility methods allowing easy {@link java.nio.Buffer} manipulations. * @@ -663,8 +665,9 @@ public class Buffers { //---------------------------------------------------------------------- - // Convenient put methods with generic target Buffer - // + // Convenient put methods with generic target Buffer w/o value range conversion, i.e. normalization + // + @SuppressWarnings("unchecked") public static <B extends Buffer> B put(B dest, Buffer src) { if ((dest instanceof ByteBuffer) && (src instanceof ByteBuffer)) { @@ -762,6 +765,109 @@ public class Buffers { } } + //---------------------------------------------------------------------- + // Convenient put methods with generic target Buffer and value range conversion, i.e. normalization + // + + /** + * Store byte source value in given buffer after normalizing it to the destination value range + * considering signed and unsigned source and destination representation. + * + * @param dest One of {@link ByteBuffer}, {@link ShortBuffer}, {@link IntBuffer}, {@link FloatBuffer} + * @param dSigned true if destination buffer holds signed values, false if destination buffer holds unsigned values + * @param v source byte value to be put in dest buffer + * @param sSigned true if source represents a signed value, false if source represents an unsigned value + */ + @SuppressWarnings("unchecked") + public static <B extends Buffer> B putNb(B dest, boolean dSigned, byte v, boolean sSigned) { + if (dest instanceof ByteBuffer) { + return (B) ((ByteBuffer) dest).put( v ); + } else if (dest instanceof ShortBuffer) { + return (B) ((ShortBuffer) dest).put( ValueConv.byte_to_short(v, sSigned, dSigned) ); + } else if (dest instanceof IntBuffer) { + return (B) ((IntBuffer) dest).put( ValueConv.byte_to_int(v, sSigned, dSigned) ); + } else if (dest instanceof FloatBuffer) { + return (B) ((FloatBuffer) dest).put( ValueConv.byte_to_float(v, sSigned) ); + } else { + throw new IllegalArgumentException("Byte doesn't match Buffer Class: " + dest); + } + } + + /** + * Store short source value in given buffer after normalizing it to the destination value range + * considering signed and unsigned source and destination representation. + * + * @param dest One of {@link ByteBuffer}, {@link ShortBuffer}, {@link IntBuffer}, {@link FloatBuffer} + * @param dSigned true if destination buffer holds signed values, false if destination buffer holds unsigned values + * @param v source short value to be put in dest buffer + * @param sSigned true if source represents a signed value, false if source represents an unsigned value + */ + @SuppressWarnings("unchecked") + public static <B extends Buffer> B putNs(B dest, boolean dSigned, short v, boolean sSigned) { + if (dest instanceof ByteBuffer) { + return (B) ((ByteBuffer) dest).put( ValueConv.short_to_byte(v, sSigned, dSigned) ); + } else if (dest instanceof ShortBuffer) { + return (B) ((ShortBuffer) dest).put( v ); + } else if (dest instanceof IntBuffer) { + return (B) ((IntBuffer) dest).put( ValueConv.short_to_int(v, sSigned, dSigned) ); + } else if (dest instanceof FloatBuffer) { + return (B) ((FloatBuffer) dest).put( ValueConv.short_to_float(v, sSigned) ); + } else { + throw new IllegalArgumentException("Byte doesn't match Buffer Class: " + dest); + } + } + + /** + * Store short source value in given buffer after normalizing it to the destination value range + * considering signed and unsigned source and destination representation. + * + * @param dest One of {@link ByteBuffer}, {@link ShortBuffer}, {@link IntBuffer}, {@link FloatBuffer} + * @param dSigned true if destination buffer holds signed values, false if destination buffer holds unsigned values + * @param v source short value to be put in dest buffer + * @param sSigned true if source represents a signed value, false if source represents an unsigned value + */ + @SuppressWarnings("unchecked") + public static <B extends Buffer> B putNi(B dest, boolean dSigned, int v, boolean sSigned) { + if (dest instanceof ByteBuffer) { + return (B) ((ByteBuffer) dest).put( ValueConv.int_to_byte(v, sSigned, dSigned) ); + } else if (dest instanceof ShortBuffer) { + return (B) ((ShortBuffer) dest).put( ValueConv.int_to_short(v, sSigned, dSigned) ); + } else if (dest instanceof IntBuffer) { + return (B) ((IntBuffer) dest).put( v ); + } else if (dest instanceof FloatBuffer) { + return (B) ((FloatBuffer) dest).put( ValueConv.int_to_float(v, sSigned) ); + } else { + throw new IllegalArgumentException("Byte doesn't match Buffer Class: " + dest); + } + } + + /** + * Store float source value in given buffer after normalizing it to the destination value range + * considering signed and unsigned destination representation. + * + * @param dest One of {@link ByteBuffer}, {@link ShortBuffer}, {@link IntBuffer}, {@link FloatBuffer} + * @param dSigned true if destination buffer holds signed values, false if destination buffer holds unsigned values + * @param v source float value to be put in dest buffer + */ + @SuppressWarnings("unchecked") + public static <B extends Buffer> B putNf(B dest, boolean dSigned, float v) { + if (dest instanceof ByteBuffer) { + return (B) ((ByteBuffer) dest).put( ValueConv.float_to_byte(v, dSigned) ); + } else if (dest instanceof ShortBuffer) { + return (B) ((ShortBuffer) dest).put( ValueConv.float_to_short(v, dSigned) ); + } else if (dest instanceof IntBuffer) { + return (B) ((IntBuffer) dest).put( ValueConv.float_to_int(v, dSigned) ); + } else if (dest instanceof FloatBuffer) { + return (B) ((FloatBuffer) dest).put( v ); + } else { + throw new IllegalArgumentException("Byte doesn't match Buffer Class: " + dest); + } + } + + //---------------------------------------------------------------------- + // Range check methods + // + public static void rangeCheck(byte[] array, int offset, int minElementsRemaining) { if (array == null) { return; diff --git a/src/java/com/jogamp/common/util/ValueConv.java b/src/java/com/jogamp/common/util/ValueConv.java new file mode 100644 index 0000000..fa49341 --- /dev/null +++ b/src/java/com/jogamp/common/util/ValueConv.java @@ -0,0 +1,161 @@ +package com.jogamp.common.util; + +/** + * Copyright 2012 JogAmp Community. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, are + * permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, this list of + * conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, this list + * of conditions and the following disclaimer in the documentation and/or other materials + * provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF + * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * The views and conclusions contained in the software and documentation are those of the + * authors and should not be interpreted as representing official policies, either expressed + * or implied, of JogAmp Community. + */ + +/** + * Utility class providing simple signed and unsigned primitive value conversions + * for byte, short, int, float and double. + * <p> + * Non float to non float conversions are handled via float or double, + * depending on the value range. + * </p> + */ +public class ValueConv { + public static final byte float_to_byte(float v, boolean dSigned) { + // lossy + if( dSigned ) { + return (byte) ( v * ( v > 0 ? 127.0f : 128.0f ) ); + } else { + return (byte) ( v * 255.0f ); + } + } + public static final short float_to_short(float v, boolean dSigned) { + if( dSigned ) { + return (short) ( v * ( v > 0 ? 32767.0f : 32768.0f ) ); + } else { + return (short) ( v * 65535.0f ); + } + } + public static final int float_to_int(float v, boolean dSigned) { + // float significand 0x007fffff + // double significand 0x000fffffffffffffL + // int min = 0x80000000 = -2147483648 + // int max = 0x7fffffff = +2147483647 + if( dSigned ) { + return (int) ( v * ( v > 0 ? 2147483647.0 : 2147483648.0 ) ); + } else { + return (int) (long) ( v * 4294967295.0 ); + } + } + + public static final byte double_to_byte(double v, boolean dSigned) { + // lossy + if( dSigned ) { + return (byte) ( v * ( v > 0 ? 127.0 : 128.0 ) ); + } else { + return (byte) ( v * 255.0 ); + } + } + public static final short double_to_short(double v, boolean dSigned) { + // lossy + if( dSigned ) { + return (short) ( v * ( v > 0 ? 32767.0 : 32768.0 ) ); + } else { + return (short) ( v * 65535.0 ); + } + } + public static final int double_to_int(double v, boolean dSigned) { + // lossy + if( dSigned ) { + return (int) ( v * ( v > 0 ? 2147483647.0 : 2147483648.0 ) ); + } else { + return (int) (long) ( v * 4294967295.0 ); + } + } + + public static final float byte_to_float(byte v, boolean sSigned) { + if( sSigned ) { + return (v & 0xff) / ( v > 0 ? 127.0f : -128.0f ) ; + } else { + return (v & 0xff) / 255.0f ; + } + } + public static final double byte_to_double(byte v, boolean sSigned) { + if( sSigned ) { + return (v & 0xff) / ( v > 0 ? 127.0 : -128.0 ) ; + } else { + return (v & 0xff) / 255.0 ; + } + } + public static final float short_to_float(short v, boolean sSigned) { + if( sSigned ) { + return (v & 0xffff) / ( v > 0 ? 32767.0f : -32768.0f ) ; + } else { + return (v & 0xffff) / 65535.0f ; + } + } + public static final double short_to_double(short v, boolean sSigned) { + // lossy + if( sSigned ) { + return (v & 0xffff) / ( v > 0 ? 32767.0 : -32768.0 ) ; + } else { + return (v & 0xffff) / 65535.0 ; + } + } + public static final float int_to_float(int v, boolean sSigned) { + // lossy + // float significand 0x007fffff + // double significand 0x000fffffffffffffL + // int min = 0x80000000 = -2147483648 + // int max = 0x7fffffff = +2147483647 + if( sSigned ) { + return (float) ( v / ( v > 0 ? 2147483647.0 : 2147483648.0 ) ); + } else { + return (float) ( ((long)v & 0xffffffffL) / 4294967295.0 ); + } + } + public static final double int_to_double(int v, boolean sSigned) { + if( sSigned ) { + return v / ( v > 0 ? 2147483647.0 : 2147483648.0 ) ; + } else { + return ((long)v & 0xffffffffL) / 4294967295.0 ; + } + } + + public static final short byte_to_short(byte v, boolean sSigned, boolean dSigned) { + return float_to_short(byte_to_float(v, sSigned), dSigned); + } + public static final int byte_to_int(byte v, boolean sSigned, boolean dSigned) { + return float_to_int(byte_to_float(v, sSigned), dSigned); + } + + public static final byte short_to_byte(short v, boolean sSigned, boolean dSigned) { + return float_to_byte(short_to_float(v, sSigned), dSigned); + } + public static final int short_to_int(short v, boolean sSigned, boolean dSigned) { + return float_to_int(short_to_float(v, sSigned), dSigned); + } + + public static final byte int_to_byte(int v, boolean sSigned, boolean dSigned) { + return float_to_byte(int_to_float(v, sSigned), dSigned); + } + public static final short int_to_short(int v, boolean sSigned, boolean dSigned) { + return float_to_short(int_to_float(v, sSigned), dSigned); + } +} -- cgit v1.2.3