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] [-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 は、取り消し可能、照会可能、および編集不可能です。

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

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

また、アトリビュートは「フラグ」セクションに記述された順番に適用され、値を返します。(この順番は下記の変換行列に表示されている順序に対応しています。)

関連項目: move、rotate、scale

注

-1                       -1
[M]  = [sp]x[s]x[sh]x[sp]x[st]x[rp]x[ar]x[ro]x[rp]x[rt]x[t]

ここで:

[sp] = |  1      0        0       0 | = スケール ピボット行列
|  0      1        0       0 |
|  0      0        1       0 |
| -spx   -spy     -spz     1 |


[s]  = |  sx     0        0       0 | = スケール行列
|  0      sy       0       0 |
|  0      0        sz      0 |
|  0      0        0       1 |


[sh] = |  1      0        0       0 | = シア行列
|  xy     1        0       0 |
|  xz     yz       1       0 |
|  0      0        0       1 |

-1
[sp] = |  1       0       0       0 | = スケール ピボット逆行列
|  0       1       0       0 |
|  0       0       1       0 |
|  spx     spy     spz     1 |


[st] = |  1       0       0       0 | = スケール移動行列
|  0       1       0       0 |
|  0       0       1       0 |
|  stx     sty     stz     1 |


[rp] = |  1       0       0       0 | = 回転ピボット行列
|  0       1       0       0 |
|  0       0       1       0 |
| -rpx    -rpy    -rpz     1 |


[ar] = |  *       *       *       0 | = 軸回転行列
|  *       *       *       0 |   (合成回転、詳細は
|  *       *       *       0 |    以下の[rx]、
|  0       0       0       1 |    [ry]、[rz]を参照)


[rx] = |  1       0       0       0 | = 回転 X 行列
|  0       cos(x)  sin(x)  0 |
|  0      -sin(x)  cos(x)  0 |
|  0       0       0       1 |


[ry] = |  cos(y)  0      -sin(y)  0 | = 回転 Y 行列 
|  0       1       0       0 |
|  sin(y)  0       cos(y)  0 |
|  0       0       0       1 |


[rz] = |  cos(z)  sin(z)  0       0 | = 回転 Z 行列
| -sin(z)  cos(z)  0       0 |
|  0       0       1       0 |
|  0       0       0       1 |

-1
[rp] = |  1       0       0       0 | = 回転ピボット行列
|  0       1       0       0 |
|  0       0       1       0 |
|  rpx     rpy     rpz     1 |


[rt] = |  1       0       0       0 | = 回転移動行列
|  0       1       0       0 |
|  0       0       1       0 |
|  rtx     rty     rtz     1 |


[t]  = |  1       0       0       0 | =  移動行列
|  0       1       0       0 |
|  0       0       1       0 |
|  tx      ty      tz      1 |

戻り値

なし

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

関連

フラグ

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