Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / I/O - Image Data Formats / IDLffMrSID::GetDimsAtLevel

IDLffMrSID::GetDimsAtLevel

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


5.5

Introduced



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us