loci.formats.out

Class OMETiffWriter

java.lang.Object

loci.formats.FormatHandler

loci.formats.FormatWriter

loci.formats.out.TiffWriter

loci.formats.out.OMETiffWriter

All Implemented Interfaces:

Closeable, AutoCloseable, IFormatHandler, IFormatWriter, IMetadataConfigurable

public class OMETiffWriter
extends TiffWriter

OMETiffWriter is the file format writer for OME-TIFF files.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPANION_KEY
private Map<String,Integer>	ifdCounts
private String[][]	imageLocations
private OMEXMLMetadata	omeMeta
private OMEXMLService	service
private Map<String,String>	uuids
private static String	WARNING_COMMENT

Fields inherited from class loci.formats.out.TiffWriter

checkParams, COMPRESSION_J2K, COMPRESSION_J2K_LOSSY, COMPRESSION_JPEG, COMPRESSION_LZW, COMPRESSION_UNCOMPRESSED, in, isBigTiff, tiffSaver, tileSizeX, tileSizeY

Fields inherited from class loci.formats.FormatWriter

cm, compression, compressionTypes, fps, initialized, interleaved, metadataRetrieve, options, out, sequential, series, validBits

Fields inherited from class loci.formats.FormatHandler

COMPRESSION_SUFFIXES, currentId, format, LOGGER, metadataOptions, suffixes

Constructor Summary

Constructors

Constructor and Description
OMETiffWriter()

Method Summary

Modifier and Type	Method and Description
void	close()
private String	getBinaryOnlyOMEXML(String file, String companion, String companionUUID)
String	getCompanion()
private String	getOMEXML(String file)
private String	getUUID(String filename) Gets the UUID corresponding to the given filename.
private String	insertWarningComment(String xml)
private int	planeCount()
private void	populateImage(OMEXMLMetadata omeMeta, int series)
private void	populateTiffData(OMEXMLMetadata omeMeta, int[] zct, int ifd, int series, int plane)
void	saveBytes(int no, byte[] buf, IFD ifd, int x, int y, int w, int h) Saves the given image to the specified series in the current file.
void	saveBytes(int no, byte[] buf, int x, int y, int w, int h) Saves the given image tile to the current series in the current file.
private void	saveComment(String file, String xml)
void	setId(String id) Initializes a writer from the input file name.
private void	setupServiceAndMetadata()

Methods inherited from class loci.formats.out.TiffWriter

canDoStacks, createInputStream, createTiffSaver, getPixelTypes, getPlaneCount, getPlaneCount, getTileSizeX, getTileSizeY, prepareToWriteImage, saveBytes, setBigTiff, setTileSizeX, setTileSizeY, setupTiffSaver

Methods inherited from class loci.formats.FormatWriter

changeOutputFile, checkParams, createOutputStream, getColorModel, getCompression, getCompressionTypes, getFramesPerSecond, getMetadataRetrieve, getPixelTypes, getSamplesPerPixel, getSamplesPerPixel, getSeries, isFullPlane, isInterleaved, isSupportedType, saveBytes, saveBytes, savePlane, savePlane, savePlane, seekToPlaneOffset, setCodecOptions, setColorModel, setCompression, setFramesPerSecond, setInterleaved, setMetadataRetrieve, setSeries, setValidBitsPerPixel, setWriteSequentially

Methods inherited from class loci.formats.FormatHandler

checkSuffix, checkSuffix, getFormat, getMetadataOptions, getNativeDataType, getSuffixes, getSupportedMetadataLevels, isThisType, setMetadataOptions

Methods inherited from class java.lang.Object

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

Methods inherited from interface loci.formats.IFormatHandler

getFormat, getNativeDataType, getSuffixes, isThisType

Methods inherited from interface loci.formats.IMetadataConfigurable

getMetadataOptions, getSupportedMetadataLevels, setMetadataOptions

Field Detail

WARNING_COMMENT

private static final String WARNING_COMMENT

See Also:

Constant Field Values

COMPANION_KEY

public static final String COMPANION_KEY

See Also:

Constant Field Values

imageLocations

private String[][] imageLocations

omeMeta

private OMEXMLMetadata omeMeta

service

private OMEXMLService service

ifdCounts

private Map<String,Integer> ifdCounts

uuids

private Map<String,String> uuids

Constructor Detail

OMETiffWriter

public OMETiffWriter()

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class TiffWriter

Throws:

IOException

saveBytes

public void saveBytes(int no,
                      byte[] buf,
                      int x,
                      int y,
                      int w,
                      int h)
               throws FormatException,
                      IOException

Description copied from interface: IFormatWriter

Saves the given image tile to the current series in the current file.

Specified by:

saveBytes in interface IFormatWriter

Overrides:

saveBytes in class TiffWriter

Parameters:

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

buf - the byte array that represents the image tile.

x - the X coordinate of the upper-left corner of the image tile.

y - the Y coordinate of the upper-left corner of the image tile.

w - the width (in pixels) of the image tile.

h - the height (in pixels) of the image tile.

Throws:

FormatException - if one of the parameters is invalid.

IOException - if there was a problem writing to the file.

See Also:

IFormatWriter.saveBytes(int, byte[], int, int, int, int)

saveBytes

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

Description copied from class: TiffWriter

Saves the given image to the specified series in the current file. The IFD hashtable allows specification of TIFF parameters such as bit depth, compression and units.

Overrides:

saveBytes in class TiffWriter

Throws:

FormatException

IOException

See Also:

IFormatWriter.saveBytes(int, byte[], int, int, int, int)

setId

public void setId(String id)
           throws FormatException,
                  IOException

Description copied from class: FormatWriter

Initializes a writer from the input file name. Initializes a RandomAccessOutputStream for the output file and initializes the metadata for all the series using FormatWriter.setSeries(int).

Specified by:

setId in interface IFormatHandler

Overrides:

setId in class TiffWriter

Parameters:

id - a String specifying the path to the file

Throws:

FormatException

IOException

getCompanion

public String getCompanion()

getUUID

private String getUUID(String filename)

Gets the UUID corresponding to the given filename.

setupServiceAndMetadata

private void setupServiceAndMetadata()
                              throws loci.common.services.DependencyException,
                                     loci.common.services.ServiceException

Throws:

loci.common.services.DependencyException

loci.common.services.ServiceException

insertWarningComment

private String insertWarningComment(String xml)

getOMEXML

private String getOMEXML(String file)
                  throws FormatException,
                         IOException

Throws:

FormatException

IOException

getBinaryOnlyOMEXML

private String getBinaryOnlyOMEXML(String file,
                                   String companion,
                                   String companionUUID)
                            throws FormatException,
                                   IOException,
                                   loci.common.services.DependencyException,
                                   loci.common.services.ServiceException

Throws:

FormatException

IOException

loci.common.services.DependencyException

loci.common.services.ServiceException

saveComment

private void saveComment(String file,
                         String xml)
                  throws IOException

Throws:

IOException

populateTiffData

private void populateTiffData(OMEXMLMetadata omeMeta,
                              int[] zct,
                              int ifd,
                              int series,
                              int plane)

populateImage

private void populateImage(OMEXMLMetadata omeMeta,
                           int series)

planeCount

private int planeCount()