add gamma ramps + suppress serial warning on libgammaexception

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 291 insertions, 0 deletions

diff --git a/src/libgamma/GammaRamps.java b/src/libgamma/GammaRamps.java
new file mode 100644
index 0000000..32be718
--- /dev/null
+++ b/src/libgamma/GammaRamps.java
@@ -0,0 +1,291 @@
+/**
+ * jlibgamma — Display server abstraction layer for gamma ramp and Java
+ * Copyright © 2014  Mattias Andrée (maandree@member.fsf.org)
+ * 
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License
+ * along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package libgamma;
+
+
+/**
+ * Gamma ramp structure.
+ * 
+ * @param  <T>  The ramp class, should be select in accordance
+ *              with the <tt>depth</tt> parameter of the constructor:
+ *              <p>
+ *               8:  Ramp8<br/>
+ *              16:  Ramp16<br/>
+ *              32:  Ramp32<br/>
+ *              64:  Ramp64<br/>
+ *              -1:  Rampf<br/>
+ *              -2:  Rampd<br/>
+ *              </p>
+ */
+public class GammaRamps<T extends Ramp>
+{
+    /**
+     * Constructor.
+     * 
+     * @param  red_size    The size of the encoding axis of the red gamma ramp.
+     * @param  green_size  The size of the encoding axis of the green gamma ramp.
+     * @param  blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @param  depth       The bit-depth of the value axes of gamma ramps,
+     *                     -1 for single precision floating point, and -2 for
+     *                     double precision floating point.
+     */
+    @SuppressWarnings("unchecked")
+    public GammaRamps(int red_size, int green_size, int blue_size, short depth) throws LibgammaException
+    {
+	long[] r;
+	if      (depth ==  8)  r = libgamma_gamma_ramps8_create (red_size, green_size, blue_size);
+	else if (depth == 16)  r = libgamma_gamma_ramps16_create(red_size, green_size, blue_size);
+	else if (depth == 32)  r = libgamma_gamma_ramps32_create(red_size, green_size, blue_size);
+	else if (depth == 64)  r = libgamma_gamma_ramps64_create(red_size, green_size, blue_size);
+	else if (depth == -1)  r = libgamma_gamma_rampsf_create (red_size, green_size, blue_size);
+	else if (depth == -2)  r = libgamma_gamma_rampsd_create (red_size, green_size, blue_size);
+	else
+	    throw new IllegalArgumentException("depth must be either of: 8, 16, 32, 64, -1, -2.");
+	
+	if (r[4] != 0)
+	    throw new LibgammaException((int)(r[4]));
+	
+	this.address = r[0];
+	this.depth = depth;
+	
+	Ramp red   = null;
+	Ramp green = null;
+	Ramp blue  = null;
+	
+	if      (depth ==  8)  red   = (Ramp)(new Ramp8 (r[1],   red_size));
+	else if (depth == 16)  red   = (Ramp)(new Ramp16(r[1],   red_size));
+	else if (depth == 32)  red   = (Ramp)(new Ramp32(r[1],   red_size));
+	else if (depth == 64)  red   = (Ramp)(new Ramp64(r[1],   red_size));
+	else if (depth == -1)  red   = (Ramp)(new Rampf (r[1],   red_size));
+	else if (depth == -2)  red   = (Ramp)(new Rampd (r[1],   red_size));
+	
+	if      (depth ==  8)  green = (Ramp)(new Ramp8 (r[2], green_size));
+	else if (depth == 16)  green = (Ramp)(new Ramp16(r[2], green_size));
+	else if (depth == 32)  green = (Ramp)(new Ramp32(r[2], green_size));
+	else if (depth == 64)  green = (Ramp)(new Ramp64(r[2], green_size));
+	else if (depth == -1)  green = (Ramp)(new Rampf (r[2], green_size));
+	else if (depth == -2)  green = (Ramp)(new Rampd (r[2], green_size));
+	
+	if      (depth ==  8)  blue  = (Ramp)(new Ramp8 (r[3],  blue_size));
+	else if (depth == 16)  blue  = (Ramp)(new Ramp16(r[3],  blue_size));
+	else if (depth == 32)  blue  = (Ramp)(new Ramp32(r[3],  blue_size));
+	else if (depth == 64)  blue  = (Ramp)(new Ramp64(r[3],  blue_size));
+	else if (depth == -1)  blue  = (Ramp)(new Rampf (r[3],  blue_size));
+	else if (depth == -2)  blue  = (Ramp)(new Rampd (r[3],  blue_size));
+	
+	this.red   = (T)red;
+	this.green = (T)green;
+	this.blue  = (T)blue;
+    }
+    
+    
+    /**
+     * The gamma ramp for the red channel.
+     */
+    public final T red;
+    
+    /**
+     * The gamma ramp for the green channel.
+     */
+    public final T green;
+    
+    /**
+     * The gamma ramp for the blue channel.
+     */
+    public final T blue;
+    
+    /**
+     * The bit-depth of the value axes of gamma ramps,
+     * -1 for single precision floating point, and -2 for
+     * double precision floating point.
+     */
+    public final short depth;
+    
+    /**
+     * The address of the native object.
+     */
+    private final long address;
+    
+    
+    /**
+     * Release resources.
+     */
+    public void close()
+    {
+	if      (this.depth ==  8)  libgamma_gamma_ramps8_free(this.address);
+	else if (this.depth == 16)  libgamma_gamma_ramps16_free(this.address);
+	else if (this.depth == 32)  libgamma_gamma_ramps32_free(this.address);
+	else if (this.depth == 64)  libgamma_gamma_ramps64_free(this.address);
+	else if (this.depth == -1)  libgamma_gamma_rampsf_free(this.address);
+	else if (this.depth == -2)  libgamma_gamma_rampsd_free(this.address);
+    }
+    
+    
+    /**
+     * Create and initialise a gamma ramp in the proper way that allows all adjustment
+     * methods to read from and write to it without causing segmentation violation.
+     * 
+     * @param   red_size    The size of the encoding axis of the red gamma ramp.
+     * @param   green_size  The size of the encoding axis of the green gamma ramp.
+     * @param   blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @return              Element 0:  The address of the native object.
+     *                      Element 1:  The address of the red gamma ramp.
+     *                      Element 2:  The address of the green gamma ramp.
+     *                      Element 3:  The address of the blue gamma ramp.
+     *                      Element 4:  Zero on success, an error code on error.
+     */
+    private static native long[] libgamma_gamma_ramps8_create(int red_size, int green_size, int blue_size);
+    
+    /**
+     * Create and initialise a gamma ramp in the proper way that allows all adjustment
+     * methods to read from and write to it without causing segmentation violation.
+     * 
+     * @param   red_size    The size of the encoding axis of the red gamma ramp.
+     * @param   green_size  The size of the encoding axis of the green gamma ramp.
+     * @param   blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @return              Element 0:  The address of the native object.
+     *                      Element 1:  The address of the red gamma ramp.
+     *                      Element 2:  The address of the green gamma ramp.
+     *                      Element 3:  The address of the blue gamma ramp.
+     *                      Element 4:  Zero on success, an error code on error.
+     */
+    private static native long[] libgamma_gamma_ramps16_create(int red_size, int green_size, int blue_size);
+    
+    /**
+     * Create and initialise a gamma ramp in the proper way that allows all adjustment
+     * methods to read from and write to it without causing segmentation violation.
+     * 
+     * @param   red_size    The size of the encoding axis of the red gamma ramp.
+     * @param   green_size  The size of the encoding axis of the green gamma ramp.
+     * @param   blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @return              Element 0:  The address of the native object.
+     *                      Element 1:  The address of the red gamma ramp.
+     *                      Element 2:  The address of the green gamma ramp.
+     *                      Element 3:  The address of the blue gamma ramp.
+     *                      Element 4:  Zero on success, an error code on error.
+     */
+    private static native long[] libgamma_gamma_ramps32_create(int red_size, int green_size, int blue_size);
+    
+    /**
+     * Create and initialise a gamma ramp in the proper way that allows all adjustment
+     * methods to read from and write to it without causing segmentation violation.
+     * 
+     * @param   red_size    The size of the encoding axis of the red gamma ramp.
+     * @param   green_size  The size of the encoding axis of the green gamma ramp.
+     * @param   blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @return              Element 0:  The address of the native object.
+     *                      Element 1:  The address of the red gamma ramp.
+     *                      Element 2:  The address of the green gamma ramp.
+     *                      Element 3:  The address of the blue gamma ramp.
+     *                      Element 4:  Zero on success, an error code on error.
+     */
+    private static native long[] libgamma_gamma_ramps64_create(int red_size, int green_size, int blue_size);
+    
+    /**
+     * Create and initialise a gamma ramp in the proper way that allows all adjustment
+     * methods to read from and write to it without causing segmentation violation.
+     * 
+     * @param   red_size    The size of the encoding axis of the red gamma ramp.
+     * @param   green_size  The size of the encoding axis of the green gamma ramp.
+     * @param   blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @return              Element 0:  The address of the native object.
+     *                      Element 1:  The address of the red gamma ramp.
+     *                      Element 2:  The address of the green gamma ramp.
+     *                      Element 3:  The address of the blue gamma ramp.
+     *                      Element 4:  Zero on success, an error code on error.
+     */
+    private static native long[] libgamma_gamma_rampsf_create(int red_size, int green_size, int blue_size);
+    
+    /**
+     * Create and initialise a gamma ramp in the proper way that allows all adjustment
+     * methods to read from and write to it without causing segmentation violation.
+     * 
+     * @param   red_size    The size of the encoding axis of the red gamma ramp.
+     * @param   green_size  The size of the encoding axis of the green gamma ramp.
+     * @param   blue_size   The size of the encoding axis of the blue gamma ramp.
+     * @return              Element 0:  The address of the native object.
+     *                      Element 1:  The address of the red gamma ramp.
+     *                      Element 2:  The address of the green gamma ramp.
+     *                      Element 3:  The address of the blue gamma ramp.
+     *                      Element 4:  Zero on success, an error code on error.
+     */
+    private static native long[] libgamma_gamma_rampsd_create(int red_size, int green_size, int blue_size);
+    
+    
+    /**
+     * Release resources that are held by a gamma ramp strcuture that
+     * has been allocated by {@link #libgamma_gamma_ramps8_create} or
+     * otherwise initialised in the proper manner, as well as release
+     * the pointer to the structure.
+     * 
+     * @param  address  The gamma ramps.
+     */
+    private static native void libgamma_gamma_ramps8_free(long address);
+    
+    /**
+     * Release resources that are held by a gamma ramp strcuture that
+     * has been allocated by {@link #libgamma_gamma_ramps16_create} or
+     * otherwise initialised in the proper manner, as well as release
+     * the pointer to the structure.
+     * 
+     * @param  address  The gamma ramps.
+     */
+    private static native void libgamma_gamma_ramps16_free(long address);
+    
+    /**
+     * Release resources that are held by a gamma ramp strcuture that
+     * has been allocated by {@link #libgamma_gamma_ramps32_create} or
+     * otherwise initialised in the proper manner, as well as release
+     * the pointer to the structure.
+     * 
+     * @param  address  The gamma ramps.
+     */
+    private static native void libgamma_gamma_ramps32_free(long address);
+    
+    /**
+     * Release resources that are held by a gamma ramp strcuture that
+     * has been allocated by {@link #libgamma_gamma_ramps64_create} or
+     * otherwise initialised in the proper manner, as well as release
+     * the pointer to the structure.
+     * 
+     * @param  address  The gamma ramps.
+     */
+    private static native void libgamma_gamma_ramps64_free(long address);
+    
+    /**
+     * Release resources that are held by a gamma ramp strcuture that
+     * has been allocated by {@link #libgamma_gamma_rampsf_create} or
+     * otherwise initialised in the proper manner, as well as release
+     * the pointer to the structure.
+     * 
+     * @param  address  The gamma ramps.
+     */
+    private static native void libgamma_gamma_rampsf_free(long address);
+    
+    /**
+     * Release resources that are held by a gamma ramp strcuture that
+     * has been allocated by {@link #libgamma_gamma_rampsd_create} or
+     * otherwise initialised in the proper manner, as well as release
+     * the pointer to the structure.
+     * 
+     * @param  address  The gamma ramps.
+     */
+    private static native void libgamma_gamma_rampsd_free(long address);
+    
+}
+