loci.formats.tiff

Class TiffSaver

java.lang.Object

loci.formats.tiff.TiffSaver

public class TiffSaver
extends Object

Parses TIFF data from an input source.

Source code:

Trac, Gitweb

Author:

Curtis Rueden ctrueden at wisc.edu, Eric Kjellman egkjellman at wisc.edu, Melissa Linkert melissa at glencoesoftware.com, Chris Allan callan at blackcat.ca

Field Summary

Fields

Modifier and Type	Field and Description
protected ByteArrayHandle	bytes Output bytes.
protected String	filename Output filename.
protected RandomAccessOutputStream	out Output stream to use when saving TIFF data.

Constructor Summary

Constructors

Constructor and Description
TiffSaver(RandomAccessOutputStream out, ByteArrayHandle bytes) Constructs a new TIFF saver from the given output source.
TiffSaver(RandomAccessOutputStream out, String filename) Constructs a new TIFF saver from the given output source.
TiffSaver(String filename) Constructs a new TIFF saver from the given filename.

Method Summary

Methods

Modifier and Type	Method and Description
RandomAccessOutputStream	getStream() Gets the stream from which TIFF data is being saved.
boolean	isBigTiff() Returns whether or not we are writing BigTIFF data.
boolean	isLittleEndian() Returns whether or not we are writing little-endian data.
void	overwriteComment(RandomAccessInputStream in, Object value) Convenience method for overwriting a file's first ImageDescription.
void	overwriteIFDValue(RandomAccessInputStream raf, int ifd, int tag, Object value) Surgically overwrites an existing IFD value with the given one.
void	overwriteLastIFDOffset(RandomAccessInputStream raf)
void	setBigTiff(boolean bigTiff) Sets whether or not BigTIFF data should be written.
void	setCodecOptions(CodecOptions options) Sets the codec options.
void	setLittleEndian(boolean littleEndian) Sets whether or not little-endian data should be written.
void	setWritingSequentially(boolean sequential) Sets whether or not we know that the planes will be written sequentially.
void	writeHeader() Writes the TIFF file header.
void	writeIFD(IFD ifd, long nextOffset)
void	writeIFDValue(RandomAccessOutputStream extraOut, long offset, int tag, Object value) Writes the given IFD value to the given output object.
void	writeImage(byte[][] buf, IFDList ifds, int pixelType)
void	writeImage(byte[] buf, IFD ifd, int no, int pixelType, boolean last)
void	writeImage(byte[] buf, IFD ifd, int no, int pixelType, int x, int y, int w, int h, boolean last) Writes to any rectangle from the passed block.
void	writeImage(byte[] buf, IFD ifd, int no, int pixelType, int x, int y, int w, int h, boolean last, Integer nChannels, boolean copyDirectly)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

out

protected RandomAccessOutputStream out

Output stream to use when saving TIFF data.

filename

protected String filename

Output filename.

bytes

protected ByteArrayHandle bytes

Output bytes.

Constructor Detail

TiffSaver

public TiffSaver(String filename)
          throws IOException

Constructs a new TIFF saver from the given filename.

Parameters:

filename - Filename of the output stream that we may use to create extra input or output streams as required.

Throws:

IOException

TiffSaver

public TiffSaver(RandomAccessOutputStream out,
         String filename)

Constructs a new TIFF saver from the given output source.

Parameters:

out - Output stream to save TIFF data to.

filename - Filename of the output stream that we may use to create extra input or output streams as required.

TiffSaver

public TiffSaver(RandomAccessOutputStream out,
         ByteArrayHandle bytes)

Constructs a new TIFF saver from the given output source.

Parameters:

out - Output stream to save TIFF data to.

bytes - In memory byte array handle that we may use to create extra input or output streams as required.

Method Detail

setWritingSequentially

public void setWritingSequentially(boolean sequential)

Sets whether or not we know that the planes will be written sequentially. If we are writing planes sequentially and set this flag, then performance is slightly improved.

getStream

public RandomAccessOutputStream getStream()

Gets the stream from which TIFF data is being saved.

setLittleEndian

public void setLittleEndian(boolean littleEndian)

Sets whether or not little-endian data should be written.

setBigTiff

public void setBigTiff(boolean bigTiff)

Sets whether or not BigTIFF data should be written.

isLittleEndian

public boolean isLittleEndian()

Returns whether or not we are writing little-endian data.

isBigTiff

public boolean isBigTiff()

Returns whether or not we are writing BigTIFF data.

setCodecOptions

public void setCodecOptions(CodecOptions options)

Sets the codec options.

Parameters:

options - The value to set.

writeHeader

public void writeHeader()
                 throws IOException

Writes the TIFF file header.

Throws:

IOException

writeImage

public void writeImage(byte[][] buf,
              IFDList ifds,
              int pixelType)
                throws FormatException,
                       IOException

Throws:

FormatException

IOException

writeImage

public void writeImage(byte[] buf,
              IFD ifd,
              int no,
              int pixelType,
              boolean last)
                throws FormatException,
                       IOException

Throws:

FormatException

IOException

writeImage

public void writeImage(byte[] buf,
              IFD ifd,
              int no,
              int pixelType,
              int x,
              int y,
              int w,
              int h,
              boolean last)
                throws FormatException,
                       IOException

Writes to any rectangle from the passed block.

Parameters:

buf - The block that is to be written.

ifd - The Image File Directories. Mustn't be null.

no - The image index within the current file, starting from 0.

pixelType - The type of pixels.

x - The X-coordinate of the top-left corner.

y - The Y-coordinate of the top-left corner.

w - The width of the rectangle.

h - The height of the rectangle.

last - Pass true if it is the last image, false otherwise.

Throws:

FormatException

IOException

writeImage

public void writeImage(byte[] buf,
              IFD ifd,
              int no,
              int pixelType,
              int x,
              int y,
              int w,
              int h,
              boolean last,
              Integer nChannels,
              boolean copyDirectly)
                throws FormatException,
                       IOException

Throws:

FormatException

IOException

writeIFD

public void writeIFD(IFD ifd,
            long nextOffset)
              throws FormatException,
                     IOException

Throws:

FormatException

IOException

writeIFDValue

public void writeIFDValue(RandomAccessOutputStream extraOut,
                 long offset,
                 int tag,
                 Object value)
                   throws FormatException,
                          IOException

Writes the given IFD value to the given output object.

Parameters:

extraOut - buffer to which "extra" IFD information should be written

offset - global offset to use for IFD offset values

tag - IFD tag to write

value - IFD value to write

Throws:

FormatException

IOException

overwriteLastIFDOffset

public void overwriteLastIFDOffset(RandomAccessInputStream raf)
                            throws FormatException,
                                   IOException

Throws:

FormatException

IOException

overwriteIFDValue

public void overwriteIFDValue(RandomAccessInputStream raf,
                     int ifd,
                     int tag,
                     Object value)
                       throws FormatException,
                              IOException

Surgically overwrites an existing IFD value with the given one. This method requires that the IFD directory entry already exist. It intelligently updates the count field of the entry to match the new length. If the new length is longer than the old length, it appends the new data to the end of the file and updates the offset field; if not, or if the old data is already at the end of the file, it overwrites the old data in place.

Throws:

FormatException

IOException

overwriteComment

public void overwriteComment(RandomAccessInputStream in,
                    Object value)
                      throws FormatException,
                             IOException

Convenience method for overwriting a file's first ImageDescription.

Throws:

FormatException

IOException