This page contains documentation for advanced Fuse features, so we have taken the liberty to tick the "Show advanced things" checkbox above for you in advance to be able to provide you with some additional information.

Specifies how an image size is calculated and how it is stretched.

Location

Namespace
Fuse.Elements
Package
Fuse.Elements 1.11.2

Possible Values

PointPrecise

The size of the source image, in points calculated with density, are used as the image size. This is the default: a 100x50 source image will be 100x50 points in size. This preserves size across various device densities.

PixelPrecise

The size is pixel matched to the source so the image is drawn 1:1. This means the visual size changes across device densities, but the image remains sharp.

PointPrefer

If the size of the image in PixelPrecise mode is close to PointPrecise then use PixelPrecise mode, otherwise use PointPrecise mode. This retains sharpness with slightly varying sizes, but prevents too much size variation.

Fill

The image is stretched to fill the available space. The aspect ratio is not retained.

Scale9

The image is stretched in 9-segments defined by the Scale9Margin. Corners are not stretched, borders are stretced in one direction, the center is stretched in both directions.

Uniform

Stretches the image to touch the sides of the available space and retain the aspect ratio. This will result in unfilled sections on either the left/right or top/bottom sides of the image.

UniformToFill

Stretches an image to touch all sides of the available space and retain the aspect ratio. This will result in the image being clipped on the left/right or top/bottom.

Interface of StretchMode

Fill : StretchMode uno

The image is stretched to fill the available space. The aspect ratio is not retained.

PixelPrecise : StretchMode uno

The size is pixel matched to the source so the image is drawn 1:1. This means the visual size changes across device densities, but the image remains sharp.

PointPrecise : StretchMode uno

The size of the source image, in points calculated with density, are used as the image size. This is the default: a 100x50 source image will be 100x50 points in size. This preserves size across various device densities.

PointPrefer : StretchMode uno

If the size of the image in PixelPrecise mode is close to PointPrecise then use PixelPrecise mode, otherwise use PointPrecise mode. This retains sharpness with slightly varying sizes, but prevents too much size variation.

Scale9 : StretchMode uno

The image is stretched in 9-segments defined by the Scale9Margin. Corners are not stretched, borders are stretced in one direction, the center is stretched in both directions.

Uniform : StretchMode uno

Stretches the image to touch the sides of the available space and retain the aspect ratio. This will result in unfilled sections on either the left/right or top/bottom sides of the image.

UniformToFill : StretchMode uno

Stretches an image to touch all sides of the available space and retain the aspect ratio. This will result in the image being clipped on the left/right or top/bottom.

Inherited from object