|
1 | | -# k4a_mkv2image |
2 | | -Tool to convert mkv files to image files for Azure Kinect |
| 1 | +k4a_mkv2image |
| 2 | +============= |
| 3 | +This is convert tool that works on cross-platform (Windows, Linux) for Azure Kinect. |
| 4 | +This tool converts all data of each stream types (Color, Depth, Infrared) that contained in mkv file to image file. |
| 5 | + |
| 6 | +Sample |
| 7 | +------ |
| 8 | +### Command |
| 9 | +``` |
| 10 | +k4a_mkv2image -i="./file.mkv" -s=true -d=true |
| 11 | +``` |
| 12 | +### Output |
| 13 | +Image files are output in the following folder structure. |
| 14 | +Image file name is "\<file_index\>_\<device_timestamp\>.jpg". |
| 15 | +The file index is sequencial number for output images. |
| 16 | +The unit of device timestamp is microseconds. |
| 17 | +``` |
| 18 | +k4a_mkv2image.exe |
| 19 | +file.mkv |
| 20 | +file |
| 21 | + |-color |
| 22 | + | |-000000_00000000000.jpg |
| 23 | + | |-000001_00000000033.jpg |
| 24 | + | |-000002_00000000066.jpg |
| 25 | + | |
| 26 | + |-depth |
| 27 | + | |-000000_00000000000.png |
| 28 | + | |-000001_00000000033.png |
| 29 | + | |-000002_00000000066.png |
| 30 | + | |
| 31 | + |-infrared |
| 32 | + |-000000_00000000000.jpg |
| 33 | + |-000001_00000000033.jpg |
| 34 | + |-000002_00000000066.jpg |
| 35 | +``` |
| 36 | + |
| 37 | +Option |
| 38 | +------ |
| 39 | +| option | description | |
| 40 | +|:------:|:--------------------------------------------------------------------------------------| |
| 41 | +| -i | input mkv file path. (requered) | |
| 42 | +| -s | enable depth scaling. <code>false</code> is raw 16bit image. (bool) | |
| 43 | +| -t | enable transform depth to color camera. <code>false</code> is not transform. (bool) | |
| 44 | +| -q | jpeg encoding quality for infrared. [0-100] | |
| 45 | +| -d | display each images on window. <code>false</code> is not display. (bool) | |
| 46 | + |
| 47 | +Environment |
| 48 | +----------- |
| 49 | +* Visual Studio 2017/2019 / GCC 7.4 / Clang 6.0 (require <code>\<filesystem\></code> supported) |
| 50 | +* Azure Kinect Sensor SDK v1.3.0 (or later) |
| 51 | +* OpenCV 4.1.2 (or later) |
| 52 | +* CMake 3.15.4 (latest release is preferred) |
| 53 | +* Intel Thread Building Blocks (latest release is preferred) |
| 54 | + |
| 55 | +<sup>* This tool requires Intel TBB only on Linux.</sup> |
| 56 | + |
| 57 | +License |
| 58 | +------- |
| 59 | +Copyright © 2019 Tsukasa SUGIURA |
| 60 | +Distributed under the [MIT License](http://www.opensource.org/licenses/mit-license.php "MIT License | Open Source Initiative"). |
| 61 | + |
| 62 | +Contact |
| 63 | +------- |
| 64 | +* Tsukasa Sugiura |
| 65 | + * <t.sugiura0204@gmail.com> |
| 66 | + * <http://unanancyowen.com> |
0 commit comments