ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.
imagePlane([camera=string], [counter=boolean], [detach=boolean], [dropFrame=boolean], [frameDuration=int], [height=float], [imageSize=[int, int]], [maintainRatio=boolean], [name=string], [negTimesOK=boolean], [numFrames=int], [quickTime=boolean], [timeCode=int], [timeCodeTrack=boolean], [timeScale=int], [twentyFourHourMax=boolean], [width=float])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
imagePlane は、取り消し可能、照会可能、および 編集可能 です。
imagePlane コマンドを使用すると、1 つのイメージ プレーンのさまざまなプロパティ、およびそのイメージ プレーンが使用しているムービーに対して、照会を実行できます。このコマンドは、作成と編集もサポートしています。このコマンドには、imagePlane ノードまたはカメラのいずれかのオブジェクトを渡すことができます。カメラを渡した場合は、カメラにアタッチされたイメージ プレーン(存在する場合)が使用されます。オブジェクトを渡さない場合は、現在の選択範囲が使用されます。現在、ほとんどのムービー関連の照会は、64 ビット Windows システム上でのみ機能します。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
image, plane
camera
camera, counter, detach, dropFrame, frameDuration, height, imageSize, maintainRatio, name, negTimesOK, numFrames, quickTime, timeCode, timeCodeTrack, timeScale, twentyFourHourMax, width
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
quickTime(qt)
|
boolean
|
|
|
イメージ プレーンで QuickTime ムービーが使用されているかどうかを照会します。
|
|
timeCodeTrack(tt)
|
boolean
|
|
|
イメージ プレーン上のムービーにタイムコード トラックがあるかどうかを照会します。
|
|
dropFrame(df)
|
boolean
|
|
|
ムービーのタイムコード フォーマットの「drop frame」フラグを照会します。
|
|
twentyFourHourMax(tf)
|
boolean
|
|
|
ムービーのタイムコード フォーマットの「24 hour max」フラグを照会します。
|
|
negTimesOK(nt)
|
boolean
|
|
|
ムービーのタイムコード フォーマットの「neg times OK」フラグを照会します。
|
|
counter(cn)
|
boolean
|
|
|
ムービーのタイムコード フォーマットの「counter」フラグを照会します。これが true の場合、-timeCode フラグによって返されるタイムコードは単純なカウンタです。false の場合、返されるタイムコードは整数の配列(時間、分、秒、フレーム)です。
|
|
timeScale(ts)
|
int
|
|
|
ムービーのタイムコード フォーマットのタイムスケールを照会します。
|
|
frameDuration(fd)
|
int
|
|
|
ムービーのタイムコード フォーマットのフレーム期間を照会します。
|
|
numFrames(nf)
|
int
|
|
|
ムービーのタイムコード フォーマットの 1 秒あたりの全フレーム数を照会します。
|
|
timeCode(tc)
|
int
|
|
|
ムービーのタイムコード フォーマットの 1 秒あたりの全フレーム数を照会します。
|
|
width(w)
|
float
|
|
|
イメージ プレーンの幅。作成時にこのフラグが指定されていない場合、「optionVar -q freeImageWidth」で既定値が照会されます。optionVar での照会に失敗した場合、または照会結果が 0 の場合は、幅の既定値として 1.0 が使用されます。
|
|
height(h)
|
float
|
|
|
イメージ プレーンの高さ。作成時にこのフラグが指定されていない場合、「optionVar -q freeImageHeight」で既定値が照会されます。optionVar での照会に失敗した場合、または照会結果が 0 の場合は、高さの既定値として 1.0 が使用されます。
|
|
name(n)
|
string
|
|
|
作成時はイメージ プレーンのノード名を設定します。照会時はイメージ プレーン名を返します。
|
|
imageSize(iz)
|
[int, int]
|
|
|
maintainRatio(mr)
|
boolean
|
|
|
イメージのピクセル アスペクト比を維持するためにイメージの平面サイズを設定します。
|
|
camera(c)
|
string
|
|
|
作成時は、指定されたカメラへの作成済みイメージ プレーンのアタッチを試みます。指定のカメラが無効な場合、作成は失敗します。照会時は、現在のイメージ プレーンがどのカメラにアタッチされているかを照会します。(フリー イメージ プレーンの場合のように)アタッチされているカメラがない場合は、空の文字列が返されます。編集時は、イメージ プレーンを指定の新しいカメラにアタッチします。指定のカメラが無効な場合は、何も行われません。イメージ プレーンをカメラにアタッチすると、イメージ プレーンのトランスフォーム ノードも同一の設定になります。デタッチ コマンドはイメージ プレーンの元の位置を復元しません。ただし、元に戻すコマンドはイメージ プレーンの元の位置を復元します。
|
|
detach(d)
|
boolean
|
|
|
このフラグを使用できるのは編集モードの場合のみです。編集時にこのフラグを使用すると、現在のイメージ プレーンを、アタッチされているすべてのカメラからデタッチしてフリー イメージ プレーンにします。
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
import maya.cmds as cmds
// create image plane with width and height example
myImagePlane = cmds.imagePlane( width=100, height=50 )
// create image plane with width and maintainRatio off
myImagePlane = cmds.imagePlane( width=100, maintainRatio=False )
// edit image plane example
cmds.imagePlane( myImagePlane[1], e=True, w=100, h=200, mr=False ) ;
// query image width height example
cmds.imagePlane( myImagePlane[1], q=True, w=True, h=True ) ;
// Create image plane with name
cmds.imagePlane( name="Foo") ;
cmds.imagePlane( width=100, height=50, name="Foo") ;
// query loaded image ratio
cmds.imagePlane( myImagePlane[1], q=True, iz=True );
// Create image plane under a specified camera
camera = cmds.camera()
cmds.imagePlane(camera=camera[1])