본문으로 건너뛰기

RotateControl

Since version 4.0.0

카메라의 회전을 담당하는 컨트롤

class RotateControl extends Component<RotateControlEvents> implements CameraControl

Extends

Implements

Properties

현재 컨트롤이 동작중인지를 나타내는 값

키보드를 이용한 회전을 비활성화합니다.

x축 회전(pitch)을 비활성화합니다.

y축 회전(yaw)을 비활성화합니다.

회전 애니메이션의 시간 (ms)

회전 애니메이션에 적용할 easing 함수

컨트롤이 활성화되었는지 여부를 나타내는 값

키보드를 통한 회전 배율

현재 pitch 값

마우스/터치를 통한 회전 배율

true로 설정할 경우, 모바일(터치) 환경의 캔버스 영역 내에서 스크롤을 가능하게 합니다.

주의

이 값을 활성화할 경우, 사용자가 카메라 뷰를 위/아래로 바꾸기 위해서는 먼저 가로로 스와이프한 이후에 세로로 스와이프해야만 합니다.

현재 yaw 값

Methods

인스턴스를 삭제하고 부착된 모든 이벤트 리스너를 제거합니다.

컨트롤을 비활성화하고 모든 이벤트 리스너들을 제거합니다.

컨트롤을 활성화하고 이벤트 리스너들을 추가합니다.

컨트롤의 내부 크기를 갱신합니다.

컨트롤을 카메라의 현재 상태와 동기화합니다.

Constructor

RotateControl의 인스턴스를 생성합니다.
new RotateControl(controlEl: HTMLElement, enableBlocked: boolean, options: Partial<RotateControlOptions>): RotateControl

Parameters

controlEl

HTMLElement

입력을 받을 엘리먼트

enableBlocked

boolean

초기화 과정에서 컨트롤 활성화 여부

options

{}

컨트롤 옵션들

Properties

animating

readonly
animating

boolean

현재 컨트롤이 동작중인지를 나타내는 값

disableKeyboard

disableKeyboard

boolean

false

키보드를 이용한 회전을 비활성화합니다.

disablePitch

disablePitch

boolean

false

x축 회전(pitch)을 비활성화합니다.

disableYaw

disableYaw

boolean

false

y축 회전(yaw)을 비활성화합니다.

duration

duration

number

300

회전 애니메이션의 시간 (ms)

easing

easing

((x: number) => number)

EASING.EASE_OUT_CUBIC

회전 애니메이션에 적용할 easing 함수

enabled

readonly
enabled

boolean

컨트롤이 활성화되었는지 여부를 나타내는 값

keyboardScale

>=4.0.0
keyboardScale

[number,number]

[1, 1]

키보드를 통한 회전 배율

pitch

>=4.0.0
readonly
pitch

Motion

현재 pitch 값

pointerScale

>=4.0.0
pointerScale

[number,number]

[1, 1]

마우스/터치를 통한 회전 배율

scrollable

scrollable

boolean

true로 설정할 경우, 모바일(터치) 환경의 캔버스 영역 내에서 스크롤을 가능하게 합니다.

주의

이 값을 활성화할 경우, 사용자가 카메라 뷰를 위/아래로 바꾸기 위해서는 먼저 가로로 스와이프한 이후에 세로로 스와이프해야만 합니다.

yaw

>=4.0.0
readonly
yaw

Motion

현재 yaw 값

Methods

destroy

>=4.0.0
destroy

void

destroy(): void

인스턴스를 삭제하고 부착된 모든 이벤트 리스너를 제거합니다.

disable

>=4.0.0
disable

void

disable(): void

컨트롤을 비활성화하고 모든 이벤트 리스너들을 제거합니다.

enable

>=4.0.0
enable

void

enable(): void

컨트롤을 활성화하고 이벤트 리스너들을 추가합니다.

hasOn

inherited
hasOn

boolean

hasOn<K>(eventName: K): boolean

Parameters

eventName

K

off

inherited
off

RotateControl

off<K>(eventName: K, handlerToDetach: EventCallback<RotateControlEvents, K, RotateControl>): RotateControl

Parameters

eventName

K

handlerToDetach

EventCallback<RotateControlEvents, K, RotateControl>

on

inherited
on

RotateControl

on(eventHash: Partial<{ change: ((event: { delta: RotateDeltaType; isKeyboard: boolean; isTouch: boolean }) => any); disable: ((event: { updateCursor: boolean }) => any); enable: ((event: { control: CameraControl; updateCursor: boolean }) => any); inputEnd: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; scrolling: boolean }) => any); inputStart: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; srcEvent: MouseEvent | TouchEvent | KeyboardEvent }) => any); staticClick: ((event: { isTouch: boolean }) => any) }>): RotateControl

Parameters

eventHash

Partial<{ change: ((event: { delta: RotateDeltaType; isKeyboard: boolean; isTouch: boolean }) => any); disable: ((event: { updateCursor: boolean }) => any); enable: ((event: { control: CameraControl; updateCursor: boolean }) => any); inputEnd: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; scrolling: boolean }) => any); inputStart: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; srcEvent: MouseEvent | TouchEvent | KeyboardEvent }) => any); staticClick: ((event: { isTouch: boolean }) => any) }>

once

inherited
once

RotateControl

once(eventHash: Partial<{ change: ((event: { delta: RotateDeltaType; isKeyboard: boolean; isTouch: boolean }) => any); disable: ((event: { updateCursor: boolean }) => any); enable: ((event: { control: CameraControl; updateCursor: boolean }) => any); inputEnd: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; scrolling: boolean }) => any); inputStart: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; srcEvent: MouseEvent | TouchEvent | KeyboardEvent }) => any); staticClick: ((event: { isTouch: boolean }) => any) }>): RotateControl

Parameters

eventHash

Partial<{ change: ((event: { delta: RotateDeltaType; isKeyboard: boolean; isTouch: boolean }) => any); disable: ((event: { updateCursor: boolean }) => any); enable: ((event: { control: CameraControl; updateCursor: boolean }) => any); inputEnd: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; scrolling: boolean }) => any); inputStart: ((event: { inputType: "zoom" | "rotate" } & { isKeyboard: boolean; isTouch: boolean; srcEvent: MouseEvent | TouchEvent | KeyboardEvent }) => any); staticClick: ((event: { isTouch: boolean }) => any) }>

resize

resize

void

resize(hfov: number, aspect: number, width: number, height: number): void

컨트롤의 내부 크기를 갱신합니다.

Parameters

hfov

number

카메라의 수평방향 fov값 (도 단위)

aspect

number

카메라 가로/세로 비율

width

number

갱신된 너비

height

number

갱신된 높이

sync

>=4.0.0
sync

void

sync(camera: Camera): void

컨트롤을 카메라의 현재 상태와 동기화합니다.

Parameters

camera

카메라 인스턴스

trigger

inherited
trigger

RotateControl

trigger<K>(event: K, ...params: EventTriggerParams<RotateControlEvents, K>): RotateControl

Parameters

event

K

params

EventTriggerParams<RotateControlEvents, K>