An image displayed by a complication.
- watchOS 2.0+
You create an image provider with at least one image and may specify two additional images to use under certain conditions. The images you specify are template images that have a color applied to them prior to display. The clock face displaying the complication determines how the images are composited together and which tint color is applied.
Every image provider must contain a one-piece image, which is comprised of a single template image. In multicolor clock faces, ClockKit applies the color in the
tint property to your template image and displays the results in your complication. If you do not specify a value for the
tint property, the image provider uses the tint color associated with the underlying template, or white if no other color is specified. In monochrome environments, ClockKit applies the tint color associated with the clock face itself, ignoring any custom colors you specify.
In addition to the one-piece image, you may optionally specify two additional images to composite together to create a single final image. Two-piece images are displayed only in multicolor environments and take priority over one-piece images in those environments. A two-piece image consists of a foreground image layered on top of a background image. Both images are template images. ClockKit applies the color in the
tint property to the background image, falling back to the color in the underlying template or white if no custom color is specified. ClockKit always applies a white color to the foreground image. Two-piece images are not used in monochrome environments.
For information about the image sizes to use in different templates, see Apple Watch Human Interface Guidelines.