Executa detecção de pontos de referência em imagens.
Essa API espera um pacote de recursos de modelos de pontos de referência pré-treinados. Consulte
- Imagem de entrada
MPImage
- A imagem em que a detecção de pontos de referência é executada.
- Saída HandLandmarkerResult
HandLandmarkerResult
- Um HandLandmarkerResult contendo pontos de referência de mão.
Classes aninhadas
classe | HandLandmarker.HandLandmarkerOptions | Opções para configurar um HandLandmarker . |
Campos
público estático final Set<Connection> | HAND_CONNECTIONS | |
público estático final Set<Connection> | HAND_INDEX_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_MIDDLE_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_PALM_CONNECTIONS | |
público estático final Set<Connection> | HAND_PINKY_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_RING_FINGER_CONNECTIONS | |
público estático final Set<Connection> | HAND_THUMB_CONNECTIONS |
Métodos públicos
estático HandLandmarker |
createFromBuffer(contexto de contexto, modelBuffer ByteBuffer)
Cria uma instância
HandLandmarker com base em um buffer de modelo e o HandLandmarker.HandLandmarkerOptions padrão. |
estático HandLandmarker |
createFromFile(contexto de contexto, modelPath String)
Cria uma instância
HandLandmarker com base em um arquivo de modelo e o HandLandmarker.HandLandmarkerOptions padrão. |
estático HandLandmarker |
createFromFile(contexto de contexto, File modelFile)
Cria uma instância
HandLandmarker com base em um arquivo de modelo e o HandLandmarker.HandLandmarkerOptions padrão. |
estático HandLandmarker |
createFromOptions(Contexto do contexto, HandLandmarker.HandLandmarkerOptions marcoerOptions)
Cria uma instância de
HandLandmarker de um HandLandmarker.HandLandmarkerOptions . |
HandLandmarkerResult | |
HandLandmarkerResult |
detect(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa a detecção de pontos de referência em mãos na imagem única fornecida.
|
void |
detectAsync(imagem MPImage, ImageProcessingOptions imageHandlingOptions, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar a detecção de pontos de referência em mãos. Os resultados ficam disponíveis
pelo
OutputHandler.ResultListener fornecido no HandLandmarker.HandLandmarkerOptions . |
void |
detectAsync(imagem MPImage, carimbos de data/hora longos)
Envia dados de imagem em tempo real para realizar detecção de pontos de referência manuais com opções de processamento de imagem
padrão, ou seja,
|
HandLandmarkerResult |
detectForVideo(imagem MPImage, ImageProcessingOptions imageprocessingOptions, carimbos de data/hora longos)
Executa a detecção de pontos de referência na mão no frame de vídeo fornecido.
|
HandLandmarkerResult |
detectForVideo(imagem MPImage, carimbos de data/hora longos)
Executa a detecção de pontos de referência manualmente no frame de vídeo fornecido com as opções de processamento de
imagem padrão, ou seja,
|
Métodos herdados
Campos
Métodos públicos
público estático HandLandmarker createFromBuffer (contexto de contexto, ByteBuffer modelBuffer)
Cria uma instância HandLandmarker
com base em um buffer de modelo e o HandLandmarker.HandLandmarkerOptions
padrão.
Parâmetros
contexto | um ERROR(/Context) do Android. |
---|---|
modelBuffer | um ByteBuffer direto ou um ERROR(/MappedByteBuffer) do modelo de detecção. |
Gera
se houver um erro durante a criação de HandLandmarker .
|
public Static HandLandmarker createFromFile (Contexto do contexto, String modelPath)
Cria uma instância HandLandmarker
com base em um arquivo de modelo e o HandLandmarker.HandLandmarkerOptions
padrão.
Parâmetros
contexto | um ERROR(/Context) do Android. |
---|---|
modelPath | caminho para o modelo de pontos de referência em mãos com metadados nos recursos. |
Gera
se houver um erro durante a criação de HandLandmarker .
|
público estático HandLandmarker createFromFile (contexto de contexto, arquivo modelFile)
Cria uma instância HandLandmarker
com base em um arquivo de modelo e o HandLandmarker.HandLandmarkerOptions
padrão.
Parâmetros
contexto | um ERROR(/Context) do Android. |
---|---|
modelFile | a instância File do modelo de pontos de referência de mão. |
Gera
IOException | se ocorrer um erro de E/S ao abrir o arquivo do modelo do tflite. |
---|---|
se houver um erro durante a criação de HandLandmarker .
|
public Static HandLandmarker createFromOptions (Contexto de contexto, HandLandmarker.HandLandmarkerOptions marcoerOptions)
Cria uma instância de HandLandmarker
de um HandLandmarker.HandLandmarkerOptions
.
Parâmetros
contexto | um ERROR(/Context) do Android. |
---|---|
landmarkerOptions | uma instância HandLandmarker.HandLandmarkerOptions . |
Gera
se houver um erro durante a criação de HandLandmarker .
|
public HandLandmarkerResult detect (MPImage)
Executa a detecção de pontos de referência na imagem única fornecida com opções de processamento de imagem padrão, ou seja, sem aplicação de qualquer rotação. Use esse método somente quando o HandLandmarker
for criado com ERROR(/RunningMode.IMAGE)
. TODO atualização do documento Java
para o formato da imagem de entrada.
HandLandmarker
oferece suporte aos seguintes tipos de espaço de cores:
Parâmetros
imagem | um objeto MPImage do MediaPipe para processamento. |
---|
Gera
caso haja um erro interno. |
public HandLandmarkerResult detect (MPImage image, ImageProcessingOptions imageprocessingOptions)
Executa a detecção de pontos de referência em mãos na imagem única fornecida. Use esse método somente quando o
HandLandmarker
for criado com ERROR(/RunningMode.IMAGE)
. TODO update java
doc para o formato da imagem de entrada.
HandLandmarker
oferece suporte aos seguintes tipos de espaço de cores:
Parâmetros
imagem | um objeto MPImage do MediaPipe para processamento. |
---|---|
imageProcessingOptions | o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException. |
Gera
IllegalArgumentException | se ImageProcessingOptions especificar uma região de interesse. |
---|---|
caso haja um erro interno. |
public void detectAsync (MPImage imagem, ImageProcessingOptions image ProcessingOptions, long timestampMs)
Envia dados de imagens em tempo real para realizar a detecção de pontos de referência em mãos. Os resultados ficam disponíveis
pelo OutputHandler.ResultListener
fornecido no HandLandmarker.HandLandmarkerOptions
. Use esse método somente quando o HandLandmarker
for criado com ERROR(/RunningMode.LIVE_STREAM)
.
É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada para o ponto de referência da mão. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.
HandLandmarker
oferece suporte aos seguintes tipos de espaço de cores:
Parâmetros
imagem | um objeto MPImage do MediaPipe para processamento. |
---|---|
imageProcessingOptions | o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException. |
timestampMs | o carimbo de data/hora de entrada (em milissegundos). |
Gera
IllegalArgumentException | se ImageProcessingOptions especificar uma região de interesse. |
---|---|
caso haja um erro interno. |
public void detectAsync (MPImage imagem, carimbos de data/hora longos)
Envia dados de imagem em tempo real para realizar a detecção de pontos de referência em mãos com opções de processamento de imagem padrão, ou seja, sem nenhuma rotação aplicada, e os resultados estarão disponíveis por meio do OutputHandler.ResultListener
fornecido no HandLandmarker.HandLandmarkerOptions
. Use esse método somente quando o
HandLandmarker
for criado com ERROR(/RunningMode.LIVE_STREAM)
.
É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada para o ponto de referência da mão. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.
HandLandmarker
oferece suporte aos seguintes tipos de espaço de cores:
Parâmetros
imagem | um objeto MPImage do MediaPipe para processamento. |
---|---|
timestampMs | o carimbo de data/hora de entrada (em milissegundos). |
Gera
caso haja um erro interno. |
public HandLandmarkerResult detectForVideo (MPImage image, ImageProcessingOptions imageprocessingOptions, long timestampMs)
Executa a detecção de pontos de referência na mão no frame de vídeo fornecido. Use esse método somente quando o
HandLandmarker
for criado com ERROR(/RunningMode.VIDEO)
.
É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.
HandLandmarker
oferece suporte aos seguintes tipos de espaço de cores:
Parâmetros
imagem | um objeto MPImage do MediaPipe para processamento. |
---|---|
imageProcessingOptions | o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException. |
timestampMs | o carimbo de data/hora de entrada (em milissegundos). |
Gera
IllegalArgumentException | se ImageProcessingOptions especificar uma região de interesse. |
---|---|
caso haja um erro interno. |
public HandLandmarkerResult detectForVideo (MPImage image, long timestampMs)
Executa a detecção de pontos de referência manuais no frame de vídeo fornecido com opções de processamento de imagem padrão,
ou seja, sem aplicação de rotação. Use esse método somente quando o HandLandmarker
for criado com ERROR(/RunningMode.VIDEO)
.
É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.
HandLandmarker
oferece suporte aos seguintes tipos de espaço de cores:
Parâmetros
imagem | um objeto MPImage do MediaPipe para processamento. |
---|---|
timestampMs | o carimbo de data/hora de entrada (em milissegundos). |
Gera
caso haja um erro interno. |