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. |