com.github.jaiimageio.jpeg2000.impl.J2KImageReadParamJava Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jai-imageio-jpeg2000 Show documentation
Show all versions of jai-imageio-jpeg2000 Show documentation
JPEG2000 support for Java Advanced Imaging Image I/O Tools API core.
This module is licensed under the [JJ2000 license](LICENSE.txt) and
is therefore NOT compatible with the GPL 3 license. It should be
compatible with the LGPL 2.1 license.
/*
* $RCSfile: J2KImageReadParamJava.java,v $
*
*
* Copyright (c) 2005 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* - Redistribution of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* - Redistribution 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 Sun Microsystems, Inc. or the names of
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any
* kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
* WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
* EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
* NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
* USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
* ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
* CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
* REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
* INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed or intended for
* use in the design, construction, operation or maintenance of any
* nuclear facility.
*
* $Revision: 1.1 $
* $Date: 2005/02/11 05:01:33 $
* $State: Exp $
*/
package com.github.jaiimageio.jpeg2000.impl;
import javax.imageio.ImageReadParam;
import com.github.jaiimageio.jpeg2000.J2KImageReadParam;
/**
* A subclass of ImageReadParam
for reading images in
* the JPEG 2000 format.
*
* The decoding parameters for JPEG 2000 are listed below:
*
*
* JPEG 2000 Plugin Decoding Parameters
* Parameter Name Description
*
* decodingRate
* Specifies the decoding rate in bits per pixel (bpp) where the
* number of pixels is related to the image's original size (Note:
* this parameter is not affected by resolution
). The
* codestream is either parsed (default) or truncated depending
* parsingEnabled
. The default is Double.MAX_VALUE
.
* It means decoding with the encoding rate.
*
*
*
* resolution
* Specifies the resolution level wanted for the decoded image
* (0 means the lowest available resolution, the resolution
* level gives an image with the original dimension). If the given index
* is greater than the number of available resolution levels of the
* compressed image, the decoded image has the lowest available
* resolution (among all tile-components). This parameter affects only
* the inverse wavelet transform and not the number of bytes read by the
* codestream parser, which depends only on decodingRate
.
*
*
*
* noROIDescaling
* Ensures that no ROI de-scaling is performed. Decompression is done
* like there is no ROI in the image.
*
*
*
* parsingEnabled
* Enable the parsing mode or not when the decoding rate is specified.
* If it is false, the codestream is decoded as if it were truncated to
* the given rate. If it is true, the decoder creates, truncates and
* decodes a virtual layer progressive codestream with the same
* truncation points in each code-block.
*
*
*
*/
public class J2KImageReadParamJava extends J2KImageReadParam {
/** Ensures that no ROI de-scaling is performed. Decompression
* is done like there is no ROI in the image.
*/
private boolean noROIDescaling = true;
/** Enable the parsing mode or not when the decoding rate is specified .
* If it is false, the codestream is decoded as if it were truncated to
* the given rate. If it is true, the decoder creates, truncates and
* decodes a virtual layer progressive codestream with the same
* truncation points in each code-block.
*/
private boolean parsingEnabled = true;
/** Constructs a default instance of J2KImageReadParamJava
. */
public J2KImageReadParamJava() {
super();
}
public J2KImageReadParamJava(ImageReadParam param) {
super();
// Generic settings.
if(param.hasController()) {
setController(param.getController());
}
setSourceRegion(param.getSourceRegion());
setSourceBands(param.getSourceBands());
setDestinationBands(param.getDestinationBands());
setDestination(param.getDestination());
setDestinationOffset(param.getDestinationOffset());
setSourceSubsampling(param.getSourceXSubsampling(),
param.getSourceYSubsampling(),
param.getSubsamplingXOffset(),
param.getSubsamplingYOffset());
setDestinationType(param.getDestinationType());
// J2K settings.
J2KImageReadParam j2kParam;
if(param instanceof J2KImageReadParam) {
j2kParam = (J2KImageReadParam)param;
} else {
j2kParam = new J2KImageReadParam();
}
setDecodingRate(j2kParam.getDecodingRate());
setResolution(j2kParam.getResolution());
}
/** Sets noROIDescaling
*/
public void setNoROIDescaling(boolean value) {
this.noROIDescaling = value;
}
/** Gets noROIDescaling
*/
public boolean getNoROIDescaling() {
return noROIDescaling;
}
/** Sets parsingEnabled
*/
public void setParsingEnabled(boolean value) {
this.parsingEnabled = value;
}
/** Gets parsingEnabled
*/
public boolean getParsingEnabled() {
return parsingEnabled;
}
}