استخدام Azure Kinect Sensor SDK لتسجيل تنسيق الملف
لتسجيل بيانات المستشعر ، يتم استخدام تنسيق حاوية Matroska (.mkv) ، والذي يسمح بتخزين مسارات متعددة باستخدام مجموعة واسعة من برامج الترميز. يحتوي ملف التسجيل على مسارات لتخزين اللون والعمق وصور الأشعة تحت الحمراء وIMU.
يمكن العثور على تفاصيل منخفضة المستوى لتنسيق حاوية .mkv على موقع Matroska على الويب.
| اسم المسار | تنسيق برنامج الترميز |
|---|---|
| لون | Mode-Dependent (MJPEG أو NV12 أو YUY2) |
| عمق | b16g (تدرج رمادي 16 بت، Big-endian) |
| IR | b16g (تدرج رمادي 16 بت، Big-endian) |
| IMU | بنية مخصصة، راجع بنية نموذج IMU أدناه. |
استخدام أدوات الجهات الخارجية
يمكن استخدام أدوات مثل ffmpeg أو mkvinfo الأمر من مجموعة أدوات MKVToolNix لعرض المعلومات واستخراجها من ملفات التسجيل.
على سبيل المثال، سيقوم الأمر التالي باستخراج مسار العمق كتسلسل من ملفات PNG 16 بت إلى نفس المجلد:
ffmpeg -i output.mkv -map 0:1 -vsync 0 depth%04d.png
ستقوم المعلمة -map 0:1 باستخراج فهرس المسار 1 ، والذي سيكون في معظم التسجيلات عمقا. إذا كان التسجيل لا يحتوي على مسار ملون، -map 0:0 استخدامه.
تجبر المعلمة ffmpeg على استخراج الإطارات -vsync 0 كما هي بدلا من محاولة مطابقة معدل إطارات يبلغ 30 إطارا في الثانية أو 15 إطارا في الثانية أو 5 إطارات في الثانية.
هيكل عينة IMU
إذا تم استخراج بيانات IMU من الملف دون استخدام واجهة برمجة تطبيقات التشغيل ، فستكون البيانات في شكل ثنائي. وفيما يلي هيكل بيانات IMU. جميع الحقول هي نهاية صغيرة.
| الحقل | النوع |
|---|---|
| الطابع الزمني لقياس التسارع (μs) | uint64 |
| بيانات مقياس التسارع (x، y، z) | تعويم[3] |
| الطابع الزمني جيروسكوب (μs) | uint64 |
| بيانات الجيروسكوب (x، y، z) | تعويم[3] |
تحديد المسارات
قد يكون من الضروري تحديد المسار الذي يحتوي على اللون والعمق والأشعة تحت الحمراء وما إلى ذلك. هناك حاجة إلى تحديد المسارات عند العمل مع أدوات الجهات الخارجية لقراءة ملف Matroska. تختلف أرقام المسارات بناء على وضع الكاميرا ومجموعة المسارات الممكنة. تستخدم العلامات لتحديد معنى كل مسار.
يتم إرفاق قائمة العلامات أدناه بعنصر Matroska معين ، ويمكن استخدامها للبحث عن المسار أو المرفق المقابل.
هذه العلامات قابلة للعرض باستخدام أدوات مثل ffmpeg و mkvinfo.
يتم سرد القائمة الكاملة للعلامات في صفحة التسجيل والتشغيل .
| اسم العلامة | هدف العلامة | قيمة العلامة |
|---|---|---|
| K4A_COLOR_TRACK | مسار الألوان | مسار ماتروسكا UID |
| K4A_DEPTH_TRACK | مسار العمق | مسار ماتروسكا UID |
| K4A_IR_TRACK | مسار الأشعة تحت الحمراء | مسار ماتروسكا UID |
| K4A_IMU_TRACK | مسار IMU | مسار ماتروسكا UID |
| K4A_CALIBRATION_FILE | مرفق المعايرة | اسم الملف المرفق |