Skip to content

Commit a4486ed

Browse files
committed
Update README
1 parent 84b72c7 commit a4486ed

1 file changed

Lines changed: 66 additions & 2 deletions

File tree

README.md

Lines changed: 66 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,66 @@
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>&#042; This tool requires Intel TBB only on Linux.</sup>
56+
57+
License
58+
-------
59+
Copyright &copy; 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

Comments
 (0)