鱼眼校正典型场景的调试说明

pan

视场角的左右转动，大于180向右转动，小于180向左转动。

转动范围：[-width/2, width/2]

注：width为输出图像的宽。

tilt

视场角的上下转动，大于180向上转动，小于180向下转动。

转动范围：[-30°, +30°]。

hor_zoom

水平视场角大小，4095为最大（180°）。

ver_zoom

垂直视场角大小，4095为最大（90°）。

输入图像宽高

左侧为壁装180全景校正模式的典型设置（输出图像宽等于输入图像宽，输出图像高为输入图像高的一半）。以下示意图是在典型设置时只改变当前参数的演示图，右侧为对应的校正效果图。

in_width

3000

in_height

3000

180校正参数

安装模式

壁装

out_width

3000

out_height

1500

hor_offset

0

ver_offset

0

out_radius

1500

pan

180

tilt

180

hor_zoom

4095

ver_zoom

4095

trapezoid_coef

0

fan_strength

0

trapezoid_coef = 32

梯形强度系数trapezoid_coef只在壁装时的normal和180校正时有效。

fan_strength = 500

扇形强度系数fan_strength只在180校正时有效，用于调整图像水平方向的线条。

fan_strength = -500

pan = 270

pan = 90

tilt = 270

tilt = 90

hor_zoom = 2048

ver_zoom = 2048

pan

视场角的左右转动，大于180向右转动，小于180向左转动；

转动范围：[-90°, 90°]；

tilt

视场角的上下转动，大于180向下转动，小于180向上转动；

转动范围：[-90°, 90°]；

hor_zoom

水平、垂直视场角的大小，4095为最大（126度，Normal模式水平、垂直视场角相等）；

ver_zoom

无效参数；

输入图像宽高

左侧为壁装Normal校正模式的典型设置（输出图像宽高等于输入图像宽高）。以下示意图是在典型设置时只改变当前参数的演示图，右侧为对应的校正效果图。

in_width

3000

in_height

3000

normal校正参数

安装模式

壁装

out_width

3000

out_height

3000

hor_offset

0

ver_offset

0

out_radius

1500

pan

180

tilt

180

hor_zoom

4095

trapezoid_coef

0

fan_strength

0

trapezoid_coef = 32

梯形强度系数trapezoid_coef只在壁装时的normal和180校正时有效。

pan = 270

pan = 90

tilt = 270

tilt = 90

hor_zoom = 2048

（视场角只有hor_zoom = 4095时的一半，63度）

pan

选定原图pan角度的方向作为校正图的正上方；

转动范围：[0, 360°]

tilt

tilt与180差值的绝对值代表视场角向pan确定的方向转动的幅度；

转动范围：[0, 90°]

hor_zoom

水平、垂直视场角的大小，4095为最大（126度，normal模式水平、垂直视场角相等）；

ver_zoom

无效参数。

输入图像宽高

左侧为顶装normal校正模式的典型设置（输出图像宽高等于输入图像宽高）。以下示意图是在典型设置时只改变当前参数的演示图，右侧为对应的校正效果图。

in_width

3000

in_height

3000

Normal校正参数

安装模式

顶装

out_width

3000

out_height

3000

hor_offset

0

ver_offset

0

out_radius

1500

pan

180

tilt

180

hor_zoom

4095

pan用于选择校正区域经normal校正后的在校正图中朝上的方向。

pan = 180时，校正区域的正左方在校正图中朝上。如图中蓝色箭头所示。

安装模式：地装

（normal校正地装与顶类似，只是在顶装的基础上对图像进行了上下翻转）

pan = 0或360时，校正区域的正右方在校正图中朝上。如图中红色箭头所示。

normal校正顶装时，tilt与180的差值的绝对值表示由hor_zoom确定的视场角转动的角度，转动方向由pan确定。

pan = 270

tilt = 270或90

原图中绿色箭头在校正图中朝上，tilt为270及90时效果相同。

pan = 90

tilt = 360或0

原图中黄色箭头在校正图中朝上。

pan

校正图的最左侧对应原图的半径起始位置，即原图中校正区域的起始位置；

tilt

校正区域相对于原图向外或向内移动，大于180向外移动，小于180向内移动；

hor_zoom

校正区域范围（幅度），4095代表选定一圈，2048代表选中半圈；

ver_zoom

在由外半径与内半径确定的范围内调节校正区域的高度；

in_radius

可视内圈半径；

out_radius

可视外圈半径。该参数一般设置为鱼眼原图的半径。

输入图像宽高

左侧为顶装360全景校正模式的典型设置（输出图像宽等于输入图像宽，输出图像高为输入图像高的三分之一）。以下示意图是在典型设置时只改变当前参数的演示图，右侧为对应的校正效果图。

in_width

3000

in_height

3000

360校正参数

安装模式

顶装

out_width

3000

out_height

1000

hor_offset

0

ver_offset

0

in_radius

0

out_radius

1500

pan

180

tilt

180

hor_zoom

4095

ver_zoom

4095

安装模式：地装

（360全景校正地装与顶类似，只是在顶装的基础上对图像进行了上下翻转）

ver_zoom = 2048

out_radius = 1500

in_radius = 100

ver_zoom用于在由内、外半径确定的范围内调节校正区域的高度，校正区域的高度可用如下式表示：

h = (out_radius – in_radius) × ver_zoom / 4095，下图阴影区域为实际选取的校正区域。

ver_zoom = 4095

out_radius = 1300（只为了演示该参数的效果，外半径out_radius应设置为原图实际半径1500，应通过ver_zoom在内、外半径的范围内选择校正区域）

in_radius = 200

（与典型配置时的校正图像相比，上下各裁剪掉一部分）

pan = 270

（该参数用来选择校正区域的起始位置）

pan = 360

ver_zoom = 4095

out_radius = 1500

in_radius = 100

tilt = 90

tilt用于向内或向外移动校正区域，小于180向内移动，大于180向外移动。校正区域内外边界由out_radius' 和in_radius' 确定：

out_radius' = out_radius + offset

in_radius' = in_radius + offset

其中，

offset = out_radius × (tilt –180) / 360

out_radius' = in_radius' + (out_radius – in_radius) × ver_zoom/4095

ver_zoom = 4095

out_radius = 1500

in_radius = 100

tilt = 270

对鱼眼硬件来说，外半径out_radius指定了图像内容的边界，超过out_radius的部分视为无效内容，即：

out_radius' > out_radius时，校正图会出现黑色部分（下图阴影区域），in_radius' < 0时，同样会出现黑色部分。

hor_zoom = 2048

（校正区域只有原图的一半，为得到更好的效果，建议此时把输出图像的宽度做相应比例的缩小）

hor_zoom = 2048

out_width = 1500