IDL

QUERY_JPEG2000

QUERY_JPEG2000

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


6.1

Introduced

See Also


QUERY_* Routines, READ_JPEG2000, WRITE_JPEG2000

 



Notes


This page has no user notes yet. Be the first one!


This information is not subject to the controls of the International Traffic in Arms Regulations (ITAR) or the Export Administration Regulations (EAR). However, it may be restricted from transfer to various embargoed countries under U.S. laws and regulations.
© 2014 Exelis Visual Information Solutions