ジャンプ先: 概要. 戻り値. フラグ. Python 例.

概要

manipScaleContext( [object] , [activeHandle=int], [alignAlong=[float, float, float]], [constrainAlongNormal=boolean], [currentActiveHandle=int], [editPivotMode=boolean], [editPivotPosition=boolean], [exists=boolean], [image1=string], [image2=string], [image3=string], [lastMode=int], [manipVisible=boolean], [mode=int], [orientAxes=[float, float, float]], [orientObject=string], [orientTowards=[float, float, float]], [pinPivot=boolean], [pivotOriHandle=boolean], [position=boolean], [postCommand=script], [postDragCommand=[script, string]], [preCommand=script], [preDragCommand=[script, string]], [preserveChildPosition=boolean], [preserveUV=boolean], [preventNegativeScale=boolean], [reflection=boolean], [reflectionAbout=int], [reflectionAxis=int], [reflectionTolerance=float], [scale=[float, float, float]], [snap=boolean], [snapPivotOri=boolean], [snapPivotPos=boolean], [snapRelative=boolean], [snapValue=float], [tweakMode=boolean], [useManipPivot=boolean], [useObjectPivot=boolean], [xformConstraint=string])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

スケール マニピュレータ コンテキストの作成、編集、照会を実行するときに使用します。

戻り値

string(新しいコンテキストの名前)

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

フラグ

activeHandle, alignAlong, constrainAlongNormal, currentActiveHandle, editPivotMode, editPivotPosition, exists, image1, image2, image3, lastMode, manipVisible, mode, orientAxes, orientObject, orientTowards, pinPivot, pivotOriHandle, position, postCommand, postDragCommand, preCommand, preDragCommand, preserveChildPosition, preserveUV, preventNegativeScale, reflection, reflectionAbout, reflectionAxis, reflectionTolerance, scale, snap, snapPivotOri, snapPivotPos, snapRelative, snapValue, tweakMode, useManipPivot, useObjectPivot, xformConstraint
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
activeHandle(ah) int queryedit
マニピュレータの既定のアクティブ ハンドルを設定します。つまり、ツールを有効にしたとき最初にアクティブにするハンドルです。次の値を指定することができます。
  • 0 - X 軸ハンドルがアクティブ
  • 1 - Y 軸ハンドルがアクティブ
  • 2 - Z 軸ハンドルがアクティブ
  • 3 - 中央ハンドル(すべての軸)がアクティブ(既定)
alignAlong(aa) [float, float, float] createedit
アクティブ ハンドルをベクトルに沿って揃えます。
constrainAlongNormal(xn) boolean queryedit
true の場合は、最初に頂点法線方向にトランスフォーム コンストレイントが適用されます。法線方向に交差が検出されなかった場合は、最近接ポイントのみが使用されます。
currentActiveHandle(cah) int queryedit
マニピュレータのアクティブ ハンドルを設定します。次の値を指定することができます。
  • 0 - X 軸ハンドルがアクティブ
  • 1 - Y 軸ハンドルがアクティブ
  • 2 - Z 軸ハンドルがアクティブ
  • 3 - 中央ハンドル(すべての軸)がアクティブ
  • 4 - XY 平面ハンドルがアクティブ
  • 5 - YZ 平面ハンドルがアクティブ
  • 6 - XZ 平面ハンドルがアクティブ
editPivotMode(epm) boolean query
マニピュレータが編集ピボット モードにある場合は true を返します。
editPivotPosition(epp) boolean query
編集ピボット マニピュレータの現在位置を返します。
exists(ex) boolean create
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
image1(i1) string createqueryedit
コンテキストに関連付けられているツールを表す 3 つの可能なアイコンの中の最初のアイコンです。
image2(i2) string createqueryedit
コンテキストに関連付けられているツールを表す 3 つの可能なアイコンの中の 2 番目のアイコンです。
image3(i3) string createqueryedit
コンテキストに関連付けられているツールを表す 3 つの可能なアイコンの中の 3 番目のアイコンです。
lastMode(lm) int query
前のスケーリング モードを返します。
manipVisible(vis) boolean query
スケール マニピュレータが表示されている場合は true を返します。
mode(m) int queryedit
スケール モード:
  • 0 - オブジェクト空間
  • 1 - ローカル空間
  • 2 - ワールド空間(既定)
  • 3 - 頂点法線に沿ってスケール
  • 4 - 回転軸に沿ってスケール
  • 5 - ライブ オブジェクト軸に沿ってスケール
  • 6 - カスタム軸方向
  • 10 - コンポーネント空間
orientAxes(oa) [float, float, float] queryedit
軸を中心に回転するマニピュレータの向きを指定した角度だけ変えます。
orientObject(oo) string createedit
マニピュレータを、渡されたオブジェクト/コンポーネントの方向に位置合わせします。
orientTowards(ot) [float, float, float] createedit
アクティブ ハンドルをワールド ポイント方向へ向けます。
pinPivot(pin) boolean queryedit
コンポーネント ピボットを固定します。コンポーネント ピボットが設定され、固定されると、選択項目の変更によってピボットの位置と方向がリセットされなくなります。
pivotOriHandle(poh) boolean queryedit
true の場合は、編集中にピボット マニピュレータは方向ハンドルを表示します。既定は true です。
position(p) boolean query
マニピュレータの現在位置を返します。
postCommand(psc) script createedit
ツールを終了したときに実行されるコマンドを指定します。
postDragCommand(pod) [script, string] createedit
コマンドおよびノード タイプを指定します。このコマンドは、指定されたタイプのノードが選択範囲内に入っているときに、ドラッグを終了すると実行されます。
preCommand(prc) script createedit
ツールを開始したときに実行されるコマンドを指定します。
preDragCommand(prd) [script, string] createedit
コマンドおよびノード タイプを指定します。このコマンドは、指定されたタイプのノードが選択範囲内に入っているときに、ドラッグを開始すると実行されます。
preserveChildPosition(pcp) boolean queryedit
false の場合は、親が回転したときに子オブジェクトは移動します。true の場合は、親が移動しても子のワールド空間位置は維持されます。既定は false です。
preserveUV(puv) boolean queryedit
false の場合、uv は頂点の編集に合わせて変更されません。true の場合、頂点の移動につれてテクスチャがずれるのを止めるため、新しい値を投影するように uv が編集されます。
preventNegativeScale(pns) boolean query
これが true である場合、負のスケールは使用できません。
reflection(rfl) boolean
このフラグは現在サポートしていません。対称(Reflection)は、symmetricModeling コマンドを使用した選択自体の一部として管理されます。
reflectionAbout(rab) int
このフラグは現在サポートしていません。対称(Reflection)は、symmetricModeling コマンドを使用した選択自体の一部として管理されます。
reflectionAxis(rfa) int
このフラグは現在サポートしていません。対称(Reflection)は、symmetricModeling コマンドを使用した選択自体の一部として管理されます。
reflectionTolerance(rft) float
このフラグは現在サポートしていません。対称(Reflection)は、symmetricModeling コマンドを使用した選択自体の一部として管理されます。
scale(sc) [float, float, float] queryedit
マニピュレータの現在の方向/モードのスケールを返します。
snap(s) boolean createqueryedit
操作で絶対スナップを使用することを指定します。
snapPivotOri(spo) boolean queryedit
ピボットのスナップ方向です。ピボットをコンポーネントにスナップする場合のピボット方向を変更します。
snapPivotPos(spp) boolean queryedit
ピボットのスナップ位置です。ピボットをコンポーネントにスナップする場合のピボット位置を変更します。
snapRelative(sr) boolean createqueryedit
操作で相対スナップを使用することを指定します。
snapValue(sv) float createqueryedit
スナップ値を指定します。
tweakMode(twk) boolean queryedit
True にすると、マニピュレータが非表示になり、ハイライト表示されたコンポーネントを選択できるようになります。これをクリック & ドラッグ操作による 1 回のステップでスケールすることができます。
useManipPivot(ump) boolean createqueryedit
マニピュレータ上でピボットするかどうかを指定します。
useObjectPivot(uop) boolean createqueryedit
オブジェクト上でピボットするかどうかを指定します。
xformConstraint(xc) string queryedit
  • none - トランスフォーム コンストレイントなし
  • edge - エッジ トランスフォーム コンストレイント
  • surface - サーフェス トランスフォーム コンストレイント

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# To create a new scale context:
cmds.manipScaleContext()

# To query the active handle of an existing scale context:
cmds.manipScaleContext( 'manipScaleContext1', q=True, ah=True )

# To edit an exiting scale context so that it comes up with the X axis
# handle active by default:
cmds.manipScaleContext( 'manipScaleContext1', e=True, ah=0 )