FaceLandmarker

publiczna klasa finałowa FaceLandmarker

Wykrywanie na zdjęciach punktów orientacyjnych twarzy.

Ten interfejs API wymaga wytrenowanego pakietu zasobów z modelem punktów orientacyjnych twarzy. Patrz sekcja .

  • Obraz wejściowy MPImage
    • Obraz, na którym wykrywane są punkty orientacyjne.
  • Dane wyjściowe FaceLandmarkerResult
    • Obiekt FaceLandmarkerResult zawierający punkty orientacyjne twarzy.

Zagnieżdżone klasy

klasa FaceLandmarker.FaceLandmarkerOptions Opcje konfigurowania: FaceLandmarker 

Pola

public static final Set<Connection> FACE_LANDMARKS_CONNECTORS
public static final Set<Connection> FACE_LANDMARKS_FACE_OVAL
public static final Set<Connection> FACE_LANDMARKS_LEFT_EYE
public static final Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
public static final Set<Connection> FACE_LANDMARKS_LEFT_IRIS
public static final Set<Connection> FACE_LANDMARKS_LIPS
public static final Set<Connection> FACE_LANDMARKS_RIGHT_EYE
public static final Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
public static final Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
public static final Set<Connection> FACE_LANDMARKS_TESSELATION

Metody publiczne

statyczny FaceLandmarker
createFromBuffer(kontekst, zasób ByteBuffer)
Tworzy instancję FaceLandmarker z bufora pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.
statyczny FaceLandmarker
createFromFile(Kontekst; ciąg znaków modelAssetPath)
Tworzy instancję FaceLandmarker na podstawie ścieżki pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.
statyczny FaceLandmarker
createFromFile(Kontekst; Plik modelAssetFile)
Tworzy instancję FaceLandmarker z pliku pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.
statyczny FaceLandmarker
createFromOptions(Kontekst kontekst, FaceLandmarker.FaceLandmarkerOptions destinationerOptions)
Tworzy instancję FaceLandmarker z FaceLandmarker.FaceLandmarkerOptions.
FaceLandmarkerResult
detect(obraz MPImage)
Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, tj.
FaceLandmarkerResult
detect(obraz MPImage, ImageProcessingOptions imageProcessingOptions)
Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu.
void
detectAsync(obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych twarzy, a wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener w interfejsie FaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(obraz MPImage, długie sygnatury czasowe)
Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych twarzy za pomocą domyślnych opcji przetwarzania obrazu, np.
FaceLandmarkerResult
detectForVideo(obraz MPImage, ImageProcessingOptions imageProcessingOptions, długi timestampMs)
Wykrywanie punktów orientacyjnych twarzy w dostarczonej klatce wideo.
FaceLandmarkerResult
detectForVideo(obraz MPImage, długie sygnatury czasowe)
Wykrywanie punktów orientacyjnych twarzy w dostarczonej klatce wideo z domyślnymi opcjami przetwarzania obrazu, tj.

Metody dziedziczone

Pola

public static final Ustaw<Połączenie> FACE_LANDMARKS_CONNECTORS

public static final Ustaw<Połączenie> FACE_LANDMARKS_FACE_OVAL

public static final Ustaw<Połączenie> FACE_LANDMARKS_LEFT_EYE

public static final Ustaw<Połączenie> FACE_LANDMARKS_LEFT_EYE_BROW

public static final Ustaw<Połączenie> FACE_LANDMARKS_LEFT_IRIS

public static final Ustaw<Połączenie> FACE_LANDMARKS_LIPS

public static final Ustaw<Połączenie> FACE_LANDMARKS_RIGHT_EYE

public static final Ustaw<Połączenie> FACE_LANDMARKS_RIGHT_EYE_BROW

public static final Ustaw<Połączenie> FACE_LANDMARKS_RIGHT_IRIS

public static final Ustaw<Połączenie> FACE_LANDMARKS_TESSELATION

Metody publiczne

public static FaceLandmarker createFromBuffer (Kontekst kontekstu, ByteBuffer modelAssetBuffer)

Tworzy instancję FaceLandmarker z bufora pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.

Parametry
sytuacja ERROR(/Context) na Androidzie.
modelAssetBuffer
Rzuty
jeśli podczas tworzenia zbioru danych FaceLandmarker wystąpi błąd.

public static FaceLandmarker createFromFile (Kontekst kontekstu, Ciąg modelAssetPath)

Tworzy instancję FaceLandmarker na podstawie ścieżki pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.

Parametry
sytuacja ERROR(/Context) na Androidzie.
modelAssetPath ścieżki do modelu punktów orientacyjnych twarzy z metadanymi w zasobach.
Rzuty
jeśli podczas tworzenia zbioru danych FaceLandmarker wystąpi błąd.

public static FaceLandmarker createFromFile (Kontekst kontekstu, Plik modelAssetFile)

Tworzy instancję FaceLandmarker z pliku pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.

Parametry
sytuacja ERROR(/Context) na Androidzie.
modelAssetFile model File twarzy.
Rzuty
IOException jeśli podczas otwierania pliku modelu tflite wystąpi błąd wejścia-wyjścia.
jeśli podczas tworzenia zbioru danych FaceLandmarker wystąpi błąd.

public static FaceLandmarker createFromOptions (Kontekst kontekst, FaceLandmarker.FaceLandmarkerOptions pointerOptions)

Tworzy instancję FaceLandmarker z FaceLandmarker.FaceLandmarkerOptions.

Parametry
sytuacja ERROR(/Context) na Androidzie.
landmarkerOptions instancję FaceLandmarker.FaceLandmarkerOptions.
Rzuty
jeśli podczas tworzenia zbioru danych FaceLandmarker wystąpi błąd.

public FaceLandmarkerResult detect (obraz MPImage)

Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, tj. bez zastosowania rotacji. Używaj tej metody tylko wtedy, gdy tworzony jest FaceLandmarker za pomocą ERROR(/RunningMode.IMAGE). TODO zaktualizuj dokument Java pod kątem formatu obrazu wejściowego.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

Parametry
obraz do przetwarzania obiektu MediaPipe MPImage.
Rzuty
jeśli wystąpił błąd wewnętrzny.

public FaceLandmarkerResult detect (obraz MPImage, ImageProcessingOptions imageProcessingOptions)

Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu. Używaj tej metody tylko wtedy, gdy obiekt FaceLandmarker został utworzony za pomocą ERROR(/RunningMode.IMAGE). TODO Zaktualizuj dokument Java pod kątem formatu obrazu wejściowego.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

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.

public void detectAsync (obraz MPImage, ImageProcessingOptions imageProcessingOptions, długi timestampMs)

Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych twarzy, a wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener w interfejsie FaceLandmarker.FaceLandmarkerOptions. Używaj tej metody tylko wtedy, gdy FaceLandmarker zostaje utworzony za pomocą ERROR(/RunningMode.LIVE_STREAM).

Wymagane jest podanie sygnatury czasowej (w milisekundach), która wskazuje, kiedy obraz wejściowych ma zostać wysłany do elementu orientacyjnego z rozpoznawaniem twarzy. Podane sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

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.
timestampMs wejściową sygnaturę czasową (w milisekundach).
Rzuty
IllegalArgumentException jeśli ImageProcessingOptions określa region zainteresowań.
jeśli wystąpił błąd wewnętrzny.

public void detectAsync (obraz MPImage, długie sygnatura czasowa)

Wysyła bieżące dane zdjęcia, aby umożliwić wykrywanie punktów orientacyjnych twarzy przy użyciu domyślnych opcji przetwarzania obrazu, tj.bez zastosowania rotacji. Wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener podanej w FaceLandmarker.FaceLandmarkerOptions. Używaj tej metody tylko wtedy, gdy obiekt FaceLandmarker został utworzony za pomocą ERROR(/RunningMode.LIVE_STREAM).

Wymagane jest podanie sygnatury czasowej (w milisekundach), która wskazuje, kiedy obraz wejściowych ma zostać wysłany do elementu orientacyjnego z rozpoznawaniem twarzy. Podane sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

Parametry
obraz do przetwarzania obiektu MediaPipe MPImage.
timestampMs wejściową sygnaturę czasową (w milisekundach).
Rzuty
jeśli wystąpił błąd wewnętrzny.

public FaceLandmarkerResult detectForVideo (obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Wykrywanie punktów orientacyjnych twarzy w dostarczonej klatce wideo. Używaj tej metody tylko wtedy, gdy obiekt FaceLandmarker został utworzony za pomocą ERROR(/RunningMode.VIDEO).

Wymagane jest podanie sygnatury czasowej klatki wideo (w milisekundach). Wejściowe sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

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.
timestampMs wejściową sygnaturę czasową (w milisekundach).
Rzuty
IllegalArgumentException jeśli ImageProcessingOptions określa region zainteresowań.
jeśli wystąpił błąd wewnętrzny.

public FaceLandmarkerResult detectForVideo (obraz MPImage, długie sygnatury czasowe)

Wykrywanie punktów orientacyjnych twarzy w dostarczonej ramce wideo z domyślnymi opcjami przetwarzania obrazu, tj. bez zastosowania rotacji. Używaj tej metody tylko wtedy, gdy tworzony jest FaceLandmarker za pomocą ERROR(/RunningMode.VIDEO).

Wymagane jest podanie sygnatury czasowej klatki wideo (w milisekundach). Wejściowe sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

Parametry
obraz do przetwarzania obiektu MediaPipe MPImage.
timestampMs wejściową sygnaturę czasową (w milisekundach).
Rzuty
jeśli wystąpił błąd wewnętrzny.