Melakukan deteksi penanda tangan pada gambar.
API ini mengharapkan paket aset model penanda tangan terlatih. Lihat
- Gambar input
MPImage
- Gambar yang digunakan untuk mendeteksi penanda tangan.
- Output HandLandmarkerResult
HandLandmarkerResult
- HandLandmarkerResult yang berisi penanda tangan.
Class Bertingkat
class | HandLandmarker.HandLandmarkerOptions | Opsi untuk menyiapkan HandLandmarker . |
Kolom
public static final Set<Connection> | HAND_CONNECTIONS | |
public static final Set<Connection> | HAND_INDEX_FINGER_CONNECTIONS | |
public static final Set<Connection> | HAND_MIDDLE_FINGER_CONNECTIONS | |
public static final Set<Connection> | HAND_PALM_CONNECTIONS | |
public static final Set<Connection> | HAND_PINKY_FINGER_CONNECTIONS | |
public static final Set<Connection> | HAND_RING_FINGER_CONNECTIONS | |
public static final Set<Connection> | HAND_THUMB_CONNECTIONS |
Metode Publik
statis HandLandmarker |
createFromBuffer(Konteks konteks, modelBuffer ByteBuffer)
Membuat instance
HandLandmarker dari buffering model dan HandLandmarker.HandLandmarkerOptions default. |
statis HandLandmarker |
createFromFile(Konteks konteks, String modelPath)
Membuat instance
HandLandmarker dari file model dan HandLandmarker.HandLandmarkerOptions default. |
statis HandLandmarker |
createFromFile(Konteks konteks, File modelFile)
Membuat instance
HandLandmarker dari file model dan HandLandmarker.HandLandmarkerOptions default. |
statis HandLandmarker |
createFromOptions(Konteks konteks, penandaerOptions HandLandmarker.HandLandmarkerOptions)
Membuat instance
HandLandmarker dari HandLandmarker.HandLandmarkerOptions . |
HandLandmarkerResult | |
HandLandmarkerResult |
detect(gambar MPImage, ImageProcessingOptions imageProcessingOptions)
Melakukan deteksi penanda tangan pada gambar tunggal yang disediakan.
|
void |
detectAsync(gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang)
Mengirimkan data gambar live untuk melakukan deteksi penanda tangan, dan hasilnya akan tersedia melalui
OutputHandler.ResultListener yang disediakan di HandLandmarker.HandLandmarkerOptions . |
void |
detectAsync(gambar MPImage, timestampMs panjang)
Mengirim data gambar live untuk melakukan deteksi penanda tangan dengan opsi pemrosesan gambar default, yaitu
|
HandLandmarkerResult |
detectForVideo(gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang)
Melakukan deteksi penanda tangan pada frame video yang disediakan.
|
HandLandmarkerResult |
detectForVideo(gambar MPImage, timestampMs panjang)
Melakukan deteksi penanda tangan pada frame video yang disediakan dengan opsi pemrosesan gambar default, yaitu
|
Metode Turunan
Kolom
Metode Publik
publik statis HandLandmarker createFromBuffer (Konteks konteks, ByteBuffer modelBuffer)
Membuat instance HandLandmarker
dari buffering model dan HandLandmarker.HandLandmarkerOptions
default.
Parameter
context | ERROR(/Context) Android. |
---|---|
modelBuffer | ByteBuffer atau ERROR(/MappedByteBuffer) langsung dari model deteksi. |
Menampilkan
jika terjadi error selama pembuatan HandLandmarker .
|
publik statis HandLandmarker createFromFile (Konteks konteks, String modelPath)
Membuat instance HandLandmarker
dari file model dan HandLandmarker.HandLandmarkerOptions
default.
Parameter
context | ERROR(/Context) Android. |
---|---|
modelPath | ke model penanda tangan dengan metadata dalam aset. |
Menampilkan
jika terjadi error selama pembuatan HandLandmarker .
|
publik statis HandLandmarker createFromFile (Konteks konteks, File modelFile)
Membuat instance HandLandmarker
dari file model dan HandLandmarker.HandLandmarkerOptions
default.
Parameter
context | ERROR(/Context) Android. |
---|---|
modelFile | instance File model penanda tangan. |
Menampilkan
IOException | jika terjadi error I/O saat membuka file model tflite. |
---|---|
jika terjadi error selama pembuatan HandLandmarker .
|
publik statis HandLandmarker createFromOptions (Konteks konteks, HandLandmarker.HandLandmarkerOptions penandaerOptions)
Membuat instance HandLandmarker
dari HandLandmarker.HandLandmarkerOptions
.
Parameter
context | ERROR(/Context) Android. |
---|---|
landmarkerOptions | instance HandLandmarker.HandLandmarkerOptions . |
Menampilkan
jika terjadi error selama pembuatan HandLandmarker .
|
publik HandLandmarkerResult detect (gambar MPImage)
Melakukan deteksi tempat terkenal tangan pada satu gambar yang disediakan dengan opsi pemrosesan gambar default, yaitu tanpa rotasi yang diterapkan. Hanya gunakan metode ini saat HandLandmarker
dibuat dengan ERROR(/RunningMode.IMAGE)
. TODO memperbarui dokumen java
untuk format gambar input.
HandLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|
Menampilkan
jika terjadi error internal. |
publik HandLandmarkerResult detect (MPImage gambar, ImageProcessingOptions imageProcessingOptions)
Melakukan deteksi penanda tangan pada gambar tunggal yang disediakan. Hanya gunakan metode ini jika HandLandmarker
dibuat dengan ERROR(/RunningMode.IMAGE)
. TODO memperbarui dokumen
java untuk format gambar input.
HandLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
imageProcessingOptions | ImageProcessingOptions yang menentukan cara memproses gambar input sebelum menjalankan inferensi. Perlu diperhatikan bahwa region minat tidak didukung oleh tugas ini: menentukan ImageProcessingOptions.regionOfInterest() akan menyebabkan metode ini menampilkan IllegalArgumentException. |
Menampilkan
IllegalArgumentException | jika ImageProcessingOptions menentukan
wilayah minat. |
---|---|
jika terjadi error internal. |
public void detectAsync (Gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang)
Mengirimkan data gambar live untuk melakukan deteksi penanda tangan, dan hasilnya akan tersedia melalui OutputHandler.ResultListener
yang disediakan di HandLandmarker.HandLandmarkerOptions
. Hanya gunakan metode ini jika HandLandmarker
dibuat dengan ERROR(/RunningMode.LIVE_STREAM)
.
Anda harus memberikan stempel waktu (dalam milidetik) untuk menunjukkan kapan gambar input dikirim ke penanda tangan. Stempel waktu input harus meningkat secara monoton.
HandLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
imageProcessingOptions | ImageProcessingOptions yang menentukan cara memproses gambar input sebelum menjalankan inferensi. Perlu diperhatikan bahwa region minat tidak didukung oleh tugas ini: menentukan ImageProcessingOptions.regionOfInterest() akan menyebabkan metode ini menampilkan IllegalArgumentException. |
timestampMs | stempel waktu input (dalam milidetik). |
Menampilkan
IllegalArgumentException | jika ImageProcessingOptions menentukan
wilayah minat. |
---|---|
jika terjadi error internal. |
public void detectAsync (gambar MPImage, timestampMs panjang)
Mengirim data gambar live untuk melakukan deteksi tempat terkenal tangan dengan opsi pemrosesan gambar default, yaitu tanpa penerapan rotasi apa pun, dan hasilnya akan tersedia melalui OutputHandler.ResultListener
yang disediakan di HandLandmarker.HandLandmarkerOptions
. Hanya gunakan metode ini jika HandLandmarker
dibuat dengan ERROR(/RunningMode.LIVE_STREAM)
.
Anda harus memberikan stempel waktu (dalam milidetik) untuk menunjukkan kapan gambar input dikirim ke penanda tangan. Stempel waktu input harus meningkat secara monoton.
HandLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
timestampMs | stempel waktu input (dalam milidetik). |
Menampilkan
jika terjadi error internal. |
publik HandLandmarkerResult detectForVideo (gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjangMs)
Melakukan deteksi penanda tangan pada frame video yang disediakan. Hanya gunakan metode ini jika HandLandmarker
dibuat dengan ERROR(/RunningMode.VIDEO)
.
Anda harus memberikan stempel waktu frame video (dalam milidetik). Stempel waktu input harus meningkat secara monoton.
HandLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
imageProcessingOptions | ImageProcessingOptions yang menentukan cara memproses gambar input sebelum menjalankan inferensi. Perlu diperhatikan bahwa region minat tidak didukung oleh tugas ini: menentukan ImageProcessingOptions.regionOfInterest() akan menyebabkan metode ini menampilkan IllegalArgumentException. |
timestampMs | stempel waktu input (dalam milidetik). |
Menampilkan
IllegalArgumentException | jika ImageProcessingOptions menentukan
wilayah minat. |
---|---|
jika terjadi error internal. |
publik HandLandmarkerResult detectForVideo (gambar MPImage, timestampMs panjang)
Melakukan deteksi penanda tangan pada frame video yang disediakan dengan opsi pemrosesan gambar default, yaitu tanpa menerapkan rotasi apa pun. Hanya gunakan metode ini saat HandLandmarker
dibuat dengan ERROR(/RunningMode.VIDEO)
.
Anda harus memberikan stempel waktu frame video (dalam milidetik). Stempel waktu input harus meningkat secara monoton.
HandLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
timestampMs | stempel waktu input (dalam milidetik). |
Menampilkan
jika terjadi error internal. |