• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C)2011, 2013-2015 D. R. Commander.  All Rights Reserved.
3  * Copyright (C)2015 Viktor Szathmáry.  All Rights Reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * - Redistributions of source code must retain the above copyright notice,
9  *   this list of conditions and the following disclaimer.
10  * - Redistributions in binary form must reproduce the above copyright notice,
11  *   this list of conditions and the following disclaimer in the documentation
12  *   and/or other materials provided with the distribution.
13  * - Neither the name of the libjpeg-turbo Project nor the names of its
14  *   contributors may be used to endorse or promote products derived from this
15  *   software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS",
18  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
21  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27  * POSSIBILITY OF SUCH DAMAGE.
28  */
29 
30 package org.libjpegturbo.turbojpeg;
31 
32 /**
33  * TurboJPEG lossless transformer
34  */
35 public class TJTransformer extends TJDecompressor {
36 
37   /**
38    * Create a TurboJPEG lossless transformer instance.
39    */
TJTransformer()40   public TJTransformer() throws TJException {
41     init();
42   }
43 
44   /**
45    * Create a TurboJPEG lossless transformer instance and associate the JPEG
46    * image stored in <code>jpegImage</code> with the newly created instance.
47    *
48    * @param jpegImage JPEG image buffer (size of the JPEG image is assumed to
49    * be the length of the array.)  This buffer is not modified.
50    */
TJTransformer(byte[] jpegImage)51   public TJTransformer(byte[] jpegImage) throws TJException {
52     init();
53     setSourceImage(jpegImage, jpegImage.length);
54   }
55 
56   /**
57    * Create a TurboJPEG lossless transformer instance and associate the JPEG
58    * image of length <code>imageSize</code> bytes stored in
59    * <code>jpegImage</code> with the newly created instance.
60    *
61    * @param jpegImage JPEG image buffer.  This buffer is not modified.
62    *
63    * @param imageSize size of the JPEG image (in bytes)
64    */
TJTransformer(byte[] jpegImage, int imageSize)65   public TJTransformer(byte[] jpegImage, int imageSize) throws TJException {
66     init();
67     setSourceImage(jpegImage, imageSize);
68   }
69 
70   /**
71    * Losslessly transform the JPEG image associated with this transformer
72    * instance into one or more JPEG images stored in the given destination
73    * buffers.  Lossless transforms work by moving the raw coefficients from one
74    * JPEG image structure to another without altering the values of the
75    * coefficients.  While this is typically faster than decompressing the
76    * image, transforming it, and re-compressing it, lossless transforms are not
77    * free.  Each lossless transform requires reading and performing Huffman
78    * decoding on all of the coefficients in the source image, regardless of the
79    * size of the destination image.  Thus, this method provides a means of
80    * generating multiple transformed images from the same source or of applying
81    * multiple transformations simultaneously, in order to eliminate the need to
82    * read the source coefficients multiple times.
83    *
84    * @param dstBufs an array of image buffers.  <code>dstbufs[i]</code> will
85    * receive a JPEG image that has been transformed using the parameters in
86    * <code>transforms[i]</code>.  Use {@link TJ#bufSize} to determine the
87    * maximum size for each buffer based on the transformed or cropped width and
88    * height and the level of subsampling used in the source image.
89    *
90    * @param transforms an array of {@link TJTransform} instances, each of
91    * which specifies the transform parameters and/or cropping region for the
92    * corresponding transformed output image
93    *
94    * @param flags the bitwise OR of one or more of
95    * {@link TJ#FLAG_BOTTOMUP TJ.FLAG_*}
96    */
transform(byte[][] dstBufs, TJTransform[] transforms, int flags)97   public void transform(byte[][] dstBufs, TJTransform[] transforms,
98                         int flags) throws TJException {
99     if (jpegBuf == null)
100       throw new IllegalStateException("JPEG buffer not initialized");
101     transformedSizes = transform(jpegBuf, jpegBufSize, dstBufs, transforms,
102                                  flags);
103   }
104 
105   /**
106    * Losslessly transform the JPEG image associated with this transformer
107    * instance and return an array of {@link TJDecompressor} instances, each of
108    * which has a transformed JPEG image associated with it.
109    *
110    * @param transforms an array of {@link TJTransform} instances, each of
111    * which specifies the transform parameters and/or cropping region for the
112    * corresponding transformed output image
113    *
114    * @return an array of {@link TJDecompressor} instances, each of
115    * which has a transformed JPEG image associated with it.
116    *
117    * @param flags the bitwise OR of one or more of
118    * {@link TJ#FLAG_BOTTOMUP TJ.FLAG_*}
119    */
transform(TJTransform[] transforms, int flags)120   public TJDecompressor[] transform(TJTransform[] transforms, int flags)
121                                     throws TJException {
122     byte[][] dstBufs = new byte[transforms.length][];
123     if (jpegWidth < 1 || jpegHeight < 1)
124       throw new IllegalStateException("JPEG buffer not initialized");
125     for (int i = 0; i < transforms.length; i++) {
126       int w = jpegWidth, h = jpegHeight;
127       if ((transforms[i].options & TJTransform.OPT_CROP) != 0) {
128         if (transforms[i].width != 0) w = transforms[i].width;
129         if (transforms[i].height != 0) h = transforms[i].height;
130       }
131       dstBufs[i] = new byte[TJ.bufSize(w, h, jpegSubsamp)];
132     }
133     TJDecompressor[] tjd = new TJDecompressor[transforms.length];
134     transform(dstBufs, transforms, flags);
135     for (int i = 0; i < transforms.length; i++)
136       tjd[i] = new TJDecompressor(dstBufs[i], transformedSizes[i]);
137     return tjd;
138   }
139 
140   /**
141    * Returns an array containing the sizes of the transformed JPEG images
142    * generated by the most recent transform operation.
143    *
144    * @return an array containing the sizes of the transformed JPEG images
145    * generated by the most recent transform operation.
146    */
getTransformedSizes()147   public int[] getTransformedSizes() {
148     if (transformedSizes == null)
149       throw new IllegalStateException("No image has been transformed yet");
150     return transformedSizes;
151   }
152 
init()153   private native void init() throws TJException;
154 
transform(byte[] srcBuf, int srcSize, byte[][] dstBufs, TJTransform[] transforms, int flags)155   private native int[] transform(byte[] srcBuf, int srcSize, byte[][] dstBufs,
156     TJTransform[] transforms, int flags) throws TJException;
157 
158   static {
TJLoader.load()159     TJLoader.load();
160   }
161 
162   private int[] transformedSizes = null;
163 }
164