dynPaintEditor

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

概要

dynPaintEditor( editorName , [activeOnly=boolean], [autoSave=boolean], [camera=string], [canvasMode=boolean], [canvasUndo=boolean], [changeCommand=[string, string, string, string]], [clear=[float, float, float]], [control=boolean], [currentCanvasSize=boolean], [defineTemplate=string], [displayAppearance=string], [displayFog=boolean], [displayImage=int], [displayLights=string], [displayStyle=string], [displayTextures=boolean], [docTag=string], [doubleBuffer=boolean], [drawAxis=boolean], [drawContext=boolean], [exists=boolean], [fileName=string], [filter=string], [forceMainConnection=string], [highlightConnection=string], [iconGrab=boolean], [loadImage=string], [lockMainConnection=boolean], [mainListConnection=string], [menu=string], [nbImages=boolean], [newImage=[int, int, float, float, float]], [paintAll=float], [panel=string], [parent=string], [redrawLast=boolean], [refresh=boolean], [refreshMode=int], [removeAllImages=boolean], [removeImage=boolean], [rollImage=[float, float]], [saveAlpha=boolean], [saveBumpmap=string], [saveImage=boolean], [scaleBlue=float], [scaleGreen=float], [scaleRed=float], [selectionConnection=string], [singleBuffer=boolean], [snapShot=boolean], [stateString=boolean], [tileSize=int], [unParent=boolean], [undoCache=boolean], [unlockMainConnection=boolean], [updateMainConnection=boolean], [useTemplate=string], [wrap=[boolean, boolean]], [writeImage=string], [zoom=float])

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

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

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
activeOnly(ao)	boolean
シーン モードの場合、アクティブなストロークのみをリフレッシュするかどうかが決まります。
autoSave(autoSave)	boolean
キャンバス モードの場合、各ストローク後にバッファをディスク ファイルに保存するかどうかが決まります。モデル ビューのシェーディング表示で、テクスチャのペイントと結果の表示を行う場合に適しています。
camera(cam)	string
ペイント エフェクト パネルが見通すカメラの名前が設定されます。
canvasMode(cm)	boolean
true にすると、ペイント エフェクト パネルがキャンバス モードに設定されます。
canvasUndo(cu)	boolean
キャンバス モードで元に戻すアクションが高速で実行されます。キャンバス モードでペイントする場合はヒストリが使用されないので、特殊な元に戻すアクションになります。キャンバスでは 1 レベルの元に戻すアクションを実行できます。
changeCommand(cc)	[string, string, string, string]
パラメータ: 先頭文字列: command 2 番目の文字列: editorName 3 番目の文字列: editorCmd 4 番目の文字列: updateFunc エディタで何らかの変更を行う場合にこのコマンドをコールします。このコマンドの基本形は次のとおりです: command(string $editor, string $editorCmd, string $updateFunc, int $reason) 考えられる理由は次のとおりです。 0: 特に理由なし 1: スケール カラー 2: バッファ(シングル/ダブル) 3: 軸 4: 表示されたイメージ 5: メモリに保存されたイメージ
clear(cl)	[float, float, float]
キャンバス モードでは、バッファが浮動小数点値(R,G,B)にクリアされます。
control(ctl)	boolean
照会モード専用です。このエディタの最上位のコントロールを返します。通常は、親を取得してポップアップ メニューをアタッチするために使用します。注意: コントロールのないエディタが存在する場合があります。コントロールが存在しない場合は、この照会は NONE を返します。
currentCanvasSize(ccs)	boolean
照会モードでは、現在のキャンバスの解像度(X,Y)が返されます。
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
displayAppearance(dsa)	string
モデル パネルの表示の外観を設定します。有効な値は、「wireframe」、「points」、「boundingBox」、「smoothShaded」、「flatShaded」です。このフラグは、-interactive フラグと -default フラグと一緒に使用できます。インタラクティブ モードでは、「wireframe」、「points」、「boundingBox」のみが有効であることに注意してください。
displayFog(dfg)	boolean
シーン モードの場合、シーンをリフレッシュした際にペイント エフェクト パネルでフォグを表示するかどうかが決まります。フォグをオンにしてこのフラグをオフにすると、フォグはストローク上には描画されますが、シーンの残りでは描画されません。
displayImage(di)	int
特定のイメージをエディタ イメージ スタック(Editor Image Stack)で現在のエディタ イメージ(Editor Image)として設定します。イメージは、「si/saveImage」フラグを使用して Editor Image Stack に追加されます。
displayLights(dsl)	string
シェーディング モード用にライティングを設定します。有効な値は、「selected」、「active」、「all」、「default」です。
displayStyle(dst)	string
イメージを表示するモードを設定します。有効な値は、 基本 RGB イメージを表示する場合は「カラー」 マスク チャネルを表示する場合は「マスク」 イメージの輝度を表示する場合は「輝度」
displayTextures(dtx)	boolean
シェーディング モードでのテクスチャの表示をオンまたはオフにします。
docTag(dtg)	string
エディタにタグをアタッチします。
doubleBuffer(dbf)	boolean
表示をダブル バッファ モードに設定します。
drawAxis(da)	boolean
軸が描画されるかどうかを設定または照会します。
drawContext(drc)	boolean
コンテキストの名前が返されます。
exists(ex)	boolean
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
fileName(fil)	string
キャンバスを保存するファイルが設定されます。
filter(f)	string
このエディタに使用する項目フィルタ オブジェクトの名前を指定します。エディタの主要リストに表示される情報をフィルタします。
forceMainConnection(fmc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。これは -mainListConnection フラグの変形で、接続がロックされている場合でも強制的に変更します。このフラグを使用して、-unlockMainConnection、-mainListConnection、-lockMainConnection フラグを直後に連続して使用する場合に、オーバーヘッドを減します。
highlightConnection(hlc)	string
そのハイライト リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。すべてのエディタにハイライト リストがあるわけではありません。ハイライト リストがあるエディタの場合、これは第二の選択項目を表示したリストになります。
iconGrab(ig)	boolean
ペイント エフェクト パネルがアイコン グラブ モードになります。このモードでは、ユーザが画面の一部をドラッグしてアイコンにします。
loadImage(li)	string
ディスクからイメージをロードして現在のエディタ イメージとして設定します。
lockMainConnection(lck)	boolean
mainConnection 内のオブジェクトの現在のリストをロックして、そのオブジェクトだけがエディタ内に表示されるようにします。これ以降、元の mainConnection に変更を加えても無視されます。
mainListConnection(mlc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。
menu(mn)	string
エディタ内でメニューを構築するために使用するスクリプトの名前が設定されます。スクリプトはエディタ名を引数として取ります。
nbImages(nim)	boolean
イメージの数を返します。
newImage(ni)	[int, int, float, float, float]
新しいイメージが編集モードで起動され、解像度が整数値(X,Y)に設定されてバッファが浮動小数点値(R,G,B)にクリアされます。照会モードでは、現在のイメージの解像度(X,Y)が返されます。
paintAll(pa)	float
現在のリフレッシュ モードでバッファが再描画されます。
panel(pnl)	string
このエディタ用のパネルを指定します。既定では、エディタがスクリプト パネルの作成コールバックで作成された場合、エディタはそのパネルに属します。エディタがパネルに属していない場合、エディタのあるウィンドウを削除するとエディタも削除されます。
parent(p)	string
このエディタの親のレイアウトを指定します。このフラグは、エディタが現在ペアレント化されていない場合のみに効果があります。
redrawLast(rl)	boolean
最後のストロークが再描画されます。これはブラシを変更した場合に便利です。この機能では、元に戻すアクションが高速で実行されてからストロークが再描画されます。
refresh(ref)	boolean
現在のエディタ イメージのリフレッシュを要求します。
refreshMode(rmd)	int
指定した値にリフレッシュ モードが設定されます。0 - リフレッシュ時にストロークが描画されません。1 - ワイヤフレーム モードでストロークが再描画されます。2 - 最終レンダー モードでストロークが再描画されます。
removeAllImages(ra)	boolean
Editor Image Stack からすべての Editor Image を除去します。
removeImage(ri)	boolean
Editor Image Stack から現在の Editor Image を除去します。
rollImage(rig)	[float, float]
キャンバス モードの場合、浮動小数点値(X,Y)でイメージがロールされます。X と Y は、0 (ロールなし)から 1 (完全なロール)の間で指定できます。値を 0.5 にすると、イメージは 50% ロールされます（つまり、境界がスクリーンの中央に移動します）。
saveAlpha(sa)	boolean
キャンバス モードの場合、キャンバスをディスク ファイルに保存する際にアルファを保存するかどうかが決まります。
saveBumpmap(sbm)	string
指定したファイルに現在のバッファがバンプ マップとして保存されます。
saveImage(si)	boolean
メモリに現在の Editor Image を保存します。保存されたエディタ イメージは、エディタ イメージ スタックに格納されます。最も新しく保存したイメージは 0 の位置に、次に新しく保存したイメージは 1 の位置、などと格納されます。現在のエディタ イメージを前に保存したイメージに設定するには、「di/displayImage」フラグを使用します。
scaleBlue(sb)	float
ビュー内の青の成分のスケーリング係数を定義します。既定値は 1 で、-1000 から +1000 までが可能です。
scaleGreen(sg)	float
ビュー内の緑の成分のスケーリング係数を定義します。既定値は 1 で、-1000 から +1000 までが可能です。
scaleRed(sr)	float
ビュー内の赤の成分のスケーリング係数を定義します。既定値は 1 で、-1000 から +1000 までが可能です。
selectionConnection(slc)	string
その独自のセレクション リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。このエディタから選択する場合、selectionConnection オブジェクトの中から選択します。オブジェクトが変更されると、エディタが更新されて変更が反映されます。
singleBuffer(sbf)	boolean
表示をシングル バッファ モードに設定します。
snapShot(snp)	boolean
現在のカメラ ビューのスナップショットが取られます。
stateString(sts)	boolean
照会モード専用のフラグです。エディタを作成して現在のエディタの状態と一致させる MEL コマンドを返します。返されたコマンド文字列は、指定した名前の代わりに文字列変数 $editorName を使用します。
tileSize(ts)	int
表示バッファのハードウェア テクスチャ再描画のタイル サイズが設定されます。
unParent(up)	boolean
エディタをそのレイアウトから除去するように指定します。これは照会モードでは使用できません。
undoCache(uc)	boolean
既定では、最後のイメージが元に戻す用にキャッシュされます。false に設定すると、キャンバス モードでの元に戻すが無効になり、シーン モードでの元に戻すでは強制的に完全なリフレッシュが適用されます。現在のシーンの最初のクリアまたはリフレッシュを行う前に false に設定すると、メモリの使用量が少なくてすみます。
unlockMainConnection(ulk)	boolean
mainConnection をロック解除して、オリジナルの mainConnection (まだ使用可能な場合)を効率的に復元し、ダイナミックな更新を行います。
updateMainConnection(upd)	boolean
ロックされた mainConnection をオリジナルの mainConnection から更新させますが、ロック状態は保持されます。
useTemplate(ut)	string
コマンドに、現在以外のコマンド テンプレートの使用を強制します。
wrap(wr)	[boolean, boolean]
キャンバス モードでは、ペイントする際に U と V でバッファをラップします。
writeImage(wi)	string
ディスクに現在のエディタ イメージを書き込みます。
zoom(zm)	float
指定した値でキャンバス イメージがズームされます。

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

Python 例

import maya.cmds as cmds

cmds.dynPaintEditor( 'editor' )

cmds.dynPaintEditor( 'editor', e=True, ni=(640, 480, 1.0, 0.5, 0.2) )