UIImageRenderingModeAlwaysOriginal

UIImageRenderingMode is a property of the UIImage class in Apple's UIKit framework. It determines how an image should be rendered when it is used in a user interface. This property is particularly useful for template images, which are often used for icons or other graphical elements that need to adapt to the tint color of their surrounding UI elements.

There are three possible values for UIImageRenderingMode:

Original: This is the default rendering mode. When an image is rendered with the original mode, its original colors are preserved. This is suitable for images that have specific color palettes that should not be altered.

AlwaysTemplate: In this mode, the image is treated as a template. All color information in the image is ignored, and it is rendered with the current tint color of the UI element it is associated with. This is ideal for creating icons that dynamically change color based on the user interface's theme or the state of a control.

AlwaysOriginal: When an image is rendered with the always original mode, it will always be displayed with its original colors, regardless of any tint color settings. This is useful when you have an image with a fixed design that must not be modified by the system's tint color.

By choosing the appropriate UIImageRenderingMode, developers can ensure their images are displayed as intended, whether they need to be recolored dynamically or maintain their original appearance. This flexibility is a key aspect of creating visually consistent and adaptable user interfaces in iOS, macOS, and other Apple platforms.