Predefined iTool File Readers

The iTool system distributed with IDL includes a number of predefined file readers. You can include these file readers in an iTool directly by registering the class with your iTool (as described in Registering a File Reader). You can also create a new file reader class based on one of the predefined classes.

IDLitReadASCII

The iTools ASCII file reader uses the IDL READ_ASCII and ASCII_TEMPLATE functions to read data from an ASCII file into an iTool data object. It presents a wizard interface that allows the user to define the structure of the data in the ASCII file and specify which data should be included.

Registered Properties

None

IDLitReadBinary

The iTools Binary file reader uses the IDL READ_BINARY and BINARY_TEMPLATE functions to read data from a binary data file into an iTool data object. It presents a wizard interface that allows the user to define the structure of the data in the binary file and specify which data should be included.

Registered Properties

TEMPLATE

A template structure (previously defined by the BINARY_TEMPLATE function) describing the file to be read.

IDLitReadBMP

The iTools BMP file reader uses the IDL READ_BMP function to read a *.bmp file and place the image data in an iTool image data object.

Registered Properties

None

IDLitReadCSV

The iTools CSV file reader uses the IDL READ_CSV function to read a *.csv (comma separated values) file and place the data in an iTool image data object or IDL variable or variables. The CSV file reader is designed to make it easy to import simple tabular data; for files that contain complex spreadsheet-like formatting, the ASCII file reader may be more suitable.

Registered Properties

NUM_RECORDS

An integer specifying the number of records to read. The default is 0 (zero), specifying that all records should be read.

RECORD_START

An integer specifying the index of the first record to read. The default is the first record of the file (record 0).

IDLitReadDICOM

The iTools DICOM reader uses the IDL READ_DICOM function to read a *.dcm and place the image data in an iTool image data object.

Registered Properties

None

IDLitReadISV

The iTools Saved Variables file reader restores a saved iTool state (*.isv) file. All data objects in the file are placed into the current iTool data manager session, and all visualization objects are restored and displayed.

Registered Properties

None

IDLitReadJPEG

The iTools JPEG file reader uses the IDL READ_JPEG procedure to read a *.jpg or *.jpeg file and place the image data in an iTool image data object.

Registered Properties

None

IDLitReadJPEG2000

The iTools JPEG 2000 file reader uses the IDL READ_JPEG2000 procedure to read a *.jp2, *.jpx, or *.j2k file and place the image data in an iTool image data object.

Registered Properties

DISCARD_LEVELS

An integer specifying the number of highest resolution levels which will not appear in the result. See the DISCARD_LEVELS keyword to the IDLffJPEG2000::GetData method for additional details.

QUALITY_LAYERS

An integer specifying the maximum number of quality layers which will be returned in the result. Each layer contains the information required to represent the image at a higher quality, given the information from all the previous layers. See the MAX_LAYERS keyword to the IDLffJPEG2000::GetData method for additional details.

IDLitReadPICT

The iTools PICT file reader uses the IDL READ_PICT procedure to read a *.pct or *.pict file and place the image data in an iTool image data object.

Registered Properties

None

IDLitReadPNG

The iTools PNG file reader uses the IDL READ_PNG function to read a *.png file and place the image (and, optionally, palette) data in an iTool image data object.

Registered Properties

None

IDLitReadShapefile

The iTools Shapefile reader uses the IDLffShape object to read an ESRI shapefile and place the polygons or polylines in an iTool image data object.

Registered Properties

ATTRIBUTE_NAME

The name of an attribute of the shapefile that contains the name of the individual item within the shapefile.

COMBINE_ALL

A boolean value specifying whether all shapes contained in the shapefile should be combined into a single visualization in the iTool.

IDLitReadTIFF

The iTools TIFF file reader uses the IDL READ_TIFF function to read a *.tif or *.tiff file and place the image (and, optionally, palette) data in an iTool image data object.

Registered Properties

IMAGE_INDEX

An integer specifying the index of the image within the TIFF file that should be read into the image data object.

IMAGE_STACKING

An integer specifying the stacking order for reading multi-image TIFF files into volumes.

IDLitReadWAV

The iTools WAV file reader uses the IDL READ_WAV function to read a *.wav file and place the data in an iTool vector object.

Registered Properties

None