FaceStylizer

公開最終類別 FaceStylizer

對圖片執行臉部樣式化。

請注意，除了標準樣式 API (stylize(MPImage) 和 ERROR(/#stylizeForVideo)) 以外，除了採用輸入圖片及傳回輸出內容以外，FaceStylizer 也支援回呼 API、stylizeWithResultListener(MPImage) 和 ERROR(/#stylizeForVideoWithResultListener)，可讓您在結果事件監聽器期間透過零副本存取輸出內容。

FaceStylizer 中的所有 RunningMode 都可使用回呼 API。在 FaceStylizer.FaceStylizerOptions 中正確設定 OutputHandler.ResultListener，以使用回呼 API。

API 預期會使用 TFLite 模型中繼資料的 TFLite 模型。

  • 輸入圖片 MPImage
    • 臉部風格化器的圖片運作。
  • 輸出 MPImage MPImage
    • 含有風格化臉孔的 MPImage。

巢狀類別

類別 FaceStylizer.FaceStylizerOptions 設定 FaceStylizer 的選項。 

公用方法

靜態 FaceStylizer
createFromOptions(內容結構定義、FaceStylizer.FaceStylizerOptions stylizerOptions)
從 FaceStylizer.FaceStylizerOptions 建立 FaceStylizer 例項。
FaceStylizerResult
stylize(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
針對提供的單張圖片執行臉部風格設定。
FaceStylizerResult
風格化(MPImage 圖片)
對提供預設圖片處理選項 (即
void
stylizeWithResultListener(MPImage 圖片)
對提供預設圖片處理選項 (即
void
stylizeWithResultListener(MPImage 圖片、ImageProcessingOptions imageProcessingOptions)
對提供的單一圖片執行臉部樣式，並透過 FaceStylizer.FaceStylizerOptions 中的 OutputHandler.ResultListener 提供零複製結果。

繼承的方法

公用方法

公開 靜態 FaceStylizer createFromOptions (內容結構定義、FaceStylizer.FaceStylizerOptions stylizerOptions)

從 FaceStylizer.FaceStylizerOptions 建立 FaceStylizer 例項。

參數
context Android ERROR(/Context)。
stylizerOptions FaceStylizer.FaceStylizerOptions 執行個體。
擲回
如果 FaceStylizer 建立期間發生錯誤。

public FaceStylizerResult stylize (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)

針對提供的單張圖片執行臉部風格設定。只有在使用 RunningMode.IMAGE 建立 FaceStylizer 時，才能使用這個方法。

FaceStylizer 支援下列色彩空間類型：

輸入圖片可以使用任何大小。輸出圖片是擁有最多可見臉孔的風格化圖片。樣式化輸出圖片大小與模型輸出大小相同。在輸入圖片上未偵測到任何臉孔時，會傳回 Optional.empty()。

參數
圖片 要處理的 MediaPipe MPImage 物件。
imageProcessingOptions 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions。請注意，這項工作「不」支援搜尋區域：指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。
擲回
IllegalArgumentException 表示 ImageProcessingOptions 指定搜尋區域。
。或者，如果 FaceStylizer 使用 OutputHandler.ResultListener 建立。

公開 FaceStylizerResult 風格化 (MPImage 圖片)

對提供的單一圖片執行臉部樣式化，並使用預設圖片處理選項 (即未套用任何旋轉選項)。只有在使用 RunningMode.IMAGE 建立 FaceStylizer 時，才能使用這個方法。

FaceStylizer 支援下列色彩空間類型：

輸入圖片可以使用任何大小。輸出圖片是擁有最多可見臉孔的風格化圖片。樣式化輸出圖片大小與模型輸出大小相同。在輸入圖片上未偵測到任何臉孔時，會傳回 Optional.empty()。

參數
圖片 要處理的 MediaPipe MPImage 物件。
擲回
。或者，如果 FaceStylizer 使用 OutputHandler.ResultListener 建立。

public void stylizeWithResultListener (MPImage 圖片)

對具有預設圖片處理選項 (即未套用任何旋轉) 提供的單一圖片執行臉部樣式化，並透過 FaceStylizer.FaceStylizerOptions 中的 OutputHandler.ResultListener 提供零複製結果。只有在使用 RunningMode.IMAGE 建立 FaceStylizer 時，才能使用這個方法。

FaceStylizer 支援下列色彩空間類型：

輸入圖片可以使用任何大小。輸出圖片是擁有最多可見臉孔的風格化圖片。樣式化輸出圖片大小與模型輸出大小相同。在輸入圖片上未偵測到任何臉孔時，會傳回 Optional.empty()。

參數
圖片 要處理的 MediaPipe MPImage 物件。
擲回
IllegalArgumentException 表示 ImageProcessingOptions 指定搜尋區域。
。或者，如果 FaceStylizer 不是使用 FaceStylizer.FaceStylizerOptions 中設定的 OutputHandler.ResultListener 建立。

public void stylizeWithResultListener (MPImage 圖片、ImageProcessingOptions imageProcessingOptions)

對提供的單一圖片執行臉部樣式，並透過 FaceStylizer.FaceStylizerOptions 中的 OutputHandler.ResultListener 提供零複製結果。只有在使用 RunningMode.IMAGE 建立 FaceStylizer 時，才能使用這個方法。

FaceStylizer 支援下列色彩空間類型：

輸入圖片可以使用任何大小。輸出圖片是擁有最多可見臉孔的風格化圖片。樣式化輸出圖片大小與模型輸出大小相同。在輸入圖片上未偵測到任何臉孔時，會傳回 Optional.empty()。

參數
圖片 要處理的 MediaPipe MPImage 物件。
imageProcessingOptions 用於指定在執行推論之前如何處理輸入圖片的 ImageProcessingOptions。請注意，這項工作「不」支援搜尋區域：指定 ImageProcessingOptions.regionOfInterest() 會導致這個方法擲回 IllegalArgumentException。
擲回
IllegalArgumentException 表示 ImageProcessingOptions 指定搜尋區域。
。或者，如果 FaceStylizer 不是使用 FaceStylizer.FaceStylizerOptions 中設定的 OutputHandler.ResultListener 建立。