/*
*
* Copyright (c) 2007, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
/* ********************************************************************
**********************************************************************
**********************************************************************
*** COPYRIGHT (c) Eastman Kodak Company, 1997 ***
*** As an unpublished work pursuant to Title 17 of the United ***
*** States Code. All rights reserved. ***
**********************************************************************
**********************************************************************
**********************************************************************/
package com.sun.image.codec.jpeg;
import java.awt.image.Raster;
import java.awt.image.BufferedImage;
/**
* Signals that a truncated file was detected. This object contains
* the Raster/BufferedImage that has the partially decoded image data
* in it. There is no indication of the portion of the Raster that
* may or may not be good.
* <p>
* Note that the classes in the com.sun.image.codec.jpeg package are not
* part of the core Java APIs. They are a part of Sun's JDK and JRE
* distributions. Although other licensees may choose to distribute these
* classes, developers cannot depend on their availability in non-Sun
* implementations. We expect that equivalent functionality will eventually
* be available in a core API or standard extension.
* <p>
*
* @author Thomas DeWeese
* @see JPEGImageDecoder
* @since 1.2
*/
public
class TruncatedFileException extends RuntimeException {
private Raster ras = null;
private BufferedImage bi = null;
/**
* Constructs a <code>TruncatedFileException</code> with the
* partially decoded BufferedImage.
*
* @param bi the partially decoded BufferedImage (may be null).
* @since 1.2
*/
public TruncatedFileException(BufferedImage bi) {
super("Premature end of input file");
this.bi = bi;
this.ras = bi.getData();
}
/**
* Constructs an <code>TruncatedFileException</code> with the
* partially decoded Raster
*
* @param ras the partially decoded Raster (may be null).
* @since 1.2
*/
public TruncatedFileException(Raster ras) {
super("Premature end of input file");
this.ras = ras;
}
/** Allows access to the raster that was in the progress of being
* decoded may be null, it is likely to be only partially filled
* with image data.
* @since 1.2
*/
public Raster getRaster() { return ras; }
/** Allows access to the BufferedImage that was in the progress of
* being decoded, this may be null, it is likely to be only
* partially filled with image data.
* @since 1.2
*/
public BufferedImage getBufferedImage() { return bi; }
}