> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # 색상 팔레트 > Color Palette # Color Palette 레이아웃에서 참조할 수 있는 재사용 가능한 색상의 컬렉션입니다. ## Properties `default` - *object*, *optional*. [color reference](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference)를 사용하여 참조할 수 있는 [Hexadecimal color](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-hexcolor) 정의의 컬렉션입니다. `highContrast` - *object*, *optional*. [color reference](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference)를 사용하여 참조할 수 있는 [Hexadecimal color](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-hexcolor) 정의의 컬렉션입니다. [고대비 모드](/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md)가 활성화되면 `default`의 정의를 재정의합니다. ## Sample ```JSON theme={null} { "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/4.0/layout.json", "styles": { "colors": { "default": { "myColor1": "#ff0000ff", "myColor2": "#00ff00ff", "system_contentPrimary": "#0000ffff" }, "highContrast": { "myColor1": "#00ff00ff", "system_contrastPrimary": "#0000ffaa" } } }, "content": { "left": { "inner": [ { "type": "directionalPad", "styles": { "idle": { "background": { "type": "color", "value": "colors/myColor1" } } } } ] }, "right": { "inner": [ { "type": "button", "action": "gamepadY" }, { "type": "button", "action": "gamepadB" }, { "type": "button", "action": "gamepadA", "styles": { "idle": { "background": { "type": "color", "value": "colors/myColor2" } } } }, { "type": "button", "action": "gamepadX" } ] } } } ``` 고대비 모드가 **비활성화**된 상태에서의 위 레이아웃: ![색상 팔레트가 있고 고대비 모드가 비활성화된 터치 레이아웃](https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/game-streaming-tak-color-palette-reference-hc-disabled.png?fit=max\&auto=format\&n=-_0FrcE2bDxzGxv-\&q=85\&s=dba732004eecd1db8fc9a608c31248cd) 그리고 고대비 모드가 **활성화**된 상태: ![색상 팔레트가 있고 고대비 모드가 활성화된 터치 레이아웃](https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/game-streaming-tak-color-palette-reference-hc-enabled.png?fit=max\&auto=format\&n=-_0FrcE2bDxzGxv-\&q=85\&s=fff468e0eba734e9edec6527e7584262) ## Remarks 위 [샘플](#sample)에는 [시스템 색상](#system-colors)을 재정의하는 색상 정의(예: `system_contentPrimary`, `system_accentPrimary` 등)와 커스텀 색상 정의(`myColor1`, `myColor2`)가 포함되어 있습니다. 컨트롤은 스타일을 지정할 때 시스템 색상을 **암시적으로** 샘플링하므로, 재정의는 모든 컨트롤의 전역 스타일링에 영향을 미칩니다(컨트롤이 커스텀 `styles` 블록 내에 자체 재정의를 갖지 않는 한). 커스텀 색상은 [color reference](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference)를 사용하여 **명시적으로** 참조되어야 합니다(예: `colors/myColor1`). 또한, 커스텀 색상 정의는 시스템 색상을 위해 예약된 `system_` 접두사를 **사용할 수 없습니다**. 색상 정의는 `default` 및 `highContrast` 오브젝트에서 선언되며, [고대비 모드](/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md)가 비활성화 또는 활성화될 때 각각 활성화됩니다. 고대비 모드가 비활성화되면 색상은 `default`에서 샘플링됩니다. 활성화되면 색상은 먼저 `highContrast`에서 샘플링되며, 정의가 존재하지 않으면 `default`로 폴백됩니다. `default`에 시스템 색상 재정의가 없으면 시스템 기본값이 사용되며, 커스텀 색상은 `default`에 **반드시** 정의되어 있어야 합니다. 다음 표는 위의 색상 정의가 고대비(HC) 모드가 활성화되었는지 여부에 따라 어떻게 해석되는지를 요약합니다. | Color definition | HC mode disabled | HC mode enabled | | :- | - | - | | myColor1 | `#ff0000ff` | `#00ff00ff` | | myColor2 | `#00ff00ff` | `#00ff00ff` | | system\_contentPrimary | `#0000ffff` | `#0000ffff` | | system\_contrastPrimary | system default | `#0000ffaa` | ## System colors 다음 표는 Touch Adaptation Kit의 시스템 색상 목록, 컨트롤 스타일링에 사용되는 방식에 대한 설명, 그리고 고대비(HC) 모드가 비활성화/활성화되었을 때의 시스템 기본값을 요약합니다. | System Color | Description | HC mode disabled | HC mode enabled | | :- | :- | :- | :- | | system\_contentPrimary | 중간 스트로크, 아이콘 틴트, 방향 패드 그라디언트와 같은 컴포넌트 스타일링에 사용되는 색상입니다. | `#ffffffff` | `#ffffffff` | | system\_contentSecondary | 배경 및 채우기와 같은 컴포넌트 스타일링에 사용되는 색상입니다. | `#ffffff1a` | `#ffffffff` | | system\_contrastPrimary | 내부/외부 스트로크 및 페이스 이미지 백플레이트와 같은 대비 컴포넌트 스타일링에 사용되는 색상입니다. | `#00000000` | `#000000bf` | | system\_contrastSecondary | 터치패드 스트로크와 같은 대비 컴포넌트 스타일링에 사용되는 색상입니다. | `#00000000` | `#ffffffff` | | system\_actionColorDefault | `action` 필드가 게임패드가 아닌 액션으로 설정된 컨트롤의 컴포넌트 스타일링에 사용되는 색상입니다. | `#ffffffff` | `#ffffffe6` | | system\_actionColorA | `action` 필드가 `gamepadA`로 설정된 컨트롤의 컴포넌트 스타일링에 사용되는 색상입니다. | `#7eb902ff` | `#ffffffe6` | | system\_actionColorB | `action` 필드가 `gamepadB`로 설정된 컨트롤의 컴포넌트 스타일링에 사용되는 색상입니다. | `#f25127ff` | `#ffffffe6` | | system\_actionColorX | `action` 필드가 `gamepadX`로 설정된 컨트롤의 컴포넌트 스타일링에 사용되는 색상입니다. | `#00a2eeff` | `#ffffffe6` | | system\_actionColorY | `action` 필드가 `gamepadY`로 설정된 컨트롤의 컴포넌트 스타일링에 사용되는 색상입니다. | `#ffb807ff` | `#ffffffe6` | | system\_accentPrimary | ergo-edit 내부 휠과 같은 컴포넌트 스타일링에 사용되는 색상입니다. | `#8cc08cff` | `#8cc08cff` | | system\_accentSecondary | ergo-edit 외부 휠과 같은 컴포넌트 스타일링에 사용되는 색상입니다. | `#61ab61ff` | `#61ab61ff` | 최신 목록은 [최신 스키마](https://github.com/microsoft/xbox-game-streaming-tools/blob/main/touch-adaptation-kit/schemas/layout/v4.0/layout.json)에서 `_SystemColor` 접두사가 붙은 정의를 참조하세요. ## See Also [Touch Adaptation Kit 참조](/ko/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)\ [Touch Adaptation Layout을 위한 고대비 모드](/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md) ## Related topics - [Touch Adaptation Kit](/ko/reference/system/touchadaptationkit/touchadaptationkit-reference.md) - [터치 적응 레이아웃용 고대비 모드](/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md) - [Touch Adaptation Kit 편집기: 미리 보기 사용자 지정](/ko/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-customize-preview.md) - [접근성 메타데이터](/ko/publishing/game-publishing/concepts/metadata-accessibility.md) - [Touch Adaptation Kit 편집기: 설정](/ko/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup.md)