[page:EventDispatcher] →

# [name]

[name] 는 [page:OrbitControls] 와 유사하지만, 카메라의 일정한 [page:Object3D.up up] vector 값을 유지하지 않습니다. 이 말인즉슨, 카메라가 위쪽 방향이나 아럐쪽 방향으로 회전할 경우, "오른쪽을 위로" 유지하기 위해 뒤집을 수 없습니다.

## 수입

[name] 는 애드온이며 명시적으로 가져와야 합니다. See [link:#manual/introduction/Installation Installation / Addons].

`import { TrackballControls } from 'three/addons/controls/TrackballControls.js';`

## 예시

[example:misc_controls_trackball misc / controls / trackball ]

## 생성자

### [name]( [param:Camera camera], [param:HTMLDOMElement domElement] )

[page:Camera camera]: 렌더링 된 장면의 카메라입니다.

[page:HTMLDOMElement domElement]: 이벤트 리스너에 사용되는 HTML 엘리먼트입니다.

새로운 [name] 객체를 생성합니다.

## 이벤트

### change

컨트롤에 의해 카메라가 변환될 경우 호출됩니다.

### start

처음으로 상호 작용이 실행되면 호출됩니다. (e.g. 터치패드)

### end

상호 작용이 완료되면 호출됩니다.

## 특성

### [property:HTMLDOMElement domElement]

마우스 / 터치 이벤트를 수신하는 데 사용되는 HTMLDOMElement입니다. 이것은 생성자에 의해 설정되어야 합니다; 생성자를 통해 설정되지 않을 경우 새 이벤트 리스너에 설정되지 않습니다.

### [property:Number dynamicDampingFactor]

댐핑의 강도를 조절합니다. [page:.staticMoving staticMoving] 이 * false * 로 설정된 경우에만 고려됩니다. 기본값은 *0.2* 입니다.

### [property:Boolean enabled]

컨트롤을 활성화 여부를 설정합니다.

### [property:Array keys]

이 배열은 상호 작용을 제어하기위한 키 코드를 보유합니다.

- 처음 정의 된 키를 누르면 모든 마우스 상호 작용 (왼쪽, 가운데, 오른쪽)이 궤도를 회전합니다.
- 두 번째로 정의 된 키를 누르면 모든 마우스 상호 작용 (왼쪽, 가운데, 오른쪽)이 확대 / 축소를 수행합니다.
- 세 번째로 정의 된 키를 누르면 모든 마우스 상호 작용 (왼쪽, 가운데, 오른쪽)이 패닝을 수행합니다.

기본값은 A, S, D를 나타내는 *KeyA, KeyS, KeyD* 입니다.

### [property:Number maxDistance]

축소할 수 있는 범위를 설정합니다. ([page:PerspectiveCamera] only). 기본값은 *무한대* 입니다.

### [property:Number minDistance]

확대할 수 있는 범위를 설정합니다. ([page:PerspectiveCamera] only). 기본값은 *0* 입니다.

### [property:Float maxZoom]

축소 할 수 있는 범위를 설정합니다. ( [page:OrthographicCamera] only ). 기본값은 *무한대* 입니다.

### [property:Float minZoom]

확대 할 수 있는 범위를 설정합니다. ( [page:OrthographicCamera] only ). 기본값은 *0* 입니다.

### [property:Object mouseButtons]

해당 객체는 컨트롤에서 사용하는 마우스 동작에 대한 참조를 포함합니다.

- .LEFT 는 *THREE.MOUSE>ROTATE* 에 대입됩니다.
- .MIDDLE 은 *THREE.MOUSE.ZOOM* 에 대입됩니다.
- .RIGHT 는 *THREE.MOUSE.PAN* 에 대입됩니다.

### [property:Boolean noPan]

패닝의 비활성화 여부를 설정합니다. 기본값은 *false* 입니다.

### [property:Boolean noRotate]

회전의 비활성화 여부를 설정합니다. 기본값은 *false* 입니다.

### [property:Boolean noZoom]

줌잉의 비활성화 여부를 설정합니다. 기본값은 *false* 입니다.

### [property:Camera object]

제어할 카메라 객체입니다.

### [property:Number panSpeed]

확대 속도를 설정합니다. 기본값은 *0.3* 입니다.

### [property:Number rotateSpeed]

회전 속도를 설정합니다. 기본값은 *1.0* 입니다.

### [property:Object screen]

화면 속성을 나타냅니다. [page:.handleResize handleResize]()을 호출할 시 자동적으로 설정됩니다.

- 왼쪽: 화면의 왼쪽 경계면의 오프셋을 픽셀 단위로 나타냅니다.
- 상단: 화면의 상단 경계면의 오프셋을 픽셀 단위로 나타냅니다.
- 넓이: 화면의 넓이를 픽셀 단위로 나타냅니다.
- 높이: 화면의 높이를 픽셀 단위로 나타냅니다.

### [property:Boolean staticMoving]

댐핑의 비활성화 여부를 설정합니다. 기본값은 *false* 입니다.

### [property:Number zoomSpeed]

줌 속도를 설정합니다. 기본값은 *1.2* 입니다.

## 메소드

### [method:undefined checkDistances] ()

컨트롤이 [minDistance, maxDistance] 범위내에 있는지 확인합니다. [page:.update update]() 에 의해 호출됩니다.

### [method:undefined dispose] ()

컨트롤이 더 이상 필요하지 않을 경우 호출해야 합니다.

### [method:undefined handleResize] ()

어플리케이션의 창 크기를 조절 하려면 호출해야 합니다.

### [method:undefined panCamera] ()

패닝이 필요한 경우 [page:.update update]() 을 호출하여 수행합니다.

### [method:undefined reset] ()

컨트롤을 초기 상태로 전환합니다.

### [method:undefined rotateCamera] ()

카메라의 회전이 필요한 경우 [page:.update update]() 을 호출하여 수행합니다.

### [method:undefined update] ()

컨트롤을 업데이트합니다. 보통은 애니메이션 루프에서 수행합니다.

### [method:undefined zoomCamera] ()

줌잉이 필요항 경우 [page:.update update]() 을 호출하여 수행합니다.

## Source

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/TrackballControls.js examples/jsm/controls/TrackballControls.js]