/* * Copyright (C)2011, 2013-2015, 2023 D. R. Commander. All Rights Reserved. * Copyright (C)2015 Viktor Szathmáry. 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. */ package org.libjpegturbo.turbojpeg; /** * TurboJPEG lossless transformer */ public class TJTransformer extends TJDecompressor { /** * Create a TurboJPEG lossless transformer instance. */ public TJTransformer() throws TJException { init(); } /** * Create a TurboJPEG lossless transformer instance and associate the JPEG * source image stored in jpegImage with the newly created * instance. * * @param jpegImage buffer containing the JPEG source image to transform. * (The size of the JPEG image is assumed to be the length of the array.) * This buffer is not modified. */ public TJTransformer(byte[] jpegImage) throws TJException { init(); setSourceImage(jpegImage, jpegImage.length); } /** * Create a TurboJPEG lossless transformer instance and associate the JPEG * source image of length imageSize bytes stored in * jpegImage with the newly created instance. * * @param jpegImage buffer containing the JPEG source image to transform. * This buffer is not modified. * * @param imageSize size of the JPEG source image (in bytes) */ public TJTransformer(byte[] jpegImage, int imageSize) throws TJException { init(); setSourceImage(jpegImage, imageSize); } /** * Embed an ICC (International Color Consortium) color management profile in * JPEG images generated by subsequent transform operations. * * @param iccBuf buffer containing an ICC profile. (The size of the ICC * profile is assumed to be the length of the array.) A copy is made of the * ICC profile, so this buffer can be reused as soon as this method returns. * Setting this parameter to null removes any ICC profile that was previously * associated with this transformer instance. */ public native void setICCProfile(byte[] iccBuf) throws TJException; /** * Returns the maximum size of the buffer (in bytes) required to hold a JPEG * image transformed, with the given transform parameters and/or cropping * region, from the JPEG source image associated with this transformer * instance. This function is a wrapper for {@link TJ#bufSize TJ.bufSize()} * that takes into account cropping, transposition of the width and height * (which affects the destination image dimensions and level of chrominance * subsampling), grayscale conversion, and the ICC profile (if any) that was * previously associated with this transformer instance (see * {@link #setICCProfile setICCProfile()}) or extracted from the source image * (see {@link #getICCProfile} and {@link TJ#PARAM_SAVEMARKERS}.) * * @param transform a {@link TJTransform} instance that specifies the * transform parameters and/or cropping region for the transformed JPEG * image. * * @return the maximum size of the buffer (in bytes) required to hold a JPEG * image transformed, with the given transform parameters and/or cropping * region, from the JPEG source image associated with this transformer * instance */ public native int bufSize(TJTransform transform) throws TJException; /** * Losslessly transform the JPEG source image associated with this * transformer instance into one or more JPEG images stored in the given * destination buffers. Lossless transforms work by moving the raw * coefficients from one JPEG image structure to another without altering the * values of the coefficients. While this is typically faster than * decompressing the image, transforming it, and re-compressing it, lossless * transforms are not free. Each lossless transform requires reading and * performing Huffman decoding on all of the coefficients in the source * image, regardless of the size of the destination image. Thus, this method * provides a means of generating multiple transformed images from the same * source or of applying multiple transformations simultaneously, in order to * eliminate the need to read the source coefficients multiple times. * * @param dstBufs an array of JPEG destination buffers. * dstbufs[i] will receive a JPEG image that has been * transformed using the parameters in transforms[i]. Use * {@link #bufSize bufSize()} to determine the maximum size for each buffer. * * @param transforms an array of {@link TJTransform} instances, each of * which specifies the transform parameters and/or cropping region for the * corresponding transformed JPEG image */ public void transform(byte[][] dstBufs, TJTransform[] transforms) throws TJException { transformedSizes = transform(getJPEGBuf(), getJPEGSize(), dstBufs, transforms); } /** * Losslessly transform the JPEG source image associated with this * transformer instance and return an array of {@link TJDecompressor} * instances, each of which has a transformed JPEG image associated with it. * * @param transforms an array of {@link TJTransform} instances, each of * which specifies the transform parameters and/or cropping region for the * corresponding transformed JPEG image * * @return an array of {@link TJDecompressor} instances, each of * which has a transformed JPEG image associated with it. */ public TJDecompressor[] transform(TJTransform[] transforms) throws TJException { byte[][] dstBufs = new byte[transforms.length][]; for (int i = 0; i < transforms.length; i++) dstBufs[i] = new byte[bufSize(transforms[i])]; TJDecompressor[] tjd = new TJDecompressor[transforms.length]; transform(dstBufs, transforms); for (int i = 0; i < transforms.length; i++) tjd[i] = new TJDecompressor(dstBufs[i], transformedSizes[i]); return tjd; } /** * Returns an array containing the sizes of the transformed JPEG images * (in bytes) generated by the most recent transform operation. * * @return an array containing the sizes of the transformed JPEG images * (in bytes) generated by the most recent transform operation. */ public int[] getTransformedSizes() { if (transformedSizes == null) throw new IllegalStateException("No image has been transformed yet"); return transformedSizes; } private native void init() throws TJException; private native int[] transform(byte[] srcBuf, int srcSize, byte[][] dstBufs, TJTransform[] transforms) throws TJException; static { TJLoader.load(); } private int[] transformedSizes = null; private int iccSize = 0; }