Watch Face Format version <button value="5" default="">Version 5</button> <button value="4">Version 4</button> <button value="3">Version 3</button> <button value="2">Version 2</button> <button value="1">Version 1</button>

*** ** * ** ***

Represents the part of a watch face that contains one or more images.

Introduced in Wear OS 4.

## Syntax

```xml
<PartImage x="integer" y="integer" width="integer" height="integer"
           pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
           name="string" scaleX="float" scaleY="float"
           renderMode="[SOURCE | MASK | ALL]"
           blendMode="string"
           tintColor="argb-color | rgb-color">
    <!-- Image-specific child elements. A "PartImage" element must have only
      one of the following elements. -->
    <Images>
        <Image ... />
    </Images>
    <Image ... />
    <Photos ... />
    <!-- Optionally a single ImageFilter can be applied. -->
    <ImageFilters ... />
    <!-- Child elements that are shared across all "Part" elements. -->
    <Localization .../>
    <Transform .../>
    <Variant .../>
    <Gyro .../>
    <Launch .../>
    <ScreenReader .../>
</PartImage>
```

## Attributes

The `PartImage` element has the following attributes:

### Required attributes

The following attributes are required:

`x`, `y`, `width`, `height`

:   A collection of integers that specify the element's size and position.

    These attributes are [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

### Optional attributes

The following attributes are optional:

`pivotX`, `pivotY`

:   A two-dimensional pivot point about which the element rotates. Both values
    are floating-point numbers that are scaled to fit in the range $ \[0, 1\] $.

    These attributes are [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

`angle`

:   A number of degrees, clockwise, that the element should be rotated about its
    pivot point.

    This attribute is [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

`alpha`

:   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.

    This attribute is [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

`name`

:   A string that identifies this element. Useful if you need to refer to this
    element from another location within your watch face file.

`scaleX`

:   The horizontal scaling factor to apply to this element.

    This attribute is [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

`scaleY`

:   The vertical scaling factor to apply to this element.

    This attribute is [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

[`renderMode`](https://developer.android.com/training/wearables/wff/effects#clipping)

:   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).

    From version 4, this attribute is [transformable](https://developer.android.com/reference/wear-os/wff/common/transform/transform).

[`blendMode`](https://developer.android.com/training/wearables/wff/effects#blend-mode)

:   Sets the [`blendMode`](https://developer.android.com/reference/wear-os/wff/group/part/image/photos) for drawing this `PartImage` (this element is
    treated as the *src*).

## Inner elements

The `PartImage` element must contain a single [`Image`](https://developer.android.com/reference/wear-os/wff/group/part/image/image), [`Images`](https://developer.android.com/reference/wear-os/wff/group/part/image/images) or [`Photos`](https://developer.android.com/reference/wear-os/wff/group/part/image/photos) element.

All of the following elements can optionally appear once, apart from `Transform`
which can appear an unlimited number of times.

- [`ImageFilters`](https://developer.android.com/reference/wear-os/wff/group/part/image/image-filter/image-filters)
- [`Localization`](https://developer.android.com/reference/wear-os/wff/common/localization)
- [`Transform`](https://developer.android.com/reference/wear-os/wff/common/transform/transform)
- [`Variant`](https://developer.android.com/reference/wear-os/wff/common/variant/variant)
- [`Gyro`](https://developer.android.com/reference/wear-os/wff/common/transform/gyro)
- [`Launch`](https://developer.android.com/reference/wear-os/wff/common/launch)
- [`ScreenReader`](https://developer.android.com/reference/wear-os/wff/common/screen-reader)
- [`Reference`](https://developer.android.com/training/wearables/wff/common/reference/reference)

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [PartImage](https://developer.android.com/reference/wear-os/wff/group/part/image/part-image)