Buffers: Add normalized put methods, i.e. incl. value range conversion; New util. ValueConv for primitive type value conversion

1 files changed, 161 insertions, 0 deletions

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);
+    }
+}