HandLandmarker

classe pubblica finale HandLandmarker

Esegue il rilevamento dei punti di riferimento della mano sulle immagini.

Questa API prevede un bundle di asset del modello di punti di riferimento della mano preaddestrato. Vedere la sezione .

  • Immagine di input MPImage
    • L'immagine su cui viene eseguito il rilevamento dei punti di riferimento della mano.
  • Risultato dell'indicatore manuale di output HandLandmarkerResult
    • Un HandLandMarkResult che contiene i punti di riferimento delle mani.

Corsi nidificati

classe HandLandmarker.HandLandmarkerOptions Opzioni per configurare un HandLandmarker

Campi

pubblico statico finale Set<Connection> HAND_CONNECTIONS
pubblico statico finale Set<Connection> HAND_INDEX_FINGER_CONNECTIONS
pubblico statico finale Set<Connection> HAND_MIDDLE_FINGER_CONNECTIONS
pubblico statico finale Set<Connection> HAND_PALM_CONNECTIONS
pubblico statico finale Set<Connection> HAND_PINKY_FINGER_CONNECTIONS
pubblico statico finale Set<Connection> HAND_RING_FINGER_CONNECTIONS
pubblico statico finale Set<Connection> HAND_THUMB_CONNECTIONS

Metodi pubblici

statico HandLandmarker
createFromBuffer(Context context, ByteBuffer modelBuffer)
Crea un'istanza HandLandmarker da un buffer del modello e il valore predefinito HandLandmarker.HandLandmarkerOptions.
statico HandLandmarker
createFromFile(Contesto del contesto, Stringa modelPath)
Crea un'istanza HandLandmarker da un file del modello e dal valore predefinito HandLandmarker.HandLandmarkerOptions.
statico HandLandmarker
createFromFile(Contesto del contesto, File modelFile)
Crea un'istanza HandLandmarker da un file del modello e dal valore predefinito HandLandmarker.HandLandmarkerOptions.
statico HandLandmarker
createFromOptions(Contesto del contesto, HandLandmarker.HandLandmarkerOptions distintierOptions)
HandLandmarkerResult
detect(immagine MPImage)
Esegue il rilevamento dei punti di riferimento della mano sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ad esempio
HandLandmarkerResult
detect(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)
Esegue il rilevamento dei punti di riferimento della mano sull'immagine singola fornita.
void
detectAsync(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs)
Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento delle mani. I risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in HandLandmarker.HandLandmarkerOptions.
void
detectAsync(immagine MPImage, timestamp lunghiM)
Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento delle mani con opzioni di elaborazione delle immagini predefinite, ad esempio
HandLandmarkerResult
detectForVideo(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)
Esegue il rilevamento dei punti di riferimento della mano sul fotogramma video fornito.
HandLandmarkerResult
detectForVideo(immagine MPImage, timestamp lunghiM)
Esegue il rilevamento dei punti di riferimento della mano sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio

Metodi ereditati

Campi

statica pubblica finale Imposta<Connessione> HAND_CONNECTIONS

statica pubblica finale Imposta<Connessione> HAND_INDEX_FINGER_CONNECTIONS

statica pubblica finale Imposta<Connessione> HAND_MIDDLE_FINGER_CONNECTIONS

statica pubblica finale Imposta<Connessione> HAND_PALM_CONNECTIONS

statica pubblica finale Imposta<Connessione> HAND_PINKY_FINGER_CONNECTIONS

statica pubblica finale Imposta<Connessione> HAND_RING_FINGER_CONNECTIONS

statica pubblica finale Imposta<Connessione> HAND_THUMB_CONNECTIONS

Metodi pubblici

pubblico statico HandLandmarker createFromBuffer (Context context, ByteBuffer modelBuffer)

Crea un'istanza HandLandmarker da un buffer del modello e il valore predefinito HandLandmarker.HandLandmarkerOptions.

Parametri
context un ERROR(/Context) Android.
modelBuffer un ByteBuffer diretto o un ERROR(/MappedByteBuffer) del modello di rilevamento.
Lanci
in caso di errore durante la creazione di HandLandmarker.

pubblico statico HandLandmarker createFromFile (Context context, String modelPath)

Crea un'istanza HandLandmarker da un file del modello e dal valore predefinito HandLandmarker.HandLandmarkerOptions.

Parametri
context un ERROR(/Context) Android.
modelPath del modello dei punti di riferimento della mano con metadati negli asset.
Lanci
in caso di errore durante la creazione di HandLandmarker.

pubblico statico HandLandmarker createFromFile (Contesto del contesto, File modelFile)

Crea un'istanza HandLandmarker da un file del modello e dal valore predefinito HandLandmarker.HandLandmarkerOptions.

Parametri
context un ERROR(/Context) Android.
modelFile l'istanza del modello File con punti di riferimento della mano.
Lanci
IOException se si verifica un errore I/O all'apertura del file del modello tflite.
in caso di errore durante la creazione di HandLandmarker.

pubblico static HandLandmarker createFromOptions (Context context, HandLandmarker.HandLandmarkerOptions LandmarkerOptions)

Parametri
context un ERROR(/Context) Android.
landmarkerOptions un'istanza HandLandmarker.HandLandmarkerOptions.
Lanci
in caso di errore durante la creazione di HandLandmarker.

Public HandLandmarkerResult detect (MPImage immagine)

Esegue il rilevamento dei punti di riferimento della mano sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando HandLandmarker viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

HandLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
Lanci
in caso di errore interno.

pubblici HandLandmarkerResult detect (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)

Esegue il rilevamento dei punti di riferimento della mano sull'immagine singola fornita. Utilizza questo metodo solo quando HandLandmarker viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

HandLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public void detectAsync (immagine MPImage, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)

Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento delle mani. I risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in HandLandmarker.HandLandmarkerOptions. Utilizza questo metodo solo quando HandLandmarker viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata all'indicatore di riferimento della mano. I timestamp di input devono essere crescenti in modo monotonico.

HandLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs il timestamp di input (in millisecondi).
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public void detectAsync (immagine MPImage, timestamp lunghiM)

Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento manuali con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione, e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in HandLandmarker.HandLandmarkerOptions. Utilizza questo metodo solo quando HandLandmarker viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata all'indicatore di riferimento della mano. I timestamp di input devono essere crescenti in modo monotonico.

HandLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
timestampMs il timestamp di input (in millisecondi).
Lanci
in caso di errore interno.

pubblici HandLandmarkerResult detectForVideo (MPImage immagine, ImageProcessingOptions imageProcessOptions, timestamp lunghiMs)

Esegue il rilevamento dei punti di riferimento della mano sul fotogramma video fornito. Utilizza questo metodo solo quando HandLandmarker viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

HandLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs il timestamp di input (in millisecondi).
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public HandLandmarkerResult detectForVideo (immagine MPImage, timestamp lunghiM)

Esegue il rilevamento dei punti di riferimento della mano sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando HandLandmarker viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

HandLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
timestampMs il timestamp di input (in millisecondi).
Lanci
in caso di errore interno.