存取全身框架中的資料
本文說明本文框架中包含的資料，以及用來存取該資料的函數。
涵蓋的函式如下：
- 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()
本文框架的主要元件
每個本文框架包含本文結構的元件、2D 本文索引對應，以及產生此結果的輸入擷取。
存取本文結構的集合
單一擷取中可能會偵測到多個本文。 您可以藉由呼叫 k4abt_frame_get_num_bodies () 函數來查詢本文數目。
size_t num_bodies = k4abt_frame_get_num_bodies(body_frame);
您可以使用 k4abt_frame_get_body_id () 和 k4abt_frame_get_body_skeleton () 函數逐一查看每個本文索引，以尋找本文識別碼和聯結位置/方向資訊。
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);
}
存取本文索引對應
您可以使用 k4abt_frame_get_body_index_map () 函數來存取本文索引對應。 如需本文索引對應的詳細說明，請參閱本文索引對應。 當不再需要本文索引對應時，請務必將其釋出。
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);
存取輸入擷取
本文追蹤器是非同步 API。 原始擷取可能會在結果快顯時釋出。 使用 k4abt_frame_get_capture () 函數來查詢用來產生此本文追蹤結果的輸入擷取。 每次呼叫此函數時，k4a_capture_t的參考計數都會增加。 不再需要擷取時，請使用 k4a_capture_release () 函數。
k4a_capture_t input_capture = k4abt_frame_get_capture(body_frame);
... // Do your work with the input capture
k4a_capture_release(input_capture);