renderWindowEditor

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

概要

renderWindowEditor( editorName , [autoResize=boolean], [blendMode=int], [caption=string], [changeCommand=[string, string, string, string]], [clear=[int, int, float, float, float]], [cmEnabled=boolean], [colorManage=boolean], [compDisplay=int], [compImageFile=string], [control=boolean], [currentCamera=string], [currentCameraRig=string], [defineTemplate=string], [displayImage=int], [displayImageViewCount=int], [displayStyle=string], [docTag=string], [doubleBuffer=boolean], [drawAxis=boolean], [editorName=boolean], [exists=boolean], [exposure=float], [filter=string], [forceMainConnection=string], [frameImage=boolean], [frameRegion=boolean], [gamma=float], [highlightConnection=string], [loadImage=string], [lockMainConnection=boolean], [mainListConnection=string], [marquee=[float, float, float, float]], [nbImages=boolean], [nextViewImage=boolean], [outputColorManage=boolean], [panel=string], [parent=string], [pcaption=string], [realSize=boolean], [refresh=boolean], [removeAllImages=boolean], [removeImage=boolean], [resetRegion=boolean], [resetViewImage=boolean], [saveImage=boolean], [scaleBlue=float], [scaleGreen=float], [scaleRed=float], [selectionConnection=string], [showRegion=[int, int]], [singleBuffer=boolean], [snapshot=[string, int, int]], [snapshotMode=boolean], [stateString=boolean], [stereo=int], [stereoImageOrientation=[string, string]], [stereoMode=string], [toggle=boolean], [unParent=boolean], [unlockMainConnection=boolean], [updateMainConnection=boolean], [useTemplate=string], [viewImageCount=int], [viewTransformName=string], [writeImage=string])

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

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

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
autoResize(ar)	boolean
レンダー ビュー エディタがビューポートのサイズを自動的に変更するかしないかを設定します。
blendMode(blm)	int
レンダー ビューをブレンド モードに設定します。レンダー ビューに送信された新しいイメージがレンダー ビューで前のイメージとブレンドされて、合成されたイメージが表示されます。
caption(cap)	string
レンダー ビューの下部に表示されるキャプションを設定します。
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)	[int, int, float, float, float]
指定した解像度、指定したカラーで、画像を鮮明にします。引数はそれぞれ幅、高さ、赤、緑、青です。
cmEnabled(cme)	boolean
ビューでのカラー管理の適用をオンまたはオフにします。設定すると、現在のビューに設定されているカラー管理設定が使用されます。
colorManage(com)	boolean
writeImage フラグと一緒に使用すると、書き込まれたイメージはビューに付属するビュー カラー マネージャの設定を使用してカラー管理されます。
compDisplay(cd)	int
0: 合成を無効にします。 1: 合成されたイメージを直ちに表示します。 たとえば、フォアグラウンド レイヤ タイルがレンダー ビュー ウィンドウに送信された場合、合成されたタイルがレンダー ビュー ウィンドウに表示され、元のフォアグラウンド レイヤ タイルは表示されません。 2: 合成されていないイメージが表示され、その後のコマンドのために合成されたイメージを保持します。 たとえば、フォアグラウンド レイヤ タイルがレンダー ビュー ウィンドウに送信された場合、元のフォアグラウンド レイヤ タイルは表示されず、合成されたタイルはバッファに格納されます。 3: 現在の合成されたイメージを表示します。合成されたイメージがバッファに存在する場合は、これを表示します。
compImageFile(cif)	string
指定したイメージ ファイルを開き、イメージをレンダーする場合と同様にバッファでブレンドします。
control(ctl)	boolean
照会モード専用です。このエディタの最上位のコントロールを返します。通常は、親を取得してポップアップ メニューをアタッチするために使用します。注意: コントロールのないエディタが存在する場合があります。コントロールが存在しない場合は、この照会は NONE を返します。
currentCamera(crc)	string
現在のカメラを取得または設定します(直前のレンダーを再実行するときに使用)。
currentCameraRig(crg)	string
現在のカメラのリグの名前を取得または設定します。カメラ リグが指定されている場合、currentCamera の値とは対照的に、最後のレンダリングを再実行するときに使用されます。currentCamera の値は、カメラ リグのレンダリングに最後に使用された子カメラを保持します。
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。 templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
displayImage(di)	int
特定のイメージをエディタ イメージ スタックで現在のエディタ イメージとして設定します。イメージは、「si/saveImage」フラグを使用してエディタ イメージ スタックに追加されます。
displayImageViewCount(dvc)	int
指定したイメージに対して格納されたビューの数をエディタ イメージ スタックに照会します。これは、現在のレンダリング イメージに対するビューの数を返す「viewImageCount」を使用した照会とは異なります。
displayStyle(dst)	string
イメージを表示するモードを設定します。有効な値は、 基本 RGB イメージを表示する場合は「カラー」 マスク チャネルを表示する場合は「マスク」 イメージの輝度を表示する場合は「輝度」
docTag(dtg)	string
エディタにタグをアタッチします。
doubleBuffer(dbf)	boolean
表示をダブル バッファ モードに設定します。
drawAxis(da)	boolean
軸が描画されるかどうかを設定または照会します。
editorName(en)	boolean
エディタの名前を返します。エディタがまだ作成されていない場合は、空の文字列を返します。
exists(ex)	boolean
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
exposure(exp)	float
現在のビューのカラー管理に使用される露出値です。
filter(f)	string
このエディタに使用する項目フィルタ オブジェクトの名前を指定します。エディタの主要リストに表示される情報をフィルタします。
forceMainConnection(fmc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。これは -mainListConnection フラグの変形で、接続がロックされている場合でも強制的に変更します。このフラグを使用して、-unlockMainConnection、-mainListConnection、-lockMainConnection フラグを直後に連続して使用する場合に、オーバーヘッドを減します。
frameImage(fi)	boolean
画像をウィンドウの中に収めます。
frameRegion(fr)	boolean
領域をウィンドウの中に収めます。
gamma(ga)	float
現在のビューのカラー管理に使用されるガンマ値です。
highlightConnection(hlc)	string
そのハイライト リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。すべてのエディタにハイライト リストがあるわけではありません。ハイライト リストがあるエディタの場合、これは第二の選択項目を表示したリストになります。
loadImage(li)	string
ディスクからイメージをロードして現在のエディタ イメージとして設定します。
lockMainConnection(lck)	boolean
mainConnection 内のオブジェクトの現在のリストをロックして、そのオブジェクトだけがエディタ内に表示されるようにします。これ以降、元の mainConnection に変更を加えても無視されます。
mainListConnection(mlc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。
marquee(mq)	[float, float, float, float]
引数は長方形の 4 つのコーナー(左、右、下、上)を定義します。この長方形はレンダー計算のセレクション ボックスを定義します。
nbImages(nim)	boolean
イメージの数を返します。
nextViewImage(nvi)	boolean
レンダー エディタは、単一ビューの中で複数のカメラをレンダリングすることができます。これはイメージが保存されるイメージ ビニングとは異なります。2 つの異なるカメラ レンダーを隣り合わせに並べて比較するには、複数のイメージ ビューが便利です。nextViewImage フラグを使用すると、エディタに対して、内部格納メカニズムの準備を行って次のビュー位置に格納するよう通知されます。
outputColorManage(ocm)	boolean
writeImage フラグと一緒に使用すると、書き込まれたイメージは、ビューにアタッチされたカラー プリファレンス内の出力カラー スペースを使用してカラー管理されます。
panel(pnl)	string
このエディタ用のパネルを指定します。既定では、エディタがスクリプト パネルの作成コールバックで作成された場合、エディタはそのパネルに属します。エディタがパネルに属していない場合、エディタのあるウィンドウを削除するとエディタも削除されます。
parent(p)	string
このエディタの親のレイアウトを指定します。このフラグは、エディタが現在ペアレント化されていない場合のみに効果があります。
pcaption(pca)	string
現在、レンダー エディタに表示されているイメージの下に表示される恒久的なキャプションを取得または設定します。
realSize(rs)	boolean
画像をピクセル等倍で表示します。
refresh(ref)	boolean
現在のエディタ イメージのリフレッシュを要求します。
removeAllImages(ra)	boolean
エディタ イメージ スタックからすべてのエディタ イメージを除去します。
removeImage(ri)	boolean
エディタ イメージ スタックから現在のエディタ イメージを除去します。
resetRegion(rr)	boolean
マーキー/領域を強制的にリセットします。
resetViewImage(rvi)	boolean
レンダー エディタは、単一ビューの中で複数のカメラをレンダリングすることができます。これはイメージが保存されるイメージ ビニングとは異なります。2 つの異なるカメラ レンダーを隣り合わせに並べて比較するには、複数のイメージ ビューが便利です。resetViewImage フラグを使用すると、エディタの内部格納メカニズムを最初のイメージにリセットすることができます。これはレンダー ビュー レンダーの一番最初に行われます。
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 オブジェクトの中から選択します。オブジェクトが変更されると、エディタが更新されて変更が反映されます。
showRegion(srg)	[int, int]
指定した解像度で現在の領域を表示します。2 つのパラメータは幅と高さを定義します。
singleBuffer(sbf)	boolean
表示をシングル バッファ モードに設定します。
snapshot(snp)	[string, int, int]
指定したサイズでモデル エディタのカメラのコピーを作成します。最初の引数はエディタ名、2 番目は幅、3 番目は高さです。
snapshotMode(snm)	boolean
ウィンドウのスナップショット モードを取得または設定します。
stateString(sts)	boolean
照会モード専用のフラグです。エディタを作成して現在のエディタの状態と一致させる MEL コマンドを返します。返されたコマンド文字列は、指定した名前の代わりに文字列変数 $editorName を使用します。
stereo(s)	int
エディタを立体視イメージ モードにします。出力イメージの解像度を水平サイズの 2 倍にすると効果的です。イメージの方向は、stereoOrientation フラグを使用して設定します。
stereoImageOrientation(sio)	[string, string]
立体視カメラ レンダーの方向を指定します。1 番目の引数は firstleft イメージの方向の値を、2 番目の引数は right イメージの方向の値を指定します。方向の値は「normal」(カメラを通じてみたように表示される)、または「mirrored」(水平方向にミラーリングされる)です。
stereoMode(sm)	string
イメージをビューに表示する方法を指定します。既定は「stereo」で、イメージは隣り合わせにレンダーされます。「both」 では、レンダーされるイメージは単一のイメージで、通常のイメージのサイズの 2 倍です。その他の表示方法には「redcyan」、「redcyanlum」、「leftonly」、「rightonly」、または「stereo」があります。both - 左側と右側の両方を表示します。redcyan - イメージを赤とシアンのペアとして表示します。redcyanlum - イメージの輝度を赤とシアンのペアとして表示します。leftonly - 左側のみ表示します。rightonly - 右側のみ表示します。stereo - Crystal Eyes (tm)または Zscreen (tm)レンダーをサポートするモードです。
toggle(tgl)	boolean
地表プレーン表示のオン/オフを切り替えます。
unParent(up)	boolean
エディタをそのレイアウトから除去するように指定します。これは照会モードでは使用できません。
unlockMainConnection(ulk)	boolean
mainConnection をロック解除して、オリジナルの mainConnection (まだ使用可能な場合)を効率的に復元し、ダイナミックな更新を行います。
updateMainConnection(upd)	boolean
ロックされた mainConnection をオリジナルの mainConnection から更新させますが、ロック状態は保持されます。
useTemplate(ut)	string
コマンドに、現在のものとは異なるコマンド テンプレートを使用するように強制します。
viewImageCount(vic)	int
レンダー エディタは、単一ビューの中で複数のカメラをレンダリングすることができます。これはイメージが保存されるイメージ ビニングとは異なります。2 つの異なるカメラ レンダーを隣り合わせに並べて比較するには、複数のイメージ ビューが便利です。viewImageCount フラグを使用すると、エディタに対して、内部イメージ格納メカニズムの準備を行って指定されたビューの数に対応するよう通知されます。
viewTransformName(vtn)	string
現在のビューでカラー管理が有効になっている場合に適用されるビュー トランスフォームを設定/取得します。
writeImage(wi)	string
ディスクに現在のエディタ イメージを書き込みます。

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

Python 例

import maya.cmds as cmds

import maya.cmds as cmds

# There can only be one renderWindowEditor.
# Check if it already exists or create it otherwise.
#
editor = cmds.renderWindowEditor(q=True, editorName=True )
if( len(editor) == 0  ):
	editor = cmds.renderWindowEditor( "renderView" )

cmds.renderWindowEditor( editor, e=True, mq=(0.7, 0.3, 0.3, 0.5) )

cmds.renderWindowEditor( editor, e=True, ar=True )

cmds.renderWindowEditor( editor, e=True, snapshot=('persp', 256, 256) )

cmds.renderWindowEditor( editor, e=True, crc='persp' )
cmds.renderWindowEditor( editor, q=True, crc=True )