StretchedBMP

Property

Document.StretchedBMP(read-only, Variant)

Syntax

Document.StretchedBMP

Remarks

Applies the current screen stretch settings to the specified document and returns a variant containing a bitmap (Windows BMP format) of the stretched image, converted to an 8 bit per pixel format. The variant holds a single array of bytes, beginning with the BITMAPINFOHEADER structure and followed by the actual bitmap data.

The generated bitmap is always in the 24-bit RGB format. If the MaxIm DL document contains a monochrome image, then the R, G and B components of all output pixels are the same. If the MaxIm DL document is a color image then the stretch is applied independently to each component.

NOTE: BMPs, when saved to disk, begin with a structure known as the BITMAPFILEHEADER. If you wish to save the stretched image to disk then this header must generated by the calling program and written to the file, first, followed by the raw data in the returned variant.