> ## 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.

# MicrosoftGame.config Element - ShellVisuals

> MicrosoftGame.config Element - ShellVisuals

# MicrosoftGame.config Element - ShellVisuals

타이틀의 Shell 표시를 정의합니다. 예를 들어, 이미지와 이름 등이 있습니다. 등록 중에 Shell에서 타이틀을 표시하는 데 사용됩니다.

## 부모

이 요소의 부모는 Game 요소입니다.

## 요구 사항

이 요소는 선택 사항이며 반드시 설정할 필요는 없습니다.

## 플랫폼

이 요소는 PC 및 콘솔에 적용됩니다.

## 동작

* 특성은 다음과 같습니다.
  * DefaultDisplayName
  * PublisherDisplayName
  * StoreLogo
  * Square150x150Logo
  * Square44x44Logo
  * Square480x480Logo
  * Description
  * ForegroundText
  * BackgroundColor
  * SplashScreenImage
* ForegroundText 특성의 기본값은 'light'입니다. BackgroundColor 특성의 기본값은 'transparent'입니다. 다른 모든 특성에는 기본값이 없습니다.
* 각 항목에 허용되는 값:
  * DefaultDisplayName 특성은 최대 256자의 문자열입니다.
  * PublisherDisplayName 특성은 최대 256자의 문자열입니다.
  * StoreLogo 특성은 패키지 루트 아래의 .PNG 파일에 대한 유효한 파일 경로입니다.
  * Square150x150Logo 특성은 패키지 루트 아래의 .PNG 파일에 대한 유효한 파일 경로입니다.
  * Square44x44Logo 특성은 패키지 루트 아래의 .PNG 파일에 대한 유효한 파일 경로입니다.
  * Square480x480Logo는 패키지 루트 아래의 .PNG 파일에 대한 유효한 파일 경로입니다.
  * Description은 문자열입니다.
  * ForegroundText 특성은 light와 dark입니다.
  * BackgroundColor 특성은 일반 이름 또는 16진수 코드(#RRGGBB) 형식을 사용하는 색상 값입니다.
  * SplashScreenImage 특성은 패키지 루트 아래의 .PNG 파일에 대한 유효한 파일 경로입니다.

## 설명

* StoreLogo, Square150x150Logo, Square44x44Logo, Square480x480Logo 및 SplashScreenImage 특성은 모두 패키징에 필요합니다.
* SplashScreenImage 특성은 PC 타이틀에는 필수가 아니지만 모범 사례로 권장됩니다.
* 그 외 모든 특성은 선택 사항입니다.
* 색상 값에 대한 일반 이름의 전체 목록은 MicrosoftGame.config 스키마의 ST\_Color 섹션을 참조하세요.

### ShellVisuals와 Executable 내의 Logo

Executable 내 OverrideLogo 요소와 ShellVisuals의 Logo 요소 간의 관계입니다. OverrideLogo가 정의되어 있는 경우, 해당 실행 파일에 대해 Logo에 정의된 것보다 우선합니다. ShellVisuals의 Logo는 패키지 계층에서 정의되도록 의도되었습니다. 단일 실행 파일 패키지의 경우 Logo 요소만 필요합니다. Logo 크기는 Square150x150Logo 특성의 경우 150x150 픽셀이어야 합니다.

OverrideLogo 특성은 해당 특정 Executable에 대해 ShellVisuals에서 지정된 Square150x150Logo .png 파일을 재정의합니다. OverrideLogo 특성 외에도, OverrideSquare480x480Logo 및 Square44x44Logo에 대한 특성도 있으며, 이는 해당 특정 Executable에 대해 ShellVisuals에서 지정된 Square480x480Logo 및 Square44x44Logo .png 파일을 각각 재정의하도록 지정할 수 있습니다.

다음 예시는 Logo/DisplayName 재정의에 특화된 요소 및 특성 구성을 자세히 보여줍니다.

```xml theme={null}
<ShellVisuals DefaultDisplayName="MyGame"
                Square150x150Logo="GraphicsLogo.png"
                Square44x44Logo="SmallLogo.png"
                Square480x480Logo="LargeLogo.png"
                SplashScreenImage="SplashScreen.png"
                StoreLogo="StoreLogo.png"/>

<ExecutableList>
    <Executable Name="MyGame.exe"
                OverrideDisplayName="MyGameOverride"
                OverrideLogo="GraphicsLogoOverride.png"
                OverrideSquare44x44Logo="SmallLogoOverride.png"
                OverrideSquare480x480Logo="LargeLogoOverride.png"
                OverrideSplashScreenImage="SplashScreenOverride.png"/>
</ExecutableList>
```

`OverrideDisplayName`과 `OverrideSplashScreenImage`는 OverrideLogo와 유사하게 작동합니다.

#### 이미지 요구 사항

Square150x150Logo, Square44x44Logo 및 StoreLogo는 PC 및 콘솔 모두에서 DLC가 아닌 패키지에 필요합니다. SplashScreenImage는 콘솔에 필요하지만, 2021년 2월 GDK부터 이제 PC에서는 선택 사항입니다. DLC 패키지의 경우 StoreLogo만 필요합니다.

#### 이미지 해상도 및 형식

필요한 로고 형식은 .png이며, 픽셀 형식(24-bpp RGB 또는 32-bpp ARGB/PARGB)에 대한 요구 사항이 있습니다. 이러한 요구 사항은 SubmissionValidator를 통해 강제됩니다.

각 이미지에는 필요한 이미지 해상도가 있습니다. 다음과 같습니다.

* Square150x150Logo: 150x150
* Square44x44Logo: 44x44
* Square480x480Logo: 480x480
* StoreLogo: 100x100
* SplashScreenImage: 1920x1080

#### SplashScreenImage

SplashScreenImage는 타이틀이 실행될 때 사용되는 이미지입니다.

Executable 요소의 OverrideSplashScreenImage 특성은 타이틀 실행 시 나타나는 스플래시 화면 이미지를 재정의하는 데 사용됩니다. 이 재정의를 통해 이제 개발 중에 실행 파일별 스플래시 화면 이미지를 사용할 수 있습니다.

<Note>SplashScreenImage 특성은 플랫폼별로 다르지 않지만 현재 XBOX 콘솔 개발에는 필수이며 PC 개발에는 선택 사항입니다.</Note>

#### BackgroundColor

BackgroundColor는 ShellVisuals 요소의 특성입니다. 이는 HTML 색상 코드를 사용하여 PC의 타이틀 배경을 정의합니다. 이는 작업 표시줄과 시작 메뉴에서 로고 주위의 테두리로 표시됩니다.

## 함께 보기

[MicrosoftGame.config 참조 - 목차](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)


## Related topics

- [MicrosoftGame.config Element - Resources](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-resources.md)
- [MicrosoftGame.config Element - KnownDependency](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-knowndependency.md)
- [MicrosoftGame.config Element - TitleId](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [MicrosoftGame.config Element - MSAAppId](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-msaappid.md)
- [MicrosoftGame.config Element - SCID](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-scid.md)