Mengakses data dalam bingkai isi
Artikel ini menjelaskan data yang terdapat dalam bingkai isi dan fungsi untuk mengakses data tersebut.
Fungsi-fungsi berikut tercakup:
- k4abt_frame_get_body_id()
- k4abt_frame_get_body_index_map()
- k4abt_frame_get_body_skeleton()
- k4abt_frame_get_capture()
- k4abt_frame_get_num_bodies()
- k4abt_frame_get_device_timestamp_usec()
Komponen utama bingkai isi
Setiap bingkai isi berisi kumpulan struktur isi, peta indeks isi 2D, dan tangkapan input yang menghasilkan hasil ini.
Mengakses koleksi struktur isi
Beberapa isi mungkin terdeteksi dalam satu tangkapan. Anda dapat membuat kueri jumlah isi dengan memanggil fungsi k4abt_frame_get_num_bodies().
size_t num_bodies = k4abt_frame_get_num_bodies(body_frame);
Anda menggunakan fungsi k4abt_frame_get_body_id() dan k4abt_frame_get_body_skeleton() untuk beralih melalui setiap indeks isi untuk menemukan ID isi dan informasi posisi/orientasi sambungan.
for (size_t i = 0; i < num_bodies; i++)
{
k4abt_skeleton_t skeleton;
k4abt_frame_get_body_skeleton(body_frame, i, &skeleton);
uint32_t id = k4abt_frame_get_body_id(body_frame, i);
}
Mengakses peta indeks isi
Anda menggunakan fungsi k4abt_frame_get_body_index_map() untuk mengakses peta indeks isi. Lihat peta indeks isi untuk detail penjelasan tentang peta indeks isi. Pastikan untuk melepaskan peta indeks isi saat tidak diperlukan lagi.
k4a_image_t body_index_map = k4abt_frame_get_body_index_map(body_frame);
... // Do your work with the body index map
k4a_image_release(body_index_map);
Mengakses tangkapan input
Pelacak isi adalah API asinkron. Tangkapan asli mungkin sudah dirilis pada saat hasilnya muncul. Gunakan fungsi k4abt_frame_get_capture() untuk membuat kueri pengambilan input yang digunakan untuk menghasilkan hasil pelacakan isi ini. Jumlah referensi untuk k4a_capture_t meningkat setiap kali fungsi ini dipanggil. Gunakan fungsi k4a_capture_release() saat pengambilan tidak lagi diperlukan.
k4a_capture_t input_capture = k4abt_frame_get_capture(body_frame);
... // Do your work with the input capture
k4a_capture_release(input_capture);