Version: 5.3 (switch to 5.4b)
言語English
  • C#
  • JS

スクリプト言語

好きな言語を選択してください。選択した言語でスクリプトコードが表示されます。

Handles

class in UnityEditor

フィードバック

ありがとうございます

この度はドキュメントの品質向上のためにご意見・ご要望をお寄せいただき、誠にありがとうございます。頂いた内容をドキュメントチームで確認し、必要に応じて修正を致します。

閉じる

送信に失敗しました

なんらかのエラーが発生したため送信が出来ませんでした。しばらく経ってから<a>もう一度送信</a>してください。ドキュメントの品質向上のために時間を割いて頂き誠にありがとうございます。

閉じる

キャンセル

マニュアルに切り替える

説明

シーンビューで 3D GUI の制御と描画のカスタマイズを行うクラス

ハンドルは Unity がシーンビューでオブジェクトを操作するために使用する 3D 制御です。Transform コンポーネント経由でオブジェクトの位置、角度、大きさを操作するための、よく使用するツールとしてビルトイン Handle GUI があります。また、カスタムコンポーネントエディターで使用する独自の Handle GUI を定義することも可能です。このような GUI は手続き的に生成されたシーンの内容や、Waypoint やロケーションマーカーなど「目に見えない」要素、それに関連するオブジェクトのグループを編集するのに非常に役に立つ方法になります。

シーン内で 3D Handle GUI に加えて、2D ボタンをはじめとする 2D GUI を使用することができます。2D GUI の描画は //OnSceneGUI// 関数内で Handles.BeginGUI と EndGUI で囲んだ中で標準の Unity GUI 呼び出すことで行われます。HandleUtility.GUIPointToWorldRay と HandleUtility.WorldToGUIPoint を使用することで 2D GUI 座標と 3D ワールド座標の相互変換を行うことができます。

Static 変数

centerColor中心を示すハンドルに使用する色
colorハンドルの色
inverseMatrixすべてのハンドル操作の逆行列
lightingハンドルは点灯しているかどうか
matrixすべてのハンドル操作の行列
secondaryColor一般的に使用する柔らかい色
selectedColor現在アクティブなハンドルに使用する色
xAxisColorX 座標を操作するハンドルに使用する色
yAxisColorY 座標を操作するハンドルに使用する色
zAxisColor座標を操作するハンドルに使用する色

変数

currentCameraビューポートや各種設定をするためにアクセスする現在使用しているカメラ

Static 関数

ArrowCapMove ツールで使用されるような Arrow を描画します。
BeginGUI3D ハンドル GUI 内で 2D GUI の描画を開始します。
Button3D ボタンを作成します。
CircleCapカメラに面している円を描き、これをハンドル関数に渡します。
ClearCameraカメラをクリアします。
ConeCapコーン(円錐)を描き、これをハンドル関数に渡します。
CubeCapキューブを描き、これをハンドル関数に渡します。
CylinderCapシリンダーを描き、これをハンドル関数に渡します。
Discマウスでドラッグして 3D ディスクを作ります。 注意: 画面サイズに対して固定サイズのハンドルを持ちたい場合、 HandleUtility.GetHandleSize を使用します。
DotCapカメラに面しているドットを描き、これをハンドル関数に渡します。
DrawAAConvexPolygonポイント配列で指定されたアンチエイリアス Convex ポリゴンを描画します。
DrawAAPolyLine位置の配列と幅で指定したアンチエイリアスのかかった線を描きます。
DrawBezier指定した接線と始点と終点を通るテクスチャベジェ曲線を描画します。アンチエイリアスエフェクトを得るために 1 つの不透明な白のピクセルと 1 つの透明な白のピクセルの 1 x 2 ピクセルテクスチャーを使用します。ベジェ曲線はこのテクスチャを使用してスイープします。
DrawCamera矩形内部にカメラを描画します。
DrawDottedLine p1 から p2 に点線を描画します。
DrawDottedLines含まれる線分を点線で描画します。
DrawLine p1 から p2 にラインを描画します。
DrawLines含まれる線分を描画します。
DrawPolyLineすべての points を通るラインを描画します。
DrawSolidArc3D 空間に扇形を描画します。
DrawSolidDisc中の空間まで色のついた、フラットな円を 3D 空間に描画します。
DrawSolidRectangleWithOutline3D 空間に太い実線の矩形を描画します。
DrawWireArc3D 空間に円弧を描画します。
DrawWireDisc3D 空間でフラットな円盤のアウトラインを描画します。
EndGUI現在のハンドルカメラ上で 2D GUI のブロックを終了し、3D ハンドル GUI に戻ります。
FreeMoveHandle制約のない移動ハンドルを作成します。
FreeRotateHandle制約のない回転ハンドルを作成します。
GetMainGameViewSizeメインのゲームビューの幅と高さを取得します。
Label3D 空間に配置されるテキスト ラベルを作成します。
MakeBezierPointsベジェ曲線を表示するポイントの配列を返します。Handles.DrawBezier を参照してください。
PositionHandle3D シーンビューの Position ハンドルを作成します。
RadiusHandleシーンビューに Radius ハンドルを作成します。
RotationHandleシーンビューの Rotation ハンドルを作ります。
ScaleHandleシーンビューの Scale ハンドルを作成します。注意: 画面サイズに対して固定サイズのハンドルを持ちたい場合、 HandleUtility.GetHandleSize を使用します。
ScaleSliderディレクショナルスケールスライダーを作成します。注意: 画面サイズに対して固定サイズのハンドルを持ちたい場合、 HandleUtility.GetHandleSize を使用します。
ScaleValueHandleシングルフロートのドラッグ可能なハンドルを作成します。注意: 画面サイズに対して固定サイズのハンドルを持ちたい場合、 HandleUtility.GetHandleSize を使用します。
SelectionFrameカメラに面しているセレクションフレームを描画します。
SetCameraすべての Handle と Gizmo がその設定で描画されるように現在のカメラをセットしてください。
Slider3D スライダーを作成します。注意: 画面サイズに対して固定サイズのハンドルを持ちたい場合、 HandleUtility.GetHandleSize を使用します。
Slider2D2D 平面でハンドルをスライドします。
SnapValue val 値を snap の最も近い倍数に四捨五入します (snap の値は正数のみ可)。
SphereCapスフィア(球体)を描き、これをハンドル関数に渡します。

デリゲート

DrawCapFunction例えば、ハンドルを描画するために使用する関数 Handles.RectangleCap