# Cue

Artifact: [androidx.media3:media3-common](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/common/text/Cue.java+class:androidx.media3.common.text.Cue)

*** ** * ** ***

Kotlin \|[Java](https://developer.android.com/reference/androidx/media3/common/text/Cue "View this page in Java")


```
class Cue
```

<br />

*** ** * ** ***

Contains information about a specific cue, including textual content and formatting data.

## Summary

| ### Nested types |
|---|
| `@https://developer.android.com/reference/java/lang/annotation/Documented.html @https://developer.android.com/reference/java/lang/annotation/Retention.html(value = https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE) @https://developer.android.com/reference/java/lang/annotation/Target.html(value = ) @https://developer.android.com/reference/kotlin/androidx/annotation/IntDef(value = ) annotation https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.AnchorType` The type of anchor, which may be unset. |
| `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi class https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.Builder` A builder for `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue` objects. |
| `@https://developer.android.com/reference/java/lang/annotation/Documented.html @https://developer.android.com/reference/java/lang/annotation/Retention.html(value = https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE) @https://developer.android.com/reference/java/lang/annotation/Target.html(value = ) @https://developer.android.com/reference/kotlin/androidx/annotation/IntDef(value = ) annotation https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.LineType` The type of line, which may be unset. |
| `@https://developer.android.com/reference/java/lang/annotation/Documented.html @https://developer.android.com/reference/java/lang/annotation/Retention.html(value = https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE) @https://developer.android.com/reference/java/lang/annotation/Target.html(value = ) @https://developer.android.com/reference/kotlin/androidx/annotation/IntDef(value = ) annotation https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.TextSizeType` The type of default text size for this cue, which may be unset. |
| `@https://developer.android.com/reference/java/lang/annotation/Documented.html @https://developer.android.com/reference/java/lang/annotation/Retention.html(value = https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE) @https://developer.android.com/reference/java/lang/annotation/Target.html(value = ) @https://developer.android.com/reference/kotlin/androidx/annotation/IntDef(value = ) annotation https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.VerticalType` The type of vertical layout for this cue, which may be unset (i.e. horizontal). |

| ### Constants |
|---|---|
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_END() = 2` Anchors the right (for horizontal positions) or bottom (for vertical positions) edge of the cue box. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_MIDDLE() = 1` Anchors the middle of the cue box. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_START() = 0` Anchors the left (for horizontal positions) or top (for vertical positions) edge of the cue box. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET() = -3.4028235E38f` An unset position, width or size. |
| `const https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue!` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#EMPTY()` **This property is deprecated.** There's no general need for a cue with an empty text string. <br /> |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#LINE_TYPE_FRACTION() = 0` Value for `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` when `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` is a fractional position. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#LINE_TYPE_NUMBER() = 1` Value for `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` when `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` is a line number. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TEXT_SIZE_TYPE_ABSOLUTE() = 2` Text size is measured in number of pixels. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TEXT_SIZE_TYPE_FRACTIONAL() = 0` Text size is measured as a fraction of the viewport size minus the view padding. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TEXT_SIZE_TYPE_FRACTIONAL_IGNORE_PADDING() = 1` Text size is measured as a fraction of the viewport size, ignoring the view padding |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET() = -2147483648` An unset anchor, line, text size or vertical type value. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#VERTICAL_TYPE_LR() = 2` Vertical left-to-right (e.g. for Mongolian). |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#VERTICAL_TYPE_RL() = 1` Vertical right-to-left (e.g. for Japanese). |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.Builder!` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#buildUpon()()` Returns a new `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.Builder` initialized with the same values as this Cue. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#equals(java.lang.Object)(obj: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html?)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue!` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#fromBundle(android.os.Bundle)(bundle: https://developer.android.com/reference/android/os/Bundle.html!)` Restores a cue from a `https://developer.android.com/reference/android/os/Bundle.html`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#hashCode()()` |
| `https://developer.android.com/reference/android/os/Bundle.html!` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toBinderBasedBundle()()` Returns a `https://developer.android.com/reference/android/os/Bundle.html` that may contain `https://developer.android.com/reference/android/os/Binder.html` references, meaning it cannot be safely serialized to bytes. |
| `https://developer.android.com/reference/android/os/Bundle.html!` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi [toBundle](https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toBundle())()` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toSerializableBundle()` or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toBinderBasedBundle()` instead. <br /> |
| `https://developer.android.com/reference/android/os/Bundle.html!` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toSerializableBundle()()` Returns a `https://developer.android.com/reference/android/os/Bundle.html` that can be serialized to bytes. |

| ### Public properties |
|---|---|
| `https://developer.android.com/reference/android/graphics/Bitmap.html?` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#bitmap()` The cue image, or null if this is a text cue. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#bitmapHeight()` The bitmap height as a fraction of the viewport size, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()` if the bitmap should be displayed at its natural height given the bitmap dimensions and the specified `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#size()`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` The position of the cue box within the viewport in the direction orthogonal to the writing direction (determined by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#verticalType()`), or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.AnchorType https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineAnchor()` The cue box anchor positioned by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` when `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` is `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#LINE_TYPE_FRACTION()`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.LineType https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` The type of the `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` value. |
| `https://developer.android.com/reference/android/text/Layout.Alignment.html?` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#multiRowAlignment()` The alignment of multiple lines of text relative to the longest line, or null if the alignment is undefined. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#position()` The fractional position of the `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#positionAnchor()` of the cue box within the viewport in the direction orthogonal to `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()`, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.AnchorType https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#positionAnchor()` The cue box anchor positioned by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#position()`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#shearDegrees()` The shear angle in degrees to be applied to this Cue, expressed in graphics coordinates. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#size()` The size of the cue box in the writing direction specified as a fraction of the viewport size in that direction, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-char-sequence/index.html?` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#text()` The cue text, or null if this is an image cue. |
| `https://developer.android.com/reference/android/text/Layout.Alignment.html?` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#textAlignment()` The alignment of the cue text within the cue box, or null if the alignment is undefined. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#textSize()` The default text size for this cue's text, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()` if this cue has no default text size. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.TextSizeType https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#textSizeType()` The default text size type for this cue's text, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()` if this cue has no default text size. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.VerticalType https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#verticalType()` The vertical formatting of this Cue, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()` if the cue has no vertical setting (and so should be horizontal). |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#windowColor()` The fill color of the window. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#windowColorSet()` Specifies whether or not the `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#windowColor()` property is set. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#zIndex()` The Z index for cue, the larger index will render above the smaller index. |

## Constants

### ANCHOR_TYPE_END

```
const val ANCHOR_TYPE_END = 2: Int
```

Anchors the right (for horizontal positions) or bottom (for vertical positions) edge of the cue box.

### ANCHOR_TYPE_MIDDLE

```
const val ANCHOR_TYPE_MIDDLE = 1: Int
```

Anchors the middle of the cue box.

### ANCHOR_TYPE_START

```
const val ANCHOR_TYPE_START = 0: Int
```

Anchors the left (for horizontal positions) or top (for vertical positions) edge of the cue box.

### DIMEN_UNSET

```
const val DIMEN_UNSET = -3.4028235E38f: Float
```

An unset position, width or size.

### EMPTY

```
const val EMPTY: Cue!
```

> [!CAUTION]
> **This property is deprecated.**   
>
> There's no general need for a cue with an empty text string. If you need one, create it yourself.

### LINE_TYPE_FRACTION

```
const val LINE_TYPE_FRACTION = 0: Int
```

Value for `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` when `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` is a fractional position.

### LINE_TYPE_NUMBER

```
const val LINE_TYPE_NUMBER = 1: Int
```

Value for `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` when `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` is a line number.

### TEXT_SIZE_TYPE_ABSOLUTE

```
const val TEXT_SIZE_TYPE_ABSOLUTE = 2: Int
```

Text size is measured in number of pixels.

### TEXT_SIZE_TYPE_FRACTIONAL

```
const val TEXT_SIZE_TYPE_FRACTIONAL = 0: Int
```

Text size is measured as a fraction of the viewport size minus the view padding.

### TEXT_SIZE_TYPE_FRACTIONAL_IGNORE_PADDING

```
const val TEXT_SIZE_TYPE_FRACTIONAL_IGNORE_PADDING = 1: Int
```

Text size is measured as a fraction of the viewport size, ignoring the view padding

### TYPE_UNSET

```
const val TYPE_UNSET = -2147483648: Int
```

An unset anchor, line, text size or vertical type value.

### VERTICAL_TYPE_LR

```
const val VERTICAL_TYPE_LR = 2: Int
```

Vertical left-to-right (e.g. for Mongolian).

### VERTICAL_TYPE_RL

```
const val VERTICAL_TYPE_RL = 1: Int
```

Vertical right-to-left (e.g. for Japanese).

## Public functions

### buildUpon

```
@UnstableApi
fun buildUpon(): Cue.Builder!
```

Returns a new `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue.Builder` initialized with the same values as this Cue.

### equals

```
fun equals(obj: Any?): Boolean
```

### fromBundle

```
@UnstableApi
java-static fun fromBundle(bundle: Bundle!): Cue!
```

Restores a cue from a `https://developer.android.com/reference/android/os/Bundle.html`.

### hashCode

```
fun hashCode(): Int
```

### toBinderBasedBundle

```
@UnstableApi
fun toBinderBasedBundle(): Bundle!
```

Returns a `https://developer.android.com/reference/android/os/Bundle.html` that may contain `https://developer.android.com/reference/android/os/Binder.html` references, meaning it cannot be safely serialized to bytes.

The `https://developer.android.com/reference/android/os/Bundle.html` returned from this method can be safely sent between processes and parsed by older versions of the media3 library.

Use `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toSerializableBundle()` to get a `https://developer.android.com/reference/android/os/Bundle.html` that can be safely serialized.

### toBundle

```
@UnstableApi
fun [toBundle](https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toBundle())(): Bundle!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toSerializableBundle()` or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toBinderBasedBundle()` instead.

### toSerializableBundle

```
@UnstableApi
fun toSerializableBundle(): Bundle!
```

Returns a `https://developer.android.com/reference/android/os/Bundle.html` that can be serialized to bytes.

Prefer the more efficient `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#toBinderBasedBundle()` if the result doesn't need to be serialized.

The `https://developer.android.com/reference/android/os/Bundle.html` returned from this method must not be passed to other processes that might be using a different version of the media3 library.

## Public properties

### bitmap

```
val bitmap: Bitmap?
```

The cue image, or null if this is a text cue.

### bitmapHeight

```
val bitmapHeight: Float
```

The bitmap height as a fraction of the viewport size, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()` if the bitmap should be displayed at its natural height given the bitmap dimensions and the specified `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#size()`.

### line

```
val line: Float
```

The position of the cue box within the viewport in the direction orthogonal to the writing direction (determined by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#verticalType()`), or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()`. When set, the interpretation of the value depends on the value of `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()`.

The measurement direction depends on `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#verticalType()`:

- For `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()` (i.e. horizontal), this is the vertical position relative to the top of the viewport.
- For `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#VERTICAL_TYPE_LR()` this is the horizontal position relative to the left of the viewport.
- For `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#VERTICAL_TYPE_RL()` this is the horizontal position relative to the right of the viewport.

### lineAnchor

```
@Cue.AnchorType
val lineAnchor: Int
```

The cue box anchor positioned by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` when `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineType()` is `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#LINE_TYPE_FRACTION()`.

One of:

- `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_START()`
- `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_MIDDLE()`
- `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_END()`
- `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()`

For the normal case of horizontal text, `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_START()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_MIDDLE()` and `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_END()` correspond to the top, middle and bottom of the cue box respectively.

### lineType

```
@Cue.LineType
val lineType: Int
```

The type of the `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` value.

- `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#LINE_TYPE_FRACTION()` indicates that `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` is a fractional position within the viewport (measured to the part of the cue box determined by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineAnchor()`).
- `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#LINE_TYPE_NUMBER()` indicates that `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()` is a viewport line number. The viewport is divided into lines (each equal in size to the first line of the cue box). The cue box is positioned to align with the viewport lines as follows:
  - `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#lineAnchor()`) is ignored.
  - When `line` is greater than or equal to 0 the first line in the cue box is aligned with a viewport line, with 0 meaning the first line of the viewport.
  - When `line` is negative the last line in the cue box is aligned with a viewport line, with -1 meaning the last line of the viewport.
  - For horizontal text the start and end of the viewport are the top and bottom respectively.

### multiRowAlignment

```
val multiRowAlignment: Layout.Alignment?
```

The alignment of multiple lines of text relative to the longest line, or null if the alignment is undefined.

### position

```
val position: Float
```

The fractional position of the `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#positionAnchor()` of the cue box within the viewport in the direction orthogonal to `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#line()`, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()`.

The measurement direction depends on `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#verticalType()`.

- For `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()` (i.e. horizontal), this is the horizontal position relative to the left of the viewport. Note that positioning is relative to the left of the viewport even in the case of right-to-left text.
- For `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#VERTICAL_TYPE_LR()` and `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#VERTICAL_TYPE_RL()` (i.e. vertical), this is the vertical position relative to the top of the viewport.

### positionAnchor

```
@Cue.AnchorType
val positionAnchor: Int
```

The cue box anchor positioned by `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#position()`. One of `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_START()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_MIDDLE()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_END()` and `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()`.

For the normal case of horizontal text, `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_START()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_MIDDLE()` and `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#ANCHOR_TYPE_END()` correspond to the left, middle and right of the cue box respectively.

### shearDegrees

```
val shearDegrees: Float
```

The shear angle in degrees to be applied to this Cue, expressed in graphics coordinates. This results in a skew transform for the block along the inline progression axis.

### size

```
val size: Float
```

The size of the cue box in the writing direction specified as a fraction of the viewport size in that direction, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()`.

### text

```
val text: CharSequence?
```

The cue text, or null if this is an image cue. Note the `https://developer.android.com/reference/java/lang/CharSequence.html` may be decorated with styling spans.

### textAlignment

```
val textAlignment: Layout.Alignment?
```

The alignment of the cue text within the cue box, or null if the alignment is undefined.

### textSize

```
val textSize: Float
```

The default text size for this cue's text, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#DIMEN_UNSET()` if this cue has no default text size.

### textSizeType

```
@Cue.TextSizeType
val textSizeType: Int
```

The default text size type for this cue's text, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()` if this cue has no default text size.

### verticalType

```
@Cue.VerticalType
val verticalType: Int
```

The vertical formatting of this Cue, or `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#TYPE_UNSET()` if the cue has no vertical setting (and so should be horizontal).

### windowColor

```
val windowColor: Int
```

The fill color of the window.

### windowColorSet

```
val windowColorSet: Boolean
```

Specifies whether or not the `https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue#windowColor()` property is set.

### zIndex

```
@UnstableApi
val zIndex: Int
```

The Z index for cue, the larger index will render above the smaller index. May be negative.