IDLffMrSID::GetDimsAtLevel

Syntax | Return Value | Arguments | Keywords | Examples | Version History

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