mozjpeg/java/org/libjpegturbo/turbojpeg/TJTransform.java

/*
 * Copyright (C)2011, 2013, 2018, 2022-2023 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.*;

/**
 * Lossless transform parameters
 */
public class TJTransform extends Rectangle {

  private static final long serialVersionUID = -127367705761430371L;

  /**
   * The number of lossless transform operations
   */
  public static final int NUMOP         = 8;
  /**
   * Do not transform the position of the image pixels.
   */
  public static final int OP_NONE       = 0;
  /**
   * Flip (mirror) image horizontally.  This transform is imperfect if there
   * are any partial MCU blocks on the right edge.
   * @see #OPT_PERFECT
   */
  public static final int OP_HFLIP      = 1;
  /**
   * Flip (mirror) image vertically.  This transform is imperfect if there are
   * any partial MCU blocks on the bottom edge.
   * @see #OPT_PERFECT
   */
  public static final int OP_VFLIP      = 2;
  /**
   * Transpose image (flip/mirror along upper left to lower right axis).  This
   * transform is always perfect.
   * @see #OPT_PERFECT
   */
  public static final int OP_TRANSPOSE  = 3;
  /**
   * Transverse transpose image (flip/mirror along upper right to lower left
   * axis).  This transform is imperfect if there are any partial MCU blocks in
   * the image.
   * @see #OPT_PERFECT
   */
  public static final int OP_TRANSVERSE = 4;
  /**
   * Rotate image clockwise by 90 degrees.  This transform is imperfect if
   * there are any partial MCU blocks on the bottom edge.
   * @see #OPT_PERFECT
   */
  public static final int OP_ROT90      = 5;
  /**
   * Rotate image 180 degrees.  This transform is imperfect if there are any
   * partial MCU blocks in the image.
   * @see #OPT_PERFECT
   */
  public static final int OP_ROT180     = 6;
  /**
   * Rotate image counter-clockwise by 90 degrees.  This transform is imperfect
   * if there are any partial MCU blocks on the right edge.
   * @see #OPT_PERFECT
   */
  public static final int OP_ROT270     = 7;


  /**
   * This option will cause {@link TJTransformer#transform
   * TJTransformer.transform()} to throw an exception if the transform is not
   * perfect.  Lossless transforms operate on MCU blocks, whose size depends on
   * the level of chrominance subsampling used.  If the image's width or height
   * is not evenly divisible by the MCU block size (see {@link TJ#getMCUWidth
   * TJ.getMCUWidth()} and {@link TJ#getMCUHeight TJ.getMCUHeight()}), then
   * there will be partial MCU blocks on the right and/or bottom edges.  It is
   * not possible to move these partial MCU blocks to the top or left of the
   * image, so any transform that would require that is "imperfect."  If this
   * option is not specified, then any partial MCU blocks that cannot be
   * transformed will be left in place, which will create odd-looking strips on
   * the right or bottom edge of the image.
   */
  public static final int OPT_PERFECT     = (1 << 0);
  /**
   * This option will discard any partial MCU blocks that cannot be
   * transformed.
   */
  public static final int OPT_TRIM        = (1 << 1);
  /**
   * This option will enable lossless cropping.
   */
  public static final int OPT_CROP        = (1 << 2);
  /**
   * This option will discard the color data in the source image and produce a
   * grayscale destination image.
   */
  public static final int OPT_GRAY        = (1 << 3);
  /**
   * This option will prevent {@link TJTransformer#transform
   * TJTransformer.transform()} from outputting a JPEG image for this
   * particular transform.  This can be used in conjunction with a custom
   * filter to capture the transformed DCT coefficients without transcoding
   * them.
   */
  public static final int OPT_NOOUTPUT    = (1 << 4);
  /**
   * This option will enable progressive entropy coding in the JPEG image
   * generated by this particular transform.  Progressive entropy coding will
   * generally improve compression relative to baseline entropy coding (the
   * default), but it will reduce decompression performance considerably.
   * Implies {@link #OPT_OPTIMIZE}.  Can be combined with
   * {@link #OPT_ARITHMETIC}.
   */
  public static final int OPT_PROGRESSIVE = (1 << 5);
  /**
   * This option will prevent {@link TJTransformer#transform
   * TJTransformer.transform()} from copying any extra markers (including EXIF
   * and ICC profile data) from the source image to the destination image.
   */
  public static final int OPT_COPYNONE    = (1 << 6);
  /**
   * This option will enable arithmetic entropy coding in the JPEG image
   * generated by this particular transform.  Arithmetic entropy coding will
   * generally improve compression relative to Huffman entropy coding (the
   * default), but it will reduce decompression performance considerably.  Can
   * be combined with {@link #OPT_PROGRESSIVE}.
   */
  public static final int OPT_ARITHMETIC  = (1 << 7);
  /**
   * This option will enable optimized baseline entropy coding in the JPEG
   * image generated by this particular transform.  Optimized baseline entropy
   * coding will improve compression slightly (generally 5% or less.)
   */
  public static final int OPT_OPTIMIZE    = (1 << 8);


  /**
   * Create a new lossless transform instance.
   */
  public TJTransform() {
  }

  /**
   * Create a new lossless transform instance with the given parameters.
   *
   * @param x the left boundary of the cropping region.  This must be evenly
   * divisible by the MCU block width (see {@link TJ#getMCUWidth
   * TJ.getMCUWidth()})
   *
   * @param y the upper boundary of the cropping region.  This must be evenly
   * divisible by the MCU block height (see {@link TJ#getMCUHeight
   * TJ.getMCUHeight()})
   *
   * @param w the width of the cropping region.  Setting this to 0 is the
   * equivalent of setting it to (width of the source JPEG image -
   * <code>x</code>).
   *
   * @param h the height of the cropping region.  Setting this to 0 is the
   * equivalent of setting it to (height of the source JPEG image -
   * <code>y</code>).
   *
   * @param op one of the transform operations ({@link #OP_NONE OP_*})
   *
   * @param options the bitwise OR of one or more of the transform options
   * ({@link #OPT_PERFECT OPT_*})
   *
   * @param cf an instance of an object that implements the
   * {@link TJCustomFilter} interface, or null if no custom filter is needed
   */
  @SuppressWarnings("checkstyle:HiddenField")
  public TJTransform(int x, int y, int w, int h, int op, int options,
                     TJCustomFilter cf) {
    super(x, y, w, h);
    this.op = op;
    this.options = options;
    this.cf = cf;
  }

  /**
   * Create a new lossless transform instance with the given parameters.
   *
   * @param r a <code>java.awt.Rectangle</code> instance that specifies the
   * cropping region.  See
   * {@link #TJTransform(int, int, int, int, int, int, TJCustomFilter)} for
   * more details.
   *
   * @param op one of the transform operations ({@link #OP_NONE OP_*})
   *
   * @param options the bitwise OR of one or more of the transform options
   * ({@link #OPT_PERFECT OPT_*})
   *
   * @param cf an instance of an object that implements the
   * {@link TJCustomFilter} interface, or null if no custom filter is needed
   */
  @SuppressWarnings("checkstyle:HiddenField")
  public TJTransform(Rectangle r, int op, int options,
                     TJCustomFilter cf) {
    super(r);
    this.op = op;
    this.options = options;
    this.cf = cf;
  }

  /**
   * Transform operation (one of {@link #OP_NONE OP_*})
   */
  @SuppressWarnings("checkstyle:VisibilityModifier")
  public int op = 0;

  /**
   * Transform options (bitwise OR of one or more of
   * {@link #OPT_PERFECT OPT_*})
   */
  @SuppressWarnings("checkstyle:VisibilityModifier")
  public int options = 0;

  /**
   * Custom filter instance
   */
  @SuppressWarnings("checkstyle:VisibilityModifier")
  public TJCustomFilter cf = null;
}