The QUERY_JPEG2000 function allows you to obtain information about a JPEG2000 image file without having to read the file. It is a wrapper around the IDLffJPEG2000 object interface that presents JPEG2000 image loading in a way familiar to users of the QUERY_* image routines. (See QUERY_* Routines for more information.) However this function is not as efficient as the object interface and the object interface should be used whenever possible. See IDLffJPEG2000 for information about the object interface.
Example
For a relevant example, see READ_JPEG2000.
Syntax
Result = QUERY_JPEG2000(Filename [, Info] )
Return Value
This routine returns a long integer with the value of 1 if the query was successful (and the file type was correct) or 0 on failure.
Arguments
Filename
A scalar string containing the full path and filename of the JPEG2000 file to query.
Info
Returns an anonymous structure containing information about the image in the file. The Info.TYPE field will return the value 'JPEG2000'.
Note: See General Query * Routine Info Structures for detailed structure information.
In addition to the standard structure fields, the JPEG2000 query structure contains the following additional fields:
|
Field |
IDL Data Type |
Description |
|
N_LAYERS |
Long |
The number of quality layers.
|
|
N_LEVELS |
Long |
The number of wavelet decomposition levels.
|
|
OFFSET |
Two-element vector
|
The X and Y offsets for all image components.
|
Keywords
None.
Version History
See Also
QUERY_* Routines, READ_JPEG2000, WRITE_JPEG2000