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>

*** ** * ** ***

Provides rendering instructions for a specific instance of [`BitmapFont`](https://developer.android.com/training/wearables/wff/bitmap-fonts#bitmap-font)
that appears in a text-based element.

Introduced in Wear OS 4.

## Syntax

```xml
<BitmapFont family="string" size="float"
            color="argb-color | rgb-color">
    <!-- Inner elements consist of text formatting options. Here, "Lower" is
         used as an example. -->
    <Lower ... />
</BitmapFont>
```

## Attributes

The `BitmapFont` element has the following attributes. Some attributes are
required while others are optional.

### Required attributes

The following attributes are required:

`family`
:   A string representing the name of the bitmap character set. This name should
    match the name given to a standalone [`BitmapFont`](https://developer.android.com/training/wearables/wff/bitmap-fonts#bitmap-font) element defined elsewhere
    in the watch face file.

`size`
:   A floating-point value that specifies the bitmap font size.

### Optional attributes

The `color` attribute is optional. If you include this attribute, 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][6].

## Inner elements

The `BitmapFont` element can contains the following inner elements:

- [`InlineImage`](https://developer.android.com/training/wearables/wff/group/part/text/formatter/inline-image)
- [`Template`](https://developer.android.com/training/wearables/wff/group/part/text/formatter/template)
- [`Upper`](https://developer.android.com/training/wearables/wff/group/part/text/formatter/upper)
- [`Lower`](https://developer.android.com/training/wearables/wff/group/part/text/formatter/lower)
- [`Transform`](https://developer.android.com/training/wearables/wff/common/transform/transform)
- [`Reference`](https://developer.android.com/training/wearables/wff/common/reference/reference)

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [BitmapFont](https://developer.android.com/training/wearables/wff/v2/group/part/text/bitmap-font)
- [Font](https://developer.android.com/training/wearables/wff/v2/group/part/text/font)
- [Font](https://developer.android.com/training/wearables/wff/group/part/text/font)