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>

*** ** * ** ***

A `PartAnimatedImage` contains an animated element that appears on the watch
face. The `PartAnimatedImage` determines where on the watch face the animated
element appears, and the [inner elements](https://developer.android.com/reference/wear-os/wff/group/part/animated-image/part-animated-image#inner-elements) determine the specific animated
resource which plays.

## Syntax

```xml
<PartAnimatedImage x="integer" y="integer" width="integer" height="integer"
          name="string" angle="integer" pivotX="integer" pivotY="integer"
          alpha="integer" renderMode="SOURCE | MASK | ALL"
          tintColor="argb-color | rgb-color" blendMode="string">
    <AnimationController ... />
    <!-- One possible inner element is shown. -->
    <AnimatedImage ... />
    <!-- The Thumbnail inner element is optional, but strongly recommended for performance. -->
    <Thumbnail ... />
    ...
</PartAnimatedImage>
```

## Attributes

The `PartAnimatedImage` 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).

`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/common/attributes/blend-mode) for drawing this `PartAnimatedImage` (this element
    is treated as the *src*).

## Inner elements

Each `PartAnimatedImage` element must contain a single
[`AnimationController`](https://developer.android.com/reference/wear-os/wff/group/part/animated-image/animation-controller) inner element and one of the following inner
elements:

- [`AnimatedImages`](https://developer.android.com/reference/wear-os/wff/group/part/animated-image/animated-images)
- [`AnimatedImage`](https://developer.android.com/reference/wear-os/wff/group/part/animated-image/animated-image)
- [`SequenceImage`](https://developer.android.com/reference/wear-os/wff/group/part/animated-image/sequence-image)

Optionally, the `PartAnimatedImage` element can also contain the following
elements:

- [`Gyro`](https://developer.android.com/reference/wear-os/wff/common/transform/gyro)
- [`Launch`](https://developer.android.com/reference/wear-os/wff/common/launch)
- [`Localization`](https://developer.android.com/reference/wear-os/wff/common/localization)
- [`ScreenReader`](https://developer.android.com/reference/wear-os/wff/common/screen-reader)
- [`Transform`](https://developer.android.com/reference/wear-os/wff/common/transform/transform)
- [`Thumbnail`](https://developer.android.com/reference/wear-os/wff/group/part/animated-image/thumbnail) - this is strongly recommended.
- [`Variant`](https://developer.android.com/reference/wear-os/wff/common/variant/variant)
- [`Reference`](https://developer.android.com/training/wearables/wff/common/reference/reference)

## Recommended for you

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