release 4.1.0

目次
1. Highlights
2. FIE module Updates

1. Highlights

２値ブローブ解析（拡張版）の追加

従来と比べて処理可能な画像サイズを拡張した新たな２値ブローブ解析機能を追加しました。 サイズが65535×65535を超える画像での検査・計測に活用できます。

HDR合成の追加

複数の露光量で撮影された画像を合成して、より広いダイナミックレンジを持つ画像を生成する機能を追加しました。 明るい部分と暗い部分の両方が詳細に表現された画像を作成できるため、検査の効率化に貢献します。

2. FIE module Updates

FIE関数の追加

２値ブローブ解析（拡張版）

• 実行
  • ２値ブローブ解析実行 / fnFIE_measure2_execute()
• 実行結果操作
  • ブローブ番号配列の取得 / fnFIE_measure2_get_list()
  • ブローブ番号配列の特徴量に基づくフィルタリング / fnFIE_measure2_refilter_list()
  • ブローブの特徴量に基づくソーティング / fnFIE_measure2_sort_list()
  • REGION取得 / fnFIE_measure2_get_region()
  • 親ブローブの取得 / fnFIE_measure2_get_parent()
  • 子ブローブの取得 / fnFIE_measure2_get_child()
  • １つ後ろの兄弟ブローブの取得 / fnFIE_measure2_get_sibling_back()
  • １つ次の兄弟ブローブの取得 / fnFIE_measure2_get_sibling_next()
  • 全ブローブ数の取得 / fnFIE_measure2_get_blobnum()
  • 有効なブローブ数の取得 / fnFIE_measure2_get_real_blobnum()
• 特徴量計算
  • 色の取得 / fnFIE_measure2_get_color()
  • xyrangeの取得 / fnFIE_measure2_get_xyrange()
  • 対象ブローブの面積の取得 / fnFIE_measure2_get_area()
  • 座標の最大最小位置の取得 / fnFIE_measure2_get_maxminpos()
  • 外接矩形サイズの取得 / fnFIE_measure2_get_xydiff()
  • 外接矩形面積の取得 / fnFIE_measure2_get_rect1_area()
  • 外接矩形縦横比の取得 / fnFIE_measure2_get_rect1_lratio()
  • 外接矩形面積比の取得 / fnFIE_measure2_get_rect1_sratio()
  • １次モーメントの取得 / fnFIE_measure2_get_moment1()
  • ２次モーメントの取得 / fnFIE_measure2_get_moment2()
  • 重心２次モーメントの取得 / fnFIE_measure2_get_central_moment2()
  • ３次モーメントの取得 / fnFIE_measure2_get_moment3()
  • 重心３次モーメントの取得 / fnFIE_measure2_get_central_moment3()
  • Ｎ次モーメントの取得 / fnFIE_measure2_get_moment()
  • 重心Ｎ次モーメントの取得 / fnFIE_measure2_get_central_moment()
  • Huモーメント不変量の取得 / fnFIE_measure2_get_hu_moments()
  • 重心の取得 / fnFIE_measure2_get_center()
  • 等価楕円の取得 / fnFIE_measure2_get_equivalent_ellipse()
  • 面積等価円の取得 / fnFIE_measure2_get_equivalent_disk()
  • 外接長方形の取得 / fnFIE_measure2_get_rect2_size()
  • 外接長方形面積の取得 / fnFIE_measure2_get_rect2_area()
  • 外接長方形縦横比の取得 / fnFIE_measure2_get_rect2_lratio()
  • 外接長方形面積比の取得 / fnFIE_measure2_get_rect2_sratio()
  • フェレ径の取得 / fnFIE_measure2_get_feret_diameter()
  • 対象ブローブの周囲長の取得 / fnFIE_measure2_get_perimeter()
  • 周囲座標の取得 / fnFIE_measure2_get_boundary()
  • 周囲座標の取得 / fnFIE_measure2_get_boundary_ex()
  • 凸包の取得 / fnFIE_measure2_get_convex2d()
  • 最小外接円の取得 / fnFIE_measure2_get_circmcircle()
  • 最大フェレ径、最小フェレ径の取得 / fnFIE_measure2_get_feret_diameter_maxmin()
  • 外接長方形の頂点座標の取得 / fnFIE_measure2_get_rect2pos()
  • 指定角度外接長方形の頂点座標の取得 / fnFIE_measure2_get_bounding_rotated_rect_pos()
  • 周囲長等価円の取得 / fnFIE_measure2_get_equivalent_circle()
  • 凸包面積・周囲長の取得 / fnFIE_measure2_get_convexfeature()
  • 凸包面積比・周囲長比の取得 / fnFIE_measure2_get_convexratio()
  • 隣接エリア（兄弟ブローブ）間距離の取得 / fnFIE_measure2_get_distance_to_siblings()
  • 外周距離の取得 / fnFIE_measure2_get_distance_to_boundary()
  • 真円度＃１の取得 / fnFIE_measure2_get_circularity1()
  • 真円度＃２の取得 / fnFIE_measure2_get_circularity2()
  • 真円度＃３の取得 / fnFIE_measure2_get_circularity3()
  • 穴数の取得 / fnFIE_measure2_get_hole_num()
  • 兄弟ブローブ数の取得 / fnFIE_measure2_get_sibling_num()
  • 穴面積の取得 / fnFIE_measure2_get_hole_area()
  • 面積（穴面積含む）の取得 / fnFIE_measure2_get_area_with_hole()
  • 穴面積比の取得 / fnFIE_measure2_get_hole_ratio()
  • 子供距離の取得 / fnFIE_measure2_get_distance_to_childs()
  • 面積周囲長比(pps)の取得 / fnFIE_measure2_get_pps()
  • 座標(x,y)の位置のブローブ番号取得 / fnFIE_measure2_get_blobno_on_xy()

リージョン処理

• 幾何変換
  • リージョンの射影変換 / fnFIE_region_geotrans_perspective()
• 特徴量計算
  • REGIONオブジェクトの特徴量計算精度フラグ設定関数 / fnFIE_region_set_precision()
  • REGION特徴量：面積（巨大領域対応版） / fnFIE_region_get_area_ex()
  • REGION特徴量：外接矩形面積（巨大領域対応版） / fnFIE_region_get_rect1_area_ex()
  • REGION特徴量：１次モーメント（巨大領域対応版） / fnFIE_region_get_moment1_ex()
  • REGION特徴量：２次モーメント（巨大領域対応版） / fnFIE_region_get_moment2_ex()

ビジョンツール：HDR合成

• 実行
  • HDR画像生成 / fnFIE_hdr_execute()
  • 線形応答を表す逆カメラ応答関数の生成 / fnFIE_hdr_calibrate_linear()
  • Robertsonによる逆カメラ応答関数推定 / fnFIE_hdr_calibrate_robertson()
  • Mertensによる画像合成 (Exposure fusion) / fnFIE_hdr_mertens()
  • ガンマ変換を利用したtonemapping / fnFIE_hdr_tonemap_gamma()
  • Hoodによるtonemapping / fnFIE_hdr_tonemap_hood()
  • HDR画像生成手法の設定 / fnFIE_hdr_set_execute_method()
  • HDR画像生成手法の取得 / fnFIE_hdr_get_execute_method()
  • ゲインの設定 / fnFIE_hdr_set_gain()
  • ゲインの取得 / fnFIE_hdr_get_gain()
  • キャリブレーション手法の取得 / fnFIE_hdr_get_calibrate_method()
  • 画像枚数の取得 / fnFIE_hdr_get_num_images()
  • 画像型の取得 / fnFIE_hdr_get_imgtype()
  • チャネル数の取得 / fnFIE_hdr_get_channels()
  • 逆カメラ応答関数の取得 / fnFIE_hdr_get_icrf()
  • 露光量の比の取得 / fnFIE_hdr_get_exposure_ratio()

機能追加および、変更

• fnFIE_packing_ch()
  • 縦に並べてパックする機能を追加.
• fnFIE_unpacking_ch()
  • 縦に並べてパックされた画像のアンパック機能を追加.
• fnFIE_region_get_rect1_lratio(), fnFIE_region_get_rect1_sratio(), fnFIE_region_calc_central_moment2(), fnFIE_region_calc_hu_moments(), fnFIE_region_get_center(), fnFIE_region_get_equivalent_ellipse(), fnFIE_region_get_rect2_size(), fnFIE_region_get_rect2_area(), fnFIE_region_get_rect2_lratio(), fnFIE_region_get_rect2_sratio(), fnFIE_region_get_distance_to_boundary(), fnFIE_region_calc_equivalent_disk(), fnFIE_region_calc_circularity1(), fnFIE_region_calc_circularity2(), fnFIE_region_calc_circularity3(), fnFIE_region_calc_convexratio(), fnFIE_region_calc_rect2pos()
  • fnFIE_region_set_precision() により F_PRECISIONFLAG_MOMENT フラグが設定されていた場合、 処理可能なリージョンのサイズを増加.
• fnFIE_region_get_area(), fnFIE_region_get_rect1_area(), fnFIE_region_get_moment1(), fnFIE_region_get_moment2()
  • fnFIE_region_set_precision() により F_PRECISIONFLAG_MOMENT フラグが設定されていた場合、 より大きなリージョンを処理しても、内部的にはより正確な特徴量を計算するようにし、サチュレーション処理によりオーバーフローを回避するように変更.
• fnFIE_region_calc_moment(), fnFIE_region_calc_central_moment()
  • fnFIE_region_set_precision() により F_PRECISIONFLAG_MOMENT フラグが設定され、かつ計算するモーメントの次数が2以下の場合、 処理可能なリージョンのサイズを増加.

不具合修正

• #1673 fnFIE_region_encode()
  • 横幅が65536以上の画像を正しく処理できない問題を修正.

ドキュメント修正

• #1665 F_MEASURE_PARAMS::precalc_features
  • 存在しない特徴量フラグ定数が記載されている問題を修正.
• #1681 fnFIE_measure_get_equivalent_ellipse(), fnFIE_region_get_equivalent_ellipse()
  • 説明の誤りを修正.
• fnFIE_measure_get_area()
  • 特徴量説明ページへの参照先の誤りを修正.
• fnFIE_measure_get_perimeter(), fnFIE_region_get_perimeter()
  • 説明の不足を修正.