menuPujie BlackPujie Black logo

Editable Elements

Editable elements are those which can be designed in the watch part designer.

Content

Watch hands

Watch hand
A watch hand auto rotates around it's center according to the time specification you choose. Watch hands can be edited using the watch part designer and shared with others.

Below you can see a tutorial video of how to create a watch hand using the watch part designer.

Graphics

Graphics
A graphic is a static element. It does not change and is therefore more efficient and has less impact on your battery levels. You can use it for backgrounds or anything which remains the same. Graphics can be edited using the watch part designer and shared with others.

Tickmarks & numbers

Tickmark/number
A tickmark/number is an element which can be used to quickly create the tickmarks/numbers on a watch face. You design one, and easily place them on all or some of the hour/minute marker positions of a standard analog watch face design. Tickmarks/numbers can be edited using the watch part designer and shared with others.

Custom element

A custom element can use text tags to display data. You can add all kinds of tags and it is not limited to one data source.

Custom elements
A custom element can be anything. It is the most powerfull element available. You can create dynamic elements using automation, allowing you to design whatever you want. Custom elements can be edited using the watch part designer and shared with others.
Text tags

The custom element watch part allows you to add 'live text', using text tags. When changing the text on a text layer you will have some extra options in the text dialog. You can add all kinds of text tags to add dynamic text to the part.

Just tap one of the tags, and it will be added to the input text. You can also write the tags in the text using the keyboard.

Automation

Custom elements can also be automated using javascript. The same tags can be used to position and transform your layers, so you can create custom automated watch parts.

Read more about automation in the automation section of the watch part designer manual

Complications

A complication is any feature in a watch face that is displayed in addition to time. For example, a battery indicator is a complication.

Wear OS has a specific API for creating complications, Pujie Black adds to that by allowing the user to design the drawing style of a complication.

Complication
A complication in Pujie Black is a drawing style for a certain type of data. The complication you create, defines how it looks. Afterwards you can assign data from different sources to your complication drawing style. Complications can be edited using the watch part designer and shared with others.
What are they?

A custom complication in Pujie Black is a drawing style for a certain type of data. The complication you create, defines how it looks. Afterwards you can assign data from different sources to you complication drawing style.

The image below, from the Wear OS developer pages, shows the 6 different complication types available.

The complication types section describes these types in detail.

To illustrate, your drawing style is never specifically a battery complication for instance, it could be used to show battery data, but it should also work for any other data which has the same type.

This might sound complicated, and initially it may be, but once you understand it, it is very powerful. You define your drawing style once and later you can assign any data source to it which fits the profile.

Below you can find some links to more documentation about the Wear OS complication system.

Documentation about the complication API in Wear OS
Creating a complication

When you create a new complication, you will first have to choose it's type. You can choose from the 6 options as shown in the image above. Each complication has a set of required fields and a set of optional fields.

Complications are designed in the Watch Part Designer. For each of the required and optional fields a locked layer will be added to your complication by default. For instance, this is shown in the image below for a ranged value complication.

These locked layers have to be incorporated in your design (or you can choose to make them invisible, if your drawing style works better without). But the field connected to these locked layers might not contain a value for each data provider. The goal is to make your design work with each data provider.

Data Providers

Tap the following button to see what your complication looks like with a different data provider.

Pick complication data
This button is used throughout the application to pick your complication data provider.

Each complication type has several data providers built in Pujie Black. For instance a ranged value complication has data providers for the phone battery, watch battery and more.

The image below shows the dialog used to pick your data provider

Note that the complication shown in the dialog above uses the same style but is taylored to the data. Ideally your drawing style should work well with all the data providers in this dialog.

To achieve this you can make use of Automation. This is discussed in the automation section of the Watch Part Designer manual.

Using automation you can for example rotate a layer, based on the value supplied with a ranged value complication. And using visibility automation you can hide layers if they should not be shown in a certain configuration.

Please have a look at some of our video tutorials to better understand how to create your complication.

Test data providers

Each of the complication types has a set of test data providers. These don't supply a meaningful value and are not meant to be used in your final design, but are very helpfull in testing your complication.

Tapping and outlines

Some complications have tap actions assigned to them. So when you tap the watch face a ripple will be shown to indicate it's tap area. You can customize the shape of this ripple by adding a shape layer with the name Outline to your custom element.

External Data Providers

Because this system matches the official Wear OS Complication system, you can assign external data providers to your complication as well.

This can only be done from the Pujie Black configuration menu on your watch. Follow these steps to assign your external data provider.

1
Long press your watch screen, to open the Pujie Black configuration menu.
2
Go to Customize .. Interactive or Ambient .. Custom complications
3
Tap the complication you want to change
2
Go to External data provider and choose your provider
Complication Types

Below you can find a description of each of the 6 complication types.

Short text complication

A short text complication may be just a single piece of text, or a title and text, or an icon and text. Examples include weather or calendar information.

Required fields
  • Small Text
Optional fields
  • Icon
  • Short Title
Icon complication

An icon complication can be used when text is not needed. The icon is expected to be single-color, and can be tinted. It could for instance be an icon depicting the current weather status, or just a button to start an action.

Required fields
  • Icon
Optional fields
  • -
Ranged value complication

A ranged value complication can display data which includes a numeric value. The numeric value comes with a maximum and minimum value, so that it can be displayed relative to these bounds. It could for instance be a gauge which shows your daily steps or your battery levels.

Required fields
    Value
    • Max Value
      • Min Value
Optional fields
      Icon
      • Short Text
        • Short Title
Long text complication

A long text complication is used when you would like to show more text. It could for instance be your upcoming calendar items, or a description of the current weather.

Required fields
    Long Text
Optional fields
      Long Title
      • Icon
        • Small Image (Image)
          • Small Image (Icon)
Small image complication

A small image complication has one of two styles: photo style or icon style. Photo style means it should fill the space and can be cropped.

Required fields
    Small Image (Image)
    • Small Image (Icon)
Optional fields
  • -
Large image complication

A large image complication can be used to fill the watch face with an image. It could be the cover art of your current media, or just a nice background image.

Required fields
    Large Image
Optional fields
  • -