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 |
createFromOptions(contexte, HandLandmarker.HandLandmarkerOptions markerOptions)
Crée une instance
HandLandmarker à partir d'un HandLandmarker.HandLandmarkerOptions . |
HandLandmarkerResult | |
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
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. |