BackgroundComponent

맵의 배경을 변경하고 관리합니다. 단일 색상 배경, 메이플스토리 배경, 웹 이미지 배경, 그라데이션 배경을 사용할 수 있습니다.

# Properties

[{"index":"SyncDictionary BackgroundPieces (Sync) (MakerOnly)","0":"배경의 Background Piece 목록입니다."}]

[{"index":"Color BottomColor (Sync) (ReadOnly)","0":"그라데이션 배경의 최하단 색상 값입니다."}]

[{"index":"boolean FitWithAspect (Sync)","0":"Type이 Sprite일 때 배경의 이미지가 잘리지 않고 카메라 영역에 맞춰지도록 비율을 유지하며 크기를 조정합니다."}]

[{"index":"string MaterialId (Sync)","0":"렌더러에 적용할 머티리얼 Id를 지정합니다."}]

[{"index":"Color MiddleBottomColor (Sync) (ReadOnly)","0":"그라데이션 배경의 중하단 색상 값입니다."}]

[{"index":"float MiddleBottomRatio (Sync) (ReadOnly)","0":"그라데이션 배경의 중하단 색상의 기준 위치입니다. 0.01 이상, MiddleTopRatio - 0.01 이하의 값을 설정할 수 있습니다."}]

[{"index":"Color MiddleTopColor (Sync) (ReadOnly)","0":"그라데이션 배경의 중상단 색상 값입니다."}]

[{"index":"float MiddleTopRatio (Sync) (ReadOnly)","0":"그라데이션 배경의 중상단 색상의 기준 위치입니다. MiddleBottomRatio + 0.01 이상, 0.99 이하의 값을 설정할 수 있습니다."}]

[{"index":"float ScrollRate (Sync)","0":"Type이 Template일 때 배경의 움직이는 속도를 조절할 수 있습니다."}]

[{"index":"Color SolidColor (Sync) (ReadOnly)","0":"Type이 SolidColor일 때의 색상 값입니다. 배경을 변경하려면 ChangeBackgroundBySolidColor(Color) 함수를 사용하세요."}]

[{"index":"string SpriteRUID (Sync) (ReadOnly)","0":"Type이 Sprite일 때의 RUID 입니다. SpriteRUID만 사용할 수 있습니다."}]

[{"index":"string TemplateRUID (Sync) (ReadOnly)","0":"Type이 Template일 때의 RUID입니다. 배경을 변경하려면 ChangeBackgroundByTemplateRUID(string) 함수를 사용하세요."}]

[{"index":"Color TopColor (Sync) (ReadOnly)","0":"그라데이션 배경의 최상단 색상 값입니다."}]

[{"index":"BackgroundType Type (Sync) (ReadOnly)","0":"배경의 타입입니다. ChangeBackgroundBy류 함수를 사용해 배경을 바꿀 수 있습니다."}]

[{"index":"string WebUrl (Sync) (ReadOnly)","0":"Type이 Web일 때의 웹 이미지 배경의 주소입니다. 배경을 변경하려면 ChangeBackgroundByWebUrl(string) 함수를 사용하세요."}]

##### inherited from Component:

[{"index":"boolean Enable (Sync)","0":"컴포넌트 활성화 여부를 확인합니다."}]

[{"index":"boolean EnableInHierarchy (ReadOnly) (HideFromInspector)","0":"계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일지라도 엔티티의 Enable이 false라면 false를 반환합니다."}]

[{"index":"Entity Entity (ReadOnly)","0":"이 컴포넌트를 소유한 엔티티입니다."}]

# Methods

[{"index":"void ChangeBackgroundByGradient(Color top, Color middleTop, Color middleBottom, Color bottom, float middleTopRatio, float middleBottomRatio)","0":"배경을 그라데이션 색상들로 변경합니다."}]

[{"index":"void ChangeBackgroundBySolidColor(Color value)","0":"배경을 단색으로 변경합니다."}]

[{"index":"void ChangeBackgroundByTemplateRUID(string value)","0":"배경을 지정한 템플릿 배경 RUID로 변경합니다."}]

[{"index":"void ChangeBackgroundByWebUrl(string value)","0":"배경을 웹 이미지로 변경합니다."}]

[{"index":"void ChangeMaterial(string materialId)","0":"렌더러에 적용할 머티리얼을 교체합니다."}]

[{"index":"void SetBackgroundPieceColor(string pieceName, Color color) (ClientOnly)","0":"pieceName에 해당하는 Background Piece를 찾아 색상을 설정합니다."}]

[{"index":"void SetBackgroundPieceEnable(string pieceName, boolean enable) (ClientOnly)","0":"pieceName에 해당하는 Background Piece를 찾아 활성화 여부를 설정합니다."}]

[{"index":"void SetBackgroundPiecePosition(string pieceName, Vector2 position) (ClientOnly)","0":"pieceName에 해당하는 Background Piece를 찾아 위치를 설정합니다."}]

[{"index":"void SetBackgroundPieceRatio(string pieceName, Vector2 ratio) (ClientOnly)","0":"pieceName에 해당하는 Background Piece를 찾아 화면 이동 비율을 설정합니다. 화면 이동 비율은 카메라가 이동할 때 상대적으로 얼마큼 이동할 지 나타내는 값입니다."}]

##### inherited from Component:

[{"index":"boolean IsClient()","0":"현재 실행 환경이 클라이언트인지 아닌지의 여부를 반환합니다."}]

[{"index":"boolean IsServer()","0":"현재 실행 환경이 서버인지 아닌지의 여부를 반환합니다."}]

# Examples

다양한 방법으로 배경을 변경하는 예제입니다.
    
    
    @Component
    script BackgroundChanger extends Component
        @ExecSpace("ServerOnly")
        method void ChangeBackgroundExample()
        local background = self.Entity.BackgroundComponent
        background:ChangeBackgroundByTemplateRUID("794ad8421e2543d8a6d2c70307637450")
        background:ChangeBackgroundBySolidColor(Color.white)
        background:ChangeBackgroundByWebUrl("Http://WebUrl")
        end
    end
    

# SeeAlso

  * [배경 설정하기](/docs?postId=768)