Wykonuje stylizację twarzy na zdjęciach.
Pamiętaj, że oprócz standardowego interfejsu API stylizacji (stylize(MPImage) i ERROR(/#stylizeForVideo)), które pobierają zdjęcie wejściowe i zwracają dane wyjściowe, ale wymagają głębokiej kopii zwracanych danych, FaceStylizer obsługuje też interfejs API wywołania zwrotnego stylizeWithResultListener(MPImage) i ERROR(/#stylizeForVideoWithResultListener), który umożliwia dostęp do danych wyjściowych przez cały czas działania detektora wyników poprzez kopiowanie zerowe.
Interfejs API wywołania zwrotnego jest dostępny dla wszystkich RunningMode w FaceStylizer. Aby korzystać z interfejsu API wywołania zwrotnego, ustaw prawidłowo OutputHandler.ResultListener w FaceStylizer.FaceStylizerOptions.
Interfejs API oczekuje modelu TFLite z metadanymi modelu TFLite.
Zagnieżdżone klasy
| klasa | FaceStylizer.FaceStylizerOptions | Opcje konfigurowania: FaceStylizer |
|
Metody publiczne
| statyczny FaceStylizer |
createFromOptions(Kontekst; FaceStylizer.FaceStylizerOptions styleizerOptions))
Tworzy instancję
FaceStylizer z FaceStylizer.FaceStylizerOptions. |
| FaceStylizerResult |
stylize(obraz MPImage, opcje przetwarzania obrazu ImageProcessingOptions)
Wykonuje stylizację twarzy na przesłanym pojedynczym zdjęciu.
|
| FaceStylizerResult | |
| void |
stylizeWithResultListener(obraz MPImage)
Wykonuje stylizację twarzy na przesłanym pojedynczym obrazie z domyślnymi opcjami przetwarzania obrazu, tj.
|
| void |
stylizeWithResultListener(obraz MPImage, ImageProcessingOptions imageProcessingOptions)
Wykonuje stylizację twarzy na podanym pojedynczym obrazie i udostępnia wyniki bez kopiowania za pomocą funkcji
OutputHandler.ResultListener w FaceStylizer.FaceStylizerOptions. |
Metody dziedziczone
Metody publiczne
public static FaceStylizer createFromOptions (Kontekst kontekst, FaceStylizer.FaceStylizerOptions stylizerOptions)
Tworzy instancję FaceStylizer z FaceStylizer.FaceStylizerOptions.
Parametry
| sytuacja | ERROR(/Context) na Androidzie. |
|---|---|
| stylizerOptions | instancję FaceStylizer.FaceStylizerOptions. |
Rzuty
jeśli podczas tworzenia zbioru danych FaceStylizer wystąpi błąd.
|
public FaceStylizerResult stylizacja (obraz MPImage, ImageProcessingOptions imageProcessingOptions)
Wykonuje stylizację twarzy na przesłanym pojedynczym zdjęciu. Używaj tej metody tylko wtedy, gdy tworzony jest FaceStylizer za pomocą RunningMode.IMAGE.
FaceStylizer obsługuje te typy przestrzeni kolorów:
Obraz wejściowy może mieć dowolny rozmiar. Obraz wyjściowy to stylizowany obraz z najbardziej widoczną twarzą. Rozmiar stylizowanego obrazu wyjściowego jest taki sam jak rozmiar wyjściowy modelu. Jeśli na obrazie wejściowego nie zostanie wykryta twarz, zwraca wartość Optional.empty().
Parametry
| obraz | do przetwarzania obiektu MediaPipe MPImage. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions określający sposób przetwarzania obrazu wejściowego przed uruchomieniem wnioskowania. Zwróć uwagę, że to zadanie nie obsługuje regionu zainteresowań: określenie wartości ImageProcessingOptions.regionOfInterest() spowoduje, że ta metoda spowoduje zgłoszenie wyjątku IllegalArgumentException. |
Rzuty
| IllegalArgumentException | jeśli ImageProcessingOptions określa region zainteresowań. |
|---|---|
jeśli wystąpił błąd wewnętrzny. Lub jeśli utworzono FaceStylizer z OutputHandler.ResultListener.
|
public FaceStylizerResult stylizuj (obraz MPImage)
Wykonuje stylizację twarzy na przesłanym pojedynczym obrazie z domyślnymi opcjami przetwarzania obrazu, tj. bez zastosowania rotacji. Używaj tej metody tylko wtedy, gdy FaceStylizer zostaje utworzony za pomocą RunningMode.IMAGE.
FaceStylizer obsługuje te typy przestrzeni kolorów:
Obraz wejściowy może mieć dowolny rozmiar. Obraz wyjściowy to stylizowany obraz z najbardziej widoczną twarzą. Rozmiar stylizowanego obrazu wyjściowego jest taki sam jak rozmiar wyjściowy modelu. Jeśli na obrazie wejściowego nie zostanie wykryta twarz, zwraca wartość Optional.empty().
Parametry
| obraz | do przetwarzania obiektu MediaPipe MPImage. |
|---|
Rzuty
jeśli wystąpił błąd wewnętrzny. Lub jeśli utworzono FaceStylizer z OutputHandler.ResultListener.
|
public void stylizeWithResultListener (obraz MPImage)
Wykonuje stylizację twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, tj. bez zastosowanego obracania, i udostępnia wyniki bez kopiowania za pomocą funkcji OutputHandler.ResultListener w FaceStylizer.FaceStylizerOptions. Używaj tej metody tylko wtedy, gdy FaceStylizer zostaje utworzony za pomocą RunningMode.IMAGE.
FaceStylizer obsługuje te typy przestrzeni kolorów:
Obraz wejściowy może mieć dowolny rozmiar. Obraz wyjściowy to stylizowany obraz z najbardziej widoczną twarzą. Rozmiar stylizowanego obrazu wyjściowego jest taki sam jak rozmiar wyjściowy modelu. Jeśli na obrazie wejściowego nie zostanie wykryta twarz, zwraca wartość Optional.empty().
Parametry
| obraz | do przetwarzania obiektu MediaPipe MPImage. |
|---|
Rzuty
| IllegalArgumentException | jeśli ImageProcessingOptions określa region zainteresowań. |
|---|---|
jeśli wystąpił błąd wewnętrzny. Lub jeśli FaceStylizer nie został utworzony z OutputHandler.ResultListener ustawionym w FaceStylizer.FaceStylizerOptions.
|
public void stylizeWithResultListener (obraz MPImage, ImageProcessingOptions imageProcessingOptions)
Wykonuje stylizację twarzy na podanym pojedynczym obrazie i udostępnia wyniki bez kopiowania za pomocą funkcji OutputHandler.ResultListener w FaceStylizer.FaceStylizerOptions. Używaj tej metody tylko wtedy, gdy tworzony jest FaceStylizer za pomocą RunningMode.IMAGE.
FaceStylizer obsługuje te typy przestrzeni kolorów:
Obraz wejściowy może mieć dowolny rozmiar. Obraz wyjściowy to stylizowany obraz z najbardziej widoczną twarzą. Rozmiar stylizowanego obrazu wyjściowego jest taki sam jak rozmiar wyjściowy modelu. Jeśli na obrazie wejściowego nie zostanie wykryta twarz, zwraca wartość Optional.empty().
Parametry
| obraz | do przetwarzania obiektu MediaPipe MPImage. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions określający sposób przetwarzania obrazu wejściowego przed uruchomieniem wnioskowania. Zwróć uwagę, że to zadanie nie obsługuje regionu zainteresowań: określenie wartości ImageProcessingOptions.regionOfInterest() spowoduje, że ta metoda spowoduje zgłoszenie wyjątku IllegalArgumentException. |
Rzuty
| IllegalArgumentException | jeśli ImageProcessingOptions określa region zainteresowań. |
|---|---|
jeśli wystąpił błąd wewnętrzny. Lub jeśli FaceStylizer nie został utworzony z OutputHandler.ResultListener ustawionym w FaceStylizer.FaceStylizerOptions.
|