animCurveEditor

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

概要

animCurveEditor( editorName , [areCurvesSelected=boolean], [autoFit=string], [autoFitTime=string], [classicMode=boolean], [clipTime=string], [constrainDrag=uint], [control=boolean], [curvesShown=boolean], [curvesShownForceUpdate=boolean], [defineTemplate=string], [denormalizeCurvesCommand=string], [displayActiveKeyTangents=string], [displayActiveKeys=string], [displayInfinities=string], [displayKeys=string], [displayNormalized=boolean], [displayTangents=string], [displayValues=string], [docTag=string], [exists=boolean], [filter=string], [forceMainConnection=string], [highlightAffectedCurves=boolean], [highlightConnection=string], [keyingTime=string], [lockMainConnection=boolean], [lockPlayRangeShades=string], [lookAt=string], [mainListConnection=string], [menu=script], [normalizeCurvesCommand=string], [outliner=string], [panel=string], [parent=string], [preSelectionHighlight=boolean], [renormalizeCurves=boolean], [resultSamples=time], [resultScreenSamples=int], [resultUpdate=string], [selectionConnection=string], [showActiveCurveNames=boolean], [showBufferCurves=string], [showCurveNames=boolean], [showPlayRangeShades=string], [showResults=string], [showUpstreamCurves=boolean], [simpleKeyView=boolean], [smoothness=string], [snapTime=string], [snapValue=string], [stackedCurves=boolean], [stackedCurvesMax=float], [stackedCurvesMin=float], [stackedCurvesSpace=float], [stateString=boolean], [timelinePositionTop=boolean], [unParent=boolean], [unlockMainConnection=boolean], [updateMainConnection=boolean], [useTemplate=string], [valueLinesToggle=string])

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

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

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
areCurvesSelected(acs)	boolean
グラフ エディタで、少なくとも 1 つのカーブが選択されていることを確認するためのブール値を返します。
autoFit(af)	string
on | off | tgl はビューへの自動フィットのオン/オフを切り替えます。
autoFitTime(aft)	string
on | off | tgl は時間軸に沿ってビューへの自動フィットのオン/オフも切り替えます。
classicMode(cm)	boolean
オンのとき、グラフ エディタは「クラシック モード」で表示され、オフのときは「スィート モード」が使用されます。
clipTime(ct)	string
有効な値:「on」、「off」 クリップ内のアニメーション カーブに適用されたオフセットとスケールを持つクリップを表示します。
constrainDrag(cd)	uint
グラフ エディタでの、すべてのアニメーション カーブのドラッグ操作を、X 軸または Y 軸にコンストレイントするか、どちらの軸にもコンストレイントしないよう設定します。指定する値は、どちらの軸にもコンストレイントしない場合 0、X 軸にコンストレイントする場合 1、Y 軸にコンストレイントする場合 2 です。照会時に使用すると、このフラグは後の方の値を返します。値の解釈は前述の場合と同じです。注: アニメーション カーブをドラッグする前に Shift キーを押すと、最初のマウス動作で、ここで説明した動作に代わって以前に設定されたコンストレイント済みの軸を調べ、オーバーライドします。
control(ctl)	boolean
照会モード専用です。このエディタの最上位のコントロールを返します。通常は、親を取得してポップアップ メニューをアタッチするために使用します。注意: コントロールのないエディタが存在する場合があります。コントロールが存在しない場合は、この照会は NONE を返します。
curvesShown(cs)	boolean
現在、グラフ エディタ(Graph Editor)で表示されているアニメーション カーブ ノードの名前を含む文字配列を返します。
curvesShownForceUpdate(csf)	boolean
現在、グラフ エディタ(Graph Editor)で表示されているアニメーション カーブ ノードの名前を含む文字配列を返します。curvesShown フラグとは異なり、最後にリフレッシュされた後に mainListConnection が変更された場合、グラフ エディタを強制的に更新します。
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。 templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
denormalizeCurvesCommand(dcc)	string
グラフ エディタ(Graph Editor)でカーブを非正規化するために実行するスクリプトを設定します。Maya 内部での使用に限られます。
displayActiveKeyTangents(dat)	string
on | off | tgl はエディタのアクティブ キー接線の表示/非表示を切り替えます。
displayActiveKeys(dak)	string
on | off | tgl はエディタのアクティブ キーの表示/非表示を切り替えます。
displayInfinities(di)	string
on | off | tgl はエディタのインフィニティの表示/非表示を切り替えます。
displayKeys(dk)	string
on | off | tgl はエディタのキーフレームの表示/非表示を切り替えます。
displayNormalized(dn)	boolean
オンにすると、すべてのカーブは -1 ～ +1 の範囲に正規化して表示されます。
displayTangents(dtn)	string
on | off | tgl はエディタの接線の表示/非表示を切り替えます。
displayValues(dv)	string
on | off | tgl はエディタのアクティブ キーおよび接線の値の表示/非表示を切り替えます。
docTag(dtg)	string
エディタにタグをアタッチします。
exists(ex)	boolean
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
filter(f)	string
このエディタに使用する項目フィルタ オブジェクトの名前を指定します。エディタの主要リストに表示される情報をフィルタします。
forceMainConnection(fmc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。これは -mainListConnection フラグの変形で、接続がロックされている場合でも強制的に変更します。このフラグを使用して、-unlockMainConnection、-mainListConnection、-lockMainConnection フラグを直後に連続して使用する場合に、オーバーヘッドを減します。
highlightAffectedCurves(hac)	boolean
オンにすると、選択したキー/接線の影響を受けるカーブ セグメントがハイライトされます。
highlightConnection(hlc)	string
そのハイライト リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。すべてのエディタにハイライト リストがあるわけではありません。ハイライト リストがあるエディタの場合、これは第二の選択項目を表示したリストになります。
keyingTime(kt)	string
グラフ エディタでキー設定される、指定されたカーブの現在のタイム。
lockMainConnection(lck)	boolean
mainConnection 内のオブジェクトの現在のリストをロックして、そのオブジェクトだけがエディタ内に表示されるようにします。これ以降、元の mainConnection に変更を加えても無視されます。
lockPlayRangeShades(lpr)	string
有効な値: 「on」、「off」、「tgl」 再生範囲のシェーディングをロックします。
lookAt(la)	string
FitView ヘルパーを、「all」、「selected」、「currentTime」のいずれかで指定できます。
mainListConnection(mlc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。
menu(m)	script
エディタの作成時に実行されるスクリプトを指定します。関数は、新しいエディタの名前である文字列引数を渡します。
normalizeCurvesCommand(ncc)	string
グラフ エディタ(Graph Editor)でカーブを非正規化するために実行するスクリプトを設定します。Maya 内部での使用に限られます。
outliner(o)	string
グラフ エディタ(Graph Editor)に関連するアウトライナ(Outliner)の名前です。
panel(pnl)	string
このエディタ用のパネルを指定します。既定では、エディタがスクリプト パネルの作成コールバックで作成された場合、エディタはそのパネルに属します。エディタがパネルに属していない場合、エディタのあるウィンドウを削除するとエディタも削除されます。
parent(p)	string
このエディタの親のレイアウトを指定します。このフラグは、エディタが現在ペアレント化されていない場合のみに効果があります。
preSelectionHighlight(psh)	boolean
オンにすると、マウス ポインタの下にあるカーブ/キー/接線が選択しやすいようにハイライトされます。
renormalizeCurves(rnc)	boolean
このフラグを使用すると、カーブの正規化係数が再計算されます。
resultSamples(rs)	time
結果のカーブのサンプリングを指定します 注: この数値が小さければ小さいほど、ディスプレイの更新にかかる時間が長くなります
resultScreenSamples(rss)	int
結果のカーブに対するスクリーン ベースの結果サンプリングを指定します。0 の場合、結果は時間内にサンプリングされます。
resultUpdate(ru)	string
有効な値:「interactive」、「delayed」 アニメーション カーブに対する変更が結果のカーブにどのように反映されるかをコントロールします(結果が表示される場合)。resultUpdate が「interactive」の場合、アニメーション カーブはインタラクティブに変更されて、結果のカーブが更新されます。modelUpdate が「delayed」の場合(これは既定設定です)、結果のカーブはアニメーション カーブへの最終的な変更が行われたときに更新されます。
selectionConnection(slc)	string
その独自のセレクション リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。このエディタから選択する場合、selectionConnection オブジェクトの中から選択します。オブジェクトが変更されると、エディタが更新されて変更が反映されます。
showActiveCurveNames(acn)	boolean
アクティブ カーブ名を表示します。
showBufferCurves(sb)	string
有効な値:「on」、「off」、「tgl」 バッファ カーブを表示します。
showCurveNames(scn)	boolean
カーブ名を表示します。
showPlayRangeShades(spr)	string
有効な値: 「on」、「off」、「tgl」 再生範囲のシェーディングを表示します。
showResults(sr)	string
有効な値:「on」、「off」、「tgl」 エクスプレッション、またはその他のキー設定されていないアクションの結果のカーブを表示します。
showUpstreamCurves(suc)	boolean
true の場合は、ディペンデンシー グラフを上流に向かって選択済みプラグをドライブするすべてのカーブを検索します(たとえば、通常のドリブン キー セットアップでは複数のカーブが表示されますが、最初にドリブン キー カーブが見つかり、それからソース オブジェクトをドライブする実際のアニメーション カーブが見つかります)。false の場合は、見つかった最初のカーブのみが表示されます。false の場合でも、たとえば blendWeighted ノードを使用して複数のカーブを結合すれば、複数のカーブを表示できます。
simpleKeyView(skv)	boolean
on | off は、より単純で小さなキーの表示を切り替えます。
smoothness(s)	string
有効な値:「coarse」、「rough」、「medium」、「fine」 アニメーション カーブの表示の平滑性を指定します。
snapTime(st)	string
時間におけるキーフレームの移動スナップを「none」、「integer」、「keyframe」のいずれかで指定できます。
snapValue(sv)	string
値におけるキーフレームの移動スナップを「none」、「integer」、「keyframe」のいずれかで指定できます。
stackedCurves(sc)	boolean
法線間(軸のセットを共有するすべてのカーブ)で表示モードを切り替えてスタックさせます(各カーブをその値の軸上に、垂直方向にスタック)。
stackedCurvesMax(scx)	float
スタック モードの場合に、カーブごとの値の軸に最大値を設定します。
stackedCurvesMin(scm)	float
スタック モードの場合に、カーブごとの値の軸に最小値を設定します。
stackedCurvesSpace(scs)	float
スタック モードの場合に、カーブの間隔を設定します。
stateString(sts)	boolean
照会モード専用のフラグです。エディタを作成して現在のエディタの状態と一致させる MEL コマンドを返します。返されたコマンド文字列は、指定した名前の代わりに文字列変数 $editorName を使用します。
timelinePositionTop(tlp)	boolean
on | off | tgl は、上部または下部のタイムライン表示を切り替えます。
unParent(up)	boolean
エディタをそのレイアウトから除去するように指定します。これは照会モードでは使用できません。
unlockMainConnection(ulk)	boolean
mainConnection をロック解除して、オリジナルの mainConnection (まだ使用可能な場合)を効率的に復元し、ダイナミックな更新を行います。
updateMainConnection(upd)	boolean
ロックされた mainConnection をオリジナルの mainConnection から更新させますが、ロック状態は保持されます。
useTemplate(ut)	string
コマンドに、現在のものとは異なるコマンド テンプレートを使用するように強制します。
valueLinesToggle(vlt)	string
on | off | tgl は、エディタで選択したカーブの高/低/ゼロの値の行を表示します。

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

Python 例

import maya.cmds as cmds

# Check to see if the "default" graph editor has been created
#
cmds.animCurveEditor( 'graphEditor1GraphEd', exists=True )
# Show result curves
#
cmds.animCurveEditor( 'graphEditor1GraphEd', edit=True, showResults='on' )
# Show Play Range Shades
#
cmds.animCurveEditor( 'graphEditor1GraphEd', edit=True, showPlayRangeShades='on' )
# Lock Play Range Shades
#
cmds.animCurveEditor( 'graphEditor1GraphEd', edit=True, lockPlayRangeShades='on' )
# Decrease the sampling rate for the result curves
#
cmds.animCurveEditor( 'graphEditor1GraphEd', edit=True, resultSamples=5 )

# Constrain all Graph Editor animation curve traversals to the X-axis
#
cmds.animCurveEditor( 'graphEditor1GraphEd', edit=True, constrainDrag=1 )