Release Notes for HALCON 13.0.4

• In rare cases, find_shape_model (as well as the scaled and aniso variants) might return different results. More information.

GUI

IDE

Miscellaneous

• The example in the reference manual entries of open_io_device and query_io_interface contained a misspelled variable. This problem has been fixed.

• HALCON now supports all GS1 application identifiers specified in the latest version of the "GS1 General Specifications" (January 2019).

• HALCON now supports all GS1 application identifiers specified in the latest version of the "GS1 General Specifications" (January 2019).

• During initialization HALCON attempts to open a hidden OpenGL window to determine the supported OpenGL capabilities. On systems with broken OpenGL drivers this can lead to HALCON crashing on startup. The environment variable HALCON_NO_OPENGL can now be set to 1 to tell HALCON to disable OpenGL support, avoiding the crash.

• connection_object_model_3d did not work with objects that had both triangles and polygons inside the model. This problem has been fixed.
• object_model_3d_to_xyz with Type 'cartesian' sometimes did not show the projected coordinate values in the correctly rounded pixels. This problem has been fixed.
• object_model_3d_to_xyz with Type 'cartesian' sometimes showed incorrect points in the output images, as well as points behind the camera given by CamParam and Pose. This problem has been fixed.
• set_camera_setup_param did not handle poses correctly which were of a type other than 0, i.e., the last entry of the pose was not equal to 0. This problem has been fixed.
• In rare situations, smallest_bounding_box_object_model_3d produced different results on different platforms (macOS, Windows, Linux). This problem has been fixed. The results are now more similar on all platforms.
• In rare cases, triangulate_object_model_3d could have crashed if method was set to 'greedy' and 'greedy_mesh_erosion' was turned on. This problem has been fixed.
• triangulate_object_model_3d with Method set to 'greedy' did not remove attributes that were attached to an old triangulation. triangulate_object_model_3d with Method set to 'polygon_triangulation' raised an unrelated error in case that the input already contained triangles. triangulate_object_model_3d with Method set to 'polygon_triangulation' froze in case that it contained an attribute named '&original_indices'. These problems have been fixed. Now, triangulate_object_model_3d with Method set to 'polygon_triangulation' replaces triangles.
• union_object_model_3d did not free temporary memory correctly if all input object models contained no points. This problem has been fixed.
• vector_to_pose raised memory errors in rare cases. This problem has been fixed.

• find_bar_code could not decode GS1 DataBar Expanded Stacked codes with less than four symbol characters in the first row. This problem has been fixed. Now, the minimum number of symbol characters in the first row is two as specified by the ISO/IEC 24724:2011 standard.
• HALCON now supports all GS1 application identifiers specified in the latest version of the "GS1 General Specifications" (July 2019).

• find_calib_object could have found the same finder pattern twice in a low resolution image. This problem has been fixed. Now, the error 8395 ("Same finder pattern found multiple times") is returned.

• trans_from_rgb could have produced wrong output for the mode 'ihs' and some specific input. This problem has been fixed.
• RGB/YUV conversion was using wrong equations, not the one from Norm ITU-R BT.470-6: Conventional Television Systems, 1998. This problem has been fixed.

• In very rare cases, find_data_code_2d returned wrong QR code results if ECI mode was used for decoding. This problem has been fixed.
• In rare cases, find_data_code_2d missed decodable PDF417 symbols due to an inconsistent erasure treatment. This problem has been fixed.
• In very rare cases, find_data_code_2d crashed for PDF417. This problem has been fixed.
• In very rare cases, find_data_code_2d returned an incorrectly decoded data string for Data Matrix ECC 200 codes. This problem has been fixed.
• In rare cases, find_data_code_2d threw the error 6006 ("Tmp-memory management: could not find memory element") for Micro QR codes if small timeout values were set. This problem has been fixed.
• In rare cases, a memory leak could have occurred in find_data_code_2d for PDF417 codes if small timeout values were set. This problem has been fixed.
• In very rare cases, find_data_code_2d decoded the left/right indicators of PDF417 codes erroneously. This could have led to crashes. This problem has been fixed.
• In some cases, find_data_code_2d returned Data Matrix ECC 200 codes which were not mirrored even though the parameter 'mirrored' was set to 'yes'. The problem only occurred for data code models with 'module_grid' set to 'any'. This problem has been fixed.
• In some cases, get_data_code_2d_results returned further candidates although the expected result number, defined by 'stop_after_result_num', has already been reached. This problem has been fixed.
• In very rare cases, get_data_code_2d_results returned too bad grades for quality_isoiec15415 for Data Matrix ECC 200 codes. This problem has been fixed.
• For set_data_code_2d_param, the parameter 'format' allows a list of values. If this list contained an invalid value, the function exited and all previously set values were discarded. This problem has been fixed. Now, the old list of parameters is kept.
• HALCON now supports all GS1 application identifiers specified in the latest version of the "GS1 General Specifications" (July 2019).

• select_gray selected only pixels greater than 0 when using 'min' for the Min argument. This problem has been fixed.

• read_image crashed when reading GIF images in parallel. This problem has been fixed. Now, read_image internally protects reading of GIF images with a mutex.
• write_image wrote JpegXR files, even if an error occured. This problem has been fixed and write_image now removes partially written JpegXR files on error.

• affine_trans_image and affine_trans_region could have crashed in rare cases, if the interpolation method 'nearest_neighbor' was used together with the system parameter 'int_zooming' set to 'false'. This problem has been fixed.
• convol_image created empty images on asymmetric separable filters. This problem has been fixed.
• find_text returned non-deterministic results in the rare case when using the manual OCR mode to recognize imprinted characters in uint2 images. This problem has been fixed.

• get_disp_object_model_3d_info sometimes did not raise an error when information was not stored with the window, and 'opengl_compatibility_mode_enable' was set to 'true' via set_system. Instead, the depth information of a prior valid call was returned. This problem has been fixed.
• open_window did not work on Linux systems with IPv6 (e.g., Ubuntu 18.04). This caused also 3D plots and OpenGL operations not to work. This problem has been fixed.
• set_window_param did not ensure to run in the GUI thread for non-buffer windows. This could have resulted in undefined behavior in rare cases. This problem has been fixed.

• get_texture_inspection_model_param did not work correctly in rare cases when GenParamName was set to 'gmm_centers' or 'novelty_threshold'. In more detail, the behavior occurred in case that set_texture_inspection_model_param had been called previously with GenParamName set to 'levels' and GenParamValue set to 'auto' with no subsequent call to train_texture_inspection_model. This problem has been fixed. Now, get_texture_inspection_model_param raises the error 3801 ("Texture inspection model is not trained").

• In some cases, create_aniso_shape_model, create_aniso_shape_model_xld, create_scaled_shape_model, create_scaled_shape_model_xld, create_shape_model, create_shape_model_xld, determine_shape_model_params, and set_shape_model_metric crashed when a big memory block was requested on 32-bit systems. This problem has been fixed. Now, the error 6001 ("Not enough memory available") is returned.
• In rare cases, find_shape_model (as well as the scaled and aniso variants) did not respect the value of 'min_contrast' correctly when the number of model points is 8 or less on the respective pyramid level and if AVX2 was used. This problem has been fixed.
• In rare cases, find_shape_model (as well as the scaled and aniso variants) returned the error 3513 ("Internal error: number of chords too big for num_max"). This problem has been fixed. Note that this change affects the compatibility. Read more.
• The documentation of the procedure dev_display_shape_matching_results advised to use a wrong parameter value. This problem has been fixed.

• In very rare cases, find_text threw the error 3111 ("At least one input object has an empty region"). This problem has been fixed.
• Calling get_text_model_param for 'text_line_structure' caused a buffer overrun. This problem has been fixed.
• The previously allowed overlapping area for sort_region with SortMode 'character' was too large, so that characters in a slightly tilted row or column sometimes were erroneously sorted into two rows or columns. This problem has been fixed. Now, the maximum allowed overlap between two adjacent rows or columns is 15% of the larger one of two overlapping characters.

• distance_pr and distance_sr did not return an error if the input region was empty. This problem has been fixed.
• The operator gen_random_regions ignored the random seed defined via set_system. This problem has been fixed. Now, calls to gen_random_regions deliver reproducible results if the same random seed is set.
• intersection failed if both regions had 65536 run lengths. This problem has been fixed.
• local_threshold returned the error 3513 ("number of choords too big for num_max") in rare cases. This problem has been fixed.
• min_max_gray, gray_features, and select_gray returned wrong values for regions consisting of a single pixel. This problem has been fixed.
• partition_rectangle stored empty regions also if the system settings were set to 'store_empty_region'='false'. This problem has been fixed.

• local_threshold returned the error 3513 ("number of choords too big for num_max") in rare cases. This problem has been fixed.

• Negative float values were incorrectly rejected by the operator send_data. This problem has been fixed.

• In rare circumstances, distance_contours_xld could have crashed in HALCON XL. This problem has been fixed.
• elliptic_axis_xld returned incorrect results for squares with phi=0. This problem has been fixed.
• For a large number of input contours, gen_grid_rectification_map crashed on Windows. This problem has been fixed.
• The number of contour points required for get_contour_angle_xld was not clearly defined. This problem has been fixed. Now, the required minimum is checked correctly and specified in the documentation.