| 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;
|
| +}
|
|
|