進行状況バーの表示

この関数のグループを使用すると、時間のかかる操作に進行状況バーを表示できます。これは 3ds Max で IK、プレビューのレンダリング、キー リダクションなどの計算に使用される進行状況バーと同じです。

これらの関数は、次のとおりです。

progressStart "caption" 	 

進行状況バーを最初にキャプション付きで表示します。

progressUpdate <percent>   

完了した割合を表示するために、バーを更新します。範囲は 0 から 100 までです。また、この関数はユーザが進行状況バーの[キャンセル](Cancel)ボタンを押したかどうかを確認し、計算を続行する場合は true 、ユーザがキャンセルを要求した場合は false を返します。 getProgressCancel() を呼び出してキャンセルの状態を確認することもできます。こちらの方が使用するシステム リソースが少なくて済むため、 progressUpdate() よりも頻繁に呼び出されます。

progressEnd() 

操作の終了を知らせ、進行状況バーを画面から消します。

getProgressCancel() 

ユーザが進行状況バーの[キャンセル](Cancel)ボタンを押して操作をキャンセルしたかどうかを確認する関数で、使用するシステム リソースが少なくて済みます。深いループ内では、ユーザによるキャンセルの遅延を減らすためになるべくこの関数を呼び出すことをお勧めします。使用するシステム リソースを最低限に抑えるために、 progressUpdate() は必要に応じて進行状況バーの重要な変化を表示するためだけに呼び出します。 getProgressCancel() 関数と progressUpdate() 関数は、ユーザが[キャンセル](Cancel)ボタンを押すと確認のダイアログ ボックスを表示し、この確認処理からキャンセルの状態を返します。 progressUpdate() とは異なり、この関数は、ユーザがキャンセルの確認要求を行った場合は true を返し、それ以外の場合は false を返します。

setProgressCancel <boolean> 

進行状況バーの[キャンセル](Cancel)フラグを設定またはクリアします。 true 値を渡した場合は[キャンセル](Cancel)フラグが設定され、 progressUpdate() および getProgressCancel() 関数で検出されます。 false 値を渡した場合は、[キャンセル](Cancel)フラグが設定されている場合、これがクリアされます。

次に進行状況バーの表示と関連する 3ds Max システム グローバル変数を示します。

escapeEnable 

[Esc] キーによる中断の検出がオンかオフかを定義するブール値を取得/設定します。 enableEscape を false に設定すると [Esc] キーによる中断の検出はオフに、 true に設定すると再びオンになります。この変数は進行状況バーとともに使用すると便利です。スクリプトによる長い計算の実行をユーザが中断するのを制限したい場合に、進行状況バーに独自の[キャンセル](Cancel)ボタンが設定してあるときには、 enableEscape を false に設定できます。

1/20*100.0 -> 0*100.0 -> 0.0
2/20*100.0 -> 0*100.0 -> 0.0
3/20*100.0 -> 0*100.0 -> 0.0
...
19/20*100.0-> 0*100.0 -> 0.0
20/20*100.0-> 1*100.0 -> 100.0

100.0*1/20 -> 100.0/20 -> 5.0
100.0*2/20 -> 200.0/20 -> 10.0
100.0*3/20 -> 300.0/20 -> 15.0
...
100.0*19/20-> 1900.0/20-> 95.0
100.0*20/20-> 2000.0/20-> 100.0