# ImgSiz

> [HTML Version](imgsiz.htm)

**ImgSiz = iwidth, iheight, bpp \{,fit, stretch, scaleq, discrete\}**

Specifies the maximum image size, along with the desired image depth and scaling options. 

_iwidth_ and _iheight_ are numeric pixel counts for the maximum size image. If the XTF\_VARY bit is not set in the _flags_ parameter, then all images must be the same size. (In this case, XTREE will create an "image list" internally, which is the most efficient way to handle a lot of images.) Otherwise, the row height will vary with the actual image height, up to the maximum specified.

_bpp_ specifies the desired bit depth (bits per pixel), which is used as a clue to the various image loading, conversion, and display routines. Supported values are 1, 8 and 24. If in doubt, set it to 24, which will give the best visual results—at a possible cost in memory usage. With 8, you may see some color substitutions leading to a posterization effect. With 1, you would get monochrome.

The _fit_ and _stretch_ options apply only when the row height (and image size) is variable—i.e. the XTF\_VARY bit is set in the _flags_ parameter. _Fit_ causes images that are smaller than the maximum size to be enlarged until they hit the maximum width (_iwidth_) or height (_iheight_). _Stretch _is similar but stretches the images as needed so that they match both the _iwidth_ and _iheight _values. When XTF\_VARY is not specified, the _stretch_ option is automatic.

_Scaleq_ selects a scaling algorithm (bilinear interpolation) which is somewhat slower but generally gives higher quality results than the default scale algorithm.

_Discrete_ causes the images to be stored individually rather than as an internal "image list". This is mostly just a subtle technicality, but is required for icon images when the XTF\_VARY option is not specified.

Examples:

ImgSiz=133,100,24,Fit

ImgSiz=75,50,8,Stretch,Scaleq

ImgSiz=16,16,24,discrete