docs/examples/zh/controls/TransformControls.html

<!DOCTYPE html>
<html lang="zh">
	<head>
		<meta charset="utf-8" />
		<base href="../../../" />
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		[page:Controls] &rarr;

		<h1>变换控制器（[name]）</h1>

		<p class="desc">
			该类可提供一种类似于在数字内容创建工具（例如Blender）中对模型进行交互的方式，来在3D空间中变换物体。
			和其他控制器不同的是，变换控制器不倾向于对场景摄像机的变换进行改变。<br /><br />

			[name] 期望其所附加的3D对象是场景图的一部分。
		</p>

		<h2>导入</h2>

		<p>
			[name] 是一个附加组件，必须显式导入。
			See [link:#manual/introduction/Installation Installation / Addons].
		</p>

		<code>
			import { TransformControls } from 'three/addons/controls/TransformControls.js';
		</code>

		<h2>例子</h2>

		<p>[example:misc_controls_transform misc / controls / transform ]</p>

		<h2>构造函数</h2>

		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
		<p>
			<p>
				[page:Camera camera]: 被控制的摄像机。
			</p>
			<p>
				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。(可选)
			</p>
			<p>
				创建一个新的 [name] 实例。
			</p>
		</p>

		<h2>事件</h2>

		<h3>change</h3>
		<p>
			如果发生了任何类型的改变（对象或属性的改变）则触发该事件。
			属性改变是单独的事件，你也可以为此添加单独的事件监听；该事件类型为"propertyname-changed"（“属性名称-changed”）。
		</p>

		<h3>mouseDown</h3>
		<p>
			如果指针（鼠标/触摸）为活动状态则触发该事件。
		</p>

		<h3>mouseUp</h3>
		<p>
			如果指针（鼠标/触摸）不再为活动状态则触发该事件。
		</p>

		<h3>objectChange</h3>
		<p>
			如果被控制的3D对象发生改变则触发该事件。
		</p>

		<h2>属性</h2>

		<p>共有属性请参见其基类[page:Controls]。</p>

		<h3>[property:String axis]</h3>
		<p>
			当前变换轴。
		</p>

		<h3>[property:Camera camera]</h3>
		<p>
			渲染场景的摄像机。
		</p>

		<h3>[property:Boolean dragging]</h3>
		<p>
			当前是否正在拖动。只读属性。
		</p>

		<h3>[property:String mode]</h3>
		<p>
			当前的变换模式。可能的值包括"translate"、"rotate" 和 "scale"。默认为*translate*。
		</p>

		<h3>[property:Number rotationSnap]</h3>
		<p>
			默认情况下，3D对象是可以被连续旋转的。如果你将该值设为一个数值（弧度），则你将可以定义每次旋转3D对象时的步幅。
			默认为*null*。
		</p>

		<h3>[property:Boolean showX]</h3>
		<p>
			x轴手柄是否显示。默认为*true*。
		</p>

		<h3>[property:Boolean showY]</h3>
		<p>
			y轴手柄是否显示。默认为*true*。
		</p>

		<h3>[property:Boolean showZ]</h3>
		<p>
			z轴手柄是否显示。默认为*true*。
		</p>

		<h3>[property:Number size]</h3>
		<p>
			手柄UI（轴/平面）的大小。默认为*1*。
		</p>

		<h3>[property:String space]</h3>
		<p>
			定义了在哪种坐标空间中进行变换。可能的值有"world" 和 "local"。默认为*world*。
		</p>

		<h3>[property:Number translationSnap]</h3>
		<p>
			默认情况下，3D对象是可以被连续平移的。如果你将该值设为一个数值（世界单位），则你将可以定义每次平移3D对象时的步幅。
			默认为*null*。
		</p>

		<h2>方法</h2>

		<p>共有方法请参见其基类[page:Controls]。</p>

		<h3>[method:TransformControls attach] ( [param:Object3D object] )</h3>
		<p>
			<p>
				[page:Object3D object]: 应当变换的3D对象。
			</p>
			<p>
				设置应当变换的3D对象，并确保控制器UI是可见的。
			</p>
		</p>

		<h3>[method:TransformControls detach] ()</h3>
		<p>
			从控制器中移除当前3D对象，并确保控制器UI是不可见的。
		</p>

		<h3>[method:Object3D getHelper] ()</h3>
		<p>
			返回控件的视觉表示。将辅助对象添加到场景中，以直观地变换附着的3D对象。
		</p>

		<h3>[method:Raycaster getRaycaster] ()</h3>
		<p>
			返回用于用户交互的 [page:Raycaster] 对象。 此对象在所有实例之间共享 变换控件。 如果您设置 [name] 的
			[page:Object3D.layers .layers] 属性，您还需要 使用匹配值设置 [page:Raycaster] 上的
			[page:Raycaster.layers .layers] 属性，否则设置 [name] 不会按预期工作。
		</p>

		<h3>[method:String getMode] ()</h3>
		<p>
			返回变换模式。
		</p>
		
		<h3>[method:undefined reset] ()</h3>
		<p>
			将对象的位置、旋转和缩放重置为当前变换开始时的状态。
		</p>

		<h3>[method:undefined setMode] ( [param:String mode] )</h3>
		<p>
			<p>
				[page:String mode]: 变换模式。
			</p>
			<p>
				设置变换模式。
			</p>
		</p>

		<h3>[method:undefined setRotationSnap] ( [param:Number rotationSnap] )</h3>
		<p>
			<p>
				[page:Number rotationSnap]: 旋转捕捉步幅。
			</p>
			<p>
				设置旋转捕捉。
			</p>
		</p>

		<h3>[method:undefined setSize] ( [param:Number size] )</h3>
		<p>
			<p>
				[page:Number size]: 手柄UI的大小。
			</p>
			<p>
				设置手柄UI的大小。
			</p>
		</p>

		<h3>[method:undefined setSpace] ( [param:String space] )</h3>
		<p>
			<p>
				[page:String space]: 应用变换的坐标空间。
			</p>
			<p>
				设置应用变换的坐标空间。
			</p>
		</p>

		<h3>[method:undefined setTranslationSnap] ( [param:Number translationSnap] )</h3>
		<p>
			<p>
				[page:Number translationSnap]: 平移捕捉步幅。
			</p>
			<p>
				设置平移捕捉。
			</p>
		</p>

		<h3>[method:undefined setScaleSnap] ( [param:Number scaleSnap] )</h3>
		<p>
			<p>
				[page:Number scaleSnap]: 缩放捕捉步幅。
			</p>
			<p>
				设置缩放捕捉。
			</p>
		</p>

		<h2>源代码</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/TransformControls.js examples/jsm/controls/TransformControls.js]
		</p>
	</body>
</html>