HandLandmarker

publiczna klasa finałowa HandLandmarker

Wykrywa na zdjęciach punkty orientacyjne dłoni.

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

  • Obraz wejściowy MPImage
    • Obraz, na którym działa wykrywanie punktów orientacyjnych.
  • Dane wyjściowe HandLandmarkerResult HandLandmarkerResult
    • Parametr HandLandmarkerResult zawierający punkty orientacyjne.

Zagnieżdżone klasy

klasa HandLandmarker.HandLandmarkerOptions Opcje konfigurowania: HandLandmarker 

Pola

public static final Set<Connection> HAND_CONNECTIONS
public static final Set<Connection> HAND_INDEX_FINGER_CONNECTIONS
public static final Set<Connection> HAND_MIDDLE_FINGER_CONNECTIONS
public static final Set<Connection> HAND_PALM_CONNECTIONS
public static final Set<Connection> HAND_PINKY_FINGER_CONNECTIONS
public static final Set<Connection> HAND_RING_FINGER_CONNECTIONS
public static final Set<Connection> HAND_THUMB_CONNECTIONS

Metody publiczne

statyczny HandLandmarker
createFromBuffer(kontekst kontekst, ByteBuffer modelBuffer)
Tworzy instancję HandLandmarker z bufora modelu i domyślnej wartości HandLandmarker.HandLandmarkerOptions.
statyczny HandLandmarker
createFromFile(Kontekst; ciąg znaków modelPath)
Tworzy instancję HandLandmarker z pliku modelu i domyślne HandLandmarker.HandLandmarkerOptions.
statyczny HandLandmarker
createFromFile(kontekst; plik modelFile)
Tworzy instancję HandLandmarker z pliku modelu i domyślne HandLandmarker.HandLandmarkerOptions.
statyczny HandLandmarker
createFromOptions(Kontekst kontekstowy, HandLandmarker.HandLandmarkerOptions pointerOptions)
Tworzy instancję HandLandmarker z HandLandmarker.HandLandmarkerOptions.
HandLandmarkerResult
detect(obraz MPImage)
Wykrywanie punktów orientacyjnych na pojedynczym obrazie za pomocą domyślnych opcji przetwarzania obrazu, tj.
HandLandmarkerResult
detect(obraz MPImage, ImageProcessingOptions imageProcessingOptions)
Wykrywanie punktów orientacyjnych dłoni na pojedynczym zdjęciu.
void
detectAsync(obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych dłoni, a wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener w interfejsie HandLandmarker.HandLandmarkerOptions.
void
detectAsync(obraz MPImage, długie sygnatury czasowe)
Wysyła bieżące dane obrazu, aby wykrywać punkty orientacyjne dłoni za pomocą domyślnych opcji przetwarzania obrazu, np.
HandLandmarkerResult
detectForVideo(obraz MPImage, ImageProcessingOptions imageProcessingOptions, długi timestampMs)
Wykrywanie punktów orientacyjnych dłoni na podanej klatce wideo.
HandLandmarkerResult
detectForVideo(obraz MPImage, długie sygnatury czasowe)
Wykrywanie punktów orientacyjnych dłoni w podanej klatce wideo z domyślnymi opcjami przetwarzania obrazu, tj.

Metody dziedziczone

Pola

public static final Ustaw<Połączenie> HAND_CONNECTIONS

public static final Ustaw<Połączenie> HAND_INDEX_FINGER_CONNECTIONS

public static final Ustaw<Połączenie> HAND_MIDDLE_FINGER_CONNECTIONS

public static final Ustaw<Połączenie> HAND_PALM_CONNECTIONS

public static final Ustaw<Połączenie> HAND_PINKY_FINGER_CONNECTIONS

public static final Ustaw<Połączenie> HAND_RING_FINGER_CONNECTIONS

public static final Ustaw<Połączenie> HAND_THUMB_CONNECTIONS

Metody publiczne

public static HandLandmarker createFromBuffer (Kontekst kontekstu, ByteBuffer modelBuffer)

Tworzy instancję HandLandmarker z bufora modelu i domyślnej wartości HandLandmarker.HandLandmarkerOptions.

Parametry
sytuacja ERROR(/Context) na Androidzie.
modelBuffer bezpośrednie ByteBuffer lub ERROR(/MappedByteBuffer) modelu wykrywania.
Rzuty
jeśli podczas tworzenia zbioru danych HandLandmarker wystąpi błąd.

public static HandLandmarker createFromFile (Kontekst kontekst, String modelPath)

Tworzy instancję HandLandmarker z pliku modelu i domyślne HandLandmarker.HandLandmarkerOptions.

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

public static HandLandmarker createFromFile (Kontekst kontekst, Plik modelFile)

Tworzy instancję HandLandmarker z pliku modelu i domyślne HandLandmarker.HandLandmarkerOptions.

Parametry
sytuacja ERROR(/Context) na Androidzie.
modelFile z wystąpieniem modelu punktów orientacyjnych dłoni (File).
Rzuty
IOException jeśli podczas otwierania pliku modelu tflite wystąpi błąd wejścia-wyjścia.
jeśli podczas tworzenia zbioru danych HandLandmarker wystąpi błąd.

public static HandLandmarker createFromOptions (Kontekst kontekst, HandLandmarker.HandLandmarkerOptions pointerOptions)

Tworzy instancję HandLandmarker z HandLandmarker.HandLandmarkerOptions.

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

public HandLandmarkerResult detect (obraz MPImage)

Wykrywanie punktów orientacyjnych 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 HandLandmarker za pomocą ERROR(/RunningMode.IMAGE). TODO zaktualizuj dokument Java pod kątem formatu obrazu wejściowego.

HandLandmarker obsługuje te typy przestrzeni kolorów:

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

public HandLandmarkerResult detect (obraz MPImage, ImageProcessingOptions imageProcessingOptions)

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

HandLandmarker 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 dłoni, a wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener w interfejsie HandLandmarker.HandLandmarkerOptions. Używaj tej metody tylko wtedy, gdy HandLandmarker zostaje utworzony za pomocą ERROR(/RunningMode.LIVE_STREAM).

Konieczne jest podanie sygnatury czasowej (w milisekundach), która wskazuje, kiedy obraz wejściowy ma zostać wysłany do punktu orientacyjnego z ręką. Podane sygnatury czasowe muszą rosnąć monotonicznie.

HandLandmarker 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 obrazu, aby wykonać wykrywanie punktów orientacyjnych dłoni przy użyciu domyślnych opcji przetwarzania obrazu, tj.bez zastosowanego obracania. Wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener podanej w HandLandmarker.HandLandmarkerOptions. Używaj tej metody tylko wtedy, gdy obiekt HandLandmarker został utworzony za pomocą ERROR(/RunningMode.LIVE_STREAM).

Konieczne jest podanie sygnatury czasowej (w milisekundach), która wskazuje, kiedy obraz wejściowy ma zostać wysłany do punktu orientacyjnego z ręką. Podane sygnatury czasowe muszą rosnąć monotonicznie.

HandLandmarker 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 HandLandmarkerResult detectForVideo (obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Wykrywanie punktów orientacyjnych dłoni na podanej klatce wideo. Używaj tej metody tylko wtedy, gdy obiekt HandLandmarker został utworzony za pomocą ERROR(/RunningMode.VIDEO).

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

HandLandmarker 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 HandLandmarkerResult detectForVideo (obraz MPImage, długie sygnatury czasowe)

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

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

HandLandmarker 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.