ビューポート バックグラウンド イメージ

次のメソッドを使用すると、[ビューポート バックグラウンド](Viewport Background)ダイアログ ボックス内の値にアクセスできます。

getBkgFrameNum <time> 	 

指定された時間に表示されるビューポート バックグラウンド イメージのフレームを返します。指定された時間にフレームが使用されていない場合は、-1 を返します。

   

getBkgImageAnimate() 	 
setBkgImageAnimate <boolean>   

[バックグラウンドをアニメート](Animate Background)をオン( true )またはオフ( false )にするかどうかを取得および設定します。

   

getBkgImageAspect()   
setBkgImageAspect <name> 

バックグラウンド イメージの[アスペクト比](Aspect)オプションを取得および設定します。有効な <name> 値は次のとおりです。

   

#view -- Match Viewport 
#bitmap -- Match Bitmap 
#output -- Match Rendering Output 

   

getBkgORType <start_end_integer> 
setBkgORType <start_end_integer> <name> 

バックグラウンド イメージの[処理開始](Start Processing)および[処理終了](End Procession)オプションを取得および設定します。

<start_end_integer> = 0 - 処理開始、1 - 処理終了

有効な <name> 値は次のとおりです。

   

#blank -- Blank Before Start/After End 
#hold -- Hold Before Start/After End #loop -- Loop After End 

   

getBkgRangeVal() 

バックグラウンド イメージの[使用フレーム範囲](Use Frame range)を Point2 値として取得します。Point2 値の最初のコンポーネントは開始フレーム、2 番目のコンポーネントは終了フレームです。

   

setBkgFrameRange <point3> 

バックグラウンド イメージの[使用フレーム範囲](Use Frame range)とステップ値を設定します。 <point3> の最初のコンポーネントは[開始フレーム](Start Frame)、2 番目のコンポーネントは[終了フレーム](End Frame)、3 番目のコンポーネントは[ステップ フレーム](Step Frame)になります。

   

getBkgStartTime() 
setBkgStartTime <time> 

バックグラウンド イメージの[開始点](Start At)フレームを設定します。

   

getBkgSyncFrame() 
setBkgSyncFrame <integer> 

バックグラウンド イメージの[同期開始フレーム](Synch Start To Frame)を取得および設定します。

   

次の 3ds Max システム グローバル変数は、[ビューポート バックグラウンド](Viewport Background)ダイアログ ボックスに関連付けられています。

backgroundImageFileName 

ビューポート バックグラウンド イメージのビットマップ ファイル名を定義する文字列値を取得および設定します。これには、[ビューポート バックグラウンド](Viewport Background)ダイアログ ボックスに設定したビットマップ ファイル名が含まれます。

   

setAsBackground <bitmap> 

ビューポート バックグラウンド イメージとして指定したビットマップを設定します。 <bitmap> はビットマップ ファイルと関連付けられている必要があります。次の場合は true となります。

1 - openBitmap() selectBitMap() により、ビットマップがファイルから読み取られた場合。

2 - save <bitmap> によってビットマップが保存された場合。

3 - MAXBitMap コンストラクタに、名前の長さが 0 ではない BitmapInfo が渡される場合(たとえば、ビットマップを BitmapTexture から取り出す場合)。 または、

4 - render() コマンドでビットマップが保存される場合。

   

次のメソッドを使用すると、[ビューポート バックグラウンド](Viewport Background)が再描画されます。

InvalidateAllBackgrounds() 

すべてのビューポートのビューポート バックグラウンド イメージ を無効にし、再描画します。