textureWindow

移動先: 概要 戻り値 フラグ. Python 例.

概要

textureWindow( string , [changeCommand=[string, string, string, string]], [clearImage=boolean], [control=boolean], [defineTemplate=string], [displayAxes=boolean], [displayDivisionLines=boolean], [displayGridLines=boolean], [displayImage=int], [displayLabels=boolean], [displaySolidMap=boolean], [displayStyle=string], [divisions=int], [docTag=string], [doubleBuffer=boolean], [exists=boolean], [filter=string], [forceMainConnection=string], [forceRebake=boolean], [frameAll=boolean], [frameSelected=boolean], [highlightConnection=string], [imageBaseColor=[float, float, float]], [imageDisplay=boolean], [imageNames=boolean], [imageNumber=int], [imagePixelSnap=boolean], [imageRatio=boolean], [imageSize=boolean], [imageTileRange=[float, float, float, float]], [imageUnfiltered=boolean], [internalFaces=boolean], [labelPosition=string], [loadImage=string], [lockMainConnection=boolean], [mainListConnection=string], [maxResolution=int], [nbImages=boolean], [numUvSets=boolean], [numberOfImages=int], [panel=string], [parent=string], [realSize=boolean], [relatedFaces=boolean], [removeAllImages=boolean], [removeImage=boolean], [reset=boolean], [saveImage=boolean], [scaleBlue=int], [scaleGreen=int], [scaleRed=int], [selectInternalFaces=boolean], [selectRelatedFaces=boolean], [selectionConnection=string], [setUvSet=int], [singleBuffer=boolean], [size=float], [spacing=float], [stateString=boolean], [style=int], [toggle=boolean], [unParent=boolean], [unlockMainConnection=boolean], [updateMainConnection=boolean], [useFaceGroup=boolean], [useTemplate=string], [uvSets=boolean], [viewPortImage=boolean], [writeImage=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

textureWindow は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

UV テクスチャ エディタは、2D テクスチャ スペース内に、 テクスチャ マップされたポリゴン オブジェクトを表示します。このウィンドウでは、アクティブになっているオブジェクトのみが可視となります。

UV テクスチャ エディタは 2 種類のイメージを表示できます。テクスチャ イメージは、カレント テクスチャとコネクトされた 配置パラメータを視覚化したものです。エディタ イメージは、ディスクからロードされた ユーザ指定のイメージです。

UV テクスチャ エディタは、Maya ウィンドウの上部にある Maya メイン メニュー リストから、 ウィンドウ > UV テクスチャ エディタ...（Windows > UV Texture Editor...）を選択すると呼び出されます。または、ビューの右上に表示されるパネル（Panels）メニューから、 パネル > UV テクスチャ エディタ（Panel > UV Texture Editor） 項目を選択して呼び出すこともできます。

UV テクスチャ エディタは通常はスタートアップ時に存在し、一度に表示できるのは 1 つのエディタだけです。このコマンドは通常、エディタの設定を 照会および編集するときに使用されます。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
exists(ex)	boolean
指定したオブジェクトが存在するかどうかによって、 true または false を返します。他のフラグは無視されます。
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに 追加するモードに、コマンドのモードを変更します。 templateName がカレントのテンプレートとして設定されていれば、 その後コマンドが実行されるたびに、この引数がデフォルトの引数として使用されます。
useTemplate(ut)	string
コマンドに、カレント以外のコマンド テンプレートの使用を強制します。
panel(pnl)	string
エディタが属しているパネルを指定します。デフォルトでは、エディタがスクリプト パネルの作成コールバックで作成された場合、エディタはそのパネルに属します。エディタがパネルに属していない場合、 エディタのあるウィンドウを削除するとエディタも削除されます。
parent(p)	string
このエディタの親のレイアウトを指定します。このフラグは、エディタが現在ペアレント化されていない場合のみに効果があります。
unParent(up)	boolean
エディタをそのレイアウトから削除するように指定します。 照会には使用できません。
control(ctl)	boolean
照会モード専用です。このエディタの最上位のコントロールを返します。 通常は、親を取得してポップアップ メニューをアタッチするために使用します。 注意: コントロールのないエディタが存在する場合があります。コントロールがない場合は、このフラグは NONE を返します。
mainListConnection(mlc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。
forceMainConnection(fmc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。これは -mainListConnection フラグの変形で、 コネクションがロックされている場合でも強制的に変更します。このフラグを使用して、-unlockMainConnection、-mainListConnection、-lockMainConnection フラグを直後に連続して使用する場合に、オーバーヘッドを減します。
selectionConnection(slc)	string
その独自のセレクション リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。このエディタから選択する場合、 selectionConnection オブジェクトの中から選択します。オブジェクトが変更されると、エディタが更新されて変更が反映されます。
highlightConnection(hlc)	string
そのハイライト リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。すべてのエディタにハイライト リストがあるわけではありません。ハイライト リストがあるエディタの場合、これは第二の選択項目を表示したリストになります。
filter(f)	string
このエディタに配置する項目フィルタ オブジェクトの名前を指定します。 エディタの主要リストに表示される情報をフィルタします。
lockMainConnection(lck)	boolean
mainConnection 内のオブジェクトのカレント リストをロックして、そのオブジェクトだけがエディタ内に表示されるようにします。 これ以降、元の mainConnection に変更を加えても無視されます。
stateString(sts)	boolean
照会モード専用のフラグです。エディタを編集して現在のエディタの状態と一致させる MEL コマンドを返します。返されたコマンド文字列は、指定した名前の代わりに文字列変数 $editorName を使用します。
unlockMainConnection(ulk)	boolean
mainConnection をロック解除して、オリジナルの mainConnection（まだ使用可能な場合）を効率的に復元し、ダイナミックな更新を行います。
updateMainConnection(upd)	boolean
ロックされた mainConnection をオリジナルの mainConnection から更新させますが、ロック状態は保持されます。
docTag(dtg)	string
Maya エディタにタグをアタッチします。
scaleRed(sr)	int
ビュー内の赤の成分の スケーリング係数を定義します。デフォルト値は 1 で、-1000 から +1000 までが可能です。
scaleGreen(sg)	int
ビュー内の緑の成分の スケーリング係数を定義します。デフォルト値は 1 で、-1000 から +1000 までが可能です。
scaleBlue(sb)	int
ビュー内の青の成分の スケーリング係数を定義します。デフォルト値は 1 で、-1000 から +1000 までが可能です。
singleBuffer(sbf)	boolean
表示をシングル バッファ モードに設定します。
doubleBuffer(dbf)	boolean
表示をダブル バッファ モードに設定します。
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: メモリに保存されたイメージ
displayImage(di)	int
特定のイメージをエディタ イメージ スタック（Editor Image Stack）でカレントのエディタ イメージ（Editor Image） として設定します。 イメージは、「si/saveImage」フラグを使用して Editor Image Stack に追加されます。
loadImage(li)	string
ディスクからイメージをロードしてカレントのエディタ イメージとして設定します。
writeImage(wi)	string
ディスクにカレントのエディタ イメージを書き込みます。
displayStyle(dst)	string
イメージを表示するモードを設定します。有効な値は、 基本 RGB イメージを表示する場合は「カラー」 マスク チャンネルを表示する場合は「マスク」 イメージの輝度を表示する場合は「輝度」
removeImage(ri)	boolean
Editor Image Stack からカレントの Editor Image を削除します。
removeAllImages(ra)	boolean
Editor Image Stack からすべての Editor Image を削除します。
saveImage(si)	boolean
メモリにカレントの Editor Image を保存します。保存されたエディタ イメージは、エディタ イメージ スタックに格納されます。最も新しく保存したイメージは 0 の位置に、次に新しく保存したイメージは 1 の位置、などと格納されます。カレントのエディタ イメージを 前に保存したイメージに設定するには、「di/displayImage」フラグを使用します。
nbImages(nim)	boolean
イメージの数を返します。
toggle(tgl)	boolean
地表プレーン表示のオン/オフを切り替えます。
reset(r)	boolean
地表プレーンをデフォルト値にリセットします。
spacing(sp)	float
メイン グリッド ラインの間隔を設定します。
size(s)	float
グリッドのサイズを設定します。
divisions(d)	int
メイン グリッド ライン間のサブディビジョン数を設定します。
clearImage(ci)	boolean
カレントのエディタ イメージをクリアします。
numberOfImages(ni)	int
ディスプレイで現在利用できるテクスチャ イメージの数です。
imageDisplay(id)	boolean
テクスチャ イメージの表示のオン/オフを切り替えます。
imageNumber(imageNumber)	int
表示するテクスチャ イメージの番号を設定します。 これは、現在選択しているテクスチャの数によって 異なります。N 個のテクスチャがある場合、想定される テクスチャ イメージの番号は 0 から N-1 までとなります。
imageNames(imn)	boolean
ディスプレイで使用できるすべてのテクスチャ イメージの名前です。
imageRatio(imr)	boolean
テクスチャ イメージの縦横比を使用して描画するように ウィンドウを設定します。幅が高さよりも大きい場合は幅が「1 ユニット」として設定され、 高さは幅を高さで割って調整されます。これはテクスチャ イメージの表示には影響しますが、 エディタ イメージには影響しません。
imageTileRange(itr)	[float, float, float, float]
表示の UV 範囲を設定します。4 つの値（float）は 最小 U、最小 V、最大 U、最大 V の順で指定します。テクスチャ イメージを表示するときは、適切なパラメータ （例: 繰り返し UV（Repeat UV）、ミラー（Mirror）、ラップ（Wrap）など） に基づいてイメージを何倍でタイル表示するかに影響します。 エディタ イメージを表示するときは、 これらの値はイメージの可視サイズを定義します。たとえば、その範囲を ( 0, 0, 2, 1 ) に設定すると、 エディタ イメージを 2x1 の四角形で、使用可能なスペースを満たすために 必要に応じて変形してロードします。
imageUnfiltered(iuf)	boolean
テクスチャ イメージをフィルタ処理しないように設定します。表示解像度が画像の解像度を上回ると、画像は 「ピクセル化」した状態で表示されます。
imagePixelSnap(ip)	boolean
UV テクスチャ エディタ内での UV 変換において、UV 値が画像のピクセル コーナーにスナップされるようにモードを設定します。どのピクセルが使用されるかは、テクスチャ イメージまたは エディタ イメージのどちらが表示されるかにより、両方が表示される場合は、 テクスチャ イメージのピクセルが使用されます。
imageSize(imageSize)	boolean
現在表示されているテクスチャ イメージのサイズを返します。 返される値は、幅、高さの順です。 これは参照のみ可能です。
displayAxes(dax)	boolean
グリッド軸を表示するには、true を指定します。
displayGridLines(dgl)	boolean
グリッド ラインを表示するには、true を指定します。
displayDivisionLines(ddl)	boolean
グリッド ラインの間のサブディビジョン ラインを表示するには、 true を指定します。
displayLabels(dl)	boolean
true を指定してグリッド ラインの数字ラベルを表示します。
labelPosition(lp)	string
グリッドの数字ラベルの位置です。有効な値は「axis」と「edge」です。
style(st)	int
このフラグは廃止されているので、使用しないでください。
internalFaces(internalFaces)	boolean
選択したコンポーネントに含まれるフェースを表示します。
relatedFaces(rf)	boolean
選択したコンポーネントにコネクトされたフェースを表示します。
useFaceGroup(uf)	boolean
描画されるメッシュ ノードに設定された groupId に関連付けれられたフェースを表示します （アトリビュート: displayFacesWithGroupId）。
selectInternalFaces(sif)	boolean
選択したコンポーネント（内部）に含まれている フェースを selectionList に追加します。
selectRelatedFaces(srf)	boolean
選択したコンポーネント（内部は関連せず）に含まれている フェースを selectionList に追加します。
frameAll(fa)	boolean
シーン全体をズームします。
frameSelected(fs)	boolean
現在選択しているオブジェクトをズームします。
realSize(rs)	boolean
画像を内部バッファのサイズとともに表示します。注: 現在では、この引数はイメージ表示に影響しなくなりました。
uvSets(uvs)	boolean
このフラグは、テクスチャ ウィンドウで選択したオブジェクトの、 UV セットとオブジェクト名のペアを含んだ文字列を返します。各ペアの構文は 「objectName | uvSetName」で、| の部分は そのままの文字です。
numUvSets(nuv)	boolean
このフラグは、テクスチャ ウィンドウで選択した オブジェクトの UV セットの数を返します。
setUvSet(suv)	int
このフラグはテクスチャ ウィンドウで選択したオブジェクトに、現在の UV セットを設定します。
maxResolution(mrs)	int
このフラグはカレントのキャッシュされたテクスチャの最大解像度を設定します。
forceRebake(frb)	boolean
強制的にカレントのキャッシュ テクスチャをリフレッシュします。
viewPortImage(vpi)	boolean
ビュー ポートとキャッシング テクスチャ イメージを切り替えます。
imageBaseColor(ibc)	[float, float, float]
イメージのベース カラー。デフォルトは白 1.0 1.0 1.0 です。
displaySolidMap(dsm)	boolean
アクティブ テクスチャ マップのソリッド オーバー レイを表示します。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# As a UV Texture Editor typically exists on start-up, you normally
# will not need to create one.. Hence all the examples that follow
# explain how to query and edit the editor settings.

# Get the panel that the editor belongs to.
texWinName = cmds.getPanel(sty='polyTexturePlacementPanel')

# Get the space between main grid lines
cmds.textureWindow(texWinName[0], q=True, sp=True)
# Result: 0.05 #

# Change the space between main grid lines
cmds.textureWindow( texWinName[0], e=True, sp=0.1 )

# Get the size of the grid
cmds.textureWindow( texWinName[0], q=True, s=True )
# Result: 12 #

# Change the size of the grid
cmds.textureWindow( texWinName[0], e=True, s=0.8 )

# Zoom on the whole scene
cmds.textureWindow( texWinName[0], e=True, fa=True )

# Set display mode to related (connected) faces
cmds.textureWindow(texWinName[0], e=True, rf=True )