Add JNI wrapper for TurboJPEG/OSS

git-svn-id: https://libjpeg-turbo.svn.sourceforge.net/svnroot/libjpeg-turbo@337 3789f03b-4d11-0410-bbf8-ca57d06f2519

6 files changed, 370 insertions, 0 deletions

diff --git a/trunk/java/README b/trunk/java/README
new file mode 100644
index 0000000..cc141e9
--- /dev/null
+++ b/trunk/java/README
@@ -0,0 +1,27 @@
+TurboJPEG/OSS JNI Wrapper
+=========================
+
+TurboJPEG/OSS can optionally be built with a Java Native Interface wrapper,
+which allows the TurboJPEG/OSS dynamic library to be loaded and used directly
+from Java applications.  The Java front end for this is defined in
+turbojpeg.java, which should be located in the same directory as this README
+file.  turbojpeg.java is licensed under a BSD-style license, so it can be
+incorporated directly into both open source and proprietary projects without
+restriction.
+
+tjexample.java, which should also be located in the same directory as this
+README file, demonstrates how to use the TurboJPEG/OSS Java front end to
+compress and decompress JPEG images in memory.
+
+  javac *.java
+
+builds .class files for both the front end and example code.
+
+
+Note for OS X users
+-------------------
+
+/usr/lib, the directory under which libturbojpeg.dylib is installed on Mac
+systems, is not part of the normal Java library path.  Thus, when running a
+Java application that uses TurboJPEG/OSS on Mac systems, you will need to pass
+an argument of -Djava.library.path=/usr/lib to java.
diff --git a/trunk/java/TJ.h b/trunk/java/TJ.h
new file mode 100644
index 0000000..ab8b3fb
--- /dev/null
+++ b/trunk/java/TJ.h
@@ -0,0 +1,47 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class TJ */
+
+#ifndef _Included_TJ
+#define _Included_TJ
+#ifdef __cplusplus
+extern "C" {
+#endif
+#undef TJ_SAMP444
+#define TJ_SAMP444 0L
+#undef TJ_SAMP422
+#define TJ_SAMP422 1L
+#undef TJ_SAMP420
+#define TJ_SAMP420 2L
+#undef TJ_GRAYSCALE
+#define TJ_GRAYSCALE 3L
+#undef TJ_BGR
+#define TJ_BGR 1L
+#undef TJ_BOTTOMUP
+#define TJ_BOTTOMUP 2L
+#undef TJ_FORCEMMX
+#define TJ_FORCEMMX 8L
+#undef TJ_FORCESSE
+#define TJ_FORCESSE 16L
+#undef TJ_FORCESSE2
+#define TJ_FORCESSE2 32L
+#undef TJ_ALPHAFIRST
+#define TJ_ALPHAFIRST 64L
+#undef TJ_FORCESSE3
+#define TJ_FORCESSE3 128L
+#undef TJ_FASTUPSAMPLE
+#define TJ_FASTUPSAMPLE 256L
+#undef TJ_YUV
+#define TJ_YUV 512L
+/*
+ * Class:     TJ
+ * Method:    BUFSIZE
+ * Signature: (II)J
+ */
+JNIEXPORT jlong JNICALL Java_TJ_BUFSIZE
+  (JNIEnv *, jobject, jint, jint);
+
+#ifdef __cplusplus
+}
+#endif
+#endif
diff --git a/trunk/java/tjCompressor.h b/trunk/java/tjCompressor.h
new file mode 100644
index 0000000..fa2c5ff
--- /dev/null
+++ b/trunk/java/tjCompressor.h
@@ -0,0 +1,37 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class tjCompressor */
+
+#ifndef _Included_tjCompressor
+#define _Included_tjCompressor
+#ifdef __cplusplus
+extern "C" {
+#endif
+/*
+ * Class:     tjCompressor
+ * Method:    Init
+ * Signature: ()V
+ */
+JNIEXPORT void JNICALL Java_tjCompressor_Init
+  (JNIEnv *, jobject);
+
+/*
+ * Class:     tjCompressor
+ * Method:    Destroy
+ * Signature: ()V
+ */
+JNIEXPORT void JNICALL Java_tjCompressor_Destroy
+  (JNIEnv *, jobject);
+
+/*
+ * Class:     tjCompressor
+ * Method:    Compress
+ * Signature: ([BIIII[BIII)J
+ */
+JNIEXPORT jlong JNICALL Java_tjCompressor_Compress
+  (JNIEnv *, jobject, jbyteArray, jint, jint, jint, jint, jbyteArray, jint, jint, jint);
+
+#ifdef __cplusplus
+}
+#endif
+#endif
diff --git a/trunk/java/tjDecompressor.h b/trunk/java/tjDecompressor.h
new file mode 100644
index 0000000..498112b
--- /dev/null
+++ b/trunk/java/tjDecompressor.h
@@ -0,0 +1,45 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class tjDecompressor */
+
+#ifndef _Included_tjDecompressor
+#define _Included_tjDecompressor
+#ifdef __cplusplus
+extern "C" {
+#endif
+/*
+ * Class:     tjDecompressor
+ * Method:    Init
+ * Signature: ()V
+ */
+JNIEXPORT void JNICALL Java_tjDecompressor_Init
+  (JNIEnv *, jobject);
+
+/*
+ * Class:     tjDecompressor
+ * Method:    Destroy
+ * Signature: ()V
+ */
+JNIEXPORT void JNICALL Java_tjDecompressor_Destroy
+  (JNIEnv *, jobject);
+
+/*
+ * Class:     tjDecompressor
+ * Method:    DecompressHeader
+ * Signature: ([BJ)LtjHeaderInfo;
+ */
+JNIEXPORT jobject JNICALL Java_tjDecompressor_DecompressHeader
+  (JNIEnv *, jobject, jbyteArray, jlong);
+
+/*
+ * Class:     tjDecompressor
+ * Method:    Decompress
+ * Signature: ([BJ[BIIIII)V
+ */
+JNIEXPORT void JNICALL Java_tjDecompressor_Decompress
+  (JNIEnv *, jobject, jbyteArray, jlong, jbyteArray, jint, jint, jint, jint, jint);
+
+#ifdef __cplusplus
+}
+#endif
+#endif
diff --git a/trunk/java/tjexample.java b/trunk/java/tjexample.java
new file mode 100644
index 0000000..5f92333
--- /dev/null
+++ b/trunk/java/tjexample.java
@@ -0,0 +1,91 @@
+/*
+ * Copyright (C)2011 D. R. Commander.  All Rights Reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ *   this list of conditions and the following disclaimer.
+ * - 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.
+ * - Neither the name of the libjpeg-turbo Project nor the names of its
+ *   contributors may be used to endorse or promote products derived from this
+ *   software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT HOLDERS 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.
+ */
+
+/*
+ * This program demonstrates how to compress and decompress JPEG files using
+ * the TurboJPEG JNI wrapper
+ */
+
+import java.io.*;
+
+public class tjexample {
+
+  public static final String classname=new tjexample().getClass().getName();
+
+  public static void main(String argv[]) {
+
+    try {
+
+      if(argv.length<2) {
+        System.out.println("USAGE: java "+classname+" <Input file> <Output file>");
+        System.exit(1);
+      }
+
+      File file=new File(argv[0]);
+      FileInputStream fis=new FileInputStream(file);
+      int inputsize=fis.available();
+      if(inputsize<1) {
+        System.out.println("Input file contains no data");
+        System.exit(1);
+      }
+      byte [] inputbuf=new byte[inputsize];
+      fis.read(inputbuf);
+      fis.close();
+
+      tjDecompressor tjd=new tjDecompressor();
+      tjHeaderInfo tji=tjd.DecompressHeader(inputbuf, inputsize);
+      System.out.print("Source Image: "+tji.width+" x "+tji.height+ " pixels, ");
+      switch(tji.subsamp) {
+        case TJ.SAMP444:  System.out.println("4:4:4 subsampling");  break;
+        case TJ.SAMP422:  System.out.println("4:2:2 subsampling");  break;
+        case TJ.SAMP420:  System.out.println("4:2:0 subsampling");  break;
+        case TJ.GRAYSCALE:  System.out.println("Grayscale");  break;
+        default:  System.out.println("Unknown subsampling");  break;
+      }
+      byte [] tmpbuf=new byte[tji.width*tji.height*3];
+      tjd.Decompress(inputbuf, inputsize, tmpbuf, tji.width, tji.width*3,
+        tji.height, 3, TJ.BOTTOMUP);
+      tjd.close();
+
+      tjCompressor tjc=new tjCompressor();
+      byte [] outputbuf=new byte[(int)TJ.BUFSIZE(tji.width, tji.height)];
+      long outputsize=tjc.Compress(tmpbuf, tji.width, tji.width*3, tji.height,
+        3, outputbuf, tji.subsamp, 95, TJ.BOTTOMUP);
+      tjc.close();
+
+      file=new File(argv[1]);
+      FileOutputStream fos=new FileOutputStream(file);
+      fos.write(outputbuf, 0, (int)outputsize);
+      fos.close();
+
+    } catch(Exception e) {
+      System.out.println(e);
+    }
+  }
+
+};
diff --git a/trunk/java/turbojpeg.java b/trunk/java/turbojpeg.java
new file mode 100644
index 0000000..e5ecca7
--- /dev/null
+++ b/trunk/java/turbojpeg.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright (C)2011 D. R. Commander.  All Rights Reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ *   this list of conditions and the following disclaimer.
+ * - 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.
+ * - Neither the name of the libjpeg-turbo Project nor the names of its
+ *   contributors may be used to endorse or promote products derived from this
+ *   software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT HOLDERS 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.
+ */
+
+final class TJ {
+
+  // Subsampling options
+  final static int
+    SAMP444    = 0,
+    SAMP422    = 1,
+    SAMP420    = 2,
+    GRAYSCALE  = 3;
+
+  // Flags
+  final static int
+    BGR          = 1,
+    BOTTOMUP     = 2,
+    FORCEMMX     = 8,
+    FORCESSE     = 16,
+    FORCESSE2    = 32,
+    ALPHAFIRST   = 64,
+    FORCESSE3    = 128,
+    FASTUPSAMPLE = 256,
+    YUV          = 512;
+
+  public native final static long BUFSIZE(int width, int height);
+};
+
+class tjCompressor {
+
+  tjCompressor() throws Exception {Init();}
+
+  public void close() throws Exception {Destroy();}
+
+  protected void finalize() throws Throwable {
+    try {
+      close();
+    } catch(Exception e) {
+    }
+    finally {
+      super.finalize();
+    }
+  };
+
+  private native void Init() throws Exception;
+
+  private native void Destroy() throws Exception;
+
+  // JPEG size in bytes is returned
+  public native long Compress(byte [] srcbuf, int width, int pitch,
+    int height, int pixelsize, byte [] dstbuf, int jpegsubsamp, int jpegqual,
+    int flags) throws Exception;
+
+  static {
+    System.loadLibrary("turbojpeg");
+  }
+
+  private long handle=0;
+};
+
+class tjHeaderInfo {
+  int subsamp=-1;
+  int width=-1;
+  int height=-1;
+};
+
+class tjDecompressor {
+
+  tjDecompressor() throws Exception {Init();}
+
+  public void close() throws Exception {Destroy();}
+
+  protected void finalize() throws Throwable {
+    try {
+      close();
+    } catch(Exception e) {
+    }
+    finally {
+      super.finalize();
+    }
+  };
+
+  private native void Init() throws Exception;
+
+  private native void Destroy() throws Exception;
+
+  public native tjHeaderInfo DecompressHeader(byte [] srcbuf, long size)
+    throws Exception;
+
+  public native void Decompress(byte [] srcbuf, long size, byte [] dstbuf,
+    int width, int pitch, int height, int pixelsize, int flags)
+    throws Exception;
+
+  static {
+    System.loadLibrary("turbojpeg");
+  }
+
+  private long handle=0;
+};