RenderEffect 進行状況コールバック機能

メソッド

progressCB.setTitle <string>

進行状況バーのタイトルを設定します。

progressCB.progress <done> <total>

レンダリングの進行状況を定義します。両方の引数は整数です。 done は完了したレンダリングの数を示し、 total はレンダリングの総数を示します。たとえば、ビットマップのすべてのラインを通過するレンダリング効果のメイン ループでは、 done は進行中の現在のライン番号に、 total はビットマップ内のラインの数(その垂直方向の解像度)に設定される必要があります。

このメソッドを呼び出すと、効果が[レンダリング効果](Rendering Effects)ダイアログ ボックスによって更新される場合はレンダリング効果の進行状況メインバーが更新され、レンダラーによって呼び出される場合はレンダラー進行状況バーが更新されて、この進行状況が反映されます。

この関数ではブール値も返します。 true は、[Esc]が押されて、効果のレンダリングがキャンセルされたことを示します。

progressCB.check()

[Esc]キーが押されて、効果のレンダリングがキャンセルされたかどうかを示します。この関数は、ブール値を返します。処理を継続する必要がある場合は false 、レンダリングがキャンセルされた場合は true です。

on apply bm progressCB: do
(
...
progressCB.setTitle "My Effect Pass1"
...
oldEscapeEnable = escapeEnable -- get old state of escape processing
escapeEnable = false -- turn off MAXScript escape processing
total = bm.height -- define total as the height of the bitmap
for i in ...
(
<the effect rendering loop>
...
if progressCB.progress i total then exit --i lines done out of total
)--end i loop
...
escapeEnable = oldEscapeEnable --restore original state
...
)--end on apply