setStretch

setStretch is a function commonly found in graphics or UI programming libraries that controls how an image or graphical element is scaled to fit a specific area. When an image is displayed within a container of a different size, setStretch determines the scaling behavior.

There are typically several modes for setStretch, each producing a different visual outcome. One common mode is "stretch" or "fill," which forces the image to expand or contract to perfectly fill the entire dimensions of the container, potentially distorting its original aspect ratio. Another mode, "uniform" or "aspectFit," scales the image while maintaining its original aspect ratio. The image will be scaled as large as possible without exceeding the container's boundaries. This means that either the width or the height of the image will match the corresponding dimension of the container, leaving empty space in the other dimension.

A related mode, "aspectFill" or "crop," also maintains the aspect ratio but scales the image until both dimensions of the container are completely filled. This often results in parts of the image being cropped from the edges if the aspect ratios of the image and the container do not match. Other less common modes might include "none" or "originalSize," which display the image at its native resolution without scaling, potentially leading to clipping or underflow within the container. The specific names and behaviors of these modes can vary depending on the programming language, framework, or library being used.