HALCON算子函數——Chapter 17 : Tools
Chapter_17:Tools
17.1 2D-Transformations
1. affine_trans_pixel
功能：對像素坐標軸進行任意的仿射二維變換。
2. affine_trans_point_2d
功能：對點進行任意的最簡二維變換
3. bundle_adjust_mosaic
功能：對一幅圖像的嵌合體采取一系列調整。
4. hom_mat2d_compose
功能：將兩種相同類型二維變換矩陣相乘。
5. hom_mat2d_determinant
功能：計算一個同質的二維變換矩陣的行列式。
6. hom_mat2d_identity
功能：構建二維變換同樣的同質變換矩陣。
7. hom_mat2d_invert
功能：插入一個同質二維變換矩陣。
8. hom_mat2d_rotate
功能：為一個同質二維變換矩陣添加一個循環。
9. hom_mat2d_rotate_local
功能：為一個同質二維變換矩陣添加一個循環。
10. hom_mat2d_scale
功能：為一個同質二維變換矩陣添加一個縮放。
11. hom_mat2d_scale_local
功能：為一個同質二維變換矩陣添加一個縮放。
12. hom_mat2d_slant
功能：為一個同質二維變換矩陣添加一個斜面。
13. hom_mat2d_slant_local
功能：為一個同質二維變換矩陣添加一個斜面。
14. hom_mat2d_to_affine_par
功能：計算一個來自一個同質二維變換矩陣的仿射變換參數。
15. hom_mat2d_translate
功能：為一個同質二維變換矩陣添加一個旋轉。
16. hom_mat2d_translate_local
功能：為一個同質二維變換矩陣添加一個旋轉。
17. hom_mat2d_transpose
功能：將一個同質二維變換矩陣轉置。
18. hom_mat3d_project
功能：給一個二維投影變換矩陣投影一個仿射三維變換矩陣。
19. hom_vector_to_proj_hom_mat2d
功能：根據給定點的映射計算一個同質變換矩陣。
20. proj_match_points_ransack
功能：通過找到兩副圖像中點與點之間的映射計算一個投影變換矩陣。
21. projective_trans_pixel
功能：利用一個同質投影變換矩陣表示像素坐標軸。
22. projective_trans_point_2d
功能：利用一個投影變換矩陣表示一個同質二維點。
23. vector_angle_to_rigid
功能：從點和角度方面計算一個嚴格的仿射變換。
24. vector_field_to_hom_mat2d
功能：根據位移矢量字段獲取一個最接近的近似圖。
25. vector_to_hom_mat2d
功能：根據點與點間的映射獲取一個最接近的近似圖
26. vector_to_proj_hom_mat2d
功能：利用給定點的映射計算一個映射變換矩陣。
27. vector_to_rigid
功能：根據點的映射獲取一個近似嚴格的仿射變換。
28. vector_to_similarity
功能：根據點的映射獲取一個近似的相似變換。
17.2 3D-Transformations
1. affine_trans_point_3d
功能：對點運用一個隨即仿射三維變換。
2. convert_pose_type
功能：改變一個三維模式的表示類型。
3. create_pose
功能：創建一個三維模式。
4. get_pose_type
功能：獲取一個三維模式的表示類型。
5. hom_mat3d_compose
功能：將兩個同質三維變換矩陣相乘。
6. hom_mat3d_identity
功能：構建三維變換同樣的同質變換矩陣。
7. hom_mat3d_invert
功能：插入一個同質三維變換矩陣。
8. hom_mat3d_rotate
功能：為一個同質三維變換矩陣添加一個循環。
9. hom_mat3d_rotate_local
功能：為一個同質三維變換矩陣添加一個循環。
10. hom_mat3d_scale
功能：為一個同質三維變換矩陣添加一個縮放。
11. hom_mat3d_scale_local
功能：為一個同質三維變換矩陣添加一個縮放。
12. hom_mat3d_to_pose
功能：將一個同質變換矩陣轉換為一個三維模式。
13. hom_mat3d_translate
功能：為一個同質三維變換矩陣添加一個旋轉。
14. hom_mat3d_translate_local
功能：為一個同質三維變換矩陣添加一個旋轉。
15_.pose_to_hom_mat3d
功能：將一個三位模式轉換為一個同質變換矩陣。
16. read_pose
功能：從一個文本文件中讀取一個三維模式。
17. set_origin_pose
功能：轉換一個三位模式的原點。
18. write_pose
功能：將一個三維模式寫入一個文本文件。
17.3 Background-Estimator
1. close_all_bg_esti
功能：清除所有的背景評估數據集。
2. close_bg_esti
功能：清除背景估測數據集。
3. create_bg_esti
功能：為背景評估創建和初始化一個數據集。
4. get_bg_esti_params
功能：返回數據集的參數。
5. give_bg_esti
功能：返回估測背景圖像。
6. run_bg_esti
功能：評估背景並返回前景區域。
7. set_bg_esti_params
功能：改變數據集的參數。
8. update_bg_esti
功能：改變估測背景圖像。
17.4 Barcode
1. clear_all_bar_code_models
功能：清除所有條形碼模型，釋放其分配的存儲空間。
2. clear_bar_code_model
功能：清除一個條形碼模型，釋放相應的存儲空間。
3. create_bar_code_model
功能：創建一個條形碼閱讀器模型。
4. find_bar_code
功能：檢測和讀取一幅圖像中條形碼符號。
5. get_bar_code_object
功能：訪問創建在搜尋或條形碼符號解碼過程中的對象圖標。
6. get_bar_code_param
功能：獲取一個或多個描述條形碼模式的參數。
7. get_bar_code_result
功能：獲取字母數字混合編碼的結果，其是在條形碼符號解碼過程中累計的。
8. set_bar_code_param
功能：設置條形碼模型的選定參數。
17.5 Calibration
1. caltab_points
功能：從校准板說明文件中讀取標志中心點。
2. cam_mat_to_cam_par
功能：計算從一個相機矩陣獲取的內部相機參數。
3. cam_par_to_cam_mat
功能：從相機內部參數計算一個相機矩陣。
4. camera_calibration
功能：決定同時發生的最小化程序的所有相機參數。
5. change_radial_distortion_cam_par
功能：根據與特殊放射失真相一致決定新的相機參數。
6. change_radial_distortion_contours_xld
功能：改變了輪廓(contour)的放射失真。
7. change_radial_distortion_image
功能：改變一幅圖像的放射失真。
8. contour_to_world_plane_xld
功能：將一個XLD輪廓(contour)轉換為一個坐標系統中平面Z為零。
9. create_caltab
功能：創建一個描述文件和附文件的校准板。
10. disp_caltab
功能：投射和視覺化圖像中校准板的三維模型。
11. find_caltab
功能：分割和標准化圖像中的校准板區域。
12. find_marks_and_pose
功能：從圖像中提取二維校准標志和為外部計算機參數計算內部數值。
13. gen_caltab
功能：創建一個校准板說明文件和相應的附文件。
14. gen_image_to_world_plane_map
功能：創建一個投射圖，其描述圖像平面與坐標軸系統中平面Z為零之間的映射。
15. gen_radial_distortion_map
功能：創建一個投射圖，其描述圖像與其相應正在改變的放射失真間的映射。
16. get_circle_pose
功能：從一個圓周相應的二維投射中決定它的三維模式。
17. get_line_of_sight
功能：計算相應於圖像中一個點的視線。
18. get_rectangle_pose
功能：從一個矩形相應的二維投射中決定它的三維模式。
19. hand_eye_calibration
功能：執行一個手---眼校准。
20. image_points_to_world_plane
功能：將圖像中的點轉換到坐標軸平面Z為零上。
21. image_to_world_plane
功能：通過將一副圖像轉換為坐標軸系統中平面Z為零而矯正圖像。
22. project_3d_point
功能：將三維點投射到子像素圖像坐標。
23. radiometric_self_calibration
功能：執行一個相機的輻射測量的自校准。
24. read_cam_par
功能：從文本文件中讀取內部相機參數。
25. sim_caltab
功能：根據校准板模擬一幅圖像。
26. stationary_camera_self_calibration
功能：投射一個靜止投射相機的自校准。
27. write_cam_par
功能：將內部相機參數寫入文本文件中。
17.6 Datacode
1. clear_all_data_code_2d_models
功能：清除所有的二維數據模型並釋放它們分配的存儲空間。
2. clear_data_code_2d_model
功能：清除一個二維數據模型並釋放它分配的存儲空間。
3. create_data_code_2d_model
功能：創建一個二維數據編碼類的模式。
4. find_data_code_2d
功能：檢測和讀取一副圖像或測試的二維數據編碼模式中的二維數據編碼符號。
5. get_data_code_2d_objects
功能：查詢搜索二維數據編碼符號過程中創建的對象的圖標。
6. get_data_code_2d_param
功能：獲取一個或多個描述二維數據編碼模型的參數。
7. get_data_code_2d_results
功能：獲取字母數字混合編碼的結果，其是在搜索二維數據編碼符號過程中累計的。
8. query_data_code_2d_params
功能：為一個給定二維數據編碼模型獲取通用參數或對象的名字，其也可用於其他的二維數據編碼模型中。
9. read_data_code_2d_model
功能：從一個文件中讀取一個二維數據編碼模型並新建一個模型。
10. set_data_code_2d_param
功能：設置二維數據編碼模型的選定參數。
11. write_data_code_2d_model
功能：將一個二維數據編碼模型寫入一個文件。
17.7 Fourier-Descriptor
1. abs_invar_fourier_coeff
功能：根據起始點的位移標准化傅裡葉系數。
2. fourier_1dim
功能：計算一個參數化的元組的傅裡葉系數。
3. fourier_1dim_inv
功能：空間傅裡葉變換（傅裡葉逆變換）。
4. invar_fourier_coeff
功能：傅裡葉系數標准化。
5. match_fourier_coeff
功能：兩個元組的相似性。
6. move_contour_orig
功能：將原點變換到引力的中心。
7. prep_contour_fourier
功能：參數化傳輸的元組。
17.8 Function
1. abs_funct_1d
功能：Y值的絕對值。
2. compose_funct_1d
功能：組合兩個函數。
3. create_funct_1d_array
功能：從Y值的序列中創建一個函數。
4. create_funct_1d_pairs
功能：從（X，Y）集合中創建一個函數。
5. derivate_funct_1d
功能：計算一個函數的派生物。
6. distance_funct_1d
功能：計算兩個函數的間隔。
7. funct_1d_to_pairs
功能：查詢一個函數的（X，Y）值。
8. get_pair_funct_1d
功能：根據控制點的索引查詢一個函數值。
9. get_y_value_funct_1d
功能：返回任意位置函數的值。
10. integrate_funct_1d
功能：計算一個函數的正區域和負區域。
11. invert_funct_1d
功能：計算一個函數的反轉。
12. local_min_max_funct_1d
功能：計算一個函數的局域最小和最大值點。
13. match_funct_1d_trans
功能：計算兩個函數傳遞參數。
14. negate_funct_1d
功能：對Y值取非（反）。
15. num_points_funct_1d
功能：函數控制點的數目。
16. read_funct_1d
功能：從文件中讀取一個函數。
17. sample_funct_1d
功能：再間隔區等距取樣。
18. scale_y_funct_1d
功能：將Y值相乘和相加。
19. smooth_funct_1d_gauss
功能：采用高斯函數平滑一個等距一維函數。
20. smooth_funct_1d_mean
功能：采用平均值將一個等距一維函數平滑化。
21. transform_funct_1d
功能：根據給定傳遞參數變換你一個函數。
22. write_funct_1d
功能：將一個函數寫入一個文件。
23. x_range_funct_1d
功能：函數的最小和最大X值。
24. y_range_funct_1d
功能：函數的最小和最大Y值。
25. zero_crossings_funct_1d
功能：計算一個函數的零點。
17.9 Geometry
1. angle_ll
功能：計算兩條線的夾角。
2. angle_lx
功能：計算一條線與垂直軸之間的角度。
3. distance_cc
功能：計算兩個輪廓(contour)間的距離。
4. distance_cc_min
功能：計算兩個輪廓(contour)間的最小距離。
5. distance_lc
功能：計算一條線和一個輪廓(contour)間的距離。
6. distance_lr
功能：計算一條線和一個區域間的距離。
7. distance_pc
功能：計算一個點和一個輪廓(contour)間的距離。
8. distance_pl
功能：計算一個點和一條線間的距離。
9. distance_pp
功能：計算兩個點之間的距離。
10. distance_pr
功能：計算一個點和一個區域間的距離。
11. distance_ps
功能：計算一個點和一條分割線間的距離。
12. distance_rr_min
功能：兩個相鄰區域的相同像素間的最小距離。
13. distance_rr_min_dil
功能：膨脹時兩個區域間的最小距離。
14. distance_sc
功能：計算一條分割線和一個輪廓(contour)間的距離。
15. distance_sl
功能：計算一條分割線和一條線間的距離。
16. distance_sr
功能：計算一條分割線和一個區域間的距離。
17. distance_ss
功能：計算兩條分割線間的距離。
18. get_points_ellipse
功能：計算橢圓上特定角度的一個點。
19. intersection_ll
功能：計算兩條線的交集點（相交點）。
20. projection_pl
功能：計算一條線上一個點的投影。
17.10 Grid-Rectification
1. connect_grid_points
功能：建立矯正網格的矯正點間的連接。
2. create_rectification_grid
功能：建立一個附文件，描述矯正網格。
3. find_rectification_grid
功能：分割圖像中矯正網格區域。
4. gen_arbitrary_distortion_map
功能：產生一個投射圖，其描述隨意扭曲圖像與正確圖像間的映射。
5. gen_grid_rectification_map
功能：計算扭曲圖像與基於規律的網格的正確的圖像的映射。
17.11 Hough
1. hough_circle_trans
功能：返回指定半徑的圓周的Hough變換。
2. hough_circles
功能：特定半徑的圓周的中心。
3. hough_line_trans
功能：對區域中的線進行Hough變換。
4. hough_line_trans_dir
功能：利用局部方向梯度對線進行Hough變換。
5. hough_lines
功能：借助Hough變化查詢圖像中的線，並將其返回到HNF中。
6. hough_lines_dir
功能：借助采用局部方向梯度的Hough變換查詢圖像中的線，並將它們以正常形式返回。
7. select_matching_lines
功能：選取HNF中線的集合中匹配區域最好的線。
17.12 Image-Comparison
1. clear_all_variation_models
功能：釋放所有變化模型（variation_model）的存儲空間。
2. clear_train_data_variation_model
功能：釋放變化模型（variation_model）的測試數據的存儲空間。
3. clear_variation_model
功能：釋放一個變化模型（variation_model）的存儲空間。
4. compare_ext_variation_model
功能：將一副圖像與一個變化模型（variation_model）相比較。
5. compare_variation_model
功能：將一副圖像與一個變化模型（variation_model）相比較。
6. create_variation_model
功能：為圖像對比創建一個變化模型。
7. get_thresh_images_variation_model
功能：返回閥值圖像用於圖像對比。
8. get_variation_model
功能：返回圖像用於圖像對比。
9. prepare_direct_variation_model
功能：為圖像對比准備一個變化模型。
10. prepare_variation_model
功能：為圖像對比准備一個變化模型。
11. read_variation_model
功能：從一個文件中讀取一個變化模型。
12. train_variation_model
功能：測試一個變化模型。
13. write_variation_model
功能：將一個變化模型寫入文件。
17.13 Kalman-Filter
1. filter_kalman
功能：借助Kalman（卡爾曼）濾波器估測系統的當前狀態。
2. read_kalman
功能：讀取一個卡爾曼濾波器的說明文件。
3. sensor_kalman
功能：卡爾曼濾波器測量值的交互式輸入。
4. update_kalman
功能：讀取一個卡爾曼濾波器的更新文件。
17.14 Measure
1. close_all_measures
功能：清除所有測試對象。
2. close_measure
功能：清除一個測試對象。
3. fuzzy_measure_pairing
功能：提取與矩形或環狀弧垂直的直線邊緣。
4. fuzzy_measure_pairs
功能：提取與矩形或環狀弧垂直的直線邊緣。
5. fuzzy_measure_pos
功能：提取與矩形或環狀弧垂直的直線邊緣。
6. gen_measure_arc
功能：垂直與環狀弧的直線邊緣的提取。
7. gen_measure_rectangle2
功能：垂直與矩形的直線邊緣的提取。
8. measure_pairs
功能：提取與矩形或環狀弧垂直的直線邊緣。
9. measure_pos
功能：提取與矩形或環狀弧垂直的直線邊緣。
10. measure_projection
功能：提取垂直於一個矩形或環狀弧的灰度值輪廓(contour)。
11. measure_thresh
功能：提取沿著一個矩形或環狀弧，特殊灰度值的點。
12. reset_fuzzy_measure
功能：重置一個模糊元函數。
13. set_fuzzy_measure
功能：指定一個模糊元函數。
14. set_fuzzy_measure_norm_pair
功能：為邊緣匹配指定一個規范化模糊元函數。
15. translate_measure
功能：轉化（解釋）一個測試對象。
17.15 OCV（Open_Circuit_Voltage_|_光學字符校驗）
1. close_all_ocvs
功能：關閉所有OCV工具。
2. close_ocv
功能：關閉一個OCV工具。
3. create_ocv_proj
功能：創建一個基於灰度值突出的新的OCV工具。
4. do_ocv_simple
功能：利用一個OCV工具查證一個模式。
5. read_ocv
功能：從文件中讀取一個OCV工具。
6. traind_ocv_proj
功能：測試一個OCV工具。
7. write_ocv
功能：將一個OCV工具保存到文件。
17.16 Shape-from
1. depth_from_focus
功能：利用多倍聚焦灰度級提取高度（厚度）。
2. estimate_al_am
功能：估測一個平面的反射率和反射光的數目。
3. estimate_sl_al_lr
功能：估測一個光源的傾斜度和一個平面的反射率。
4. estimate_sl_al_zc
功能：估測一個光源的傾斜度和一個平面的反射率。
5. estimate_tilt_lr
功能：估測一個光源的傾斜。
6. estimate_tilt_zc
功能：估測一個光源的傾斜。
7. phot_stereo
功能：根據至少三個灰度值的圖像來重建一個平面。
8. select_grayvalues_from_channels
功能：利用索引圖像選擇一個多通道圖像的灰度值。
9. sfs_mod_lr
功能：從一個灰度值圖像重建一個平面。
10. sfs_orig_lr
功能：從一個灰度值圖像重建一個平面。
11. sfs_pentland
功能：從一個灰度值圖像重建一個平面。
12. shade_height_field
功能：遮蔽一個突起的字段。
17.17 Stereo
1. binocular_calibration
功能：決定一個雙目視覺立體系統的所有相機參數。
2. binocular_disparity
功能：計算一個矯正圖像對的不均衡。
3. binocular_distance
功能：計算一個矯正立體圖像對的間隔值。
4. disparity_to_distance
功能：將不均衡值轉換為矯正雙目視覺立體系統中的間隔值。
5. disparity_to_point_3d
功能：將一個圖像點和它的不均衡值轉換為一個矯正立體系統中的三維點。
6.distance_to_disparity
功能：將一個間隔值轉換為一個矯正立體系統中的一個不均衡值。
7. essential_to_fundamental_matrix
功能：計算一個從原始矩陣衍生而來的基本矩陣。
8. gen_binocular_proj_rectification
功能：計算弱雙目視覺立體系統圖像的投射矯正值。
9. gen_binocular_rectification_map_
功能：創建傳輸圖，其描述從一個雙目相機到一個普通的矯正圖像面的圖像的映射。
10. gen_binocular_rectification_map
功能：從一個雙目相機系統視覺中兩條線的交點中獲取一個三維點。
11. match_essential_matrix_ransack
功能：通過自動發掘圖像點間對應關系來計算立體圖像對的原始（本質）矩陣。
12. match_fundamental_matrix_ransack
功能：通過自動發掘圖像點間對應關系來計算立體圖像對的基本矩陣。
13. match_rel_pose_ransack
功能：通過自動發掘圖像點間對應關系來計算兩個相機間的相對方位。
14. reconst3d_from_fundamental_matrix
功能：計算基於基本矩陣的點的投影的三維重建。
15. rel_pose_to_fundamental_matrix
功能：計算兩個相機相關方向中獲取的基本矩陣。
16. vector_to_essential_matrix
功能：計算給定圖像點間映射和已知相機矩陣的原始矩陣，重建三維點。
17. vector_to_fundamental_matrix
功能：計算給定圖像點間映射的集合的基本矩陣，重建三維點。
18. vector_to_fundamental_matrix
功能：計算給定圖像點間對應關系和已知相機參數的兩個相機的相對方位，重建三維點。
17.18 Tools-Legacy
1. decode_1d_bar_code
功能：一個條形碼的順序解碼。
2. decode_2d_bar_code
功能：解碼二維條形碼數據。
3. discrete_1d_bar_code
功能：從元素寬度創建一個離散條形碼。
4. find_1d_bar_code
功能：搜索一幅圖像中的一個條形碼。
5. find_1d_bar_code_region
功能：搜索一幅圖像中的多種條形碼。
6. find_1d_bar_code_scanline
功能：搜索一幅圖像中的一個條形碼。
7. find_2d_bar_code
功能：搜索可能包括一個二維條形碼的區域。
8. gen_1d_bar_code_descry
功能：創建一個一維條形碼的說明。
9. gen_1d_bar_code_descr_gen
功能：創建一個一維條形碼的類屬描述。
10. gen_2d_bar_code_descry
功能：創建一個二維條形碼的類屬描述。
11. get_1d_bar_code
功能：提取一個條形碼中元素的寬度。
12. get_1d_bar_code_scanline
功能：提取一個條形碼區域中元素的寬度。
13. get_2d_bar_code_
功能：提取一個條形碼區域（「數據矩陣符號」）中數據元素（在ECC200：「模塊」中）的值。_
14. get_2d_bar_code_pos
功能：提取一個條形碼區域（「數據矩陣符號」）中數據元素（在ECC200：「模塊」中）的數值和它們在圖像中的位置。