画像に対してインタラクティブ セグメンテーションを実行します。
入力画像を受け取って出力を返すが、戻り値のディープコピーを必要とする標準のセグメンテーション API ERROR(/segment) に加えて、InteractiveSegmenter はコールバック API ERROR(/segmentWithResultListener) もサポートしています。この API を使用すると、ゼロコピーで出力にアクセスできます。コールバック API を使用するように、InteractiveSegmenter.InteractiveSegmenterOptions で OutputHandler.ResultListener を適切に設定します。
API は、TFLite モデル メタデータを含む TFLite モデルを想定しています。このモデルは 4 チャンネルの入力を想定しています。最初の 3 チャンネルは RGB 画像、最後のチャンネルはユーザーの関心のある領域を表します。
- 入力画像
MPImage- 画像セグメンタが実行される画像。
- 入力 ROI
InteractiveSegmenter.RegionOfInterest- ユーザー操作に基づく関心のある地域。
- 出力 ImageSegmenterResult
ImageSegmenterResult- セグメント化されたマスクを含む ImageSegmenterResult。
ネストされたクラス
| クラス | InteractiveSegmenter.InteractiveSegmenterOptions | InteractiveSegmenter の設定オプション。 |
|
| クラス | InteractiveSegmenter.RegionOfInterest | 操作する関心領域（ROI）。 | |
パブリック メソッド
| static InteractiveSegmenter |
createFromOptions（コンテキスト コンテキスト、InteractiveSegmenter.InteractiveSegmenterOptionssegmenterOptions）
InteractiveSegmenter.InteractiveSegmenterOptions から InteractiveSegmenter インスタンスを作成します。 |
| ImageSegmenterResult | |
| ImageSegmenterResult |
segment（MPImage image、InteractiveSegmenter.RegionOfInterest roi、ImageProcessingOptions imageProcessingOptions）
ユーザーの関心のある地域に基づいて、指定された単一の画像でセグメンテーションを実行します。
|
| void |
segmentWithResultListener（MPImage イメージ、InteractiveSegmenter.RegionOfInterest roi）
ユーザーの関心のある地域（たとえば、
|
| void |
segmentWithResultListener（MPImage image、InteractiveSegmenter.RegionOfInterest roi、ImageProcessingOptions imageProcessingOptions）
ユーザーの関心のある地域に基づいて、指定された単一の画像でセグメンテーションを行い、
InteractiveSegmenter.InteractiveSegmenterOptions の OutputHandler.ResultListener を介してゼロコピーされた結果を提供します。 |
継承されるメソッド
パブリック メソッド
public static InteractiveSegmenter createFromOptions （コンテキスト コンテキスト、InteractiveSegmenter.InteractiveSegmenterOptionssegmenterOptions）
InteractiveSegmenter.InteractiveSegmenterOptions から InteractiveSegmenter インスタンスを作成します。
パラメータ
| コンテキスト | Android ERROR(/Context)。 |
|---|---|
| segmenterOptions | InteractiveSegmenter.InteractiveSegmenterOptions インスタンス。 |
例外
InteractiveSegmenter の作成中にエラーが発生した場合。 |
public ImageSegmenterResult segment (MPImage image, InteractiveSegmenter.RegionOfInterest roi)
ユーザーの関心領域に応じて、デフォルトの画像処理オプションを使用して、指定された 1 つの画像に対してセグメンテーションを実行します（回転は適用されません）。入力画像形式の Java ドキュメントを更新する。
ユーザーは InteractiveSegmenter.RegionOfInterest でユーザー操作を表すことができます。これは、特定の対象領域に焦点を当ててセグメンテーションを実行する際のヒントになります。
InteractiveSegmenter は、次の色空間タイプをサポートしています。
パラメータ
| イメージ | 処理する MediaPipe MPImage オブジェクト。 |
|---|---|
| ROI | ユーザー操作を表す InteractiveSegmenter.RegionOfInterest オブジェクト。 |
例外
内部エラーが発生した場合。または、InteractiveSegmenter が OutputHandler.ResultListener で作成された場合です。 |
public ImageSegmenterResult segment (MPImage image, InteractiveSegmenter.RegionOfInterest roi, ImageProcessingOptions imageProcessingOptions)
ユーザーの関心のある地域に基づいて、指定された単一の画像でセグメンテーションを実行します。入力画像形式の Java ドキュメントを更新。
ユーザーは InteractiveSegmenter.RegionOfInterest でユーザー操作を表すことができます。これは、特定の対象領域に焦点を当ててセグメンテーションを実行する際のヒントになります。
InteractiveSegmenter は、次の色空間タイプをサポートしています。
パラメータ
| イメージ | 処理する MediaPipe MPImage オブジェクト。 |
|---|---|
| ROI | ユーザー操作を表す InteractiveSegmenter.RegionOfInterest オブジェクト。 |
| imageProcessingOptions | 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。 |
例外
| IllegalArgumentException | ImageProcessingOptions が関心のある地域を指定している場合。 |
|---|---|
内部エラーが発生した場合。または、InteractiveSegmenter が OutputHandler.ResultListener で作成された場合です。 |
public void segmentWithResultListener （MPImage 画像、InteractiveSegmenter.RegionOfInterest roi）
指定された単一の画像に対して、ユーザーの関心領域に応じて（つまり回転を適用せずに）デフォルトの画像処理オプションを使用してセグメンテーションを行い、InteractiveSegmenter.InteractiveSegmenterOptions の OutputHandler.ResultListener を介してゼロコピーされた結果を提供します。
入力画像形式の Java ドキュメントを更新。
ユーザーは InteractiveSegmenter.RegionOfInterest でユーザー操作を表すことができます。これは、特定の対象領域に焦点を当ててセグメンテーションを実行する際のヒントになります。
InteractiveSegmenter は、次の色空間タイプをサポートしています。
パラメータ
| イメージ | 処理する MediaPipe MPImage オブジェクト。 |
|---|---|
| ROI | ユーザー操作を表す InteractiveSegmenter.RegionOfInterest オブジェクト。 |
例外
| IllegalArgumentException | ImageProcessingOptions が関心のある地域を指定している場合。 |
|---|---|
内部エラーが発生した場合。または、InteractiveSegmenter.InteractiveSegmenterOptions で OutputHandler.ResultListener を設定して InteractiveSegmenter が作成されていない場合。 |
public void segmentWithResultListener （MPImage 画像、InteractiveSegmenter.RegionOfInterest roi、ImageProcessingOptions imageProcessingOptions）
ユーザーの関心のある地域に基づいて、指定された単一の画像でセグメンテーションを行い、InteractiveSegmenter.InteractiveSegmenterOptions の OutputHandler.ResultListener を介してゼロコピーの結果を提供します。
入力画像形式の Java ドキュメントを更新。
ユーザーは InteractiveSegmenter.RegionOfInterest でユーザー操作を表すことができます。これは、特定の対象領域に焦点を当ててセグメンテーションを実行する際のヒントになります。
InteractiveSegmenter は、次の色空間タイプをサポートしています。
パラメータ
| イメージ | 処理する MediaPipe MPImage オブジェクト。 |
|---|---|
| ROI | ユーザー操作を表す InteractiveSegmenter.RegionOfInterest オブジェクト。 |
| imageProcessingOptions | 推論を実行する前に入力画像を処理する方法を指定する ImageProcessingOptions。このタスクでは、関心領域はサポートされていません。ImageProcessingOptions.regionOfInterest() を指定すると、このメソッドは IllegalArgumentException をスローします。 |
例外
| IllegalArgumentException | ImageProcessingOptions が関心のある地域を指定している場合。 |
|---|---|
内部エラーが発生した場合。または、InteractiveSegmenter.InteractiveSegmenterOptions で OutputHandler.ResultListener を設定して InteractiveSegmenter が作成されていない場合。 |