The fisheye node is used to pre-process fisheye camera input feeds. It includes functionality like warping/dewarping and distort/undistort.
Input and Output
- Input: Grabs frame from a video file, IP or USB camera.
- Output: Redis (default), TCP, UDP frame with distort/undistort/warp/dewarp result
Node Parameters
The following parameters are used in the Fisheye node.
Name: Input the node name used in a specific flow.
- default: fisheye
- type: string
Mode: Let's you select the mode with available options [Distort, Undistort, Warp, Dewarp].
Overwrite Model: Determine whether you wish to calculate the new fisheye calibration matrix (based on your input) or using the pre-calculated matrix.
- default: true
- type: boolean
Depending on the mode you select, you will be presented with different parameters to be configured.
Warp/Dewarp Parameters: Define the parameters to configure the warp/dewarp matrix:
- dewarp_start_angle: the angle (degrees) of dewarp start
- dewarp_cover_angle: the angle (degrees) of dewarp from start to end
- dewarp_radius_outer: the outer radius (pixel) of dewarp calibration (polygon transformation)
- dewarp_radius_inner: the inner radius (pixel) of dewarp calibration (polygon transformation)
- dewarp_scale_factor: zoom ratio
- dewarp_aspect_ratio: aspect ratio between width and height
Distort/Undistort Parameters: Define the parameters to configure the distort/undistort calibration matrix. The following formula is applied:
- distort_matrix = [
- [(mat_w * .5) * horizon_coef, 0.0, (mat_w * .5)],
- [0.0, (mat_h * .5) * vertical_coef, (mat_h * .5)],
- [0.0, 0.0, 1.0] ]