Index: java/org/libjpegturbo/turbojpeg/TJCustomFilter.java |
diff --git a/java/org/libjpegturbo/turbojpeg/TJCustomFilter.java b/java/org/libjpegturbo/turbojpeg/TJCustomFilter.java |
new file mode 100644 |
index 0000000000000000000000000000000000000000..9a34587a182a61a73d9311a57c87ded3530a00c1 |
--- /dev/null |
+++ b/java/org/libjpegturbo/turbojpeg/TJCustomFilter.java |
@@ -0,0 +1,76 @@ |
+/* |
+ * Copyright (C)2011, 2013 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. |
+ */ |
+ |
+package org.libjpegturbo.turbojpeg; |
+ |
+import java.awt.*; |
+import java.nio.*; |
+ |
+/** |
+ * Custom filter callback interface |
+ */ |
+public interface TJCustomFilter { |
+ |
+ /** |
+ * A callback function that can be used to modify the DCT coefficients after |
+ * they are losslessly transformed but before they are transcoded to a new |
+ * JPEG image. This allows for custom filters or other transformations to be |
+ * applied in the frequency domain. |
+ * |
+ * @param coeffBuffer a buffer containing transformed DCT coefficients. |
+ * (NOTE: this buffer is not guaranteed to be valid once the callback |
+ * returns, so applications wishing to hand off the DCT coefficients to |
+ * another function or library should make a copy of them within the body of |
+ * the callback.) |
+ * |
+ * @param bufferRegion rectangle containing the width and height of |
+ * <code>coeffBuffer</code> as well as its offset relative to the component |
+ * plane. TurboJPEG implementations may choose to split each component plane |
+ * into multiple DCT coefficient buffers and call the callback function once |
+ * for each buffer. |
+ * |
+ * @param planeRegion rectangle containing the width and height of the |
+ * component plane to which <code>coeffBuffer</code> belongs |
+ * |
+ * @param componentID ID number of the component plane to which |
+ * <code>coeffBuffer</code> belongs (Y, Cb, and Cr have, respectively, ID's |
+ * of 0, 1, and 2 in typical JPEG images.) |
+ * |
+ * @param transformID ID number of the transformed image to which |
+ * <code>coeffBuffer</code> belongs. This is the same as the index of the |
+ * transform in the <code>transforms</code> array that was passed to {@link |
+ * TJTransformer#transform TJTransformer.transform()}. |
+ * |
+ * @param transform a {@link TJTransform} instance that specifies the |
+ * parameters and/or cropping region for this transform |
+ */ |
+ void customFilter(ShortBuffer coeffBuffer, Rectangle bufferRegion, |
+ Rectangle planeRegion, int componentID, int transformID, |
+ TJTransform transform) |
+ throws TJException; |
+} |