移動先: 概要 戻り値 フラグ Python の例
playblast(
filename
, [activeEditor=boolean], [cameraSetup=[string, string]], [clearCache=boolean], [completeFilename=string], [compression=string], [endTime=time], [filename=string], [forceOverwrite=boolean], [format=string], [frame=time], [framePadding=int], [height=int], [offScreen=boolean], [options=boolean], [percent=int], [rawFrameNumbers=boolean], [showOrnaments=boolean], [sound=string], [startTime=time], [viewer=boolean], [width=int], [widthHeight=[int, int]])
注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
playblast は「元に戻す」が可能、「照会」が不可能、「編集」が不可能です。
現在の再生範囲をプレイブラストします。
サウンドはオプションです。
| string | 作成される moviefile の名前。 |
activeEditor, cameraSetup, clearCache, completeFilename, compression, endTime, filename, forceOverwrite, format, frame, framePadding, height, offScreen, options, percent, rawFrameNumbers, showOrnaments, sound, startTime, viewer, width, widthHeight
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
startTime(st)
|
time
|
|
|
プレイブラストの開始時間を指定します。デフォルトは、タイム スライダに表示されている再生範囲の開始時間です。-frame によって変換。
|
|
endTime(et)
|
time
|
|
|
プレイブラストの終了時間を指定します。デフォルトは、タイム スライダに表示されている再生範囲の終了時間です。-frame によって変換。
|
|
sound(s)
|
string
|
|
|
プレイブラスト中に使用するサウンド ノードを指定します。
|
|
filename(f)
|
string
|
|
|
プレイブラストの出力に使用するファイル名。
そのファイルがすでに存在する場合は、プレイブラストをインタラクティブに実行するかどうかを確認するボックスが表示されます。コマンド ラインからプレイブラストを実行した場合にファイルがすでに存在すると、異常終了します。
|
|
forceOverwrite(fo)
|
boolean
|
|
|
"-f" フラグで指定したものと同じ名前の既存プレイブラスト ファイルを上書きします。
|
|
format(fmt)
|
string
|
|
|
プレイブラストの出力フォーマット。有効な値とその意味。
-- 「movie」Windows では、出力のタイプは avi で、プレーヤは Microsoft Media Player です。Mac OSX では、出力のタイプは QuickTime で、プレーヤは QuickTime です。Unix では、このオプションは SGI のムービー フォーマットで出力し、デフォルトのビュー コマンドを「movieplayer」に設定します。生成されるファイルには、「-f」フラグに従った名前が付きます（このフラグを指定した場合）。
-- 「image」は、イメージ ファイルのシーケンスを出力し、ユーザがプリファレンスで指定したアプリケーションにビュー コマンドを設定します。
アプリケーションが指定されていない場合、ビュー コマンドは「fcheck」に設定されます。イメージ フォーマットは、レンダー > レンダー グローバル（Render > RenderGlobals）を使用して指定した出力フォーマットになります。
結果として得られるファイルでは「myFile.0007.iff」のように、「-f」フラグの値をプリフィックスとして、これにフレーム番号をアペンドしたものが使用されます。
-fmt/format フラグのデフォルト値は「movie」です。
|
|
frame(fr)
|
time
|
|
|
ブラストするフレームのリスト。1 フラグごとに 1 フレーム指定します。
フレームの指定順序に決まりはありませんが、出力は順番に並べられます。このフラグが指定されている場合、開始/終了範囲をすべてオーバーライドします。
|
|
percent(p)
|
int
|
|
|
プレイブラスト中に使用する、現在のビュー サイズのパーセンテージ。
許容される値は、10～100 の整数です。すべての他の値はこの範囲内に当てはめられます。値「25」は、現在選択しているビューの大きさの 1/4 を表します。値「50」は、現在選択しているビューの大きさの半分を表します。値「100」は、フル サイズを表します。デフォルトは 50 です。
|
|
compression(c)
|
string
|
|
|
ムービー ファイルに使用される圧縮方法を指定します。
Unix で有効な値は「mvc1」、「mvc2」、「jpeg」、「rle」、「none」です。
デフォルトは「mvc2」です。
Windows では、引数が空の文字列（""）である場合、ダイアログ ボックスが表示され、ユーザーはコーデック、データ レート、キーフレーム、圧縮精度、およびコーデックを設定できます（このダイアログは「playblast -options」にも付属しています）。その他の文字列を使用した場合、以前このダイアログ ボックスで設定したコーデックが使用されます。
|
|
options(o)
|
boolean
|
|
|
Windows のみ。Windows NT のみ。プレイブラスト オプションを設定するダイアログが表示され、プレイブラストは実行されません。
|
|
viewer(v)
|
boolean
|
|
|
プレイブラスト用にビューアを起動するかどうかを指定します。デフォルトは true です。-fmt が「image」の場合は「fcheck」が実行されます。
ムービー ファイルのプレーヤは OS によって決まります。Windows では Microsoft Media
Player、Irix ではムービー プレーヤ、OSX では QuickTime が使用されます。
|
|
width(w)
|
int
|
|
|
最終イメージの幅。この値がアクティブ ウィンドウの幅よりも大きい場合は、固定値になります。
Windows: fcheck を使用していない場合、幅と高さは 4 で割り切れる必要があります。
|
|
height(h)
|
int
|
|
|
最終イメージの高さ。この値がアクティブ ウィンドウの幅よりも大きい場合は、固定値になります。
Windows: fcheck を使用していない場合、幅と高さは 4 で割り切れる必要があります。
|
|
widthHeight(wh)
|
[int, int]
|
|
|
最終イメージの幅と高さ。
アクティブなウィンドウの寸法より大きい値は縮小されます。
幅と高さを 0 にすると、ウィンドウのカレント サイズが使用されます。
Windows: fcheck を使用していない場合、幅と高さは 4 で割り切れる必要があります。
|
|
showOrnaments(orn)
|
boolean
|
|
|
モデル ビューの装飾（軸アイコンなど）を表示するかどうかを設定します。
|
|
clearCache(cc)
|
boolean
|
|
|
true に設定すると、以前のすべての一時プレイブラスト ファイルが削除されてから新しいプレイブラスト ファイルが作成されます。ユーザが名前を明確に指定したプレイブラスト ファイルは削除されません。その他すべての一時プレイブラスト ファイルは、このフラグの設定にかかわらず、アプリケーションが終了した時点で削除されます。
|
|
offScreen(os)
|
boolean
|
|
|
設定されている場合、プレイブラストでオフスクリーン バッファを使用して、ビューをレンダーできるようになります。これにより、アプリケーションがアイコン化された場合、または覆い隠された場合でも、プレイブラストは動作できるようになります。このフラグは Linux でのみサポートされています。
|
|
completeFilename(cf)
|
string
|
|
|
設定されている場合、この文字列は出力イメージの正確な名前を表します。
-f/filename フラグ タグと対称的に、-cf/completeFilename はファイル名の末尾にこれ以上数字や拡張子文字列をアペンドしません。
また、プレイブラストはイメージの表示後、これをディスクから削除しません。このフラグは、-f/filename と併用できません。
|
|
framePadding(fp)
|
int
|
|
|
ファイル名を埋めるために使用される 0 の数。通常、fcheck をサポートするために 4 に設定されます。
|
|
rawFrameNumbers(rfn)
|
boolean
|
|
|
通常プレイブラストは、フレームにゼロから始まる連続した番号を付けます。
このフラグはデフォルトのアクションを無効にし、-frame または -startFrame/-endFrame フラグで指定した実際のフレームを使用して、フレームに番号が付けられます。
|
|
cameraSetup(cs)
|
[string, string]
|
|
|
カメラのセットアップに関する情報。1 番目の文字列は、カメラ セットアップ MEL プロシージャを定義します。
カメラ セットアップ プロシージャは、プレイブラストの実行前に起動されます。2 番目の文字列引数はカメラ識別子として使用されるもので、最終的な出力ファイル名を指定するために、ルート ファイル名にアペンドされます。
引数に文字列のペアが提供されていない場合、このコマンドは失敗します。
|
|
activeEditor(ae)
|
boolean
|
|
|
このフラグはプレイブラストで使用される現在のモデル エディタを返します。プレイブラスト自体を起動することはありません。
|
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
: コマンドの照会モードで使用可能なフラグ
|
: タプルまたはリストとして渡された複数の引数を持てるフラグ
|
import maya.cmds as cmds
# Run movieplayer on the currently playblasted range
# (including sound) and save the movie to a file.
#
cmds.playblast( s="ohNo", f="myMovie.mv" )
# Run movieplayer on the currently playblasted range
# (at 60% of the size of the current view), and
# save the movie to file "myMovie.mv" and don't
# launch any viewing program.
#
cmds.playblast( p=60, s="ohNo", f="myMovie.mv", v=False )
# Output frames 2, 3, 8 as images and launch the viewer;
#
cmds.playblast( frame=[8,3,2], format="image", viewer=True )