Class: Circle

화면에 원을 그리는 객체다.

Usage

                    
                        new Circle(options)
                    
                
Extends:
GameObject
Parameters:
Name Type Description
options object
Properties
Name Type Default Description
nameopt string
radiusopt number
coloropt Color
strokeWidthopt number
strokeColoropt Color
isActiveopt boolean
isVisibleopt boolean
layeropt Layer
isPhysicsEnableopt boolean false
boundaryopt object
Properties
Name Type Description
radiusopt number
offsetopt number
transformopt object
Properties
Name Type Default Description
positionopt Vector new Vector(0, 0)
scaleopt Vector new Vector(1, 1)
rotationopt number 0
rigidbodyopt object
Properties
Name Type Default Description
massopt number 1
bouncenessopt number 0.5
staticFrictionopt number 0.2
dynamicFrictionopt number 0.1
isStaticopt boolean false
isGravityopt boolean false
isTriggeropt boolean false

Members

isStroke: boolean

윤곽선을 그릴 것인지를 의미한다. 윤곽선을 그리기 위해서는 옵션에서 strokeColor나 strokeWidth를 설정하여야한다.

Type:
{boolean}
Extends:
GameObject#isStroke

strokeColor

윤곽선의 색상을 의미한다. 만약 옵션에서 윤곽선에 대한 정보가 있다면 isStroke는 true로 설정되고 윤곽선의 색상이 설정된다.

Extends:
GameObject#strokeColor

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

getWorldBoundary() → {number}

원의 화면상 반지름의 길이를 반환한다. 사실 scale이 Vector라서 정확히는 잘못된 함수다. 물리엔진에서 scale값을 고려하고 있지만 원에 대해서는 그렇지 않다. 이 함수에는 worldScale의 x와 y값을 더한 후 2로 나눈 값을 반지름에 곱하고 있다. 가급적이면 원의 scale을 변경하지 않아야 하고, 변경하더라도 scale의 x와 y값을 같은 값으로 설정하여야 정상적으로 작동한다.

Returns:
Type:
{number}

setStrokeWidth(width)

윤곽선의 두께를 설정한다.

Extends:
GameObject#setStrokeWidth
Parameters:
Name Type Description
width 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()로 되돌리게 된다. 따라서 현재 설정값이 자식들의 렌더링에 사용된다.

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