/* * Copyright (c) 2002-2007, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium * Copyright (c) 2002-2007, Professor Benoit Macq * Copyright (c) 2002-2007, Patrick Piscaglia, Telemis s.a. * 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 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 OWNER 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. */ package org.openJpeg; import java.io.File; import java.util.Vector; /** This class encodes one image into the J2K format, * using the OpenJPEG.org library. * To be able to log messages, the called must register a IJavaJ2KEncoderLogger object. */ public class OpenJPEGJavaEncoder { public interface IJavaJ2KEncoderLogger { public void logEncoderMessage(String message); public void logEncoderError(String message); } private static boolean isInitialized = false; // ===== Compression parameters =============> // 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

*/ 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