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)
Crea un'istanza
HandLandmarker da un HandLandmarker.HandLandmarkerOptions . |
HandLandmarkerResult | |
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
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)
Crea un'istanza HandLandmarker
da un HandLandmarker.HandLandmarkerOptions
.
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. |