ByteArray または Vector の場合は、target の結果データの高さです。<Number> インスタンスです。ByteArray または Vector のサイズです。<Number> インスタンスは必要に応じて拡大され、既存のデータは上書きされます。

実行中のシェーダの進行状況です。このプロパティは 0 から 1 までの値です。初期値は 0 です (0 ％完了)。1 はシェーダ操作が完了したことを示します。

cancel() メソッドが呼び出されると、このプロパティは undefined になり、シェーダ操作が再開されるまで、信頼性のある値の使用はできません。

操作に使用したシェーダです。Shader インスタンスの data プロパティで、ShaderInput または ShaderParameter プロパティを使用して、目的のシェーダの入力またはパラメータを指定する必要があります。対応する ShaderInput が target オブジェクトと同じ場合でも、これを使用して入力を指定する必要があります。

線形データ配列 (イメージデータではなく) を含む ByteArray を処理するには、ByteArray 内の対応する ShaderInput インスタンスの height を 1 に、width を 32 ビット浮動小数点の値に設定します。その場合、シェーダの入力は image1 データ型で定義する必要があります。

関連項目

シェーダ操作の結果が書き込まれるオブジェクトです。このオブジェクトは、BitmapData、ByteArray、または Vector のいずれかでなければなりません。<Number> インスタンスです。

ByteArray または Vector の場合は、target の結果データの幅です。<Number> インスタンスです。ByteArray または Vector のサイズです。<Number> インスタンスは必要に応じて拡大され、既存のデータは上書きされます。

現在実行中のシェーダ操作をキャンセルします。既に計算済みの結果データがある場合、そのデータは破棄されます。complete イベントは送出されません。

cancel() を複数回呼び出しても効果はありません。

waitForCompletion パラメータの値に従って、シェーダ操作を同期モードまたは非同期モードで開始します。

waitForCompletion が false (デフォルト) の場合は、非同期モードになり、ShaderJob はバックグラウンドで実行されます。シェーダ操作は、表示の応答性や他の操作には影響しません。非同期モードでは、start() 呼び出しが即座に戻り、プログラムの実行が次のコード行から続行されます。非同期のシェーダ操作が終了すると、結果が出て complete イベントが送出されます。

バックグラウンドでは一度に 1 つの ShaderJob 操作のみが実行されます。シェーダ操作は実行されるまでキューに入ります。シェーダ操作の実行中に start() メソッドを呼び出すと、追加の操作がキューの末尾に追加されます。後で順番が来ると、その操作が実行されます。

シェーダ操作を同期モードで実行するには、start() を呼び出して waitForCompletion パラメータ (唯一のパラメータ) に true を渡します。シェーダ操作が完了するまでは、コードの実行が start() を呼び出した箇所で一時停止します。操作が完了すると、結果が出て次のコード行から実行が続行されます。

start() メソッドを呼び出すと、shader プロパティの Shader インスタンスの内部的にコピーされます。シェーダ操作は、元のシェーダを参照するのではなく、その内部コピーを使用します。パラメータ値、入力、バイトコードの変更などの変更をシェーダに加えたとしても、シェーダの処理で使用したコピーシェーダにはその変更は適用されません。シェーダの変更をシェーダの処理に適用するには、(必要に応じて) cancel() メソッドを呼び出し、もう一度 start() メソッドを呼び出して、シェーダの処理を再開します。

シェーダ操作の実行中、target オブジェクトの値は変わりません。操作が終了すると (非同期モードで complete イベントが送出されると)、結果全体が一度に target オブジェクトに書き込まれます。target オブジェクトが BitmapData インスタンスで、操作が終了する前にその dispose() メソッドが呼び出された場合でも、非同期モードでは complete イベントが送出されます。ただし、結果データは破棄状態にあるため、BitmapData オブジェクトには書き込まれません。

パラメータ

ShaderJob を非同期的に実行したときに、シェーダによるデータ処理が終了すると送出されます。ShaderJob インスタンスを非同期的に実行するには、start() メソッドを呼び出して waitForCompletion パラメータに値として false を渡します。

このイベントには、次のプロパティがあります。