Table of Contents

TTMSFNCGraphics.DrawScaledBitmap Method

Selects the best-resolution bitmap from ABitmaps for the given scale factor and draws it into a TRectF bounding box.

API unit family: TMSFNCGraphics Declaring type: TTMSFNCGraphics

Overloads

Overload 1

Selects the best-resolution bitmap from ABitmaps for the given scale factor and draws it into a TRectF bounding box.

procedure DrawScaledBitmap;

Parameters

Name Description
ARect Destination bounding box on the canvas.
ABitmaps Scaled bitmap collection from which the best-resolution variant is selected.
AScale DPI scale factor used to select the bitmap variant. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.

Overload 2

Selects the best-resolution bitmap from ABitmaps for the given scale factor and draws it into a double-coordinate bounding box.

procedure DrawScaledBitmap;

Parameters

Name Description
ALeft Left edge of the destination bounding box in floating-point pixels.
ATop Top edge of the destination bounding box in floating-point pixels.
ARight Right edge of the destination bounding box in floating-point pixels.
ABottom Bottom edge of the destination bounding box in floating-point pixels.
ABitmaps Scaled bitmap collection from which the best-resolution variant is selected.
AScale DPI scale factor used to select the bitmap variant. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.

Overload 3

Selects the best-resolution bitmap from ABitmaps for the given scale factor and draws it into a TRect bounding box.

procedure DrawScaledBitmap;

Parameters

Name Description
ARect Destination bounding box on the canvas, in integer pixels.
ABitmaps Scaled bitmap collection from which the best-resolution variant is selected.
AScale DPI scale factor used to select the bitmap variant. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.

Overload 4

Selects the best-resolution bitmap from ABitmaps for the given scale factor and draws it into an integer-coordinate bounding box.

procedure DrawScaledBitmap;

Parameters

Name Description
ALeft Left edge of the destination bounding box in integer pixels.
ATop Top edge of the destination bounding box in integer pixels.
ARight Right edge of the destination bounding box in integer pixels.
ABottom Bottom edge of the destination bounding box in integer pixels.
ABitmaps Scaled bitmap collection from which the best-resolution variant is selected.
AScale DPI scale factor used to select the bitmap variant. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.