# ColorScheme

Artifact: [androidx.tv:tv-material](https://developer.android.com/jetpack/androidx/releases/tv) [View Source](https://cs.android.com/search?q=file:androidx/tv/material3/ColorScheme.kt+class:androidx.tv.material3.ColorScheme) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)


```
class ColorScheme
```

<br />

*** ** * ** ***

A color scheme holds all the named color parameters for a `https://developer.android.com/reference/kotlin/androidx/tv/material3/MaterialTheme`.

Color schemes are designed to be harmonious, ensure accessible text, and distinguish UI elements and surfaces from one another. There are two built-in baseline schemes, `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#lightColorScheme(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)` and a `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#darkColorScheme(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`, that can be used as-is or customized.

The Material color system and custom schemes provide default values for color as a starting point for customization.

To learn more about colors, see [Material Design colors](https://m3.material.io/styles/color/overview).

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#ColorScheme(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)( primary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, primaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, inversePrimary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, background: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onBackground: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSurface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSurfaceVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceTint: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, inverseSurface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, inverseOnSurface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, error: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onError: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, errorContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onErrorContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, border: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, borderVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, scrim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color )` |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#copy(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)( primary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, primaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, inversePrimary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiary: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiaryContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, background: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onBackground: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSurface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSurfaceVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceTint: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, inverseSurface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, inverseOnSurface: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, error: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onError: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, errorContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onErrorContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, border: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, borderVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, scrim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color )` Returns a copy of this ColorScheme, optionally overriding some of the values. |
| `open https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#toString()()` |

| ### Public properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#background()` The background color that appears behind scrollable content. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#border()` Subtle color used for boundaries. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#borderVariant()` Utility color used for boundaries for decorative elements when strong contrast is not required. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#error()` The error color is used to indicate errors in components, such as invalid text in a text field. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#errorContainer()` The preferred tonal color of error containers. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#inverseOnSurface()` A color that contrasts well with `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#inversePrimary()` Color to be used as a "primary" color in places where the inverse color scheme is needed, such as the button on a SnackBar. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#inverseSurface()` A color that contrasts sharply with `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onBackground()` Color used for text and icons displayed on top of the background color. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onError()` Color used for text and icons displayed on top of the error color. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onErrorContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onPrimary()` Color used for text and icons displayed on top of the primary color. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onPrimaryContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onSecondary()` Color used for text and icons displayed on top of the secondary color. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onSecondaryContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onSurface()` Color used for text and icons displayed on top of the surface color. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onSurfaceVariant()` The color (and state variants) that can be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onTertiary()` Color used for text and icons displayed on top of the tertiary color. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onTertiaryContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#primary()` The primary color is the color displayed most frequently across your app's screens and components. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#primaryContainer()` The preferred tonal color of containers. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#scrim()` Color of a scrim that obscures content. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#secondary()` The secondary color provides more ways to accent and distinguish your product. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#secondaryContainer()` A tonal color to be used in containers. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#surface()` The surface color that affect surfaces of components, such as cards, sheets, and menus. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#surfaceTint()` This color will be used by components that apply tonal elevation and is applied on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#surfaceVariant()` Another option for a color with similar uses of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#tertiary()` The tertiary color that can be used to balance primary and secondary colors, or bring heightened attention to an element such as an input field. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#tertiaryContainer()` A tonal color to be used in containers. |

| ### Extension functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme.https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)(backgroundColor: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color)` The Material color system contains pairs of colors that are typically used for the background and content color inside a component. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme.https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.tv.material3.ColorScheme).surfaceColorAtElevation(androidx.compose.ui.unit.Dp)(elevation: https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp)` Computes the surface tonal color at different elevation levels e.g. surface1 through surface5. |

## Public constructors

### ColorScheme

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/tv#1.1.0)

```
ColorScheme(
    primary: Color,
    onPrimary: Color,
    primaryContainer: Color,
    onPrimaryContainer: Color,
    inversePrimary: Color,
    secondary: Color,
    onSecondary: Color,
    secondaryContainer: Color,
    onSecondaryContainer: Color,
    tertiary: Color,
    onTertiary: Color,
    tertiaryContainer: Color,
    onTertiaryContainer: Color,
    background: Color,
    onBackground: Color,
    surface: Color,
    onSurface: Color,
    surfaceVariant: Color,
    onSurfaceVariant: Color,
    surfaceTint: Color,
    inverseSurface: Color,
    inverseOnSurface: Color,
    error: Color,
    onError: Color,
    errorContainer: Color,
    onErrorContainer: Color,
    border: Color,
    borderVariant: Color,
    scrim: Color
)
```

## Public functions

### copy

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/tv#1.1.0)

```
fun copy(
    primary: Color = this.primary,
    onPrimary: Color = this.onPrimary,
    primaryContainer: Color = this.primaryContainer,
    onPrimaryContainer: Color = this.onPrimaryContainer,
    inversePrimary: Color = this.inversePrimary,
    secondary: Color = this.secondary,
    onSecondary: Color = this.onSecondary,
    secondaryContainer: Color = this.secondaryContainer,
    onSecondaryContainer: Color = this.onSecondaryContainer,
    tertiary: Color = this.tertiary,
    onTertiary: Color = this.onTertiary,
    tertiaryContainer: Color = this.tertiaryContainer,
    onTertiaryContainer: Color = this.onTertiaryContainer,
    background: Color = this.background,
    onBackground: Color = this.onBackground,
    surface: Color = this.surface,
    onSurface: Color = this.onSurface,
    surfaceVariant: Color = this.surfaceVariant,
    onSurfaceVariant: Color = this.onSurfaceVariant,
    surfaceTint: Color = this.surfaceTint,
    inverseSurface: Color = this.inverseSurface,
    inverseOnSurface: Color = this.inverseOnSurface,
    error: Color = this.error,
    onError: Color = this.onError,
    errorContainer: Color = this.errorContainer,
    onErrorContainer: Color = this.onErrorContainer,
    border: Color = this.border,
    borderVariant: Color = this.borderVariant,
    scrim: Color = this.scrim
): ColorScheme
```

Returns a copy of this ColorScheme, optionally overriding some of the values.

### toString

```
open fun toString(): String
```

## Public properties

### background

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val background: Color
```

The background color that appears behind scrollable content.

### border

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val border: Color
```

Subtle color used for boundaries. Border color role adds contrast for accessibility purposes.

### borderVariant

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val borderVariant: Color
```

Utility color used for boundaries for decorative elements when strong contrast is not required.

### error

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val error: Color
```

The error color is used to indicate errors in components, such as invalid text in a text field.

### errorContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val errorContainer: Color
```

The preferred tonal color of error containers.

### inverseOnSurface

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val inverseOnSurface: Color
```

A color that contrasts well with `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. Useful for content that sits on top of containers that are `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### inversePrimary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val inversePrimary: Color
```

Color to be used as a "primary" color in places where the inverse color scheme is needed, such as the button on a SnackBar.

### inverseSurface

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val inverseSurface: Color
```

A color that contrasts sharply with `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. Useful for surfaces that sit on top of other surfaces with `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)` color.

### onBackground

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onBackground: Color
```

Color used for text and icons displayed on top of the background color.

### onError

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onError: Color
```

Color used for text and icons displayed on top of the error color.

### onErrorContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onErrorContainer: Color
```

The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### onPrimary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onPrimary: Color
```

Color used for text and icons displayed on top of the primary color.

### onPrimaryContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onPrimaryContainer: Color
```

The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### onSecondary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onSecondary: Color
```

Color used for text and icons displayed on top of the secondary color.

### onSecondaryContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onSecondaryContainer: Color
```

The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### onSurface

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onSurface: Color
```

Color used for text and icons displayed on top of the surface color.

### onSurfaceVariant

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onSurfaceVariant: Color
```

The color (and state variants) that can be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### onTertiary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onTertiary: Color
```

Color used for text and icons displayed on top of the tertiary color.

### onTertiaryContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val onTertiaryContainer: Color
```

The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### primary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val primary: Color
```

The primary color is the color displayed most frequently across your app's screens and components.

### primaryContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val primaryContainer: Color
```

The preferred tonal color of containers.

### scrim

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val scrim: Color
```

Color of a scrim that obscures content.

### secondary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val secondary: Color
```

The secondary color provides more ways to accent and distinguish your product. Secondary colors are best for:

- Floating action buttons

- Selection controls, like checkboxes and radio buttons

- Highlighting selected text

- Links and headlines

### secondaryContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val secondaryContainer: Color
```

A tonal color to be used in containers.

### surface

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val surface: Color
```

The surface color that affect surfaces of components, such as cards, sheets, and menus.

### surfaceTint

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val surfaceTint: Color
```

This color will be used by components that apply tonal elevation and is applied on top of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`. The higher the elevation the more this color is used.

### surfaceVariant

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val surfaceVariant: Color
```

Another option for a color with similar uses of `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#(androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color)`.

### tertiary

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val tertiary: Color
```

The tertiary color that can be used to balance primary and secondary colors, or bring heightened attention to an element such as an input field.

### tertiaryContainer

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/tv#1.0.0)

```
val tertiaryContainer: Color
```

A tonal color to be used in containers.

## Extension functions

### ColorScheme.contentColorFor

Artifact: [androidx.tv:tv-material](https://developer.android.com/jetpack/androidx/releases/tv) [View Source](https://cs.android.com/search?q=file:androidx/tv/material3/ColorScheme.kt+function:contentColorFor)

```
fun ColorScheme.contentColorFor(backgroundColor: Color): Color
```

The Material color system contains pairs of colors that are typically used for the background and content color inside a component. For example, a Button typically uses `primary` for its background, and `onPrimary` for the color of its content (usually text or iconography).

This function tries to match the provided `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` to a 'background' color in this `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme`, and then will return the corresponding color used for content. For example, when `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` is `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#primary()`, this will return `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#onPrimary()`.

If `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` does not match a background color in the theme, this will return `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color#Unspecified()`.

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | the matching content color for `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)`. If `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` is not present in the theme's `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme`, then returns `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color#Unspecified()`. |

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/tv/material3/package-summary#(androidx.tv.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` |   |

### ColorScheme.surfaceColorAtElevation

Artifact: [androidx.tv:tv-material](https://developer.android.com/jetpack/androidx/releases/tv) [View Source](https://cs.android.com/search?q=file:androidx/tv/material3/ColorScheme.kt+function:surfaceColorAtElevation)

```
fun ColorScheme.surfaceColorAtElevation(elevation: Dp): Color
```

Computes the surface tonal color at different elevation levels e.g. surface1 through surface5.

| Parameters |
|---|---|
| `elevation: https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | Elevation value used to compute alpha of the color overlay layer. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | the `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#surface()` color with an alpha of the `https://developer.android.com/reference/kotlin/androidx/tv/material3/ColorScheme#surfaceTint()` color overlaid on top of it. |