Set the level of transparency that this element should have. A value of 0
indicates that the element should be completely transparent. A value of 255
indicates that the element should be completely opaque.
The element's render mode type. Possible values are: SOURCE (default),
MASK, or ALL.
tintColor
Apply a tint color filter to the element. You must specify the color using
either the ARGB format (#ff000000 = opaque black) or the RGB format
(#000000 = black).
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-06-03 UTC.
[null,null,["Last updated 2025-06-03 UTC."],[],[],null,["# PartImage\n\nWatch Face Format version Version 4 Version 3 Version 2 Version 1\n\n*** ** * ** ***\n\nRepresents the part of a watch face that contains one or more images.\n\nIntroduced in Wear OS 4.\n\nSyntax\n------\n\n```xml\n\u003cPartImage x=\"integer\" y=\"integer\" width=\"integer\" height=\"integer\"\n pivotX=\"float\" pivotY=\"float\" angle=\"float-degrees\" alpha=\"integer\"\n name=\"string\" scaleX=\"float\" scaleY=\"float\"\n renderMode=\"[SOURCE | MASK | ALL]\"\n blendMode=\"string\"\n tintColor=\"argb-color | rgb-color\"\u003e\n \u003c!-- Image-specific child elements. A \"PartImage\" element must have only\n one of the following elements. --\u003e\n \u003cImages\u003e\n \u003cImage ... /\u003e\n \u003c/Images\u003e\n \u003cImage ... /\u003e\n \u003cPhotos ... /\u003e\n \u003c!-- Optionally a single ImageFilter can be applied. --\u003e\n \u003cImageFilters ... /\u003e\n \u003c!-- Child elements that are shared across all \"Part\" elements. --\u003e\n \u003cLocalization .../\u003e\n \u003cTransform .../\u003e\n \u003cVariant .../\u003e\n \u003cGyro .../\u003e\n \u003cLaunch .../\u003e\n \u003cScreenReader .../\u003e\n\u003c/PartImage\u003e\n```\n\nAttributes\n----------\n\nThe `PartImage` element has the following attributes:\n\n### Required attributes\n\nThe following attributes are required:\n\n`x`, `y`, `width`, `height`\n\n: A collection of integers that specify the element's size and position.\n\n These attributes are [transformable](/reference/wear-os/wff/common/transform/transform).\n\n### Optional attributes\n\nThe following attributes are optional:\n\n`pivotX`, `pivotY`\n\n: A two-dimensional pivot point about which the element rotates. Both values\n are floating-point numbers that are scaled to fit in the range $ \\[0, 1\\] $.\n\n These attributes are [transformable](/reference/wear-os/wff/common/transform/transform).\n\n`angle`\n\n: A number of degrees, clockwise, that the element should be rotated about its\n pivot point.\n\n This attribute is [transformable](/reference/wear-os/wff/common/transform/transform).\n\n`alpha`\n\n: Set the level of transparency that this element should have. A value of `0`\n indicates that the element should be completely transparent. A value of `255`\n indicates that the element should be completely opaque.\n\n This attribute is [transformable](/reference/wear-os/wff/common/transform/transform).\n\n`name`\n\n: A string that identifies this element. Useful if you need to refer to this\n element from another location within your watch face file.\n\n`scaleX`\n\n: The horizontal scaling factor to apply to this element.\n\n This attribute is [transformable](/reference/wear-os/wff/common/transform/transform).\n\n`scaleY`\n\n: The vertical scaling factor to apply to this element.\n\n This attribute is [transformable](/reference/wear-os/wff/common/transform/transform).\n\n[`renderMode`](/training/wearables/wff/effects#clipping)\n\n: The element's render mode type. Possible values are: `SOURCE` (default),\n `MASK`, or `ALL`.\n\n`tintColor`\n\n: Apply a tint color filter to the element. You must specify the color using\n either the ARGB format (`#ff000000` = opaque black) or the RGB format\n (`#000000` = black).\n\n From version 4, this attribute is [transformable](/reference/wear-os/wff/common/transform/transform).\n\n[`blendMode`](/training/wearables/wff/effects#blend-mode)\n\n: Sets the [`blendMode`](/reference/wear-os/wff/group/part/image/photos) for drawing this `PartImage` (this element is\n treated as the *src*).\n\nInner elements\n--------------\n\nThe `PartImage` element must contain a single [`Image`](/reference/wear-os/wff/group/part/image/image), [`Images`](/reference/wear-os/wff/group/part/image/images) or [`Photos`](/reference/wear-os/wff/group/part/image/photos) element.\n\nAll of the following elements can optionally appear once, apart from `Transform`\nwhich can appear an unlimited number of times.\n\n- [`ImageFilters`](/reference/wear-os/wff/group/part/image/image-filter/image-filters)\n- [`Localization`](/reference/wear-os/wff/common/localization)\n- [`Transform`](/reference/wear-os/wff/common/transform/transform)\n- [`Variant`](/reference/wear-os/wff/common/variant/variant)\n- [`Gyro`](/reference/wear-os/wff/common/transform/gyro)\n- [`Launch`](/reference/wear-os/wff/common/launch)\n- [`ScreenReader`](/reference/wear-os/wff/common/screen-reader)\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [PartImage](/reference/wear-os/wff/group/part/image/part-image)"]]