Routines for reading TIFF images

Functions
void	IPGZ::readTiff2Float2D (char *inFilename, PixelArray2D< float > *data, int channel)
	Method to read a TIFF file into an instance of the PixelArray2D class.
void	IPGZ::readTiff2Float3D (char *inFilenamePattern, int min, int max, PixelArray3D< float > *data, int channel)
	Method to read a series of TIFF files into an instance of the PixelArray3D class.
void	IPGZ::readTiff2Uint32 (char *inFilename, PixelArray2D< uint32 > *data)
	General routine to read a TIFF image as RGBA data into unsigned integer PixelArray2D. This is primarily called by other functions (readTiff2Float3D(), readTiff2Float2D()) and will not typically be called directly.
void	IPGZ::readTiff2Uint32 (char *inFilename, uint32 *raster, uint32 width, uint32 height)
	General routine to read a TIFF image as RGBA data into unsigned integer array. This is primarily called by other functions and will not typically be called directly.

---

Function Documentation

void IPGZ::readTiff2Float2D	(	char *	inFilename,
		PixelArray2D< float > *	data,
		int	channel
	)

Method to read a TIFF file into an instance of the PixelArray2D class.

Parameters:

	filename	The name of the tiff file that will be read into the array (e.g. "phsa_image.tiff").
	data	The instance of the PixelArray2D class where the intensity data, height and width of the image will be stored. Note that memory allocation for the array within the class is done within this function.
	channel	The specific channel to read into the data class. This can be set to be IP_RED, IP_GREEN, IP_BLUE, or IP_GRAY (red, green, blue, or gray respectively). Note that the gray channel is simply the average of the red, green, and blue channels.

void IPGZ::readTiff2Float3D	(	char *	inFilenamePattern,
		int	min,
		int	max,
		PixelArray3D< float > *	data,
		int	channel
	)

Method to read a series of TIFF files into an instance of the PixelArray3D class.

Parameters:

	inFilenamePattern	General pattern of the filenames that will be read into the array. This must contain a C-style format specifier for an integer (%d). For example, "stack_%d.tiff" for filenames {"stack_1.tiff", "stack_2.tiff", etc.}, or stack_%.3d.tiff for filenames {"stack_001.tiff", "stack_002.tiff", etc.}.
	min	Corresponds to the starting value for substitution into the filenamePattern.
	max	Corresponds to the final value for substitution into the filenamePattern. Note, this behaves as a 'less than condition', e.g. specifying 100, will result in the loop stopping at 99.
	data	The instance of the PixelArray3D class to store the intensity data. Note that memory allocation for the array within the class is done within this function.
	channel	The channel to read into the array. Can be set to be IP_RED, IP_GREEN, IP_BLUE, or IP_GRAY (red, green, blue, or gray respectively). Note that the gray channel is simply the average of the red, green, and blue channels.

void IPGZ::readTiff2Uint32	(	char *	inFilename,
		uint32 *	raster,
		uint32	width,
		uint32	height
	)

General routine to read a TIFF image as RGBA data into unsigned integer array. This is primarily called by other functions and will not typically be called directly.

Parameters:

	inFilename	The name of the TIFF file to be read into the array (e.g. "phsa_image.tiff").
	raster	The array to store the intensity data. Note that this stores information for all channels (red, green, blue, and alpha).
	width	The width of the image file specified in filename.
	height	The height of the image file specified in filename.

void IPGZ::readTiff2Uint32	(	char *	inFilename,
		PixelArray2D< uint32 > *	data
	)

General routine to read a TIFF image as RGBA data into unsigned integer PixelArray2D. This is primarily called by other functions (readTiff2Float3D(), readTiff2Float2D()) and will not typically be called directly.

Parameters:

	inFilename	The name of the TIFF file to be read into the array (e.g. "phsa_image.tiff").
	data	The instance of the PixelArray2D class to store the intensity data. Note that this stores information for all channels (red, green, blue, and alpha).

---