Sfoglia il codice sorgente

docs:korean translations

kijunkim9 4 anni fa
parent
commit
ab878aa5a1

+ 43 - 44
docs/examples/ko/controls/OrbitControls.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="ko">
 	<head>
 		<meta charset="utf-8" />
 		<base href="../../../" />
@@ -112,90 +112,90 @@
 
 		<h3>[property:Boolean enableKeys]</h3>
 		<p>
-			Enable or disable the use of keyboard controls.
+			키보드 컨트롤의 활성화 또는 비활성화를 설정합니다.
 		</p>
 
 		<h3>[property:Boolean enablePan]</h3>
 		<p>
-			Enable or disable camera panning. Default is true.
+			카매라 패닝의 활성화 또는 비활성화를 설정합니다. 기본값은 *true* 입니다.
 		</p>
 
 		<h3>[property:Boolean enableRotate]</h3>
 		<p>
-			Enable or disable horizontal and vertical rotation of the camera. Default is true.<br>
-			Note that it is possible to disable a single axis by setting the min and max of the
-			[page:.minPolarAngle polar angle] or [page:.minAzimuthAngle azimuth angle] to the same value,
-			which will cause the vertical or horizontal rotation to be fixed at that value.
+			카메라의 수직 및 수평 회전의 활성화 또는 비활성화를 설정합니다. 기본값은 *true* 입니다.<br>
+			[page:.minPolarAngle polar angle] 또는 page:.minAzimuthAngle azimuth angle]의 최소 및 최대를 동일한 값으로 설정하여 단일 축을 비활성화 할 수 있습니다. 
+			그러면 수직 또는 수평 회전이 해당 값으로 고정됩니다.
+			
 		</p>
 
 		<h3>[property:Boolean enableZoom]</h3>
 		<p>
-			Enable or disable zooming (dollying) of the camera.
+			카메라 확대 / 축소 (dollying)를 활성화 또는 비활성화를 설정합니다.
 		</p>
 
 		<h3>[property:Float keyPanSpeed]</h3>
 		<p>
-			How fast to pan the camera when the keyboard is used. Default is 7.0 pixels per keypress.
+			키보드를 사용할 때 카메라를 패닝하는 속도를 설정합니다. 기본값은 키 누름 당 7.0 픽셀입니다.
 		</p>
 
 		<h3>[property:Object keys]</h3>
 		<p>
-			This object contains references to the keycodes for controlling camera panning. Default is the 4 arrow keys.
+			해당 객체는 카메라 패닝을 제어하기위한 키 코드에 대한 참조를 포함합니다. 기본값은 4 개의 화살표 키입니다.
 			<code>
 controls.keys = {
-	LEFT: 37, //left arrow
-	UP: 38, // up arrow
-	RIGHT: 39, // right arrow
-	BOTTOM: 40 // down arrow
+	LEFT: 37, // 왼쪽 화살표
+	UP: 38, // 위쪽 화살표
+	RIGHT: 39, // 오른쪽 화살표
+	BOTTOM: 40 // 아래쪽 화살표
 }
-			 </code> See [link:https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/keyCode this page] for a full
-			list of keycodes.
+			 </code> 
+			 전체 키코드 목록은 [link:https://developer.mozilla.org/ko/docs/Web/API/KeyboardEvent/keyCode this page] 를 참조하세요.
 		</p>
 
 		<h3>[property:Float maxAzimuthAngle]</h3>
 		<p>
-			How far you can orbit horizontally, upper limit. If set, the interval [ min, max ] must be a sub-interval of [ - 2 PI, 2 PI ], with ( max - min < 2 PI ). Default is Infinity.
+			수평으로 궤도를 얼마나 돌 수 있는지 상한을 설정합니다. [ min, max ] 	의 간격은 ( max - min < 2 PI ) 와 함께 ( max - min < 2 PI ) 의 하위 간격이어야 합니다. 기본값은 무한대입니다.
 		</p>
 
 		<h3>[property:Float maxDistance]</h3>
 		<p>
-			How far you can dolly out ( [page:PerspectiveCamera] only ). Default is Infinity.
+			달리 아웃(dolly out)할 수 있는 최대 거리를 설정합니다. ([page:PerspectiveCamera] only). 기본값은 무한대입니다.
 		</p>
 
 		<h3>[property:Float maxPolarAngle]</h3>
 		<p>
-			How far you can orbit vertically, upper limit. Range is 0 to Math.PI radians, and default is Math.PI.
+			수직으로 궤도를 얼마나 돌 수 있는지 상한을 설정합니다. 0 부터 Math.PI radians 까지 범위를 가질 수 있습니다. 기본값은 Math.PI 입니다.
 		</p>
 
 		<h3>[property:Float maxZoom]</h3>
 		<p>
-			How far you can zoom out ( [page:OrthographicCamera] only ). Default is Infinity.
+			축소 할 수 있는 범위를 설정합니다.( [page:OrthographicCamera] only ). 기본값은 무한대입니다.
 		</p>
 
 		<h3>[property:Float minAzimuthAngle]</h3>
 		<p>
-			How far you can orbit horizontally, lower limit. If set, the interval [ min, max ] must be a sub-interval of [ - 2 PI, 2 PI ], with ( max - min < 2 PI ). Default is Infinity.
+			수평으로 궤도를 얼마나 돌 수 있는지 하한을 설정합니다. [ min, max ] 의 간격은 ( max - min < 2 PI ) 와 함께 ( max - min < 2 PI ) 의 하위 간격이어야 합니다. 기본값은 무한대입니다.
 		</p>
 
 		<h3>[property:Float minDistance]</h3>
 		<p>
-			 How far you can dolly in ( [page:PerspectiveCamera] only ). Default is 0.
+			달리 인(dolly in)할 수 있는 최소 거리를 설정합니다. ([page:PerspectiveCamera] only). 기본값은 0 입니다.
 		</p>
 
 		<h3>[property:Float minPolarAngle]</h3>
 		<p>
-			How far you can orbit vertically, lower limit. Range is 0 to Math.PI radians, and default is 0.
+			수직으로 궤도를 얼마나 돌 수 있는지 하한을 설정합니다. 0 부터 Math.PI radians 까지 범위를 가질 수 있습니다. 기본값은 0 입니다.
 		</p>
 
 		<h3>[property:Float minZoom]</h3>
 		<p>
-			How far you can zoom in ( [page:OrthographicCamera] only ). Default is 0.
+			확대 할 수 있는 범위를 설정합니다. ( [page:OrthographicCamera] only ). 기본값은 0 입니다.
 		</p>
 
 		<h3>
 			[property:Object mouseButtons]</h3>
 		<p>
-			This object contains references to the mouse actions used by the controls.
+			해당 객체는 컨트롤에서 사용하는 마우스 동작에 대한 참조를 포함합니다.
 			<code>
 controls.mouseButtons = {
 	LEFT: THREE.MOUSE.ROTATE,
@@ -207,45 +207,44 @@ controls.mouseButtons = {
 
 		<h3>[property:Camera object]</h3>
 		<p>
-			The camera being controlled.
+			제어할 카메라 객체입니다.
 		</p>
 
 		<h3>[property:Float panSpeed]</h3>
 		<p>
-			Speed of panning. Default is 1.
+			패닝 속도를 설정합니다. 기본값은 1입니다.
 		</p>
 
 		<h3>[property:Vector3 position0]</h3>
 		<p>
-			Used internally by the [method:saveState] and [method:reset] methods.
+			해당 프로퍼티는 [method:saveState] 및 [method:reset] 메서드에서 내부적으로 사용합니다.
 		</p>
 
 		<h3>[property:Float rotateSpeed]</h3>
 		<p>
-			Speed of rotation. Default is 1.
+			회전 속도를 설정합니다. 기본값은 1입니다.
 		</p>
 
 		<h3>[property:Boolean screenSpacePanning]</h3>
 		<p>
-		Defines how the camera's position is translated when panning. If true, the camera pans in screen space.
+		패닝할 떄, 카메라 위치가 변환되는 방식를 정의합니다. 만약 true일 경우, 카메라가 화면 공간에서 이동합니다.
 		Otherwise, the camera pans in the plane orthogonal to the camera's up direction.
-		Default is true for OrbitControls; false for MapControls.
+		OrbitControls의 경우 기본값은 true 이고, MapControls의 경우 기본값은 false 입니다.
 		</p>
 
 		<h3>[property:Vector3 target0]</h3>
 		<p>
-			Used internally by the [method:saveState] and [method:reset] methods.
+			[method:saveState] 및 [method:rest] 메서드에서 내부적으로 사용합니다.
 		</p>
 
 		<h3>[property:Vector3 target]</h3>
 		<p>
-			The focus point of the controls, the [page:.object] orbits around this. It can be updated manually at any point to change
-			the focus of the controls.
+			컨트롤의 중요 포인트는, [page:.object] 를 중심으로 회전하는 것입니다. 컨트롤의 중요 포인트는 언제든지 수동으로 변경할 수 있습니다.
 		</p>
 
 		<h3>[property:Object touches]</h3>
 		<p>
-			This object contains references to the touch actions used by the controls.
+			해당 객체는 컨트롤에 사용되는 터치 동작에 대한 참조를 포함합니다.
 			<code>
 controls.touches = {
 	ONE: THREE.TOUCH.ROTATE,
@@ -256,47 +255,47 @@ controls.touches = {
 
 		<h3>[property:Float zoom0]</h3>
 		<p>
-			Used internally by the [method:saveState] and [method:reset] methods.
+			[method:saveState] 및 [method:reset] 메서드에서 내부적으로 사용합니다.
 		</p>
 
 		<h3>[property:Float zoomSpeed]</h3>
 		<p>
-			Speed of zooming / dollying. Default is 1.
+			줌잉(Zooming)과 달링(Dollying)의 속도를 설정합니다. 기본값은 1 입니다.
 		</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>메서드</h2>
 
 		<h3>[method:null dispose] ()</h3>
 		<p>
+			모든 이벤트 리스너를 삭제합니다.
 			Remove all the event listeners.
 		</p>
 
 		<h3>[method:radians getAzimuthalAngle] ()</h3>
 		<p>
-			Get the current horizontal rotation, in radians.
+			라디안 단위로 현재 수평 회전값을 가져옵니다.
 		</p>
 
 		<h3>[method:radians getPolarAngle] ()</h3>
 		<p>
-			Get the current vertical rotation, in radians.
+			라디안 단위로 현재 수직 회전값을 가져옵니다.
 		</p>
 
 		<h3>[method:null reset] ()</h3>
 		<p>
-			Reset the controls to their state from either the last time the [page:.saveState] was called, or the initial state.
+			컨트롤이 마지막으로 호출된 [page:.saveState] 시점으로 돌리거나, 초기상태로 재설정합니다.
 		</p>
 
 		<h3>[method:null saveState] ()</h3>
 		<p>
-			Save the current state of the controls. This can later be recovered with [page:.reset].
+			컨트롤의 현재 상태를 저장합니다. 나중에 [page:.rest]을 이용하여 현재 상태로 복구할 수 있습니다.
 		</p>
 
 		<h3>[method:Boolean update] ()</h3>
 		<p>
-			Update the controls. Must be called after any manual changes to the camera's transform,
-			or in the update loop if [page:.autoRotate] or [page:.enableDamping] are set.
+			컨트롤을 업데이트합니다. 카메라를 수동으로 변환하거나, [page:.autoRotate] 또는 [page:.enableDamping]을 설정할 경우 업데이트 루프에서 호출해야 합니다.
 		</p>
 
 		<h2>Source</h2>

+ 31 - 32
docs/examples/ko/controls/PointerLockControls.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="ko">
 	<head>
 		<meta charset="utf-8" />
 		<base href="../../../" />
@@ -12,8 +12,7 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		The implementation of this class is based on the [link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API].
-		[name] is a perfect choice for first person 3D games.
+		해당 클래스의 구현은 [link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API] 를 기반으로 합니다. [name] 은 1 인칭 3D 게임을 위한 완벽한 선택입니다.
 		</p>
 
 		<h2>Code Example</h2>
@@ -21,7 +20,7 @@
 		<code>
 		const controls = new PointerLockControls( camera, document.body );
 
-		// add event listener to show/hide a UI (e.g. the game's menu)
+		// UI를 표시하거나 숨기기 위해 이벤트 리스너를 추가합니다. (예시: 게임 메뉴)
 
 		controls.addEventListener( 'lock', function () {
 
@@ -36,118 +35,118 @@
 		} );
 		</code>
 
-		<h2>Examples</h2>
+		<h2>예시</h2>
 
 		<p>[example:misc_controls_pointerlock misc / controls / pointerlock ]</p>
 
-		<h2>Constructor</h2>
+		<h2>생성자</h2>
 
 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 		<p>
 			<p>
-			[page:Camera camera]: The camera of the rendered scene.
+			[page:Camera camera]: 렌더링 된 장면의 카메라입니다.
 			</p>
 			<p>
-			[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
+			[page:HTMLDOMElement domElement]: 이벤트 리스너에 사용되는 HTML 엘리먼트입니다.
 			</p>
 			<p>
-				Creates a new instance of [name].
+				새로운 [name] 객체를 생성합니다.
 			</p>
 		</p>
 
-		<h2>Events</h2>
+		<h2>이벤트</h2>
 
 		<h3>change</h3>
 		<p>
-			Fires when the user moves the mouse.
+			사용자 마우스가 움직일 떄 호출됩니다.
 		</p>
 
 		<h3>lock</h3>
 		<p>
-			Fires when the pointer lock status is "locked" (in other words: the mouse is captured).
+			포인터의 잠금 상태가 "잠김" 일 때 호출됩니다 (in other words: the mouse is captured).
 		</p>
 
 		<h3>unlock</h3>
 		<p>
-			Fires when the pointer lock status is "unlocked" (in other words: the mouse is not captured anymore).
+			포인터의 잠금 상태가 "잠금 해제" 일 때 호출됩니다. (in other words: the mouse is not captured anymore)
 		</p>
 
-		<h2>Properties</h2>
+		<h2>특성</h2>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 		<p>
-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
-			not set up new event listeners.
+			마우스 / 터치 이벤트를 수신하는 데 사용되는 HTMLDOMElement입니다. 이것은 생성자에 의해 설정되어야 합니다; 
+			생성자를 통해 설정되지 않을 경우 새 이벤트 리스너에 설정되지 않습니다.
 		</p>
 
 
 		<h3>[property:Boolean isLocked]</h3>
 		<p>
-			Whether or not the controls are locked.
+			컨트롤의 잠김 여부를 설정합니다.
 		</p>
 
 		<h3>[property:Float maxPolarAngle]</h3>
 		<p>
-			Camera pitch, upper limit. Range is 0 to Math.PI radians. Default is Math.PI.
+			카메라 피치(pitch)의 상한값을 설정합니다. 0 부터 Math.PI 라디안까지 범위를 가질 수 있습니다. 기본값은 Math.PI 입니다.
 		</p>
 
 		<h3>[property:Float minPolarAngle]</h3>
 		<p>
-			Camera pitch, lower limit. Range is 0 to Math.PI radians. Default is 0.
+			카메라 피치(pitch)의 하한값을 설정합니다. 0 부터 Math.PI 라디안까지 범위를 가질 수 있습니다. 기본값은 0 입니다.
 		</p>
 
-		<h2>Methods</h2>
-
-		<p>See the base [page:EventDispatcher] class for common methods.</p>
+		<h2>메소드</h2>
+		<p>일반적인 메소드는 [page:EventDispatcher] 클래스를 참조하세요.</p>
+		
 
 		<h3>[method:null connect] ()</h3>
 		<p>
-			Adds the event listeners of the controls.
+			컨트롤의 이벤트 리스너를 추가합니다.			
 		</p>
 
 		<h3>[method:null disconnect] ()</h3>
 		<p>
-			Removes the event listeners of the controls.
+			컨트롤의 이벤트 리스너를 제거합니다.
 		</p>
 
 		<h3>[method:Vector3 getDirection] ( [param:Vector3 target] )</h3>
 		<p>
 			<p>
-				[page:Vector3 target]: The target vector.
+				[page:Vector3 target]: 타겟 벡터를 의미합니다.
 			</p>
 			<p>
-				Returns the look direction of the camera.
+				카메라가 보고있는 방향을 반환합니다.
 			</p>
 		</p>
 
 		<h3>[method:null lock] ()</h3>
 		<p>
-			Activates the pointer lock.
+			포인터 잠금을 활성화합니다.
 		</p>
 
 		<h3>[method:null moveForward] ( [param:Number distance] )</h3>
 		<p>
 			<p>
-				[page:Number distance]: The signed distance.
+				[page:Number distance]: 앞으로 이동할 거리를 설정합니다.
 			</p>
 			<p>
-				Moves the camera forward parallel to the xz-plane. Assumes camera.up is y-up.
+				카메라를 xz-평면에 평행하게 앞으로 이동합니다. camera.up을 y-up이라고 가정합니다.
 			</p>
 		</p>
 
 		<h3>[method:null moveRight] ( [param:Number distance] )</h3>
 		<p>
 			<p>
-				[page:Number distance]: The signed distance.
+				[page:Number distance]: 오른쪽으로 이동할 거리를 설정합니다.
 			</p>
 			<p>
-				Moves the camera sidewards parallel to the xz-plane.
+				카메라를 xz 평면에 평행하게 옆으로 이동합니다.
 			</p>
 		</p>
 
 		<h3>[method:null unlock] ()</h3>
 		<p>
-			Exits the pointer lock.
+			포인터 잠금을 종료합니다.
 		</p>
 
 		<h2>Source</h2>

+ 21 - 22
docs/examples/ko/controls/TrackballControls.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="ko">
 	<head>
 		<meta charset="utf-8" />
 		<base href="../../../" />
@@ -13,74 +13,73 @@
 
 		<p class="desc">
 			<p>
-				[name] is similar to [page:OrbitControls]. However, it does not maintain a constant camera [page:Object3D.up up] vector.
-				That means if the camera orbits over the “north” and “south” poles, it does not flip to stay "right side up".
+				[name] 는 [page:OrbitControls] 와 유사하지만, 카메라의 일정한 [page:Object3D.up up] vector 값을 유지하지 않습니다.
+				이 말인즉슨, 카메라가 위쪽 방향이나 아럐쪽 방향으로 회전할 경우, "오른쪽을 위로" 유지하기 위해 뒤집을 수 없습니다.
 			</p>
 		</p>
 
-		<h2>Examples</h2>
+		<h2>예시</h2>
 
 		<p>[example:misc_controls_trackball misc / controls / trackball ]</p>
 
-		<h2>Constructor</h2>
+		<h2>생성자</h2>
 
 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 		<p>
 			<p>
-				[page:Camera camera]: The camera of the rendered scene.
+				[page:Camera camera]: 렌더링 된 장면의 카메라입니다.
 			</p>
 			<p>
-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
+				[page:HTMLDOMElement domElement]: 이벤트 리스너에 사용되는 HTML 엘리먼트입니다.
 			</p>
 			<p>
-				Creates a new instance of [name].
+				새로운 [name] 객체를 생성합니다.
 			</p>
 		</p>
 
-		<h2>Events</h2>
+		<h2>이벤트</h2>
 
 		<h3>change</h3>
 		<p>
-			Fires when the camera has been transformed by the controls.
+			컨트롤에 의해 카메라가 변환될 경우 호출됩니다.
 		</p>
 
 		<h3>start</h3>
 		<p>
-			Fires when an interaction (e.g. touch) was initiated.
+			처음으로 상호 작용이 실행되면 호출됩니다. (e.g. 터치패드)
 		</p>
 
 		<h3>end</h3>
 		<p>
-			Fires when an interaction has finished.
+			상호 작용이 완료되면 호출됩니다.
 		</p>
 
-		<h2>Properties</h2>
+		<h2>특성</h2>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 		<p>
-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
-			not set up new event listeners.
+			마우스 / 터치 이벤트를 수신하는 데 사용되는 HTMLDOMElement입니다. 이것은 생성자에 의해 설정되어야 합니다; 생성자를 통해 설정되지 않을 경우 새 이벤트 리스너에 설정되지 않습니다.
 		</p>
 
 		<h3>[property:Number dynamicDampingFactor]</h3>
 		<p>
-			Defines the intensity of damping. Only considered if [page:.staticMoving staticMoving] is set to *false*. Default is *0.2*.
+			댐핑의 강도를 조절합니다. [page:.staticMoving staticMoving] 이 * false * 로 설정된 경우에만 고려됩니다. 기본값은 *0.2* 입니다.
 		</p>
 
 		<h3>[property:Boolean enabled]</h3>
 		<p>
-			Whether or not the controls are enabled.
+			컨트롤이 활성화인지 비활성화인지 나타냅니다.
 		</p>
 
 		<h3>[property:Array keys]</h3>
 		<p>
-			This array holds keycodes for controlling interactions.
+			이 배열은 상호 작용을 제어하기위한 키 코드를 보유합니다.
 			<ul>
-				<li>When the first defined key is pressed, all mouse interactions (left, middle, right) performs orbiting.</li>
-				<li>When the second defined key is pressed, all mouse interactions (left, middle, right) performs zooming.</li>
-				<li>When the third defined key is pressed, all mouse interactions (left, middle, right) performs panning.</li>
+				<li>처음 정의 된 키를 누르면 모든 마우스 상호 작용 (왼쪽, 가운데, 오른쪽)이 궤도를 회전합니다.</li>
+				<li>두 번째로 정의 된 키를 누르면 모든 마우스 상호 작용 (왼쪽, 가운데, 오른쪽)이 확대 / 축소를 수행합니다.</li>
+				<li>세 번째로 정의 된 키를 누르면 모든 마우스 상호 작용 (왼쪽, 가운데, 오른쪽)이 패닝을 수행합니다.</li>
 			</ul>
-			Default is *65, 83, 68* which represents A, S, D.
+			기본값은 A, S, D를 나타내는 * 65, 83, 68 *입니다.
 		</p>
 
 		<h3>[property:Number maxDistance]</h3>