Sprite

스프라이트(GUI) 객체에 추가되는 API들.

속성

스프라이트의 속성은 해당 스프라이트의 부모 객체 영역에 따라 결정됩니다.
부모 객체가 GUI Scene인 경우 전체 화면 영역을 기준으로 합니다.

.anchor

.anchor : 객체 { x, y }

스프라이트의 오프셋이 기준으로 하는 위치입니다.

• x : 화면 수평 방향의 기준 위치. 기본값은 “Center”.
  - “Far-Left” : 부모의 왼쪽 끝.
  - “Center” : 부모의 수평 중심.
  - “Far-Right” : 부모의 오른쪽 끝.
• y : 화면 수직 방향의 기준 위치. 기본값은 “Center”.
  - “Bottom” : 부모의 아래쪽 끝.
  - “Center” : 부모의 수직 중심.
  - “Top” : 부모의 위쪽 끝.

.offset

.offset : 객체 { x : { 값, 단위 }, y : { 값, 단위 } }

스프라이트의 앵커 위치로부터의 오프셋입니다.

• x
  - 값 : 화면 수평 오프셋 값. 기본값은 0.
  - 단위 : 화면 수평 오프셋 단위. 기본값은 “px”.
      - “px” : 절대 픽셀 단위.
      - “%” : 부모의 너비를 기준으로 한 상대적 단위.
• y
  - 값 : 화면 수직 오프셋 값. 기본값은 0.
  - 단위 : 화면 수직 오프셋 단위. 기본값은 “px”.
      - “px” : 절대 픽셀 단위.
      - “%” : 부모의 너비를 기준으로 한 상대적 단위.

.size

.size : 객체 { x : { 값, 단위 }, y : { 값, 단위 } }

스프라이트의 크기입니다.

• x
  - 값 : 폭(수평 방향의 길이) 값.
  - 단위 : 폭 단위. 기본값은 “px”.
      - “px” : 절대 픽셀 단위.
      - “%” : 부모의 너비를 기준으로 한 상대적 단위.
• y
  - 값 : 높이(수직 방향의 길이) 값.
  - 단위 : 높이 단위. 기본값은 “px”.
      - “px” : 절대 픽셀 단위.
      - “%” : 부모의 너비를 기준으로 한 상대적 단위.

.constantAspectRatio

.constantAspectRatio : Boolean

true이면, 스프라이트는 원래의 종횡비를 유지합니다. 종횡비를 초과한다면, 폭과 높이 중 한쪽이 감소되어 종횡비를 맞춥니다.

메소드

.setText()

.setText(text)

스프라이트에 나타나는 텍스트를 설정합니다.

• text : 텍스트 내용.

.setTextSize()

.setTextSize(size)

스프라이트에 나타나는 텍스트 크기를 설정합니다.

• size : 텍스트의 크기. 단위는 px입니다.

.show()

스프라이트를 보이게 합니다.

.hide()

스프라이트를 보이지 않게 합니다.

.onClick()

.onClick(callback)

스프라이트가 클릭될 때 지정된 콜백 함수를 실행합니다.

• callback : 클릭될 때 실행할 함수. 이 컨텍스트를 유지하기 위해 화살표 함수 사용을 권장합니다.