Skip to content

Commit 44998d5

Browse files
author
Raul Acuna
committedJun 21, 2016
Added important information to the README
1 parent 53f653a commit 44998d5

File tree

2 files changed

+62
-2
lines changed

2 files changed

+62
-2
lines changed
 

‎README.md

+60-1
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,61 @@
11
# tud_img_prep
2-
Set of tools for processing camera images. It is a ROS wrapper for comonly used OpenCv techniques including deinterlace of analog images and filtering.
2+
Set of tools for preprocessing a camera video feed using OpenCV.
3+
4+
## Includes:
5+
6+
* Deinterlacing of analog video signals, e.g. video feed acquired using an Easycap USB capture card. Different interlacing methods:
7+
* Half image
8+
* Interpolation (several interpolation methods)
9+
* Color format selection and conversion
10+
* Equalization of the images
11+
* Manual equalization using brighness and contrast controls
12+
* Automatic using OpenCV EqualizeHistogram function
13+
* Filtering
14+
* Median
15+
* Gaussian
16+
* Bilateral Filter
17+
18+
All the options can be changed in real time using Dynamic Reconfigure.
19+
20+
## Installation
21+
Clone repository in your catkin worskspace:
22+
23+
cd ~/catkin_ws/src
24+
git clone git@github.com:raultron/tud_img_prep.git
25+
26+
Compile using catkin:
27+
28+
catkin build tud_img_prep
29+
30+
31+
## Usage
32+
33+
rosrun tud_img_prep img_prep
34+
35+
This package requires ROS camera topics properly published.
36+
37+
Default input topics:
38+
39+
/cam/image_raw
40+
/cam/camera_info
41+
42+
Default output topics:
43+
44+
/prep/cam/image_raw
45+
/prep/cam/camera_info
46+
47+
The default camera namespace can be changed using the parameter "camera_namespace" in a launch file or directly in the terminal.
48+
49+
For example, if you have a camera that publishes in:
50+
51+
/my_camera/image_raw
52+
/my_camera/camera_info
53+
54+
Then the terminal command will be:
55+
56+
rosrun tud_img_prep img_prep _camera_namespace:=/my_camera
57+
58+
And the ouput topics will be
59+
60+
/prep/my_camera/image_raw
61+
/prep/my_camera/camera_info

‎include/tud_img_prep/imgprepnode.hpp

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
#ifndef IMGPREPNODE_HPP
22
#define IMGPREPNODE_HPP
33

4-
# With parts of code taken from https://github.com/omwdunkley/ollieRosTools.git
4+
/// Some parts of this package were modified from:
5+
/// https://github.com/omwdunkley/ollieRosTools.git
56

67
#include "ros/ros.h"
78
#include <dynamic_reconfigure/server.h>

0 commit comments

Comments
 (0)
Please sign in to comment.