FaceStylizer

public final class FaceStylizer

画像に顔のスタイル化を行います。

FaceStylizer は、入力画像を受け取って出力を返すが、戻り値のディープコピーを行う標準のスタイル化 API stylize(MPImage) と ERROR(/#stylizeForVideo) に加えて、コールバック API、stylizeWithResultListener(MPImage) と ERROR(/#stylizeForVideoWithResultListener) もサポートしています。これにより、結果リスナーの期間中、ゼロコピーを介して出力にアクセスできます。

コールバック API は FaceStylizer のすべての RunningMode で使用できます。コールバック API を使用するように、FaceStylizer.FaceStylizerOptions で OutputHandler.ResultListener を適切に設定します。

API は、TFLite モデル メタデータを含む TFLite モデルを想定しています。

  • 入力画像 MPImage
    • 顔のスタイルライザーが実行される画像。
  • 出力 MPImage MPImage
    • 様式化された顔を含む MPImage。

ネストされたクラス

クラス FaceStylizer.FaceStylizerOptions FaceStylizer の設定オプション。 

パブリック メソッド

static FaceStylizer
createFromOptions（コンテキスト コンテキスト、FaceStylizer.FaceStylizerOptions stylizerOptions）
FaceStylizer.FaceStylizerOptions から FaceStylizer インスタンスを作成します。
FaceStylizerResult
stylize（MPImage image、ImageProcessingOptions imageProcessingOptions）
指定された 1 つの画像に顔のスタイル化を実行します。
FaceStylizerResult
stylize（MPImage 画像）
指定された 1 つの画像に、デフォルトの画像処理オプション（
void
stylizeWithResultListener（MPImage イメージ）
指定された 1 つの画像に、デフォルトの画像処理オプション（
void
stylizeWithResultListener（MPImage image、ImageProcessingOptions imageProcessingOptions）
指定された 1 つの画像に対して顔のスタイル化を行い、FaceStylizer.FaceStylizerOptions の OutputHandler.ResultListener を介してゼロコピーされた結果を提供します。

継承されるメソッド

パブリック メソッド

public static FaceStylizer createFromOptions （コンテキスト コンテキスト、FaceStylizer.FaceStylizerOptions stylizerOptions）

FaceStylizer.FaceStylizerOptions から FaceStylizer インスタンスを作成します。

パラメータ
コンテキスト Android ERROR(/Context)。
stylizerOptions FaceStylizer.FaceStylizerOptions インスタンス。
例外
FaceStylizer の作成中にエラーが発生した場合。

public FaceStylizerResult stylize (MPImage image, ImageProcessingOptions imageProcessingOptions)

指定された 1 つの画像に顔のスタイル化を実行します。このメソッドは、FaceStylizer が RunningMode.IMAGE で作成された場合にのみ使用します。

FaceStylizer は、次の色空間タイプをサポートしています。

入力画像のサイズに制限はありません。出力画像は、顔が最も見える定型化された画像です。様式化された出力画像のサイズは、モデルの出力サイズと同じです。入力画像で顔が検出されない場合は、Optional.empty() を返します。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
imageProcessingOptions 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。
例外
IllegalArgumentException ImageProcessingOptions が関心のある地域を指定している場合。
内部エラーが発生した場合。または、FaceStylizer が OutputHandler.ResultListener で作成された場合です。

public FaceStylizerResult stylize （MPImage 画像）

指定された 1 つの画像に対して、デフォルトの画像処理オプションを使用して（つまり、回転を適用せずに）顔のスタイル化を実行します。このメソッドは、FaceStylizer が RunningMode.IMAGE で作成された場合にのみ使用します。

FaceStylizer は、次の色空間タイプをサポートしています。

入力画像のサイズに制限はありません。出力画像は、顔が最も見える定型化された画像です。様式化された出力画像のサイズは、モデルの出力サイズと同じです。入力画像で顔が検出されない場合は、Optional.empty() を返します。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
例外
内部エラーが発生した場合。または、FaceStylizer が OutputHandler.ResultListener で作成された場合です。

public void stylizeWithResultListener （MPImage 画像）

指定された 1 つの画像に対して、デフォルトの画像処理オプション（回転は適用しない）で顔のスタイル化を実行します。また、FaceStylizer.FaceStylizerOptions の OutputHandler.ResultListener を介して、ゼロコピーされた結果を提供します。このメソッドは、FaceStylizer が RunningMode.IMAGE で作成された場合にのみ使用します。

FaceStylizer は、次の色空間タイプをサポートしています。

入力画像のサイズに制限はありません。出力画像は、顔が最も見える定型化された画像です。様式化された出力画像のサイズは、モデルの出力サイズと同じです。入力画像で顔が検出されない場合は、Optional.empty() を返します。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
例外
IllegalArgumentException ImageProcessingOptions が関心のある地域を指定している場合。
内部エラーが発生した場合。または、FaceStylizer.FaceStylizerOptions で OutputHandler.ResultListener を設定して FaceStylizer が作成されていない場合。

public void stylizeWithResultListener （MPImage イメージ、ImageProcessingOptions imageProcessingOptions）

指定された 1 つの画像に対して顔のスタイル化を行い、FaceStylizer.FaceStylizerOptions の OutputHandler.ResultListener を介してゼロコピーされた結果を提供します。このメソッドは、FaceStylizer が RunningMode.IMAGE で作成された場合にのみ使用します。

FaceStylizer は、次の色空間タイプをサポートしています。

入力画像のサイズに制限はありません。出力画像は、顔が最も見える定型化された画像です。様式化された出力画像のサイズは、モデルの出力サイズと同じです。入力画像で顔が検出されない場合は、Optional.empty() を返します。

パラメータ
イメージ 処理する MediaPipe MPImage オブジェクト。
imageProcessingOptions 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。
例外
IllegalArgumentException ImageProcessingOptions が関心のある地域を指定している場合。
内部エラーが発生した場合。または、FaceStylizer.FaceStylizerOptions で OutputHandler.ResultListener を設定して FaceStylizer が作成されていない場合。