Skip to content

Commit ca9999d

Browse files
author
Manuel Stoiber
committed
feat(readme): provide information about LoaderCamera metafiles
1 parent 54dc944 commit ca9999d

1 file changed

Lines changed: 34 additions & 0 deletions

File tree

ICG/readme.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,40 @@ detector_image_path: "./detector_image.png"
147147
- `reference_points`: 3D points on the object surface given in the body frame. During manual detection, the user has to specify the corresponding 2D coordinates of those points in the image to define the object pose.
148148
- `detector_image_path`: optional image that illustrates on which points the user has to click.
149149

150+
#### LoaderColorCamera / LoaderDepthCamera
151+
```
152+
load_directory: "./"
153+
intrinsics:
154+
f_u: 638.633
155+
f_v: 638.377
156+
pp_x: 639.451
157+
pp_y: 366.379
158+
width: 1280
159+
height: 720
160+
camera2world_pose: !!opencv-matrix
161+
rows: 4
162+
cols: 4
163+
dt: f
164+
data: [ 1., 0., 0., 0.,
165+
0., 1., 0., 0.,
166+
0., 0., 1., 0.,
167+
0., 0., 0., 1. ]
168+
depth_scale: 0.001 # only for depth camera
169+
image_name_pre: "color_camera_image_"
170+
load_index: 0
171+
n_leading_zeros: 0
172+
image_name_post: ""
173+
load_image_type: "png"
174+
```
175+
- `load_directory`: directory from which images are loaded.
176+
- `intrinsics`: intrinsics of the camera that was used to record images, with fu, fv, ppu, ppv, width, and height, respectively.
177+
- `depth_scale`: scale with which pixel values have to be multiplied to get the depth in meter. (only required for depth cameras)
178+
- `image_name_pre`: text at the beginning of image name, before load_index.
179+
- `load_index`: index of the first image that is loaded.
180+
- `n_leading_zeros`: minimum number of digits used in the image name with zero padding to reach correct number.
181+
- `image_name_post`: text at the end of image name, after load_index.
182+
- `load_image_type`: file format of images.
183+
150184
To start tracking your own objects, we recommend defining your own metafile for `Body` and `StaticDetector` and use the `examples/run_on_camera_sequence.cpp`. Note that depending on the parameters for the `RunTrackerProcess` function of the `Tracker` class, detection and tracking will not start automatically. To start the detection, please press the D key on your keyboard. For tracking, the T key has to be pressed. To quit the application, press Q. If you would like to use the RealSense camera instead of the AzureKinect, please replace `#include <icg/azure_kinect_camera.h>` with `#include <icg/realsense_camera.h>` and all occurences of `AzureKinectColorCamera` and `AzureKinectDepthCamera` with `RealSenseColorCamera` and `RealSenseDepthCamera`. If you would like to use another camera than the RealSense or Azure Kinect, we encourage you to create a class similar to the `AzureKinectCamera` class in src/azure_kinect_camera.cpp. To use results from the tracker in your own application, you can implement your own `Publisher` class that implements the method `UpdatePublisher()`.
151185

152186
In addition to this short overview, detailed information on all objects and parameters can be found in the [Documentation](annotated.html), which can be generated using *Doxygen* with *dot*.

0 commit comments

Comments
 (0)