HandLandmarker

classe finale publique HandLandmarker

Effectue une détection des points de repère de la main sur les images.

Cette API attend un lot d'assets pré-entraînés de modèle de points de repère main. Voir la section .

  • Image d'entrée MPImage
    • Image utilisée par la main pour la détection des points de repère.
  • Résultat HandLandMarkerResult de sortie HandLandmarkerResult
    • Un objet HandLandMarkerResult contenant des points de repère pour la main.

Classes imbriquées

classe HandLandmarker.HandLandmarkerOptions Options de configuration d'un HandLandmarker

Champs

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

Méthodes publiques

HandLandmarker statique
createFromBuffer(contexte de contexte, modelBuffer ByteBuffer)
Crée une instance HandLandmarker à partir d'un tampon de modèle et la valeur HandLandmarker.HandLandmarkerOptions par défaut.
HandLandmarker statique
createFromFile(contexte de contexte, String modelPath)
Crée une instance HandLandmarker à partir d'un fichier de modèle et de la valeur HandLandmarker.HandLandmarkerOptions par défaut.
HandLandmarker statique
createFromFile(contexte de contexte, File modelFile)
Crée une instance HandLandmarker à partir d'un fichier de modèle et de la valeur HandLandmarker.HandLandmarkerOptions par défaut.
HandLandmarker statique
HandLandmarkerResult
detect(image MPImage)
Effectue une détection des points de repère de la main sur l'image unique fournie avec des options de traitement d'image par défaut, telles que
HandLandmarkerResult
detect(image MPImage, ImageProcessingOptions imageProcessingOptions)
Effectue la détection des points de repère de la main sur l'image unique fournie.
void
detectAsync(image MPImage, ImageProcessingOptions imageProcessOptions, code temporel long)
Envoie des données d'image en direct pour détecter les points de repère de la main. Les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le HandLandmarker.HandLandmarkerOptions.
void
detectAsync(image MPImage, code temporel long)
Envoie des données d'image en direct pour détecter les points de repère de la main avec des options de traitement d'image par défaut, par exemple
HandLandmarkerResult
detectForVideo(image MPImage, ImageProcessingOptions imageProcessingOptions, longtimestampMs)
Effectue la détection des points de repère de la main sur l'image vidéo fournie.
HandLandmarkerResult
detectForVideo(image MPImage, code temporel long)
Effectue une détection des points de repère de la main sur l'image vidéo fournie avec des options de traitement d'image par défaut, telles que

Méthodes héritées

Champs

public statique final Set<Connection> HAND_CONNECTIONS

public statique final Set<Connection> HAND_INDEX_FINGER_CONNECTIONS

public statique final Set<Connection> HAND_MIDDLE_FINGER_CONNECTIONS

public statique final Set<Connection> HAND_PALM_CONNECTIONS

public statique final Set<Connection> HAND_PINKY_FINGER_CONNECTIONS

public statique final Set<Connection> HAND_RING_FINGER_CONNECTIONS

public statique final Set<Connection> HAND_THUMB_CONNECTIONS

Méthodes publiques

public statique HandLandmarker createFromBuffer (contexte contextuel, ByteBuffer modelBuffer)

Crée une instance HandLandmarker à partir d'un tampon de modèle et la valeur HandLandmarker.HandLandmarkerOptions par défaut.

Paramètres
context un ERROR(/Context) Android.
modelBuffer un ByteBuffer ou un ERROR(/MappedByteBuffer) direct du modèle de détection.
Génère
si une erreur se produit lors de la création de HandLandmarker.

public statique HandLandmarker createFromFile (contexte de contexte, String modelPath)

Crée une instance HandLandmarker à partir d'un fichier de modèle et de la valeur HandLandmarker.HandLandmarkerOptions par défaut.

Paramètres
context un ERROR(/Context) Android.
modelPath Chemin d'accès au modèle des points de repère de la main avec les métadonnées dans les éléments.
Génère
si une erreur se produit lors de la création de HandLandmarker.

public statique HandLandmarker createFromFile (contexte contextuel, File modelFile)

Crée une instance HandLandmarker à partir d'un fichier de modèle et de la valeur HandLandmarker.HandLandmarkerOptions par défaut.

Paramètres
context un ERROR(/Context) Android.
modelFile l'instance File du modèle de points de repère de main.
Génère
IOException si une erreur d'E/S se produit lors de l'ouverture du fichier de modèle tflite.
si une erreur se produit lors de la création de HandLandmarker.

public statique HandLandmarker createFromOptions (contexte contextuel, HandLandmarker.HandLandmarkerOptions markerOptions)

Crée une instance HandLandmarker à partir d'un HandLandmarker.HandLandmarkerOptions.

Paramètres
context un ERROR(/Context) Android.
landmarkerOptions une instance HandLandmarker.HandLandmarkerOptions.
Génère
si une erreur se produit lors de la création de HandLandmarker.

public HandLandmarkerResult detect (MPImage image)

Effectue une détection des points de repère de la main sur l'image unique fournie avec des options de traitement d'image par défaut, c'est-à-dire sans appliquer de rotation. N'utilisez cette méthode que lorsque le HandLandmarker est créé avec ERROR(/RunningMode.IMAGE). TODO pour mettre à jour le document Java pour le format d'image d'entrée.

HandLandmarker accepte les types d'espaces colorimétriques suivants:

Paramètres
Image un objet MPImage MediaPipe à traiter.
Génère
en cas d'erreur interne.

public HandLandmarkerResult detect (MPImage image, ImageProcessingOptions imageProcessingOptions)

Effectue la détection des points de repère de la main sur l'image unique fournie. N'utilisez cette méthode que lorsque l'élément HandLandmarker est créé avec ERROR(/RunningMode.IMAGE). À FAIRE mettre à jour le document Java pour le format d'image d'entrée.

HandLandmarker accepte les types d'espaces colorimétriques suivants:

Paramètres
Image un objet MPImage MediaPipe à traiter.
imageProcessingOptions Le ImageProcessingOptions, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez ImageProcessingOptions.regionOfInterest(), cette méthode générera une exception IllegalArgumentException.
Génère
IllegalArgumentException si ImageProcessingOptions spécifie une région d'intérêt.
en cas d'erreur interne.

public void detectAsync (MPImage image, ImageProcessingOptions imageProcessingOptions, longTimestampMs)

Envoie des données d'image en direct pour détecter les points de repère de la main. Les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le HandLandmarker.HandLandmarkerOptions. N'utilisez cette méthode que lorsque l'élément HandLandmarker est créé avec ERROR(/RunningMode.LIVE_STREAM).

Il est nécessaire de fournir un horodatage (en millisecondes) pour indiquer le moment où l'image d'entrée est envoyée à l'outil de repère de la main. Les horodatages d'entrée doivent être croissants de manière monotone.

HandLandmarker accepte les types d'espaces colorimétriques suivants:

Paramètres
Image un objet MPImage MediaPipe à traiter.
imageProcessingOptions Le ImageProcessingOptions, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez ImageProcessingOptions.regionOfInterest(), cette méthode générera une exception IllegalArgumentException.
timestampMs l'horodatage d'entrée (en millisecondes) ;
Génère
IllegalArgumentException si ImageProcessingOptions spécifie une région d'intérêt.
en cas d'erreur interne.

public void detectAsync (image MPImage, code temporel long)

Envoie des données d'image en direct pour détecter les points de repère de la main avec des options de traitement d'image par défaut, c'est-à-dire sans rotation appliquée. Les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le HandLandmarker.HandLandmarkerOptions. N'utilisez cette méthode que lorsque l'élément HandLandmarker est créé avec ERROR(/RunningMode.LIVE_STREAM).

Il est nécessaire de fournir un horodatage (en millisecondes) pour indiquer le moment où l'image d'entrée est envoyée à l'outil de repère de la main. Les horodatages d'entrée doivent être croissants de manière monotone.

HandLandmarker accepte les types d'espaces colorimétriques suivants:

Paramètres
Image un objet MPImage MediaPipe à traiter.
timestampMs l'horodatage d'entrée (en millisecondes) ;
Génère
en cas d'erreur interne.

public HandLandmarkerResult detectForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, longTimestampMs)

Effectue la détection des points de repère de la main sur l'image vidéo fournie. N'utilisez cette méthode que lorsque l'élément HandLandmarker est créé avec ERROR(/RunningMode.VIDEO).

Il est obligatoire de fournir le code temporel de l'image vidéo (en millisecondes). Les horodatages d'entrée doivent être croissants de manière monotone.

HandLandmarker accepte les types d'espaces colorimétriques suivants:

Paramètres
Image un objet MPImage MediaPipe à traiter.
imageProcessingOptions Le ImageProcessingOptions, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez ImageProcessingOptions.regionOfInterest(), cette méthode générera une exception IllegalArgumentException.
timestampMs l'horodatage d'entrée (en millisecondes) ;
Génère
IllegalArgumentException si ImageProcessingOptions spécifie une région d'intérêt.
en cas d'erreur interne.

public HandLandmarkerResult detectForVideo (image MPImage, code temporel long)

Effectue la détection des points de repère de la main sur l'image vidéo fournie avec des options de traitement d'image par défaut, c'est-à-dire sans appliquer de rotation. N'utilisez cette méthode que lorsque le HandLandmarker est créé avec ERROR(/RunningMode.VIDEO).

Il est obligatoire de fournir le code temporel de l'image vidéo (en millisecondes). Les horodatages d'entrée doivent être croissants de manière monotone.

HandLandmarker accepte les types d'espaces colorimétriques suivants:

Paramètres
Image un objet MPImage MediaPipe à traiter.
timestampMs l'horodatage d'entrée (en millisecondes) ;
Génère
en cas d'erreur interne.