# ColorScheme

Artifact: [androidx.compose.material3:material3](https://developer.android.com/jetpack/androidx/releases/compose-material3) [View Source](https://cs.android.com/search?q=file:androidx/compose/material3/ColorScheme.kt+class:androidx.compose.material3.ColorScheme) Common/AllAndroid/JVM
- Cmn

  ```
  class ColorScheme
  ```

*** ** * ** ***

A color scheme holds all the named color parameters for a `https://developer.android.com/reference/kotlin/androidx/compose/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/compose/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,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.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/compose/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,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.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/system/overview).

## Summary

| ### Public constructors |
|---|---|
| `[ColorScheme](https://developer.android.com/reference/kotlin/androidx/compose/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, outline: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, outlineVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, scrim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color )` **This function is deprecated.** Use constructor with additional 'surfaceContainer' roles. | Cmn |
| `[ColorScheme](https://developer.android.com/reference/kotlin/androidx/compose/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,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.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, outline: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, outlineVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, scrim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceBright: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerHigh: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerHighest: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerLow: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerLowest: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color )` **This function is deprecated.** Use constructor with additional 'fixed' container roles. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/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,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.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, outline: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, outlineVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, scrim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceBright: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerHigh: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerHighest: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerLow: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerLowest: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, primaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, primaryFixedDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimaryFixedVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondaryFixedDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondaryFixedVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiaryFixedDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiaryFixedVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color )` | Cmn |

| ### Public functions |
|---|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme` | `https://developer.android.com/reference/kotlin/androidx/compose/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,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.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, outline: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, outlineVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, scrim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceBright: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainer: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerHigh: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerHighest: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerLow: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, surfaceContainerLowest: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, primaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, primaryFixedDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onPrimaryFixedVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, secondaryFixedDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onSecondaryFixedVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, tertiaryFixedDim: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiaryFixed: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, onTertiaryFixedVariant: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color )` Returns a copy of this ColorScheme, optionally overriding some of the values. | Cmn |
| `open https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#toString()()` | Cmn |

| ### Public properties |
|---|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#background()` The background color that appears behind scrollable content. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#error()` The error color is used to indicate errors in components, such as invalid text in a text field. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#errorContainer()` The preferred tonal color of error containers. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#inverseOnSurface()` A color that contrasts well with `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#inverseSurface()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/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. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#inverseSurface()` A color that contrasts sharply with `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onBackground()` Color used for text and icons displayed on top of the background color. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onError()` Color used for text and icons displayed on top of the error color. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onErrorContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#errorContainer()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimary()` Color used for text and icons displayed on top of the primary color. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimaryContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryContainer()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimaryFixed()` Color used for text and icons displayed on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryFixed()` or `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryFixedDim()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimaryFixedVariant()` An `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimaryFixed()` variant which provides less emphasis. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSecondary()` Color used for text and icons displayed on top of the secondary color. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSecondaryContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryContainer()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSecondaryFixed()` Color used for text and icons displayed on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryFixed()` or `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryFixedDim()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSecondaryFixedVariant()` An `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSecondaryFixed()` variant which provides less emphasis. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSurface()` Color used for text and icons displayed on top of the surface color. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSurfaceVariant()` The color (and state variants) that can be used for content on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onTertiary()` Color used for text and icons displayed on top of the tertiary color. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onTertiaryContainer()` The color (and state variants) that should be used for content on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryContainer()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onTertiaryFixed()` Color used for text and icons displayed on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryFixed()` or `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryFixedDim()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onTertiaryFixedVariant()` An `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onTertiaryFixed()` variant which provides less emphasis. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#outline()` Subtle color used for boundaries. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#outlineVariant()` Utility color used for boundaries for decorative elements when strong contrast is not required. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primary()` The primary color is the color displayed most frequently across your app's screens and components. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryContainer()` The preferred tonal color of containers. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryFixed()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primary()` variant that maintains the same tone in light and dark themes. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryFixedDim()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primary()` variant that maintains the same tone in light and dark themes. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#scrim()` Color of a scrim that obscures content. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondary()` The secondary color provides more ways to accent and distinguish your product. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryContainer()` A tonal color to be used in containers. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryFixed()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondary()` variant that maintains the same tone in light and dark themes. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryFixedDim()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondary()` variant that maintains the same tone in light and dark themes. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` The surface color that affect surfaces of components, such as cards, sheets, and menus. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceBright()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant that is always brighter than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`, whether in light or dark mode. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant that affects containers of components, such as cards, sheets, and menus. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerHigh()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with higher emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerHighest()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with higher emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerHigh()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerLow()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with lower emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerLowest()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with lower emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerLow()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceDim()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant that is always dimmer than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`, whether in light or dark mode. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/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/compose/material3/ColorScheme#surface()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceVariant()` Another option for a color with similar uses of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/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. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryContainer()` A tonal color to be used in containers. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryFixed()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiary()` variant that maintains the same tone in light and dark themes. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryFixedDim()` A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiary()` variant that maintains the same tone in light and dark themes. | Cmn |

| ### Extension functions |
|---|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme.https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#(androidx.compose.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. | Cmn |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color` | `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme.https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#(androidx.compose.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. | Cmn |

## Public constructors

### ColorScheme

Cmn

```
[ColorScheme](https://developer.android.com/reference/kotlin/androidx/compose/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: 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,
    outline: Color,
    outlineVariant: Color,
    scrim: Color
)
```

> [!CAUTION]
> **This function is deprecated.**   
> Use constructor with additional 'surfaceContainer' roles, use this instead:
>
> ```kotlin
> ColorScheme(primary,
> onPrimary,
> primaryContainer,
> onPrimaryContainer,
> inversePrimary,
> secondary,
> onSecondary,
> secondaryContainer,
> onSecondaryContainer,
> tertiary,
> onTertiary,
> tertiaryContainer,
> onTertiaryContainer,
> background,
> onBackground,
> surface,
> onSurface,
> surfaceVariant,
> onSurfaceVariant,
> surfaceTint,
> inverseSurface,
> inverseOnSurface,
> error,
> onError,
> errorContainer,
> onErrorContainer,
> outline,
> outlineVariant,
> scrim,
> surfaceBright,
> surfaceDim,
> surfaceContainer,
> surfaceContainerHigh,
> surfaceContainerHighest,
> surfaceContainerLow,
> surfaceContainerLowest,
> primaryFixed,
> primaryFixedDim,
> onPrimaryFixed,
> onPrimaryFixedVariant,
> secondaryFixed,
> secondaryFixedDim,
> onSecondaryFixed,
> onSecondaryFixedVariant,
> tertiaryFixed,
> tertiaryFixedDim,
> onTertiaryFixed,
> onTertiaryFixedVariant)
> ```

### ColorScheme

Cmn

```
[ColorScheme](https://developer.android.com/reference/kotlin/androidx/compose/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,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.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: 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,
    outline: Color,
    outlineVariant: Color,
    scrim: Color,
    surfaceBright: Color,
    surfaceDim: Color,
    surfaceContainer: Color,
    surfaceContainerHigh: Color,
    surfaceContainerHighest: Color,
    surfaceContainerLow: Color,
    surfaceContainerLowest: Color
)
```

> [!CAUTION]
> **This function is deprecated.**   
> Use constructor with additional 'fixed' container roles, use this instead:
>
> ```kotlin
> ColorScheme(primary,
> onPrimary,
> primaryContainer,
> onPrimaryContainer,
> inversePrimary,
> secondary,
> onSecondary,
> secondaryContainer,
> onSecondaryContainer,
> tertiary,
> onTertiary,
> tertiaryContainer,
> onTertiaryContainer,
> background,
> onBackground,
> surface,
> onSurface,
> surfaceVariant,
> onSurfaceVariant,
> surfaceTint,
> inverseSurface,
> inverseOnSurface,
> error,
> onError,
> errorContainer,
> onErrorContainer,
> outline,
> outlineVariant,
> scrim,
> surfaceBright,
> surfaceDim,
> surfaceContainer,
> surfaceContainerHigh,
> surfaceContainerHighest,
> surfaceContainerLow,
> surfaceContainerLowest,)
> ```

### ColorScheme

Cmn

```
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,
    outline: Color,
    outlineVariant: Color,
    scrim: Color,
    surfaceBright: Color,
    surfaceDim: Color,
    surfaceContainer: Color,
    surfaceContainerHigh: Color,
    surfaceContainerHighest: Color,
    surfaceContainerLow: Color,
    surfaceContainerLowest: Color,
    primaryFixed: Color,
    primaryFixedDim: Color,
    onPrimaryFixed: Color,
    onPrimaryFixedVariant: Color,
    secondaryFixed: Color,
    secondaryFixedDim: Color,
    onSecondaryFixed: Color,
    onSecondaryFixedVariant: Color,
    tertiaryFixed: Color,
    tertiaryFixedDim: Color,
    onTertiaryFixed: Color,
    onTertiaryFixedVariant: Color
)
```

## Public functions

### copy

Cmn

```
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,
    outline: Color = this.outline,
    outlineVariant: Color = this.outlineVariant,
    scrim: Color = this.scrim,
    surfaceBright: Color = this.surfaceBright,
    surfaceDim: Color = this.surfaceDim,
    surfaceContainer: Color = this.surfaceContainer,
    surfaceContainerHigh: Color = this.surfaceContainerHigh,
    surfaceContainerHighest: Color = this.surfaceContainerHighest,
    surfaceContainerLow: Color = this.surfaceContainerLow,
    surfaceContainerLowest: Color = this.surfaceContainerLowest,
    primaryFixed: Color = this.primaryFixed,
    primaryFixedDim: Color = this.primaryFixedDim,
    onPrimaryFixed: Color = this.onPrimaryFixed,
    onPrimaryFixedVariant: Color = this.onPrimaryFixedVariant,
    secondaryFixed: Color = this.secondaryFixed,
    secondaryFixedDim: Color = this.secondaryFixedDim,
    onSecondaryFixed: Color = this.onSecondaryFixed,
    onSecondaryFixedVariant: Color = this.onSecondaryFixedVariant,
    tertiaryFixed: Color = this.tertiaryFixed,
    tertiaryFixedDim: Color = this.tertiaryFixedDim,
    onTertiaryFixed: Color = this.onTertiaryFixed,
    onTertiaryFixedVariant: Color = this.onTertiaryFixedVariant
): ColorScheme
```

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

### toString

Cmn

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

## Public properties

### background

Cmn

```
val background: Color
```

The background color that appears behind scrollable content.

### error

Cmn

```
val error: Color
```

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

### errorContainer

Cmn

```
val errorContainer: Color
```

The preferred tonal color of error containers.

### inverseOnSurface

Cmn

```
val inverseOnSurface: Color
```

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

### inversePrimary

Cmn

```
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

Cmn

```
val inverseSurface: Color
```

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

### onBackground

Cmn

```
val onBackground: Color
```

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

### onError

Cmn

```
val onError: Color
```

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

### onErrorContainer

Cmn

```
val onErrorContainer: Color
```

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

### onPrimary

Cmn

```
val onPrimary: Color
```

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

### onPrimaryContainer

Cmn

```
val onPrimaryContainer: Color
```

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

### onPrimaryFixed

Cmn

```
val onPrimaryFixed: Color
```

Color used for text and icons displayed on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryFixed()` or `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primaryFixedDim()`. Maintains the same tone in light and dark themes.

### onPrimaryFixedVariant

Cmn

```
val onPrimaryFixedVariant: Color
```

An `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimaryFixed()` variant which provides less emphasis. Useful when a strong contrast is not required.

### onSecondary

Cmn

```
val onSecondary: Color
```

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

### onSecondaryContainer

Cmn

```
val onSecondaryContainer: Color
```

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

### onSecondaryFixed

Cmn

```
val onSecondaryFixed: Color
```

Color used for text and icons displayed on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryFixed()` or `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondaryFixedDim()`. Maintains the same tone in light and dark themes.

### onSecondaryFixedVariant

Cmn

```
val onSecondaryFixedVariant: Color
```

An `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onSecondaryFixed()` variant which provides less emphasis. Useful when a strong contrast is not required.

### onSurface

Cmn

```
val onSurface: Color
```

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

### onSurfaceVariant

Cmn

```
val onSurfaceVariant: Color
```

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

### onTertiary

Cmn

```
val onTertiary: Color
```

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

### onTertiaryContainer

Cmn

```
val onTertiaryContainer: Color
```

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

### onTertiaryFixed

Cmn

```
val onTertiaryFixed: Color
```

Color used for text and icons displayed on top of `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryFixed()` or `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiaryFixedDim()`. Maintains the same tone in light and dark themes.

### onTertiaryFixedVariant

Cmn

```
val onTertiaryFixedVariant: Color
```

An `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onTertiaryFixed()` variant which provides less emphasis. Useful when a strong contrast is not required.

### outline

Cmn

```
val outline: Color
```

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

### outlineVariant

Cmn

```
val outlineVariant: Color
```

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

### primary

Cmn

```
val primary: Color
```

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

### primaryContainer

Cmn

```
val primaryContainer: Color
```

The preferred tonal color of containers.

### primaryFixed

Cmn

```
val primaryFixed: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primary()` variant that maintains the same tone in light and dark themes. The fixed color role may be used instead of the equivalent container role in situations where such fixed behavior is desired.

### primaryFixedDim

Cmn

```
val primaryFixedDim: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primary()` variant that maintains the same tone in light and dark themes. Dim roles provide a stronger, more emphasized tone relative to the equivalent fixed color.

### scrim

Cmn

```
val scrim: Color
```

Color of a scrim that obscures content.

### secondary

Cmn

```
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

Cmn

```
val secondaryContainer: Color
```

A tonal color to be used in containers.

### secondaryFixed

Cmn

```
val secondaryFixed: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondary()` variant that maintains the same tone in light and dark themes. The fixed color role may be used instead of the equivalent container role in situations where such fixed behavior is desired.

### secondaryFixedDim

Cmn

```
val secondaryFixedDim: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#secondary()` variant that maintains the same tone in light and dark themes. Dim roles provide a stronger, more emphasized tone relative to the equivalent fixed color.

### surface

Cmn

```
val surface: Color
```

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

### surfaceBright

Cmn

```
val surfaceBright: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant that is always brighter than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`, whether in light or dark mode.

### surfaceContainer

Cmn

```
val surfaceContainer: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant that affects containers of components, such as cards, sheets, and menus.

### surfaceContainerHigh

Cmn

```
val surfaceContainerHigh: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with higher emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()`. Use this role for content which requires more emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()`.

### surfaceContainerHighest

Cmn

```
val surfaceContainerHighest: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with higher emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerHigh()`. Use this role for content which requires more emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerHigh()`.

### surfaceContainerLow

Cmn

```
val surfaceContainerLow: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with lower emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()`. Use this role for content which requires less emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainer()`.

### surfaceContainerLowest

Cmn

```
val surfaceContainerLowest: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant for containers with lower emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerLow()`. Use this role for content which requires less emphasis than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceContainerLow()`.

### surfaceDim

Cmn

```
val surfaceDim: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()` variant that is always dimmer than `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surface()`, whether in light or dark mode.

### surfaceTint

Cmn

```
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/compose/material3/ColorScheme#surface()`. The higher the elevation the more this color is used.

### surfaceVariant

Cmn

```
val surfaceVariant: Color
```

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

### tertiary

Cmn

```
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

Cmn

```
val tertiaryContainer: Color
```

A tonal color to be used in containers.

### tertiaryFixed

Cmn

```
val tertiaryFixed: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiary()` variant that maintains the same tone in light and dark themes. The fixed color role may be used instead of the equivalent container role in situations where such fixed behavior is desired.

### tertiaryFixedDim

Cmn

```
val tertiaryFixedDim: Color
```

A `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#tertiary()` variant that maintains the same tone in light and dark themes. Dim roles provide a stronger, more emphasized tone relative to the equivalent fixed color.

## Extension functions

### ColorScheme.contentColorFor

Cmn Artifact: [androidx.compose.material3:material3](https://developer.android.com/jetpack/androidx/releases/compose-material3) [View Source](https://cs.android.com/search?q=file:androidx/compose/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 `https://developer.android.com/reference/kotlin/androidx/compose/material3/Button.composable#Button(kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Boolean,androidx.compose.ui.graphics.Shape,androidx.compose.material3.ButtonColors,androidx.compose.material3.ButtonElevation,androidx.compose.foundation.BorderStroke,androidx.compose.foundation.layout.PaddingValues,androidx.compose.foundation.interaction.MutableInteractionSource,kotlin.Function1)` 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/compose/material3/package-summary#(androidx.compose.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` to a 'background' color in this `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme`, and then will return the corresponding color used for content. For example, when `https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary#(androidx.compose.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` is `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#primary()`, this will return `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#onPrimary()`.

If `https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary#(androidx.compose.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/compose/material3/package-summary#(androidx.compose.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)`. If `https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary#(androidx.compose.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` is not present in the theme's `https://developer.android.com/reference/kotlin/androidx/compose/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/compose/material3/package-summary#(androidx.compose.material3.ColorScheme).contentColorFor(androidx.compose.ui.graphics.Color)` |   |

### ColorScheme.surfaceColorAtElevation

Cmn Artifact: [androidx.compose.material3:material3](https://developer.android.com/jetpack/androidx/releases/compose-material3) [View Source](https://cs.android.com/search?q=file:androidx/compose/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/compose/material3/ColorScheme#surface()` color with an alpha of the `https://developer.android.com/reference/kotlin/androidx/compose/material3/ColorScheme#surfaceTint()` color overlaid on top of it. |