Class: Text

화면에 문자열을 그리는 객체다.

Usage

                    
                        new Text(options)
                    
                
Extends:
GameObject
Parameters:
Name Type Description
options object
Properties
Name Type Default Description
nameopt string
textopt string
fontSizeopt number
fontopt string
lineHeightopt number
isActiveopt boolean
isVisibleopt boolean
layeropt Layer
coloropt Color Random Color
isPhysicsEnableopt boolean false
transformopt object
Properties
Name Type Default Description
positionopt Vector new Vector(0, 0)
scaleopt Vector new Vector(1, 1)
rotationopt number 0

Members

text: string

화면에 보여질 문자열을 말한다. 줄바꿈을 하고 싶다면 문자열에 '\n'을 넣으면 된다. 이렇게 하면 '\n'을 기준으로 문자열을 나눠서 한 줄씩 여러번 출력하게 된다. 기본값은 팬그램 문자열이다.

Type:
{string}
Extends:
GameObject#text

font: string

폰트를 말한다. 만약 외부 폰트를 사용하려고 한다면 style.css에서 @import(url)로 불러와야 사용가능하다. 기본값은 맑은 고딕(malgeun gothic)이다.

Type:
{string}
Extends:
GameObject#font

lineHeight: number

줄 간격을 말한다. 기본값은 fontSize의 1.25배다.

Type:
{number}
Extends:
GameObject#lineHeight

isActive: boolean

이 객체가 활성상태인지 의미한다. 만약 이 값이 false라면 update와 render가 실행되지 않는다. 이 값이 false라면 물리엔진에서도 수집하지 않는다. 기본값은 true다.

Type:
{boolean}
Overrides:
GameObject#isActive

matrix: Matrix

이 객체의 transform을 행렬로 나타낸 결과다. canvas에서 좌표, 회전, 규모를 이용해 물체를 그리려면 행렬을 이용해야한다. 그래서 이 객체의 transform을 canvas에서 활용할 수 있게 matrix로 변환하여 저장한다.

Type:
{Matrix}
Overrides:
GameObject#matrix

Methods

setText(text)

문자열을 지정한다. 인자로 전달된 문자열을 파싱해 '\n'이 포함되어 있다면 '\n'을 기준으로 문자열을 쪼갠다.

Extends:
GameObject#setText
Parameters:
Name Type Description
text string

화면에 그릴 문자열

setFontSize(fontSize)

글자 크기를 정한다.

Extends:
GameObject#setFontSize
Parameters:
Name Type Description
fontSize number

setLineHeight(fontSize)

줄 간격을 정한다.

Extends:
GameObject#setLineHeight
Parameters:
Name Type Description
fontSize number

update(deltaTime)

GameObject 내에서는 단순히 이 오브젝트에 등록된 하위 GameObject들의 update를 실행시킨다.

Overrides:
GameObject#update
Parameters:
Name Type Description
deltaTime number

이전 프레임과 현재 프레임의 시간차

calculateMatrix()

transform을 matrix로 변환한다. 이 때 부모 객체가 있다면 행렬곱을 수행해 두 matrix를 결합한다. 이 객체의 transform만 변환을 수행하지 않고 이 객체의 자식들에게도 calculateMatrix를 호출한다.

render()

먼저 선형보간한 matrix를 사용해 context에 등록한다. 그 다음 draw()를 통해 물체를 렌더링한다. 이 객체를 상속받은 Rect나 Circle처럼 자식객체에 따라 각각 다른 렌더링이 수행된다. 그 후 이 객체의 모든 자식들을 렌더링한다.

Overrides:
GameObject#render

beforeDraw()

렌더링 전에 색상값을 갱신한다거나 다른 작업이 미리 처리되어야 하는 경우 이 함수를 오버라이드해서 사용하면 된다.

이 객체에서는 기본적으로 색상값을 적용시키기 위해 globalAlpha값을 조절한다. context2d.save()를 통해 현재 설정값을 저장해두었으므로, 마음대로 변경 후 context2d.restore()로 되돌리게 된다. 따라서 현재 설정값이 자식들의 렌더링에 사용된다.

draw()

이 함수는 GameObject를 상속받은 객체마다 다르게 동작한다. GameObject 자체는 렌더링할 대상이 없지만 Sprite나, Rect, Text 등 GmaeObject를 상속받은 객체들은 명확히 렌더링할 대상이 존재한다. 그 때 이 함수안에서 어떻게 렌더링할건지 정의를 해 놓으면 된다. super.render()를 먼저 호출하고 대상을 렌더링할 경우 이미 렌더링된 자식 오브젝트를 덮어씌워 렌더링할 수 있으므로 렌더링만큼은 draw 함수 내에서만 정의를 하는게 좋다.

Overrides:
GameObject#draw

afterDraw()

일반적으로 beforeDraw()에서 전처리했던 것을 원래대로 돌리는 작업을 한다. beforeDraw()를 오버라이드했다면 이 함수도 오버라이드하여 수정된 context2d를 원래대로 돌려놓아야 한다.

setParent(parent)

인자로 받은 객체와 이 객체 사이에 부모-자식 관계를 만든다. 만약 이 객체의 부모가 이미 있다면, 그 부모의 자식 테이블에서 이 객체를 제거하고, 새로운 부모의 자식 테이블에 이 객체를 추가한다.

Parameters:
Name Type Description
parent GameObject

이 객체의 부모가 될 객체

removeChild(child)

인자로 전달받은 객체가 자식 테이블에 존재한다면, 그 객체를 자식 테이블에서 제거하고, 씬 객체의 자식 테이블에 추가한다.

Parameters:
Name Type Description
child GameObject

자식 리스트에서 지워질 자식 객체

destroy()

이 객체를 씬으로부터 제거한다. 이 객체의 자식 테이블에 있는 모든 객체들도 연달아 제거된다.

이 객체를 제거하기위해 DestroyManager에 등록한다. 이 객체가 등록되었다면 업데이트가 끝난 직후 DestroyManager가 등록된 객체들을 제거한다.

Overrides:
GameObject#destroy