From 26606c71c8a5c3a79f9e371e1c0ddfcb800b77df Mon Sep 17 00:00:00 2001 From: Francois-Olivier Devaux Date: Mon, 10 Dec 2007 13:16:01 +0000 Subject: First import of JAVAOpenJPEG, a Java wrapper of OpenJPEG, developed by Patrick Piscaglia of Telemis (www.telemis.com). Thank you Patrick for this new module ! --- .../org/openJpeg/OpenJPEGJavaDecoder.java | 230 +++++++++++++++ .../org/openJpeg/OpenJPEGJavaEncoder.java | 318 +++++++++++++++++++++ 2 files changed, 548 insertions(+) create mode 100644 JavaOpenJPEG/java sources/org/openJpeg/OpenJPEGJavaDecoder.java create mode 100644 JavaOpenJPEG/java sources/org/openJpeg/OpenJPEGJavaEncoder.java (limited to 'JavaOpenJPEG/java sources') diff --git a/JavaOpenJPEG/java sources/org/openJpeg/OpenJPEGJavaDecoder.java b/JavaOpenJPEG/java sources/org/openJpeg/OpenJPEGJavaDecoder.java new file mode 100644 index 00000000..f976c27c --- /dev/null +++ b/JavaOpenJPEG/java sources/org/openJpeg/OpenJPEGJavaDecoder.java @@ -0,0 +1,230 @@ +/* + * $Id: $ + * + * Copyright (c) 1999-2007 Telemis SA. All Rights Reserved + + * Author: Patrick Piscaglia, Telemis s.a. +*/ +package org.openJpeg; + +import java.util.Vector; + +/** This class decodes one J2K codestream into an image (width + height + depth + pixels[], + * using the OpenJPEG.org library. + * To be able to log messages, the called must register a IJavaJ2KDecoderLogger object. + */ +public class OpenJPEGJavaDecoder { + + public interface IJavaJ2KDecoderLogger { + public void logDecoderMessage(String message); + public void logDecoderError(String message); + } + + private static boolean isInitialized = false; + + // ===== decompression parameters =============> + // These value may be changed for each image + private String[] decoder_arguments = null; + /** number of resolutions decompositions */ + private int nbResolutions = -1; + /** the quality layers */ + private int[] layers = null; + + /** Contains the 8 bpp version of the image. May NOT be filled together with image16 or image24.

+ * We store in Java the 8 or 16 bpp version of the image while the decoder uses a 32 bpp version, because

*/ + private byte[] image8 = null; + /** Contains the 16 bpp version of the image. May NOT be filled together with image8 or image24*/ + private short[] image16 = null; + /** Contains the 24 bpp version of the image. May NOT be filled together with image8 or image16 */ + private int[] image24 = null; + /** Holds the J2K compressed bytecode to decode */ + private byte compressedStream[] = null; + /** Holds the compressed version of the index file, to be used by the decoder */ + private byte compressedIndex[] = null; + /** Width and Height of the image */ + private int width = -1; + private int height = -1; + private int depth = -1; + /** This parameter is never used in Java but is read by the C library to know the number of resolutions to skip when decoding, + * i.e. if there are 5 resolutions and skipped=1 ==> decode until resolution 4. */ + private int skippedResolutions = 0; + + private Vector loggers = new Vector(); + + + public OpenJPEGJavaDecoder(String openJPEGlibraryFullPathAndName, IJavaJ2KDecoderLogger messagesAndErrorsLogger) throws ExceptionInInitializerError + { + this(openJPEGlibraryFullPathAndName); + loggers.addElement(messagesAndErrorsLogger); + } + + public OpenJPEGJavaDecoder(String openJPEGlibraryFullPathAndName) throws ExceptionInInitializerError + { + if (!isInitialized) { + try { + System.load(openJPEGlibraryFullPathAndName); + isInitialized = true; + } catch (Throwable t) { + throw new ExceptionInInitializerError("OpenJPEG Java Decoder: probably impossible to find the C library"); + } + } + } + + public void addLogger(IJavaJ2KDecoderLogger messagesAndErrorsLogger) { + loggers.addElement(messagesAndErrorsLogger); + } + + public void removeLogger(IJavaJ2KDecoderLogger messagesAndErrorsLogger) { + loggers.removeElement(messagesAndErrorsLogger); + } + + public int decodeJ2KtoImage() { + if ((image16 == null || (image16 != null && image16.length != width*height)) && (depth==-1 || depth==16)) { + image16 = new short[width*height]; + logMessage("OpenJPEGJavaDecoder.decompressImage: image16 length = " + image16.length + " (" + width + " x " + height + ") "); + } + if ((image8 == null || (image8 != null && image8.length != width*height)) && (depth==-1 || depth==8)) { + image8 = new byte[width*height]; + logMessage("OpenJPEGJavaDecoder.decompressImage: image8 length = " + image8.length + " (" + width + " x " + height + ") "); + } + if ((image24 == null || (image24 != null && image24.length != width*height)) && (depth==-1 || depth==24)) { + image24 = new int[width*height]; + logMessage("OpenJPEGJavaDecoder.decompressImage: image24 length = " + image24.length + " (" + width + " x " + height + ") "); + } + + String[] arguments = new String[0 + (decoder_arguments != null ? decoder_arguments.length : 0)]; + int offset = 0; + if (decoder_arguments != null) { + for (int i=0; i + // These value may be changed for each image + private String[] encoder_arguments = null; + /** number of resolutions decompositions */ + private int nbResolutions = -1; + /** the quality layers, expressed as compression rate */ + private float[] ratioLayers = null; + /** the quality layers, expressed as PSNR values. This variable, if defined, has priority over the ratioLayers variable */ + private float[] psnrLayers = null; + + /** Contains the 8 bpp version of the image. May NOT be filled together with image16 or image24.

+ * We store the 8 or 16 bpp version of the original image while the encoder uses a 32 bpp version, because

    + *
  • the storage capacity required is smaller + *
  • the transfer Java --> C will be faster + *
  • the conversion byte/short ==> int will be done faster by the C + *
*/ + private byte[] image8 = null; + /** Contains the 16 bpp version of the image. May NOT be filled together with image8 or image24*/ + private short[] image16 = null; + /** Contains the 24 bpp version of the image. May NOT be filled together with image8 or image16 */ + private int[] image24 = null; + /** Holds the result of the compression, i.e. the J2K compressed bytecode */ + private byte compressedStream[] = null; + /** Holds the compressed stream length, which may be smaller than compressedStream.length if this byte[] is pre-allocated */ + private long compressedStreamLength = -1; + /** Holds the compressed version of the index file, returned by the encoder */ + private byte compressedIndex[] = null; + /** Width and Height of the image */ + private int width = -1; + private int height = -1; + private int depth = -1; + /** Tile size. We suppose the same size for the horizontal and vertical tiles. + * If size == -1 ==> no tiling */ + private int tileSize = -1; + // <===== Compression parameters ============= + + private Vector loggers = new Vector(); + + public OpenJPEGJavaEncoder(String openJPEGlibraryFullPathAndName, IJavaJ2KEncoderLogger messagesAndErrorsLogger) throws ExceptionInInitializerError + { + this(openJPEGlibraryFullPathAndName); + loggers.addElement(messagesAndErrorsLogger); + } + + public OpenJPEGJavaEncoder(String openJPEGlibraryFullPathAndName) throws ExceptionInInitializerError + { + if (!isInitialized) { + try { + String absolutePath = (new File(openJPEGlibraryFullPathAndName)).getCanonicalPath(); + System.load(absolutePath); + isInitialized = true; + } catch (Throwable t) { + t.printStackTrace(); + throw new ExceptionInInitializerError("OpenJPEG Java Encoder: probably impossible to find the C library"); + } + } + } + + public void addLogger(IJavaJ2KEncoderLogger messagesAndErrorsLogger) { + loggers.addElement(messagesAndErrorsLogger); + } + + public void removeLogger(IJavaJ2KEncoderLogger messagesAndErrorsLogger) { + loggers.removeElement(messagesAndErrorsLogger); + } + + /** This method compresses the given image.

+ * It returns the compressed J2K codestream into the compressedStream byte[].

+ * It also returns the compression index as a compressed form, into the compressedIndex byte[].

+ * One of the image8, image16 or image24 arrays must be correctly initialized and filled.

+ * The width, height and depth variables must be correctly filled.

+ * The nbResolutions, nbLayers and if needed the float[] psnrLayers or ratioLayers must also be filled before calling this method. + */ + public void encodeImageToJ2K() { + // Need to allocate / reallocate the compressed stream buffer ? (size = max possible size = original image size) + if (compressedStream== null || (compressedStream.length != width*height*depth/8)) { + logMessage("OpenJPEGJavaEncoder.encodeImageToJ2K: (re-)allocating " + (width*height*depth/8) + " bytes for the compressedStream"); + compressedStream = new byte[width*height*depth/8]; + } + // Arguments = + // - number of resolutions "-n 5" : 2 + // - size of tile "-t 512,512" : 2 + // + // Image width, height, depth and pixels are directly fetched by C from the Java class + int nbArgs = 2 + (tileSize == -1 ? 0 : 2) + (encoder_arguments != null ? encoder_arguments.length : 0); + if (psnrLayers != null && psnrLayers.length>0 && psnrLayers[0] != 0) + // If psnrLayers is defined and doesn't just express "lossless" + nbArgs += 2; + else if (ratioLayers != null && ratioLayers.length>0 && ratioLayers[0]!=0.0) + nbArgs += 2; + String[] arguments = new String[nbArgs]; + int offset = 0; + arguments[offset] = "-n"; arguments[offset+1] = "" + nbResolutions; offset += 2; + if (tileSize!= -1) { + arguments[offset++] = "-t"; + arguments[offset++] = "" + tileSize + "," + tileSize; + } + // If PSNR layers are defined, use them to encode the images + if (psnrLayers != null && psnrLayers.length>0 && psnrLayers[0]!=-1) { + arguments[offset++] = "-q"; + String s = ""; + for (int i=0; i0 && ratioLayers[0]!=0.0) { + // Specify quality ratioLayers, as compression ratios + arguments[offset++] = "-r"; + String s = ""; + for (int i=0; i