xform

ジャンプ先: 概要. 注. 戻り値. 関連. フラグ. MEL 例.

概要

xform [-absolute] [-boundingBox] [-boundingBoxInvisible] [-centerPivots] [-centerPivotsOnComponents] [-deletePriorHistory boolean] [-euler] [-matrix float float float float float float float float float float float float float float float float] [-objectSpace] [-parentSpace] [-pivots linear linear linear] [-preserve boolean] [-preserveUV] [-reflection] [-reflectionAboutBBox] [-reflectionAboutOrigin] [-reflectionAboutX] [-reflectionAboutY] [-reflectionAboutZ] [-reflectionTolerance float] [-relative] [-rotateAxis angle angle angle] [-rotateOrder string] [-rotatePivot linear linear linear] [-rotateTranslation linear linear linear] [-rotation angle angle angle] [-scale float float float] [-scalePivot linear linear linear] [-scaleTranslation linear linear linear] [-shear float float float] [-translation linear linear linear] [-worldSpace] [-worldSpaceDistance] [-zeroTransformPivots] [objects...]

xform は、取り消し可能、照会可能、および編集不可能です。

このコマンドは、変換ノードにおける、あらゆる要素の照会/設定に使用できます。また、変換行列やバウンディング ボックスのような、直接設定できない値を照会することもできます。ピボット ポイントを設定することもできます。

すべての値は、変換の座標(アトリビュート - スペース)で指定します。

さらに、アトリビュートはフラグ セクションに表示される順序で適用されるか、返されます(この順序は、次に示す変換行列に表示される順序に対応します)。

関連トピック 移動、回転、スケール

注

//                        -1                       -1
//[M]  = [sp]x[s]x[sh]x[sp]x[st]x[rp]x[ar]x[ro]x[rp]x[rt]x[t]
//
//where:
//
//[sp] = |  1      0        0       0 | = scale pivot matrix
//       |  0      1        0       0 |
//       |  0      0        1       0 |
//       | -spx   -spy     -spz     1 |
//
//[s]  = |  sx     0        0       0 | = scale matrix
//       |  0      sy       0       0 |
//       |  0      0        sz      0 |
//       |  0      0        0       1 |
//
//
//[sh] = |  1      0        0       0 | = shear matrix
//       |  xy     1        0       0 |
//       |  xz     yz       1       0 |
//       |  0      0        0       1 |
//
//   -1
//[sp] = |  1       0       0       0 | = scale pivot inverse matrix
//       |  0       1       0       0 |
//       |  0       0       1       0 |
//       |  spx     spy     spz     1 |
//
//[st] = |  1       0       0       0 | = scale translate matrix
//       |  0       1       0       0 |
//       |  0       0       1       0 |
//       |  stx     sty     stz     1 |
//
//[rp] = |  1       0       0       0 | = rotate pivot matrix
//       |  0       1       0       0 |
//       |  0       0       1       0 |
//       | -rpx    -rpy    -rpz     1 |
//
//[ar] = |  *       *       *       0 | = axis rotation matrix
//       |  *       *       *       0 |   (composite rotation,
//       |  *       *       *       0 |    see [rx], [ry], [rz]
//       |  0       0       0       1 |    below for details)
//
//[rx] = |  1       0       0       0 | = rotate X matrix
//       |  0       cos(x)  sin(x)  0 |
//       |  0      -sin(x)  cos(x)  0 |
//       |  0       0       0       1 |
//
//[ry] = |  cos(y)  0      -sin(y)  0 | = rotate Y matrix
//       |  0       1       0       0 |
//       |  sin(y)  0       cos(y)  0 |
//       |  0       0       0       1 |
//
//[rz] = |  cos(z)  sin(z)  0       0 | = rotate Z matrix
//       | -sin(z)  cos(z)  0       0 |
//       |  0       0       1       0 |
//       |  0       0       0       1 |
//
//   -1
//[rp] = |  1       0       0       0 | = rotate pivot matrix
//       |  0       1       0       0 |
//       |  0       0       1       0 |
//       |  rpx     rpy     rpz     1 |
//
//[rt] = |  1       0       0       0 | = rotate translate matrix
//       |  0       1       0       0 |
//       |  0       0       1       0 |
//       |  rtx     rty     rtz     1 |
//
//[t]  = |  1       0       0       0 | = translation matrix
//       |  0       1       0       0 |
//       |  0       0       1       0 |
//       |  tx      ty      tz      1 |

戻り値

なし

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-absolute(-a)
絶対値による変換を実行します(既定)。
-boundingBox(-bb)
オブジェクトのバウンディング ボックスを返します。戻り値は次の順序で戻されます: x の最小値、y の最小値、z の最小値、x の最大値、y の最大値、z の最大値
-boundingBoxInvisible(-bbi)
オブジェクトのバウンディング ボックスを返します。boundingBox フラグを使用した場合は、含まれないすべての非表示の子のバウンディング ボックスも含まれます。戻り値は次の順序で返されます。x の最小値、y の最小値、z の最小値、x の最大値、y の最大値、z の最大値
-centerPivots(-cp)
ピボット ポイントを、オブジェクトのバウンディング ボックスの中心に設定します(-p フラグを参照)
-centerPivotsOnComponents(-cpc)
ピボット ポイントを、コンポーネントのバウンディング ボックスの中心に設定します(-p フラグを参照)
-deletePriorHistory(-dph)	boolean
true の場合、操作が実行される前にコンストラクション ヒストリが削除されます。
-euler(-eu)
回転値を指定する -relative フラグの修飾子で、現在の XYZ 回転値に加算されます。
-matrix(-m)	float float float float float float float float float float float float float float float float
コンポジット変換行列を作成するか、返します。*注* 行列は、列順で指定される 16 個の double 型の引数で表されます。
-objectSpace(-os)
(ピボット、移動、回転、回転軸、行列、バウンディング ボックス フラグのみに有効な)オブジェクト空間の変換値として値を扱います。
-parentSpace(-ps)
(ピボット、移動、回転、回転軸、行列、バウンディング ボックス フラグのみに有効な)親空間の変換値として値を扱います。
-pivots(-piv)	linear linear linear
回転ピボットとスケール ピボットを同時に変更する便利な方法です(詳細については、-rp -sp フラグを参照)。
-preserve(-p)	boolean
全体的な変換を保持します。ピボットまたは回転順序を変更するときにオブジェクトが「ジャンプ」するのを防ぐために使用します。既定値は true です(-sp、-rp、-roo、-cp、-ra と一緒に使用)。
-preserveUV(-puv)
true の場合、回転されるコンポーネント上の UV 値は、3D 空間の回転から投影されます。小さな編集では、これによりワールド空間のオブジェクト上のテクスチャ マッピングがフリーズします。false の場合は、選択した頂点の UV 値は変更されません。既定は false です。
-reflection(-rfl)
対応する対称的なコンポーネントも移動します。
-reflectionAboutBBox(-rab)
対称軸の位置をジオメトリのバウンディング ボックスに設定します。
-reflectionAboutOrigin(-rao)
原点に対称軸の位置を設定します。
-reflectionAboutX(-rax)
X=0 を対称プレーンとして指定します。
-reflectionAboutY(-ray)
Y=0 を対称プレーンとして指定します。
-reflectionAboutZ(-raz)
Z=0 を対称プレーンとして指定します。
-reflectionTolerance(-rft)	float
対応する対称コンポーネントを見つける許容値を指定します。
-relative(-r)
相対値による変換を実行します。
-rotateAxis(-ra)	angle angle angle
回転軸の方向です(-p フラグとともに使用する場合は、回転全体における、軸回転の補正のために回転に変更が加えられるのを防ぎます)。
-rotateOrder(-roo)	string
回転の順番です(-p フラグとともに使用する場合は、ローカル回転にオリジナルのものと同等になるよう修正を加え、回転全体を保持します)。このフラグに対する有効な値は <xyz | yzx | zxy | xzy | yxz | zyx> です。
-rotatePivot(-rp)	linear linear linear
ピボット ポイントで回転変換します(-p フラグとともに使用する場合は、変換全体の回転変換に変更が加えられるのを防ぎます)。
-rotateTranslation(-rt)	linear linear linear
回転移動します。
-rotation(-ro)	angle angle angle
回転変換します。
-scale(-s)	float float float
スケール変換します。
-scalePivot(-sp)	linear linear linear
ピボット ポイントでスケール変換します(-p フラグとともに使用する場合は、トランスフォーム全体のスケール変換に変更が加えられるのを防ぎます)。
-scaleTranslation(-st)	linear linear linear
スケール移動します。
-shear(-sh)	float float float
シア変換します。値はシアの <xy,xz,yz> を表します。
-translation(-t)	linear linear linear
移動
-worldSpace(-ws)
(ピボット、移動、回転、回転軸、行列、バウンディング ボックス フラグに対して有効。)スケールの照会時は、この計算は累積的なものであり、すべてが均等スケールで回転がない場合のみ有効になることに注意してください。不均等スケールと回転のある階層の場合、この値は認識されたグローバル スケールと正確に一致しない場合があります。
-worldSpaceDistance(-wd)
-sp、-rp、-st、-rt、-t、-piv フラグの値は、ワールド空間におけるローカル軸に沿った移動距離として扱われます。ローカル軸は、コマンドがローカル空間またはオブジェクト空間で機能しているかどうかによって異なります。このフラグは、ワールド空間では効果がありません。
-zeroTransformPivots(-ztp)
移動チャネルにこれらの値を適用することにより、行列全体を変更せずにピボット ポイントとピボットの移動をリセットします。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// create object to manipulate
sphere -n sphere1;

// set rotation of sphere
xform -r -ro 0 90 0;

// change the rotate order but preserve the overall transformation
xform -p true -roo yzx;