For digital clocks, you should aim to use `DigitalClock` where possible. For all
other text or clocks that cannot be represented using `DigitalClock`,
`PartText` is the container for text-based rendering.
Depending on whether you want to show circular or regular text, the `PartText`
should contain *either* a `Text` or a `TextCircular` element.
### Work with fonts and bitmap fonts
Using custom fonts allows your watch face to stand out with its own style.
There are two ways to use custom fonts, both within `TimeText` and `PartText`
containers.
1. Specify a custom font `family` in the `Font` element. [A range of common
formats](https://developer.android.com/training/wearables/wff/group/part/text/font?version=1) are
supported, which must be placed in `res/font`
For example, using the Pacifico font from Google Fonts, and placing the
asset as res/font/pacifico.ttf:
```xml
Hello!
```
2. Alternatively, define a `BitmapFont` supplying bitmap images in
`res/drawable`:
```xml
```
Note how sequences of characters can be given a special treatment. For example,
if "12" was to be represented with a joined 1 and 2, this could be achieved
using a `Word` element.
To use the defined font:
```xml
```
### Text effects
Watch Face Format provides several text effects which can be applied, such as
[`OutGlow`](https://developer.android.com/training/wearables/wff/group/part/text/decoration/out-glow) and [`Shadow`](https://developer.android.com/training/wearables/wff/group/part/text/decoration/shadow). To use these, apply them as subelements of the
`Font` element:
```xml
Hello!
```
### Work with templates
Instead of static text, you may need to construct your text from data sources or
expressions.
The `Template` element lets you do this:
```xml
Day: %s
```
### Work with resources
If your static text is instead defined in a resource, such as in
`res/values/strings.xml`, then it can be referenced as follows:
```xml
greeting
```
This also lets you localize your watch face using different [resource
qualifiers](https://developer.android.com/guide/topics/resources/providing-resources#AlternativeResources).
### Handle spacing
Working with text spacing in XML can be challenging. Extra spacing around text
can cause formatting problems, such as incorrect centering, or prevent your app
from finding Android string resources.
To avoid these situations, wrap your `Font` contents in a `CDATA` element:
```xml
```
### Multiline text
To create multiline text, use the `maxLines` attribute on `Text`:
```xml
```