IDLffMrSID::GetDimsAtLevel

The IDLffMrSID::GetDimsAtLevel function method is used to retrieve the dimensions of the image at a given level. This can be used, for example, to determine what level is required to fit the image into a certain area.

Syntax

Result = Obj->[IDLffMrSID::]GetDimsAtLevel (Level)

Return Value

Returns a floating-point two-element vector containing the dimensions of the image at a given level.

Arguments

Level

A scalar integer specifying the level at which the dimensions are to be determined. This level must be in the range returned by the LEVELS keyword of IDLffMrSID::GetProperty.

Keywords

None

Examples

Initialize the MrSID file object.

oFile = OBJ_NEW('IDLffMrSID', FILEPATH('test_gs.sid', $

   SUBDIRECTORY = ['examples', 'data']))

Get the range of levels of resolution contained within the file.

oFile->GetProperty, LEVELS = lvls

PRINT, lvls

IDL prints,

-9   4

Print the image dimensions at the lowest image resolution where image level = 4.

imgLevelA = MAX(lvls)

dimsAtA = oFile->GetDimsAtLevel(imgLevelA)

PRINT, 'Dimensions of lowest resolution image is', dimsAtA

IDL prints,

32   32

Print the image dimensions at full resolution where image level = 0

dimsAtFull = oFile->GetDimsAtLevel(0)

PRINT, 'Dimensions of full resolution image is', dimsAtFull

IDL prints,

512   512

Print the image dimensions at the highest resolution where image level = -9

highestLvl = MIN(lvls)

dimsAtHighest = oFile->GetDimsAtLevel(highestLvl)

PRINT, 'Dimensions of highest resolution image is', dimsAtHighest

IDL prints,

262144   262144

Clean up object references.

OBJ_DESTROY, [oFile]

Version History

5.5	Introduced