Complication bounding areas are used to define the rendering area for a Complication. An outline of the bounding area is shown in the watch face editor. Any content outside of the bounding area is cropped.
The bounding area also determines the region where the user can select the complication from the watch face.
Introduced in Wear OS 4.
BoundingBox
A BoundingBox
element defines a rectangular bounding area for the
complication.
Syntax
<BoundingBox x="integer" y="integer" width="integer" height="integer" outlinePadding="float" />
Attributes
The BoundingBox
element must contain the following attributes:
x
,y
,width
,height
- A collection of integers that specify the element's size and position.
The BoundingBox
element can optionally contain the following attributes:
outlinePadding
- A float that specifies padding to apply to the outside of the bounding area. This is used to create a larger outline in the watch face editor. Defaults to 0.
BoundingRoundBox
A BoundingRoundBox
element defines a rectangular bounding area with rounded
corners for the complication.
Syntax
<BoundingRoundBox x="integer" y="integer" width="integer" height="integer" outlinePadding="float" cornerRadius="float" />
Attributes
The BoundingRoundBox
element must contain the following attributes:
x
,y
,width
,height
- A collection of integers that specify the element's size and position.
The BoundingRoundBox
element can optionally contain the following attributes:
cornerRadius
The radius of a circle. This value defines the extent to which the corners of the rectangle are rounded.
outlinePadding
- A float that specifies padding to apply to the outside of the bounding area. This is used to create a larger outline in the watch face editor. Defaults to 0.
BoundingOval
A BoundingOval
element defines a round bounding area for the complication.
Syntax
<BoundingOval x="integer" y="integer" width="integer" height="integer" outlinePadding="float" />
Attributes
The BoundingOval
element must contain the following attributes:
x
,y
,width
,height
- A collection of integers that specify the element's size and position.
The BoundingOval
element can optionally contain the following attributes:
outlinePadding
- A float that specifies padding to apply to the outside of the bounding area. This is used to create a larger outline in the watch face editor. Defaults to 0.
BoundingArc
A BoundingArc
element defines a arc shaped bounding area for the complication.
Syntax
<BoundingArc centerX="float" centerY="float" width="float" height="float" thickness="float" isRoundEdge="boolean" startAngle="float" endAngle="float" direction="CLOCKWISE | COUNTER_CLOCKWISE" outlinePadding="float" />
Attributes
The BoundingArc
element must contain the following attributes:
centerX
,centerY
,width
,height
- A collection of attributes which define a containing oval for the arc. The arc is scaled to fit inside the specified oval. All attributes are defined as floats.
thickness
- The thickness of the arc expressed as a float.
startAngle
- Starting angle (in degrees) where the arc begins. An angle of 0 degrees corresponds to the 12 o'clock position on the watch.
endAngle
- End angle, where the arc finishes.
The BoundingArc
element can optionally contain the following attributes:
isRoundEdge
- Determines whether the cap at the end of the arc is flat or rounded. Defaults to FALSE.
direction
- The rotation direction of the arc. Defaults to
CLOCKWISE
. outlinePadding
- A float that specifies padding to apply to the outside of the bounding area. This is used to create a larger outline in the watch face editor. Defaults to 0.
Recommended for you
- Note: link text is displayed when JavaScript is off
- TextCircular
- Arc
- SweepGradient