Release Notes for MERLIC 4.4.2

Here you can read the release notes for MVTec MERLIC 4.4.2, as released in October 2020.

Supported Operating Systems

Windows

MERLIC4.4.2 is available for Windows 7 and Windows 10 (64-bit operating system).

During the installation, the environment variable MERLIC4EXAMPLES is set to C:\Users\Public\Documents\MVTec\MERLIC 4 by default. It contains the path to the directory in which additional files such as example applications or images are installed.

Please refer to the "Readme" in the MERLIC manual for more information about the system requirements.

Linux

MERLIC4.4.2 is available for selected Linux ARM 64-bit platforms. This edition requires a specific license that needs to be activated on the ARM device. Please contact MVTec to get more information about how to obtain this license. After the license activation, the ARM device also functions as a license dongle for the PC version of MERLIC4.4.2, however, with some limitations.

Please refer to the "Help → About" dialog in the MERLIC Backend for the respective limitations.

Licensing

  • Fixed Problems
    • Several vulnerabilities in CodeMeter Runtime, the license management of MERLIC, have been disclosed on the website of WIBU Systems on September 8, 2020. Successful exploitation of these vulnerabilities could potentially lead to remote code execution or prevent normal operation of MERLIC. This problem has been fixed. This MERLIC version uses the updated CodeMeter Runtime version 7.10a which secures the remote access.

 


Release Notes for MERLIC4.4.1

This document provides the release notes for MVTecMERLIC4.4.1, as released in July 2020.

Supported Operating Systems

Windows

MERLIC4.4.1 is available for Windows 7 and Windows 10 (64-bit operating system).

During the installation, the environment variable MERLIC4EXAMPLES is set to C:\Users\Public\Documents\MVTec\MERLIC 4 by default. It contains the path to the directory in which additional files such as example applications or images are installed.

Please refer to the "Readme" in the MERLIC manual for more information about the system requirements.

Linux

MERLIC4.4.1 is available for selected Linux ARM 64-bit platforms. This edition requires a specific license that needs to be activated on the ARM device. Please contact MVTec to get more information about how to obtain this license. After the license activation, the ARM device also functions as a license dongle for the PC version of MERLIC4.4.1, however, with some limitations.

Please refer to the "Help → About" dialog in the MERLIC Backend for the respective limitations.

Compatibility

Since the last MERLIC version we have been working hard to improve MERLIC in every way. This has, however, resulted in a few incompatibilities. We apologize for the inconvenience.

  • Designer
    • The minimum size of some Designer widgets has been adjusted. If an MVApp of a previous MERLIC version contains widgets that are smaller than the new minimum size, the widgets are still displayed in the respective size. However, when resizing the widgets, the new minimum width and height settings apply. More information.

Backend

  • Enhancements
    • The start-up time of MERLIC has been improved significantly. It is now up to five times faster than previous MERLIC versions.
  • FixedProblems
    • The start-up time of MERLIC was prolonged if MERLIC was used in the trial version. This problem has been fixed. Now, the overall start-up time has been reduced.
    • In rare cases, MERLIC crashed if the continuous execution of a MERLIC Vision App was stopped by double-clicking on the "Run" button in the MERLIC Backend. This problem has been fixed.
    • When the MERLIC Backend was closed while the MERLIC Vision App was still being executed in continuous mode, the process of the MERLIC Backend did not close properly. This problem has been fixed.
    • When using MERLIC on Windows 7, the quick info of the MERLIC tools was not shown. Instead an error message was repeatedly displayed that the QtWebengine process for rendering the quick info crashed. This problem has been fixed.

Designer

  • Improved Usability
    • The usability of the Designer widgets has been improved. The minimal size for selected widgets has been reduced to enable the user more flexibility when designing the Frontend for the use on small screens. The following widgets have been adjusted:
      Widget Previous Size New Size
      Dialog Button 50x20 20x20
      easyTouch 32x16 40x20
      Execution Control 130x60 50x20
      Label 60x20 30x20
      OK/NOK 50x50 20x20
      Rectangle 60x40 20x20
      Slider 50x20 40x20
      Text Box 80x40 30x30
      Write Access 32x16 40x20
      Note that this change affects the compatibility. Read more.
  • Fixed Problems
    • When right-clicking in the workspace of the MERLIC Designer, the context menu was displayed at a wrong position. In addition, when right-clicking on a widget to open the context menu for the selected widget, no context menu was opened. These problems have been fixed.

Frontend

  • Fixed Problems
    • When using the MERLIC Frontend via a Remote Desktop Connection to a Windows 7 host, the MERLIC Frontend did not close when pressing the Close button. This problem has been fixed.
    • The MERLIC Frontend could not be operated via touchscreen anymore. This problem has been fixed.

Process Integration

  • Fixed Problems
    • Sometimes, MERLIC crashed when it was started in process integration mode. This problem has been fixed.

 


Release Notes for MERLIC4.4.0

This document provides the release notes for MVTecMERLIC4.4.0, as released in March 2020.

Supported Operating Systems

Windows

MERLIC4.4.0 is available for Windows 7 and Windows 10 (64-bit operating system).

During the installation, the environment variable MERLICEXAMPLES is set to C:\Users\Public\Documents\MVTec\MERLIC 4 by default. It contains the path to the directory in which additional files such as example applications or images are installed.

Please refer to the "Readme" in the MERLIC manual for more information about the system requirements.

Linux

MERLIC4.4.0 is available for selected Linux ARM 64-bit platforms. This edition requires a specific license that needs to be activated on the ARM device. After the license activation, the ARM device also functions as a license dongle for the PC version of MERLIC4.4.0, however, with some limitations.

Please refer to the "Help → About" dialog in the MERLIC Backend for the respective limitations.

Major New Features

Process Integration with Digital I/O Communication

MERLIC4.4.0 is providing communication via digital I/O interfaces supporting Advantech, NIDAQmx, and Contec cards. In addition, the new version enables cameras to communicate via GenICam digital I/O control.

Greatly improved recipe management

The newly designed Recipe Manager helps to keep the overview of the used recipes and to organize them for the production line thanks to the easy-to-use graphical user interface.

Backend

  • Enhancements
    • The scaling of the MERLIC Backend, Designer, and Frontend has been improved. Previously, GUI elements, e.g., fonts, icons, or arrows, were scaled differently when running MERLIC on high-DPI screens such as Microsoft Surface. Now, MERLIC scales correctly when running on screens with high resolutions.
    • The startup behavior of the MERLIC Backend has been improved. Previously, the MERLIC Backend did not start but raised an error message in case the underlying configuration for MERLIC process integration contained errors. Now, the MERLIC Backend starts without error messages. A possible misconfiguration of the MERLIC process integration can be seen and investigated inside the new "MVTec MERLIC Process Integration Setup" which can be opened via the MERLIC Backend or as stand-alone application.
    • The minimal window size of MERLIC has been revised. Previously, the MERLIC Backend, MERLIC Designer, and the user management dialog were available in different minimal window sizes. Especially, the minimal size of the MERLIC Designer was too small to be applicable. Now, the minimal window size has been unified for the Backend, Designer, and the user management dialog to 1024x786.
  • Improved Usability
    • The search functionality of the Tool Library in the MERLIC Backend has been improved. Previously, the search bar became only visible via a click on the search icon. In addition, by clicking on the close icon the search bar was closed instead of clearing the search text. Now, the search bar is placed on top of the Tool Library panel and is always visible and the close icon now clears the search text.
    • The naming convention of input and output parameters that can be used for the communication during the MERLIC process integration has been revised and unified. Previously, they were named "interface parameters". Now, these parameters have been renamed to "MVApp parameters" and "MVApp results".
  • FixedProblems
    • In some cases, long tool error messages were not completely visible in the message box of MERLIC tools. This problem has been fixed.
    • When closing the MERLIC Backend, pending user actions, e.g., save on exit, were discarded under certain circumstances. This problem has been fixed.
    • In some cases, the MERLIC Frontend restored settings in the .ini file that have been changed by the MERLIC Backend and vice versa. This problem has been fixed.
    • If the .ini file contained erroneous entries or caused validation errors, the MERLIC Backend did not start anymore. This problem has been fixed.
    • MERLIC could not be started if the "Maximum size of log files" was set very high in the MERLIC preferences. This problem has been fixed. The "Maximum size of log files" is now limited to a maximum value of 1024 MB.

Designer

  • Improved Usability
    • The menu icon for the MERLIC Designer has been revised. It has been redesigned to fit to the design of the new "MVTec MERLIC Process Integration Setup".
  • Fixed Problems
    • If a Designer widget was connected to a tool parameter or tool result and the respective tool was then deleted in the Backend, the connection between the widget and the tool parameter or result was lost. A generic error message was shown that did not mention the actual problem and the respective combo boxes "Connected Tool" and "Connected Parameter" were empty instead of indicating that no tool or tool parameter is connected. This problem has been fixed. Now, a widget instantly shows the info that no tool or parameter is connected and no error message is displayed.
    • If a widget in the MERLIC Designer was connected to a tool parameter with tuple type "long", the respective parameter value was sometimes not displayed correctly and could not be edited in the Frontend. This problem has been fixed.
    • If the "Table" widget was configured in the MERLIC Designer by selecting multiple table cells at once and adjusting a widget property such as the colors, previously defined cell texts have been deleted. This problem has been fixed. In addition, the configuration of multiple table cells is now restricted to properties that do not represent the cell texts.
    • If MERLIC was set to a language other than English, the "Action" property of the "Dialog Button" widget showed an empty combo box in the Designer instead of the view selection. This problem has been fixed.

Frontend

  • Enhancements
    • The usage of the MERLIC Frontend during MERLIC process integration has been improved. Now, the user can use the new Designer widget "Write Access" to activate the write mode in the Frontend for modifying parameters and saving the MERLIC Vision App. When write access is granted to the MERLIC Frontend, the internal state of MERLIC process integration changes to "Manual" and the currently connected communication device or control system is no longer allowed to trigger commands for the execution of the MVApp or to prepare a recipe.
  • Fixed Problems
    • When displaying a multi-valued parameter in a table in the MERLIC Frontend, the first value was not shown but the last value of the parameter was shown twice instead. This problem has been fixed.
    • The menu entries and dialog texts within the MERLIC Frontend were always shown in English even if a different language was selected. This problem has been fixed.
    • If the Designer widget "Label" or a cell of the "Table" widget was connected to a tool result that might contain an empty tuple, e.g., the result "Decoded Data" of the tool "Read Bar Code", the respective text field still showed the result of the previous MVApp execution in the Frontend if the execution resulted in an empty tuple, e.g., if no bar code was visible in the image. This problem has been fixed. The text will now be set to an empty string if the connected tool result contains an empty tuple.

Tools

  • Enhancements
    • The tool "Acquire Image from Camera" has been revised. It is now possible to achieve higher frame rates for cameras that support GenICam SFNC-conform software trigger. With this change, it is no longer possible to configure these cameras to be triggered by hardware.
  • Fixed Problems
    • When trying to select a calibration plate descriptor file in the tool "Calibrate Camera", the file selection dialog automatically filtered for image files instead of files with file ending ".cpd". This problem has been fixed.
    • The tool "Measure Opposite Edges" did not respect connected calibration data when calculating the angle between opposite edges. This problem has been fixed.
    • In case of communication issues when using the tools "Read from Serial Interface", "Write to Serial Interface", "Read from Socket", or "Write to Socket", the respective tool state was set only for some of the tools. This problem has been fixed. The tool state is now set consistently for all of these tools.
    • To open a socket connection the maximum timeout was used. This increased the loading time for MERLIC Vision Apps that contains the tools "Read from Socket" or "Write from Socket". This problem has been fixed. Now, the read/write timeout that is specified in these tools is also used for opening the socket connection. In addition, the default timeout has been adjusted to 0.5 seconds and the maximum value has been changed to 10 seconds.

Process Integration

  • New Features
    • MERLIC has been extended by the new application "MVTec MERLIC Process Integration Setup" (MERLIC PI Setup) that provides a graphical user interface for the configuration of the MERLIC process integration mode. It is provided as a stand-alone software that can be opened from the MERLIC Backend or with the respective executable file without starting the MERLIC Backend.
      The MERLIC PI Setup is divided in two configuration areas: the "Recipe Manager" and the "Hardware Setup". The "Recipe Manager" enables the user to import and check existing MERLIC recipe files whereas the "Hardware Setup" enables the user to select and configure the communication device that is used for the process integration of MERLIC.
  • Fixed Problems
    • When MERLIC was started via command line with the option --ini and a file with the wrong file type was defined for the --ini option, e.g., an MVApp file instead of a .ini file, the content of the specified file has been changed. This problem has been fixed. Now, the file is not overwritten anymore if a wrong file type is specified. Instead, MERLIC is started with the default settings.
    • The "Interface Parameters" panel in the MERLIC Backend displayed the position ID of the respective interface parameters two times instead of only once. In addition, the position was counted beginning from 1. This problem has been fixed. The numbering has been unified with the numbering in the new "MVTec MERLIC Process Integration Setup" and now starts with the ID 0. The visualization of the position ID has been fixed in the course of renaming the panel to "MVApp Parameters and Results".
    • In rare cases, MERLIC hanged if it was running in process integration mode with the simulated PLC, i.e., no further executions were triggered. This problem has been fixed.
    • In some cases, the preamble byte sent by the PLC was ignored by MERLIC in process integration mode. If the preamble byte was set to a wrong value, the command was still executed. This problem has been fixed. Now, messages with a wrong preamble byte are ignored and commands will not be executed.

Documentation

  • Enhancements
    • The documentation of several tools has been improved. The quick info and tool references of the tools of the category "Combined Measuring" have been extended to be more clear. In addition, also the quick info of further tools has been extended to describe more clearly how to use the tools.
    • The documentation of the tools in the category "Reading" has been improved. The respective tool references have been extended by a description how the training is performed.
    • The documentation of the tools "Read from File" and "Write from File" has been improved. It has been extended by a description on how to finish the writing mode and close a file.
    • The MERLIC manual has been improved. Images and videos have been revised and are now displayed with a simplified user interface to provide a clear look and focus the user's attention on the features to be shown in the images and videos.
  • Fixed Problems
    • The documentation of the logging mechanism of MERLIC contained an example in which the log file size was set to 100 bytes. However, this was misleading because MERLIC ignores values less than 1 MB. This problem has been fixed. The example now uses an appropriate log file size.
    • The tool reference of the tool "Write to File" contained wrong information about how the file is opened for writing. This problem has been fixed.

Installation

  • New Features
    • MERLIC has been extended to provide a new entry for the MERLIC Frontend in the Windows start menu in addition to the new "MVTec MERLIC Process Integration Setup".
  • Fixed Problems
    • After installing MERLIC, the language of the MERLIC Backend was set to English even if a different language was selected during the installation process. This problem has been fixed.

Miscellaneous

  • If comments were added in the MERLIC configuration file (.ini file), these comments were deleted as soon as the settings have been overwritten due to adjustments from the MERLIC GUI. This problem has been fixed. Now, the comment lines starting with "#" or ";" are not removed anymore from the configuration file.
  • The loading time for MERLIC Vision Apps has been improved. Especially, large MVApps and those without complex tool connections and trainings are loaded significantly faster.
  • The configuration of MERLIC via the .ini file has been improved. MERLIC now uses the new .ini file "MERLIC4.ini" to enable separate settings for different major versions. Previously, the settings in the .ini file were applied for all MERLIC instances of all major version. Now, the new .ini file is applied only for the respective major version. When MERLIC is installed on a system that contains only a "MERLIC.ini" and no "MELRIC4.ini" yet, the settings in the "MERLIC.ini" will be automatically converted to the new "MERLIC4.ini".

 


Release Notes for MERLIC4.3.0

This document provides the release notes for MVTecMERLIC4.3.0, as released in August 2019.

Backend

  • FixedProblems
    • Error dialogs that were shown during the startup of MERLIC were not visible because they were hidden by the splash screen. This problem has been fixed.
    • The menu of the MERLIC Backend was disabled when pressing the keyboard shortcut ALT+Tab while the mouse cursor hovered over the image of the tool board. This problem has been fixed.
    • When moving the mouse cursor over the image in the tool board while pressing the keyboard shortcut ALT, the image coordinates and gray values of the respective pixel are shown. However, if the mouse cursor was moved, the displayed values were truncated and not readable anymore. This problem has been fixed.
    • When changing the value of image specific training parameters, such as "Sample Type" in the tool "Check Presence with Gray Features", the respective value was highlighted in the wrong font size. This problem has been fixed.
    • If a tool parameter name has been renamed to an HTML code instead of a text, the HTML code was accepted as parameter name, parsed, and rendered. This problem has been fixed.
    • If a tool with multiple connections to subsequent tools was displayed in the tool workspace, the text of the drop area for new tool connections was hidden by the labels of the connected tools. This problem has been fixed.
    • If a tool parameter with a predefined list of values was adjusted, the combo box with the value list was only opened after a second click on the respective connector instead on the first click. This problem has been fixed.

Tools

  • New Features
    • The path settings for the tools of the category "File Access" have been improved. Previously, the tools used paths that were relative to the working directory. Now, relative paths refer to the directory "%USERPROFILE%/Documents". Furthermore, the "File Name" parameter of these tools are now set to an absolute path by default and it is now possible to use "/" as well as "\" as path separators.
  • Fixed Problems
    • In some cases, the tool "Detect Scratches" threw an error message that too many scratches were found right after inserting the tool. This problem has been fixed. Now, the tool shows a warning which gives more detailed information about the number of found scratches and the allowed maximum number of scratches for the respective image size.
    • If the ALT key was pressed while moving the mouse cursor over the image in the tool "Invert Gray Values", the respective information about the gray value and the coordinates of the original image were displayed instead of the pixel information of the inverted image that is displayed in the tool. This problem has been fixed.
    • Each time the tool "Level Surface" was added to an MVApp, an error message was written to the log file. This problem has been fixed.

Documentation

  • Enhancements
    • The information about the system requirements of MERLIC have been improved. They are now more clear on which operating systems are supported. In addition, they have been extended by a link to the system requirements of the supported image acquisition interfaces to provide an easy access to the respective information.
  • Fixed Problems
    • Some screenshots in the MERLIC manual were not up to date. This problem has been fixed. 

Installation

  • Fixed Problems
    • In some cases, the display of the installer option to install the MVTec GigEVision streaming filter was broken. This problem has been fixed. This option is now displayed on two separate pages instead of one single page.
    • If the MERLIC setup was executed on a system with an installed MVTec GigEVision streaming filter, the respective files of the streaming filter were deleted when deselecting the option to install the streaming filter during the MERLIC setup. This problem has been fixed.

Licensing

  • New Features
    • MERLIC 4.3.0 is now available as a new edition for selected Linux ARM 64-bit platforms. This edition requires a specific license that needs to be activated on the ARM device. After the license activation, the ARM device also functions as a license dongle for the PC version of MERLIC 4.3.0, however, with some limitations. Please refer to the "Help → About" dialog in the MERLIC Backend for the respective limitations.

Miscellaneous

  • The MERLIC configuration settings in the .ini file have been improved. Previously, paths needed to be given with double backslashes "\" as path separator. Now, it is possible to also use to regular slashes "/" and backslashes "\" as path separators in the .ini file. In addition, the [ProcessIntegration] setting "RecipeCount" has been removed.
  • In some cases, settings with language-specific characters in the .ini configuration file could not be read correctly. This problem has been fixed. Note that the .ini file requires an UTF8 character encoding on all platforms.

 


Release Notes for MERLIC4.2

This document provides the release notes for MVTecMERLIC4.2, as released in February 2019. It contains information about new functionality and fixed bugs since MERLIC 3.0.9 as well as information about fixed bugs since MERLIC 4.1 Preview.

Major New Features

Parallelization

One highlight of the new version is the parallel processing and execution of different tools. This simplifies the implementation of multi-camera setups and allows for a more efficient use of the system's computing power.

3D Vision Tools

The software also provides 3D vision tools to work on height images. This enables users, for example, to read embossed text, check heights, and perform other 3D machine vision tasks. For this, four new tools are included that make it possible to prepare images from 3D sensors or 3D cameras so that inspections can be subsequently carried out using MERLIC’s existing 2D tools.

Process Integration with Real-Time Ethernet and Fieldbus Systems

Moreover, MERLIC 4 provides optimized process integration via Hilscher cifX cards (slave/device) of all current form factors. The software can thus communicate with common fieldbus and real-time Ethernet industrial protocols, such as EtherCAT, PROFINET, and many others, via Hilscher PC cards. This makes it possible to seamlessly integrate machine vision systems running MERLIC with a programmable logic controller (PLC).

Besides, MERLIC now supports 'recipes' which allow for the rapid reconfiguration of different machine vision tasks.

Improved Usability with Optimized Tool Flow

MERLIC 4 provides users with an even clearer and more intuitive user interface with a completely redesigned tool flow. Thanks to the tool flow it is possible to easily arrange and connect tools and logic elements using known principles like drag&drop, copy&paste, and multiselection. Automatisms to connect tools have been optimized. Branches between the strands (Branch on Condition) are now displayed more clearly. Using 'Triggers', the user has an additional possibility to control the program flow logically.

A quick search for tools has been implemented, allowing for better usability. For camera parameters a quick search is available now, simplifying the setup of camera settings greatly.

Customized Translations

Moreover, MERLIC 4 allows customized translations of standard texts in the Frontend for all languages.

MERLIC Trial Version

Additionally, with the new release, it is no longer necessary to unlock MERLIC trial versions with an activation ticket online. This allows easier and faster testing of MERLIC 4.

Compatibility

Since the last MERLIC 3 version we have been working hard to improve MERLIC in every way. This has, however, resulted in a few of incompatibilities. We apologize for the inconvenience.

Use of MERLIC Vision Apps created in MERLIC 3

The format of the MERLIC Vision App files has changed since MERLIC 3. MERLIC Vision Apps that have been created in MERLIC 3, e.g., MERLIC 3.0.2, must be converted to the new format if they are loaded in MERLIC4.2. This may lead to functional changes. Therefore, a backup file of the MERLIC Vision App should be created before loading the application. The backup file ensures that you can still use your original application in the previous MERLIC version.

The first save action in MERLIC4.2 stores the application according to the new internal structure and makes it incompatible to previous MERLIC versions. If no backup file was created for the MERLIC Vision App, we recommend to save the converted application with a new name.

In case a MERLIC Vision App of MERLIC 3 is also password protected, it cannot be loaded in MERLIC 4, as MERLIC 4 uses a different, more secure encryption. To still open the MVApp, the encryption must first be removed in the old version.

  • Tools
    • When loading MERLIC Vision Apps from previous MERLIC versions, the stored name of the connected camera is not restored correctly in the tool 'Acquire Image from Camera' because the format of the displayed camera name has been adjusted. Therefore, you have to select the correct camera manually and save the MVApp again. More information.
    • The tool 'Branch on Condition' is no longer compatible since it has been completely revised. MERLIC Vision Apps that contain this tool must be converted to the current version. Note that the conversion may lead to functional changes. To ensure a consistent state, it is recommended to check the configuration of the tool again after the conversion. The chapter 'MERLIC Backend > Parallel Processing > Error Causes' of the MERLIC manual gives more detailed information about possible error causes. More information.
    • If a MERLIC Vision App, that contains one of the following tools, is opened in MERLIC, the respective tool is automatically removed from the MVApp because the tools are no longer available in MERLIC:
      • 'Communicate via Hilscher cifX'
      • 'Communicate via OPC UA'
      • 'Communicate via Digital I/O'
      • 'Stop Execution'
      A backup file of the original MVApp is automatically stored if the MVApp is opened in this MERLIC version.  More information.
    • Tools provided in MERLIC 4 cannot be loaded in previous MERLIC versions because the protection format of the MERLIC tools has been improved. More information.
  • Miscellaneous
    • Protected MERLIC Vision App of previous MERLIC versions cannot be loaded in this MERLIC version because the password protection has been improved. You first have to load the application in the previous MERLIC version and remove the password protection. Then you may load the application in MERLIC 4 and define a new password. More information.

Backend

  • New Features
    • The Tool Flow panel has been extended to support the visualization of parallel tool flows. It is now possible to arrange the tools of a MERLIC Vision App side-by-side to indicate the parallel processing of the tools.
    • The Tool Flow panel has been extended by the following modification features:
      • Copy and paste
        • It is now possible to copy any number of selected tools including their currently set parameter values. They can be pasted at an arbitrary position in the Tool Flow panel. For this, the Tool Flow panel has been extended by a new context menu which enables the user to copy and paste the selected tools. Alternatively, the shortcuts 'Ctrl+C' and 'Ctrl+V' can be used for copy and paste.
      • Delete
        • It is now possible to delete a tool directly in the Tool Flow panel via the new context menu of the tool or via the shortcut 'Del'.
      • Move
        • It is now possible to move any number of selected tools within the Tool Flow panel via drag and drop. This enables the user to easily arrange the tools of the MERLIC Vision App according to the requirements.
      • Selection of multiple tools
        • It is now possible to select multiple tools within the Tool Flow panel. This enables the user to apply a specific modification to multiple tools at once, e.g., moving a group of tools. The selection can be defined via a lasso selection or by pressing the 'Ctrl' or 'Shift' key while clicking on the desired tools.
    • The Tool Flow panel has been extended to visualize the connections of all tools. For a better distinction they are visualized in different colors depending on their state:
      • Connections in an erroneous state are highlighted in red.
      • Connections of currently selected tools are highlighted in blue.
      • Connections of currently not selected tools are visualized in dark gray.
    • MERLIC now supports the use of trigger connections. This enables the user to control various aspects in the execution of a MERLIC Vision App:
      • Execution of a specific tool at a specific time
      • Execution order of the tools in parallel processing
      • Synchronization of tools during parallel processing
      For this, the MERLIC tools have been extended by trigger connectors on the right of the Tool Board. They can be used to create a trigger connection between tools. Use the + button on the top right of the tool to define one or more incoming triggers connections. The new output trigger connector 'Default Trigger' is displayed by default at the bottom right of the tool and can be used to define trigger connections to subsequent tools.
    • With respect to the new process integration mode, MERLIC now enables to specify the tool parameters that can be set via a recipe file and the tool results that are accessible for the connected programmable logic controller (PLC) with a new icon at the respective tool connectors in the MERLIC Backend.
    • With respect to the new process integration mode, the Tool Flow panel in the MERLIC Backend has been redesigned to highlight the tools with specified interface parameters for the process integration. It provides a quick overview to easily recognize the respective tools.
    • With respect to the new process integration mode, the MERLIC Backend has been extended by a new panel that shows an overview of all specified interface parameters for the process integration. It lists all tool parameters that are set via a recipe file and all tool results that are accessible for the programmable logic controller (PLC) with the respective data type.
       
  • Enhancements
    • The Tool Workspace of the MERLIC Backend has been improved in multiple ways.
      • In MERLIC 3, the workspace displayed the currently selected tool as well as part of the previous and subsequent tool. Now, only the currently selected tool is displayed in the Tool Workspace. The additional area is now used to visualize more information about the connected tools.
      • In MERLIC 3, only the name of the connected tools were displayed at the connections within the Tool Workspace. Now, the connections also display the name of the respective parameter or result that is connected.
      • In MERLIC 3, the Tool Workspace offered + buttons on the top right and bottom right of a tool for adding new tools directly from the Tool Workspace. Since the tools can now be processed in parallel and can therefore be arranged side-by-side, these + buttons have been removed. This ensures that the focus in the Tool Workspace is solely on the modification of the currently selected tool. All types of modifications regarding the arrangement of current and new tools can be done in the Tool Flow panel.
    • The renaming of tools, parameters, and results has been improved. If a tool, parameter, or result is renamed, its new name is now displayed together with its original name. The names may contain any valid Unicode character.
      For the tools 'Evaluate Expression' and 'Branch on Condition' additional restrictions apply when renaming the parameters:
      • The new name must not contain any white spaces.
      • The new name must not contain any of following characters:
        ][!\"#$%&'()*+,./:;<=>?@^`{|}~-
        
      • The new name must not be equal to a functional operator, e.g. sin, cos ...
    • If the Quick Info of a tool was expanded or closed, this setting was only applied to the respective tool. Now, this setting is also applied for all other tools. This enables you to close the Quick Info of the tools with a single click. However, the Quick Info of tools that do not have any controls in the tool board, such as the tool 'Write to File', is always shown.
  • Improved Usability
    • The usability of the Tool Library has been improved. In MERLIC 3, the subcategories and tools were not always sorted in an explicit order. Now, the subcategories and tools are sorted alphabetically.
    • The tool parameters and results for the various types of handles, e.g., file handle, were named identically. To better distinguish the respective parameters and results, the tool results that represent a handle are now marked with the suffix 'Used'.
    • The usability of the MERLIC Backend has been improved. In MERLIC 3, no visual feedback was displayed in case a user operation took some time, e.g. loading a MERLIC Vision App, which led to the impression that MERLIC hangs. Now, a waiting screen is shown that informs that a user command is still processed.
    • The usability of the Tool Library panel has been improved. It has been extended by a search filter to enable the search for available tools by arbitrary keywords or texts.
    • The usability of the context menu of tool parameters and tool results has been improved. The menu entries 'Connect from/to' and 'Disconnect from' now display the available tools in alphabetical order instead of an arbitrary order.
    • The format the MERLIC Backend window title has been changed to 'MVTec MERLIC - <MVApp_Filename.mvapp>'.
  • FixedProblems
    • If the error message dialog of the Tool Board has been moved with the mouse, parts of the background of the MERLIC Backend were not displayed correctly. This problem has been fixed. The dialog cannot be moved anymore.
    • If the name of a parameter of the tool 'Evaluate Expression' has been set to an empty string, an error message was shown that this parameter name is already in use. This problem has been fixed. Now, the parameter is set to its default name if the name is set to an empty string.
    • If a text part of the Quick Info was selected and dragged with the mouse while the MERLIC Vision App was running continuously, the execution of the application stopped. This problem has been fixed.
    • If a tool error has been resolved by a structural change, the respective tool error message did not disappear. This problem has been fixed.
    • Sometimes, the region of interest (ROI), that was shown with the easyTouch preview when hovering with the mouse cursor over the image, was still visible after the mouse cursor was moved out of the image boundaries. This problem has been fixed.
    • If the context menu of a parameter or result was used to create a connection to other tools, not all available parameters or results were listed in the context menu. This problem has been fixed. Now, all connectable parameters are shown in the context menu.
    • If a MERLIC Vision App has been loaded and then the first tool of the application has been deleted, the visualization in the Tool Flow panel was not correctly updated. This problem has been fixed.
    • Sometimes, tool parameters were displayed as a floating point number instead of an integer number if the value has been adjusted via the slider. This problem has been fixed.
    • If MERLIC was used in Windows 10, a parameter value list could not be opened with a single mouse click on the respective connector. Instead a double-click was necessary to display the list of available parameter values. This problem has been fixed.
    • If a parameter with numeric values has been adjusted by clicking on the arrows < and > at the respective connector, the value was not adjusted correctly in step increments of 1. This problem has been fixed.
    • If a parameter has been changed by easyTouch and the context menu of this parameter was opened while the new parameter value was still being highlighted in blue, the text of the context menu was also displayed in blue. This problem has been fixed.
    • The names of the MERLIC tools were not consistent in the MERLIC Backend of MERLIC 4.1 Preview. This problem has been fixed.
    • If a tool parameter was set to a negative value or a value > 10, the size of the respective connector was adjusted to a very small width in MERLIC 4.1 Preview. This problem has been fixed.
    • The 'Open Designer' button at the menu bar of the MERLIC Backend sometimes did not show the correct state whether the MERLIC Designer is open or closed. This problem has been fixed. In addition, if the MERLIC Designer is already open in the background and the 'Open Designer' button or menu entry is clicked, the MERLIC Designer window will be shown in the foreground.
    • Removing an incoming connection of a parameter by dragging the arrow handle of the connection away from the connector did not work when the arrow handle was dragged to the left. This problem has been fixed.
    • In MERLIC 4.1 Preview, the paste process after copying a tool was sometimes canceled when the mouse was moved outside of the Tool Flow panel. This problem has been fixed.
    • In rare cases MERLIC crashed when renaming a tool. This problem has been fixed.
    • In MERLIC 4.1 Preview, the tool tip shown for the tool name at the tool board missed the information about the internal tool name. This problem has been fixed.
    • In some cases, if the 'Del' or 'Backspace' key was pressed while an ROI was being drawn in a tool, the ROI was deleted but it was not possible anymore to draw any further ROIs in any tool. This problem has been fixed.
    • In MERLIC 4.1 Preview, trigger connections were sometimes not correctly visualized. This problem has been fixed.
    • If the tool focus was changed in a large MERLIC Vision App in MERLIC 4.1 Preview with more than about 250 tools, it took very long until the user interface reacted to user actions again. This problem has been fixed.
    • Loading MERLIC Vision Apps with complex Frontend GUI designs was very slow. This problem has been fixed. The speed of loading such MVApps has been improved significantly.
    • The training data set of tools with a training mode was sometimes not restored correctly. If an ROI was drawn into the training image and then the application was saved and loaded again in MERLIC, the ROI was loaded as an ROI for the processing image instead of a training ROI. This problem has been fixed.
    • MERLIC crashed if it was used on a system with Intel HD Graphics 3000. This problem has been fixed.
    • In MERLIC 4.1 Preview, regions of interest (ROIs) that have been connected from a previous tool were not visualized in the correct color that has been set for input ROIs in the MERLIC preferences. This problem has been fixed.
    • If an already selected ROI was selected anew in a tool within the MERLIC Backend and then the image was modified, e.g., by zooming or moving the image, the ROI was not adjusted correctly to the modification because its state was still inconsistent. This problem has been fixed.

Designer

  • Improved Usability
    • The usability of opening the MERLIC Frontend has been improved. Previously, different keyboard shortcuts were defined for the MERLIC Backend and the Designer to open the Frontend. Now, the Frontend can be opened from the Backend and the Designer with the same keyboard shortcut F10.
  • Fixed Problems
    • The 'Label' widget could be connected to tool parameters and tool results that represented an ROI. This problem has been fixed.
    • In the MERLIC Designer newly inserted widgets were not reliably placed atop of all widgets of the current layout. This problem has been fixed. Now, newly inserted widgets are always placed atop of all widgets of the current layout.
    • If a group of widgets has been copied and pasted within the MERLIC Designer, the pasted widgets changed their z-order order randomly. This problem has been fixed. Now, when pasting a copied group of widgets, the z-order of the widgets is kept correctly and the group is placed atop of all widgets of the current layout.
    • If the name of a tab view has been edited within the MERLIC Designer and the input field of the name was still visible when clicking on any place outside of the input field, the changes were not adopted. This problem has been fixed.
    • If multiple views were added and reordered within the MERLIC Designer, the defined order of the views was not correctly stored. In addition, the names of the views were not correctly updated in the 'Tab View' widget if a view has been renamed. These problems have been fixed.
    • If the MERLIC Designer window was minimized or inactive, it could not be reactivated and opened in the front by clicking the 'Open Designer' button in the menu bar of the MERLIC Backend. This problem has been fixed.
    • If multiple views were used in the MERLIC Designer and a 'Tab View' widget has been copied or cut and then pasted into another view, MERLIC did not mark recursive view specifications as misconfigured. This problem has been fixed.
    • If multiple views were renamed and then reordered, the changes were not correctly reversed via the undo functionality. This problem has been fixed.
    • The cells of the 'Table' widget could not be connected to tool parameters that are connected to other tools. This problem has been fixed.
    • In the MERLIC Designer the configuration of the widget 'Check Box' was not validated correctly. The widget was not recognized correctly as misconfigured if it was connected to a not editable tool parameter. This problem has been fixed. Now, the misconfiguration is correctly detected, the widget is marked as misconfigured, and the Frontend can no longer be started while the widget is misconfigured.

Frontend

  • New Features
    • With respect to the new process integration mode, MERLIC now ensures that it can be controlled only from the PLC by setting the MERLIC Frontend automatically to read-only mode in case it is executed in the new process integration mode.
  • Improved Usability
    • The usability of the Frontend menu bar has been improved. It is now possible to open the Frontend in full screen mode using the new menu entry 'View -> Full Screen' or the shortcut F11.
  • Fixed Problems
    • If the 'Image Display' widget was used in the MERLIC Frontend and an invalid image was selected while the application was being executed, the 'Image Display' widget started flickering. This problem has been fixed.
    • If the MERLIC Frontend was started via the command line option, it was not checked, whether the file name or directory of the MVApp existed. This problem has been fixed. Now, the completeness of the command line option is checked as well as whether the specified file or directory exists. If it does not exist, an error message is shown and the application is closed.
    • If a MERLIC Vision App has been started via the context menu entry 'Launch in Frontend' or via the command line with the option '--frontend',  the splash screen showed the message 'Starting MERLIC Backend'. This problem has been fixed.
    • The Frontend of an unsaved MERLIC Vision App could not be started via a remote connection. This problem has been fixed.
    • The 'Image Display' widget still displayed the previous image in the MERLIC Frontend in case the image of the current iteration was invalid or empty. This problem has been fixed. Now, the 'Image Display' widget shows no image if the image is invalid or empty.
    • The 'Image Display' widget did not display the regions of interest (ROIs) with the edit mode 'Display only' in the configured color. This problem has been fixed. Now, these non-modifiable ROIs are displayed in the color that is defined for the property 'Inactive color'.
    • If an ROI has been moved in the 'Image Display' widget within the MERLIC Frontend, it was temporarily displayed in its previous position. This problem has been fixed.
    • If the 'easyTouch Button' was activated in the MERLIC Frontend and the image in the 'Image Display' widget has been zoomed using the mouse wheel, sometimes the easyTouch preview was no longer visualized while the mouse cursor was being moved over the image. This problem has been fixed.
    • If the widget 'Check Box' was connected to a string parameter, two clicks instead of one single click were required in the Frontend to uncheck the check box correctly. This problem has been fixed.
    • The widget 'Execution Control' did not display the 'Run Once' state correctly in the MERLIC Frontend if the MERLIC Vision App was executed once. This problem has been fixed. The widget now toggles its state correctly while the MERLIC Vision App is executed.
    • The 'Table' widget did not display the values of tuples correctly in the MERLIC Frontend. This problem has been fixed.
    • In some rare cases MERLIC crashed while opening the MERLIC Designer or MERLIC Frontend. This problem has been fixed.
    • If multiple ROI parameter were editable in the Frontend and one of the not selected ROIs was deleted, sometimes a different ROI parameter was selected afterwards. This problem has been fixed.
    • While deleting ROIs in the MERLIC Frontend using the corresponding button within the ROI toolbar of the 'Image Display' widget, the active ROI was not displayed reliably in the correct color. This problem has been fixed.
    • If the MERLIC Frontend was opened, the visualization of the MERLIC Vision App was sometimes delayed. This problem has been fixed.
    • The user management of the MERLIC Frontend did not work correctly. It was not possible to login although the correct user credentials were given. This problem has been fixed.
    • MERLIC 4.1 Preview crashed when loading an empty MERLIC Vision App with an invalid Frontend definition. This problem has been fixed.
    • If a Frontend design contained the 'Dialog Button' widget with a modeless configuration and the respective dialog window was closed, the Frontend sometimes crashed. This problem has been fixed.
    • In some cases the MERLIC Frontend was not displayed in the selected language. This problem has been fixed.
    • When a MERLIC Frontend lost the connection to the server, already opened dialogs were not closed. This problem has been fixed.

Tools

  • New Features
    • MERLIC has been extended by the following tools of the new tool category '3D Height Image':
      • 'Convert Disparity To Height Image'
        • This tool can be used to convert a disparity image to a calibrated height image.
      • 'Level Surface'
        • This tool can be used to level tilted or curved areas and objects on 3D height images.
      • 'Remove Outlier Pixels'
        • This tool can be used to fill small holes in 3D height images and to determine the region that excludes outlier pixels.
      • 'Scale Gray Range to 8 Bit'
        • This tool can be used in order to scale a 16 bit image to a 8 bit image according to a user defined gray range.
  • Enhancements
    • MERLIC now provides the new GigEVision2 interface (Revision 13.0.3) for the tool 'Acquire Image from Camera'. It supports devices complying with the GigE Vision 2.x standard and replaces the old GigEVision interface.
      In addition, the image acquisition interfaces GenICamGenTL and USB3Vision have been released in a new revision. MERLIC now contains the following versions of the interfaces:
      • GenICamGenTL Revision 13.0.5
      • USB3Vision Revision 13.0.7

    • The tool 'Acquire Image from Camera' now uses a synchronous grab of an image from the specified image acquisition devices to ensure the usage of the most current image.
    • The tool 'Branch on Condition' has been improved. It has been completely revised:
      • The different branches are no longer visualized by separate areas.
      • The execution of the tools in the different branches is now initiated by triggers.
      • The output branch triggers 'Condition' and 'Default' have been added to the tool. They can be connected to all tools that should be executed if the condition is true or false, respectively.
      • The parameter properties must be instantly defined if a new parameter is added via the + button. The properties cannot be changed afterwards anymore.
      Note that this change affects the compatibility. Read more.
    • The tools 'Branch on Condition' and 'Evaluate Expression' have been improved. Previously, the user could choose from a wide range of semantic types for a newly added parameter. Now, the list of semantic types that can be selected for a new parameter has been reduced to the basic semantic types 'any', 'double', 'long', and 'string' in order to increase the clarity. The semantic types of existing MERLIC Vision Apps are automatically assigned to one of the basic semantic types.
    • The tool 'Calibrate Camera' has been improved. It has been extended by the new training results 'Marks Train' and 'Calibration Error Train'. They return the contours of the found calibration marks and the calibration error, respectively.
    • The tool 'Check Presence with Gray Features' has been improved. It has been extended by the new training results 'Feature 1 Train Out' and 'Feature 2 Train Out'. They return the values that have been used for the training parameters 'Feature 1' and 'Feature 2' in the trained model.
    • The following tools with a training mode have been improved:
      • 'Check Presence with Gray Features'
      • 'Check Presence with Matching'
      • 'Read Aztec Code'
      • 'Read Bar Code'
      • 'Read Data Matrix ECC 200'
      • 'Read PDF417'
      • 'Read QR Code'
      In MERLIC 3, the current processing image was automatically added as training image when the tool was inserted. Now, the training image must be added manually. This ensures that only the desired images are selected for the training.
      Furthermore, the modes for the training images of the tool 'Check Presence with Matching' are not defined automatically anymore. They must be defined manually for each training image.
       
    • The tool 'Check Presence with Matching' has been improved. The parameter 'Reference Position' is now an additional parameter. Furthermore, the tool has been extended by the following new training parameters:
      • 'Deformation Tolerance Train'
      • 'Maximum Overlap Train'
      • 'Minimum Score Train'
      • 'Orientation Tolerance Train'
      In addition the tool has been extended by the new training result 'Highest Pyramid Level Train Used'. It returns the value that has been used for the training parameter 'Highest Pyramid Level' in the trained model.
    • Due to the new process integration mode, the tool 'Communicate via Hilscher cifX' that has been provided in MERLIC 4.1 Preview is not required anymore. Therefore it has been removed.
      In addition, the tools 'Communicate via OPC UA', 'Communicate via Digital I/O', and 'Stop Execution' have been removed with respect to future approaches for more efficient solutions.
      Note that this change affects the compatibility. Read more.
    • The training parameters of the following tools have been renamed:
      • Determine Alignment with Matching
      • Determine Alignment with Straight Border
      • Check Presence with Gray Features
      • Check Presence with Matching
      • Count with Matching
      • Locate with Matching
      All names of the training parameters now end with the suffix 'Train' to distinguish them from the processing parameters.
    • The tool 'Determine Alignment with Straight Border' has been improved. The processing parameters 'Edge Contrast', 'Edge Width', and 'Edge Transition' have been moved to the training parameters on right side of the tool board to visualize that they are used for the training.
    • The tool 'Read Bar Code' has been improved. It has been extended by the following training results:
      • 'Code Type Out'
      • 'Maximum Element Width Out'
      • 'Minimum Element Width Out'
      • 'Minimum Absolute Edge Amplitude Out'
      • 'Minimum Relative Edge Amplitude Out'
      • 'Minimum Bar Code Width Out'
      • 'Orientation Out'
      • 'Orientation Tolerance Out'
      The new training results return the value of the respective processing parameters that were used in the trained model.
    • The following tools of the category 'Reading' have been improved:
      • 'Read Atzec Code'
      • 'Read Bar Code'
      • 'Read Data Matrix ECC200'
      • 'Read PDF417'
      • 'Read QR Code'
      The tools have been adjusted to return the values in the result 'Decoded Data' in a specific order. They are now sorted with respect to their 'row' and 'column' values in which they appear in the image.
    • The tools 'Read Data Matrix ECC 200' and 'Read PDF417' have been improved. They have been extended by the following training results:
      • 'Code Property Out'
      • 'Conform to Standard Out'
      • 'Expected Number of Codes Out'
      • 'Maximum Number of Columns Out'
      • 'Minimum Number of Columns Out'
      • 'Maximum Number of Rows Out'
      • 'Minimum Number of Rows Out'
      • 'Minimum Contrast Out'
      • 'Mirrored Code Out'
      • 'Robust Against Small Modules Out'
      Further new training results for the tool 'Read Data Matrix ECC 200' are:
      • 'Contrast Tolerance Out'
      • 'Finder Pattern Tolerance Out'
      • 'Maximum Horizontal Gap Width Out'
      • 'Minimum Horizontal Gap Width Out'
      • 'Maximum Module Size Out'
      • 'Minimum Module Size Out'
      • 'Maximum Slant Out'
      • 'Maximum Vertical Gap Width Out'
      • 'Minimum Vertical Gap Width Out'
      • 'Module Size Tolerance Out'
      Further new training results for the tool 'Read QR Code' are:
      • 'Maximum Module Aspect Ratio Out'
      • 'Minimum Module Aspect Ratio Out'
      • 'Maximum Module Width Out'
      • 'Minimum Module Width Out'
      The new training results return the value of the respective processing parameters that were used in the trained model.
    • The tools 'Read Atzec Code' and 'Read QR Code' have been improved. They have been extended by the following training results:
      • 'Code Property Out'
      • 'Conform to Standard Out'
      • 'Expected Number of Codes Out'
      • 'Maximum Horizontal Gap Width Out'
      • 'Minimum Horizontal Gap Width Out'
      • 'Maximum Vertical Gap Width Out'
      • 'Minimum Vertical Gap Width Out'
      • 'Maximum Module Size Out'
      • 'Minimum Module Size Out'
      • 'Minimum Contrast Out'
      • 'Mirrored Code Out'
      • 'Robust Against Small Modules Out'
      Further new training results for the tool 'Read Atzec Code' are:
      • 'Finder Pattern Tolerance Out'
      • 'Maximum Code Size Out'
      • 'Minimum Code Size Out'
      Further new training results for the tool 'Read QR Code' are:
      • 'Maximum Code Version Out'
      • 'Minimum Code Version Out'
      • 'Minimum Number of Position Patterns Out'
      • 'Quiet Zone Available Out'
      The new training results return the value of the respective processing parameters that were used in the trained model.
    • The tool 'Rotate Image' has been improved. It has been extended by the new parameter 'Keep Image Size' that enables the user to select if the original image size, i.e., the width and height of the image, is adjusted after the rotation.
    • The tools of the category 'Image Transformation' have been improved. In MERLIC 3, the tools displayed the resulting image on top of the input image. This could be confusing in some cases. Now, the tools only display the input image and possible input ROIs. The resulting image is shown in all subsequent tools. This faciliates the use and configuration in the input image.
    • The protection format of the MERLIC tools has been changed to improve security. Note that this change affects the compatibility. Read more.
  • Improved Usability
    • If the selected camera in the tool 'Acquire Image from Camera' could not be connected because the IP address was misconfigured, no error message was shown in MERLIC 4.1 Preview to inform the user about the problem. Now, MERLIC shows an error message for the tool to inform the user about this problem. In addition, an alternative IP address is suggested for the use in MERLIC.
    • The usability of the tool 'Locate Objects with Similar Gray Values' has been improved. Previously, the parameters 'Minimum Area' and 'Maximum Area' were defined as additional parameters. If they were not added, it was not visible by default that their values are adjusted if easyTouch was used to select the objects. Now, the parameters have been changed to basic parameters and are now visible by default.
    • The following tools of the category 'Communication' are now deprecated:
      • Read from Serial Interface
      • Read from Socket
      • Write to Serial Interface
      • Write to Socket
      These tools will no longer be maintained or updated. The functionality of these tools will be available in future MERLIC versions. However, they might be provided at a different location.
      In addition, the following tools of the category 'Communication' have been moved to the new tool category 'File Access':
      • Read from File
      • Read Region from File
      • Write Image to File
      • Write Region to File
      • Write to File

  • Fixed Problems
    • In MERLIC 4.1 Preview, the tool 'Acquire Image from Camera' did not display the names of some camera parameters correctly. If the name of a camera parameter contained square brackets, these were not displayed in the configuration area. This problem has been fixed. 
    • If a camera device was connected in the tool 'Acquire Image from Camera', a new search for available camera devices caused the disconnection of the current camera. This problem has been fixed. Due to this fix, the displayed names of the devices are shortened to the camera user ID or the vendor-defined camera unique ID. Note that this change affects the compatibility. Read more.
    • If the tool 'Acquire Image from Camera' has been used and some camera parameters with dependencies to other camera parameters were modified, MERLIC crashed. This problem has been fixed.
    • In some cases, the tool 'Acquire Image from Camera' did not display the correct values of the camera parameters that are set internally. This problem has been fixed.
    • If the currently selected camera of the tool 'Acquire Image from Camera' has been removed, the name of the camera was still displayed in the list of available cameras. This problem has been fixed.
    • The tools 'Branch on Condition' and 'Evaluate Expression' threw an error if the user tried to paste an image into the expression field via 'Ctrl+V'. This problem has been fixed. 
    • The value of the training parameter 'Matching Method Train' of the tools 'Count with Matching' and 'Locate with Matching' could be edited manually. Therefore, it was possible to define a matching method that is not available for these tools. This problem has been fixed. Now, the value list of the parameter is set to read-only to ensure that only the provided matching methods can be selected.
    • If the MERLIC Backend was set to a language other than English and the tool 'Create Paraxial Rectangle' was loaded, the tool erroneously showed an error. This problem has been fixed.
    • The tool 'Determine Data History' added the value of the connected parameter 'Data Value' to its result buffer 'Buffer Data' if certain parameters were changed. This problem has been fixed. Now, the configuration is updated without adding the data value again.
    • If a parameter of the tool 'Determine Data History' has been adjusted, constant values were not added to the buffer anymore. This problem has been fixed.
    • If the contour selection in the tool 'Evaluate Contours' has been extended via easyTouch+, the last mouse click was always ignored. This problem has been fixed.
    • If a new parameter with the semantic type 'string' had been added to the tool 'Evaluate Expression' and then an integer result of a previous tool was connected to the parameter, the semantic type of the parameters was converted to 'int'. This problem has been fixed. Now, the semantic type of the connected value is not adjusted anymore and the connected value is processed as a string.
    • If a tool was used that defined a parameter range via two separate minimum and maximum parameters, e.g., 'Evaluate Regions', and these parameters were connected with a previous tool, the parameters could contain inconsistent minimum and maximum values. This problem has been fixed.
    • The values of the parameters 'Minimum Feature Value' and 'Maximum Feature Value' of the tools 'Evaluate Regions' and 'Evaluate Contours' could not be set higher than the predefined ranges. This problem has been fixed. Now, the ranges can be set to higher values by editing the parameter field or using a parameter with a higher value from a previous tool.
    • The counter of the tool 'Get Execution Info' was sometimes not incremented correctly. If an incoming connection was deleted from the tool, the counter was incremented by 2 instead of 1. This problem has been fixed.
    • The 'Time Format' parameter of the tool 'Get Execution Info' could be set to a format that is not supported if the parameter was connected to a result of a previous tool, e.g., to the result of the tool 'Evaluate Expression'. This problem has been fixed. Now, a warning is shown if a time format is defined that is not supported.
    • The result 'Y End' of the tool 'Get Segment Properties' was set to the semantic type 'coordinates' instead of 'coordinates.y'. This problem has been fixed.
    • If ROIs were drawn in the following tools, they could not be reliably associated with the correct ROI parameter and thus led to errors when these tools were executed.
      • 'Measure Circle to Point'
      • 'Measure Circle to Segment'
      • 'Measure Point to Point'
      • 'Measure Segment to Point'
      • 'Measure Segment to Segment'
      This problem has been fixed. Now, it is no longer possible to draw input ROIs for these tools. The required ROI parameters must be delivered from previous tools, e.g., from the tools of the category 'ROI Creation'.
    • If easyTouch was used to select a circle in the tool 'Measure Circle', sometimes a circle ROI without a valid result was highlighted by the easyTouch preview. This problem has been fixed.
    • If multiple ROIs have been used in the tool 'Measure Circle' and one of the ROIs was moved, a different ROI was selected as active ROI instead of the ROI that has been moved. This problem has been fixed.
    • If very small circles were selected via easyTouch in the tool 'Measure Circle', the resulting ROI sometimes differed from the selected input ROI and the two ROIs were not displayed correctly on top of each other. This problem has been fixed. The correlation of the resulting ROI to the input ROI is now more suitable.
    • The tool 'Measure Opposite Edges' sometimes returned an exception without information about the error cause if only one edge was detected instead of an opposite edge pair. This problem has been fixed. Now, an adequate error message is shown in this case.
    • Sometimes the tool 'Read Data Matrix ECC 200' returned an error if the parameter 'Minimum Number of Columns' or 'Minimum Number of Rows' had been changed. This problem has been fixed.
    • If easyTouch was used in the tool 'Read Text and Numbers', the easyTouch preview did not highlight the result that was returned when the preview was confirmed with a mouse click. This problem has been fixed.
    • If easyTouch has been used in the tool 'Read Text and Numbers', the easyTouch preview sometimes suggested two overlapping regions. This problem has been fixed.
    • The tools 'Write to File' and 'Read from File' could be connected via the 'File Handle' parameter which resulted in an error. This problem has been fixed.
    • The tool 'Write to Socket' closed and re-opened an existing connection if no data was present to be sent. This problem has been fixed.
    • The training tools that require only one training data set have been improved. In MERLIC 3, it was possible to remove the training image which sometimes led to unexpected behavior. Now, the training image can only be replaced with a new one but it cannot be deleted anymore. This ensures that a training data set is always available.
    • If a tool of the category 'ROI Creation' has been inserted or loaded, the modifications at the respective 'ROI' parameter were not applied at the first attempt. This problem has been fixed.
    • In MERLIC 4.1 Preview, tools sometimes stayed inactive, e.g., the image was not updated and easyTouch did not work, after the tool has been selected as focus tool. This problem has been fixed.
    • In MERLIC 4.1 Preview, activating the configuration mode took a long time for some cameras. This problem has been fixed.

Examples

  • New Features
    • MERLIC has been extended by the following MERLIC Vision App examples and example recipe files that show example applications for the new process integration mode: 
      • read_barcode.mvapp
      • verify_chip_number.mvapp
      • read_barcode_recipe1.mrcp
      • read_barcode_recipe2.mrcp
      • read_barcode_recipe3.mrcp
      • read_barcode_recipe4.mrcp
      • verify_chip_number_recipe.mrcp
      They are stored in the directory '%MERLIC4EXAMPLES% ecipes\'.
    • MERLIC has been extended by the new MERLIC Vision App example 'read_text_in_3d_height_images.mvapp'. It shows how to use the new tools 'Remove Outlier Pixels' and 'Scale Gray Range to 8 Bit' of the category '3D Height Images' to read text in images with height information.
    • MERLIC has been extended by the new MERLIC Vision App example 'check_correct_filling_on_3d_height_image.mvapp'. It shows how to use the new tools of the category '3D Height Images' to check if the filling level in a cookie box.
  • Enhancements
    • The following example MERLIC Vision Apps have been revised. They have been adapted to the new Tool Flow panel, i.e., if applicable, the tools have been rearranged for parallel processing. In addition, the parameter settings of some tools have been optimized.
      • adapt_brightness_for_measuring.mvapp
      • check_bent_leads.mvapp
      • check_pen_parts.mvapp
      • check_presence_of_fuses.mvapp
      • check_saw_angles.mvapp
      • check_single_switches.mvapp
      • detect_scratches_on_metal.mvapp
      • determine_circle_quality.mvapp
      • measure_distance_between_corners.mvapp
      • measure_distance_segment_circle_calibrated.mvapp
      • measure_distance_to_center_led.mvapp
  • Improved Usability
    • The example MERLIC Vision App 'check_bottles_parallel.mvapp' that was provided in MERLIC 4.1 Preview is not available anymore because only parts of the demonstrated functionality is applicable with the new process integration mode.
  • Fixed Problems
    • The widget 'Execution State' in the example MERLIC Vision App 'determine_circle_quality.mvapp' always showed the state 'Bad' because some parameters needed to be adjusted. This problem has been fixed. The value of the parameter 'MinimumScore' of the tool 'Evaluate Expression' has been adjusted to a value with two decimal points. In addition the value range of the parameter has been adjusted to 0-1.
    • The Frontend design of the example MERLIC Vision App 'read_lot_number_and_ECC200.mvapp' was missing. This problem has been fixed.
    • The following examples were not up-to-date:
      • calibrate_for_ruler_changes_distance.mvapp
      • calibrate_for_ruler_distorted.mvapp
      • calibrate_for_ruler_simple.mvapp
      • check_bent_leads.mvapp
      • check_presence_of_fuses.mvapp
      • check_saw_angles.mvapp
      • check_single_switches.mvapp
      • count_defect_clusters.mvapp
      • determine_circle_quality.mvapp
      • measure_distance_between_corners.mvapp
      The examples still contained an outdated version of the 'Image Display' widget. Therefore, the widget was displayed with the previous name of the widget, i.e., 'CameraView', instead of the current name. This problem has been fixed.

Documentation

  • New Features
    • The layout of the MERLIC manuals has been completely revised. The following improvements have been implemented:
      • The toolbar with various buttons for the navigation, language and print settings has been moved to the top right of the topics and is now placed on the same level as the breadcrumbs path.
      • The navigation between and within the topics has been improved:
        • A new navigation area on the bottom has been added. It provides navigation buttons to the previous topic, the next topic, and also a button that leads to the top of the topic. This navigation area is always visible and therefore easily available at each position in the topic. Note that this functionality is not provided for the Internet Explorer.
        • A new header has been added to the MERLIC manuals. Clicking on the MERLIC logo in the header leads to the start page of the respective manual.
      • The structure of the glossary has been improved:
        • It is now visualized as a regular topic and can be accessed via the side navigation. Therefore it is not required anymore to click on each glossary term to display the respective description. Now, all glossary entries and descriptions are visible at once if the glossary topic is opened.
      • The MERLIC manuals now offer a responsive design. They are now displayed depending on the width of the used device display. For display width < 800px the tablet mode is activated and for display width < 400px the mobile mode is activated.
      • In addition some further minor improvements have been made for a consistent layout throughout the documentation, e.g., exchanging the icons for the drop down menus with the same icons as in the side navigation menu.
  • Enhancements
    • The documentation of the tool 'Measure Segment to Segment' has been improved. Now, it describes the logic behind the selection of the angle.
    • The MERLIC documentation has been improved. The MERLIC manuals have been extended by a new button that enables the user to change the language of the documentation directly within the manual.
    • The documentation of the following tools with a training mode has been improved:
      • 'Calibrate Camera'
      • 'Determine Alignment with Matching'
      • 'Determine Alignment with Straight Border'
      • 'Check Presence with Matching'
      • 'Check Presence with Gray Features'
      • 'Count with Matching'
      • 'Locate with Matching'
      The descriptions of how to define the training settings and search settings have been revised in the tool reference and are now structured more clearly.
    • The print settings of the MERLIC Manual have been improved. In MERLIC 3, tables were only printed with an outer border but no cell borders. Now, tables are also printed with cell borders for a better readability.
    • The documentation of the MERLIC tools has been improved. The reference of a tool now contains a new section 'Application Example' that lists all provided example applications in which the tool is used. 
    • The documentation of the tool 'Correct Shading' has been improved. Now, the effect of the shading correction on the processing image directly after adding the tool is described more clearly.
    • The tool reference of the tool 'Check Presence with Matching' has been improved. The description missed some information for the use of the parameter 'Reference Positions' and the definition of the reference positions for the object model. Now, the tool reference has been adjusted and extended by the information which type of ROI is expected and how the definition of the reference positions in a training image differs from the use of the parameter 'Reference Positions'.
  • Fixed Problems
    • The documentation of the tool 'Measure Segment to Point' was not clear enough. The description of the result 'Orientation of Distance Segment' did not clearly state that it is returned as a positive real value for counterclockwise angles and a negative value for clockwise angles.
      In addition, the description of the results 'Perpendicular Distance', 'Minimum Segment Distance', and 'Maximum Segment Distance' missed the information that they are returned in world units in case calibration data is used in the tool. These problems have been fixed.
    • Some translations in the tool reference of the tool 'Evaluate Expression' were not correct. The names of various operations, e.g., boolean operators, were translated although they need to be used with their original proper name. This problem has been fixed.
    • The search functionality in the MERLIC manuals did not offer the possibility to search for words with special characters. This problem has been fixed. Now, it is possible to search for words with special characters. In addition it is now possible to use quotes to encompass a search phrase of multiple words, for example the search phrase "data code".

Licensing

  • Enhancements
    • The MERLIC webdepot website for the activation of a MERLIC license has been moved to a new address. The license activation is now available on the 'MVTec License WebDepot' site http://license.mvtec.com/merlic.
  • Fixed Problems
    • If the MERLIC Trial version has been used, the continuous execution of a MERLIC Vision App was sometimes stopped too early. This problem has been fixed. Now, the application is executed up to the maximum time limit of 2 minutes as allowed for MERLIC Trial versions.
    • If the MERLIC Trial version has been used and a second instance of MERLIC was opened, a wrong error message appeared that stated that the trial license has expired. This problem has been fixed. Now, the error message correctly states that only one instance of MERLIC can be used in the MERLIC Trial version.

Miscellaneous

  • The password protection of MERLIC Vision Apps has been improved. The protection is now more secure. Note that this change affects the compatibility. Read more.
  • The configuration of the MERLIC server has been improved. Previously, the configuration of the server needed to be defined in a separate XML configuration file. Now, the configuration settings for the server can also be defined in the MERLIC.ini file.
  • The system requirements of MERLIC have been changed. The operating system Windows 8 is not supported anymore. To use MERLIC 4.2, the operating system Windows 7 or Windows 10 is required.
  • The system requirements for MERLIC have been changed. MERLIC for 32 bit PC systems is discontinued and will no longer be available since version 4.2.0.

Restored Features since MERLIC 4.1 Preview

Languages

The localization of the MERLIC Backend, the MERLIC Designer, and the MERLIC manual has been restored since MERLIC 4.1 Preview. Now, the translations of the user interface of all MERLIC components are reactivated and up-to-date. The documentation has also been updated in all MERLIC languages.

Logging

The logging functionality has been restored since MERLIC 4.1 Preview. The respective settings have been reactivated in the preferences dialog and in the MERLIC.ini file. Now, the logging of error messages and other types of messages into log files is provided again. The logging mechanism has also been extended by a new configuration parameter that enables you to restrict the maximal size of a single log file. In addition, MERLIC logs the messages asynchronously, i.e., while MERLIC is running, the log file might not yet contain the information about all occurred events.

Changes as Compared to MERLIC 3

MERLIC is developed in a customer-centric and agile manner. MVTec has focused on the strengths of the software and prioritized value-adding features for the customer. Thus, some features were strongly improved or newly added. By this, the creation of machine vision applications becomes even simpler, more efficient, and more user-friendly. The range of functions has also been streamlined with regards to obsolete technologies and thereby optimized for users developing real world solutions.

In the following, the changes compared to MERLIC 3 are described:

  • MERLICTool Development
    • The interface for custom tools has been changed: Customers who want to create a new custom tool or make an existing tool available in MERLIC4.2 should contact the usual support channels to have the respective HALCON procedure converted into a MERLIC tool. Training and easyTouch are not supported anymore with custom tools. The tool template examples and the Tool Development Manual have been removed in this version. In addition, the command line options -t, -p, and -tool_filter that could be used to define the directories for tools and procedures to be loaded, are not supported in this version.
  • Training Functionality in theMERLIC Frontend
    • The training functionality in the MERLIC Frontend is no longer supported in this MERLIC version. Therefore, the Designer widget 'Training' is not provided in this version and it is not possible to modify the training data set of a tool within the Frontend. In addition, the example MERLIC Vision App 'measure_angle_with_training_mode.mvapp', that demonstrated the training functionality in the MERLIC Frontend, has been removed.
  • Removed Tools of the Categories 'Communication' and 'System'
    • The tools 'Communicate Via OPC UA', 'Communicate via Digital I/O', and 'Stop Execution' are no longer available in this MERLIC version.
  • Undo and Redo Functionality in theMERLIC Backend
    • The undo and redo functionality of the MERLIC Backend is not available in this MERLIC version. However, it is still possible to undo and redo changes within the MERLIC Designer.
  • Automatic Tool Connection
    • In MERLIC 3, the tool connections between parameters and results have been automatically established after inserting a tool. In this MERLIC version, the automatic connection is only supported for image parameters to avoid unwanted tool connections. All other types of parameters and results need to be connected manually after inserting the tool.
  • Configuration of Camera Parameters
    • In this MERLIC version, the configuration of camera parameters in the tool 'Acquire Image from Camera' does not offer the same functionality as in MERLIC 3. The different modes for beginners, advanced users, and experienced users are not available anymore and the live mode can now be simulated via the execution of the MERLIC Vision App instead of an explicit 'Live Mode' button. In addition, it is not supported to add camera parameters to the tool parameters at the tool board.
  • MERLIC Engine
    • The functionality of the MERLIC Engine is no longer included in this version. Thus, it is not possible to use a MERLIC Vision App in your own C++ or .Net application or to integrate an MVApp as ActiveX Control in your application. The MERLIC Engine example applications and the MERLIC Engine Manual have been removed in this version.
  • easyTouch and easyTouch+
    • The tools 'Read Aztec Code', 'Read Bar Code', 'Read Data Matrix ECC 200', 'Read PDF417', and 'Read QR Code' do not visualize the decoded data in the easyTouch preview anymore because the required interface procedure is not supported in this version.
    • In this MERLIC version, easyTouch+ no longer displays an info box if another selection is added that does not fit to the parameter settings of the previous easyTouch or easyTouch+ selection.
  • Restricted Color Settings
    • In MERLIC 3, the colors in which various graphical elements are visualized within a tool could be defined in the preferences dialog of the MERLIC Backend. In this MERLIC version, the color settings are restricted to a reduced set of graphical elements. Due to the color restrictions in the MERLIC Backend, the regions in the tools of the category 'Filter' are now visualized with a margin instead of a filled color to ensure that they can still be recognized in the image.
  • Simultaneous Use ofMERLIC Backend, Designer, andFrontend
    • In MERLIC 3, it was possible to edit the MERLIC Vision App simultaneously in all three MERLIC components, i.e., MERLIC Backend, MERLIC Designer, and MERLIC Frontend. In this MERLIC version, the Backend and Designer windows are locked for editing if the Frontend is opened. Therefore, you have to close the Frontend in order to make adjustments in the Backend or the Designer.
  • Error Logging
    • In this MERLIC version, the output console for the display of error messages, warnings and other types of messages is no longer available. Tool messages are still shown in the bubble help window of the tools. However, only the message of the last MVApp execution is displayed.

 


Release Notes for MERLIC4.1 Preview

This document provides the release notes for MVTecMERLIC4.1 Preview, as released in June 2018. MERLIC4.1 Preview provides new and restored functionality as well as fixed bugs.

Feature Preview

MERLIC4.1 Preview is a preview version that gives an outlook on current improvements and novelties in MVTecMERLIC. It is a fully tested and stable version that allows you an early access to upcoming features. However, it contains only a subset of features from MERLIC 3. Please see the section Reduced Functionality for a detailed list of features not included in this preview version.

Expiration

This version is available for a limited time period until December 31, 2018. All versions of MERLIC4.1 Preview expire on that date.

Support

Since this version is a preview, we reserve the right not to provide support for it.

Usage

We recommend using this version only for test purposes and not in final applications deployed in manufacturing. For the latter, please use the latest retail version MERLIC 3.

Major New Feature

Prototype Tool for the Communication via Hilscher PCI Cards

MERLIC now provides a prototype tool for the communication via Hilscher PCI cards. This tool gives a sneak preview of the current development towards the seamless integration of a programmable logic controller (PLC) into vision systems using MERLIC. It supports reading and sending data via a Hilscher PCI card.

Restored Feature

Frontend Localization

In this version, the translations of the Frontend user interface to different languages have been restored. This also includes the language settings for the Frontend, which enable a customized translation of the Frontend user interface.

Compatibility

Since the last MERLIC 3 version we have been working hard to improve MERLIC in every way. This has, however, resulted in a few of incompatibilities. We apologize for the inconvenience.

Use of MERLIC Vision Apps created in MERLIC 3

The format of the MERLIC Vision App files has changed since MERLIC 3. MERLIC Vision Apps that have been created in MERLIC 3, e.g., MERLIC 3.0.2, must be converted to the new format if they are loaded in MERLIC4.1 Preview. This may lead to functional changes. Therefore, a backup file of the MERLIC Vision App should be created when loading the application.

If no backup file was created for the MERLIC Vision App, we recommend to save the converted application with a new name because the first save action in the MERLIC4.1 Preview stores the application according to the new internal structure and makes it incompatible to previous MERLIC versions.

Therefore, the backup file ensures that you can still use your original application in the previous MERLIC version.

  • Miscellaneous
    • Tools provided in MERLIC 4.1 Preview cannot be loaded in previous MERLIC versions because the protection format of the MERLIC tools has been improved. More information.

Backend

  • Enhancements
    • The visualization of trigger connections in the Tool Flow panel has been improved. Previously, trigger connections often crossed other connections which could be confusing to the user. Now, the number of crossings is reduced to improve the clarity of the Tool Flow.
  • Improved Usability
    • The usability of the Tool Library panel has been improved. It has been extended by a search filter to enable the search for available tools by arbitrary keywords or texts.
  • FixedProblems
    • The 'Open Designer' button at the menu bar of the MERLIC Backend sometimes did not show the correct state whether the MERLIC Designer is open or closed. This problem has been fixed. In addition, if the MERLIC Desiger is already open in the background and the 'Open Designer' button or menu entry is clicked, the MERLIC Designer window will be shown in the foreground.
    • While copying and pasting multiple tools in the Tool Flow panel, the respective symbol that shows the number of copied tools was not displayed at the correct position. This problem has been fixed.
    • If a paraxial rectangle ROI had been drawn in a MERLIC Vision App of MERLIC 3, the ROI was not correctly loaded if the application was opened in MERLIC 4.0 Preview. This problem has been fixed. 
    • The tool tip shown for the tool name at the tool board missed the information about the internal tool name. This problem has been fixed.
    • While copying and pasting multiple tools in the Tool Flow panel, the automatic scrolling for the Tool Flow view during the selection of the final insert position was broken. This problem has been fixed.

Designer

  • Improved Usability
    • The usability of opening the MERLIC Frontend has been improved. Previously, different keyboard shortcuts were defined for the MERLIC Backend and the Designer to open the Frontend. Now, the Frontend can be opened from the Backend and the Designer with the same keyboard shortcut F10.

Frontend

  • Fixed Problems
    • If multiple ROI parameter were editable in the Frontend and one of the not selected ROIs was deleted, sometimes a different ROI parameter was selected afterwards. This problem has been fixed.
    • While deleting ROIs in the MERLIC Frontend using the corresponding button within the ROI toolbar of the 'Image Display' widget, the active ROI was not displayed reliably in the correct color. This problem has been fixed.
    • The user management of the MERLIC Frontend did not work correctly. It was not possible to login although the correct user credentials were given. This problem has been fixed.

Tools

  • Enhancements
    • The image acquisition interfaces have been released in a new revision. MERLIC now contains the following versions of the interfaces:
      • GenICamGenTL Revision 13.0.4
      • GigEVision2 Revision 13.0.2
      • USB3Vision Revision 13.0.5
  • Fixed Problems
    • The counter of the tool 'Get Execution Info' was sometimes not incremented correctly. If an incoming connection was deleted from the tool, the counter was incremented by 2 instead of 1. This problem has been fixed.
    • The result 'Y_End' of the tool 'Get Segment Properties' was set to the semantic type 'coordinates' instead of 'coordinates.y'. This problem has been fixed.
    • The tool 'Write to Socket' closed and re-opened an existing connection if no data was present to be sent. This problem has been fixed.
    • If a tool of the category 'ROI Creation' has been inserted or loaded, the modifications at the respective 'ROI' parameter were not applied at the first attempt. This problem has been fixed.

Documentation

  • Fixed Problems
    • The description of possible use cases for the parallel processing with MERLIC was not clear enough. This problem has been fixed.
    • The documentation about the naming conventions of tool names, parameter names, and result names missed the information that hyphens are not allowed characters. This problem has been fixed.

Miscellaneous

  • The protection format of the MERLIC tools has been changed to improve security. Note that this change affects the compatibility. Read more.

Reduced Functionality

MERLIC4.1 Preview offers new and restored features including the localization of the Frontend. However, there are also some functionalities of the previous MERLIC 3 version that are not yet available in this MERLIC version but they will be provided for upcoming MERLIC releases.

  • Languages
    • MERLIC 3 was available in multiple languages. However, in MERLIC4.1 Preview only the Frontend offers updated translations in all languages. In case of the Backend and the Designer only the English version of the user interface is up-to-date. Furthermore, only the English version of the MERLIC manual contains the updated documentation of MERLIC. If MERLIC is set to a language different than English, only some parts of the Backend and Designer user interface are translated, i.e., the parts that were already translated in the previous version. In addition the documentation including the Quick Info of the tools contains no updates in other languages. Therefore, we recommend to set the language of the MERLIC Backend to English and to use only the English version of the MERLIC manual to ensure that all information is up-to-date.
  • MERLIC Backend
    • In this MERLIC version, the undo functionality is not available in the MERLIC Backend. It is not possible to undo any changes in the Backend.
    • Previously, it was possible to define the colors in which various graphical elements are visualized within a tool. In this MERLIC version, only a small set of colors is supported. Therefore, the 'Colors' tab of the preferences dialog has been reduced to the colors that are currently available.
  • MERLIC Designer
    • This MERLIC version does not support the training functionality in the Frontend. Therefore, the 'Training' widget is not available in this version.
  • MERLIC Frontend
    • This MERLIC version does not support the training functionality in the Frontend. Therefore, it is not possible to modify the training data set of a tool within the Frontend. The respective Designer widget 'Training' is also not provided in this version.
    • In MERLIC 3, it was possible to edit the MERLIC Vision App simultaneously in all three MERLIC components, i.e., MERLIC Backend, MERLIC Designer, and MERLIC Frontend. In this MERLIC version, the Backend and Designer windows are locked for editing if the Frontend is opened. Therefore, you have to close the Frontend in order to make adjustments in the Backend or the Designer.
  • Tools
    • The configuration of the tool 'Acquire Image from Camera' does not offer the full functionality as in MERLIC 3, e.g., the live mode. Please see the reference documentation for more detailed information about the configuration options in the tool.
    • The tools 'Communicate Via OPC UA' and 'Stop Execution' are not available in this version.
    • Due to the color restrictions in the MERLIC Backend, the regions in the tools of the category 'Filter' are now visualized with a margin instead of a filled color to ensure that they can still be recognized in the image.
    • If a tool is added, only the automatic connection for image parameters is supported in this MERLIC version. All other types of parameters and results are not automatically connected anymore but need to be connected manually after inserting the tool.
    • Previously, space characters were used to separate the text in the names of tool parameters and tool results. In this version, the names are separated with underscores because parts of the translation functionality is not supported yet.
    • The tools 'Read Aztec Code', 'Read Bar Code', 'Read Data Matrix ECC 200', 'Read PDF417', and 'Read QR Code' do not visualize the decoded data in the easyTouch preview anymore because the required interface procedure is not supported in this version.
    • If easyTouch+ was used to add another selection that did not fit to the parameter settings of the previous selection, an info box was displayed at the tool as feedback that this selection might not be possible or affects the parameter settings. This functionality is not supported in this MERLIC version.
  • MERLICExamples
    • The example MERLIC Vision App 'measure_angle_with_training_mode.mvapp' is not available in this version because it uses the 'Training' widget to allow modifications at the training data set. Since this MERLIC version does not support the training within the Frontend, the application is not provided.
  • MERLICTool Development
    • The use of custom tools is not supported in this version. The respective settings for the tool paths and procedure paths have been removed from the preferences dialog of the MERLIC Backend. The tool template examples have been removed in this version. The Tool Development manual of the previous version is still available. However, it does not contain any updates.
  • MERLIC Engine
    • The functionality of the MERLIC Engine is not available in this version. Thus, it is not possible to use a MERLIC Vision App in your own C++ or .Net application or to integrate an MVApp as ActiveX Control in your application. The MERLIC Engine example applications have been removed in this version.
  • Error Logging
    • In MERLIC 3, errors were shown in the output console, the tool state, and the bubble help window of the tool. However, in this version the output console is not available. Therefore, errors are only displayed in the bubble help window of the tool and in the tool state. In addition, errors are not aggregated. Only the errors from the last tool execution are displayed.
    • Because errors are not aggregated in this version, it is not possible to create a log file with the errors. The respective setting has been removed from the preferences dialog of the MERLIC Backend.
  • Miscellaneous
    • When MERLIC is started via the command line, several command line options are provided. In MERLIC 3 it was possible to use the command line options -t, -p, and -tool_filter to define the directories for MERLIC tools, MERLIC procedures, and to define the tools that should be loaded. Since the use of custom tools is not supported in this version, these command line options are also not supported anymore.

 


Release Notes for MERLIC4 Preview

This document provides the release notes for MVTecMERLIC4 Preview, as released in March 2018. MERLIC4 Preview provides new and improved functionality as well as fixed bugs.

Feature Preview

MERLIC4 Preview is a preview version that gives an outlook on current improvements and novelties in MVTecMERLIC. It is a fully tested and stable version that allows you an early access to upcoming features. However, it contains only a subset of features from previous MERLIC versions. Please see the section Reduced Functionality for a detailed list of features not included in this preview version.

Expiration

This version is available for a limited time period until December 1, 2018. All versions of MERLIC4 Preview expire on that date.

Support

Since this version is a preview, we reserve the right not to provide support for it.

Usage

We recommend using this version only for test purposes and not in final applications deployed in manufacturing. For the latter, please use the latest official release MERLIC 3.

Major New Features

Parallel Processing

MERLIC allows the parallel processing of tools to perform multiple tasks at the same time. This allows the user to perform multiple image processing tasks in parallel, e.g., independent inspection with multiple cameras. To enable the user to control the execution order and the synchronization of the tools during the parallel processing, MERLIC now supports the use of trigger connections between tools.

Tool Flow Panel

The Tool Flow panel has been completely revised, providing a better overview over the used tools. It has been extended to support the visualization of parallel tool flows and the visualization of the tool connections has also been improved. These are now displayed in different colors depending on the respective state. Lastly, the Tool Flow panel now also allows users to copy/paste and move tools within the window.

Branch on Condition

The tool Branch on Condition has been redesigned. The configuration of the connections for the different branches is now easier and more clear.

Compatibility

Since the last product version we have been working hard to improve MERLIC in every way. This has, however, resulted in a few of incompatibilities. We apologize for the inconvenience.

Use of previous MERLIC Vision Apps

The format of the MERLIC Vision App files has changed since the last version of MERLIC. MERLIC Vision Apps that have been created in a previous MERLIC version, e.g., MERLIC 3.0.2, must be converted to the new format if they are loaded in MERLIC4 Preview. This may lead to functional changes. Therefore, a backup file of the MERLIC Vision App should be created when loading the application.

If no backup file was created for the MERLIC Vision App, we recommend to save the converted application with a new name because the first save action in the MERLIC4 Preview stores the application according to the new internal structure and makes it incompatible to previous MERLIC versions.

Therefore, the backup file ensures that you can still use your original application in the previous MERLIC version.

  • Tools
    • The tool 'Branch on Condition' is no longer compatible since it has been completely revised. MERLIC Vision Apps that contain this tool must be converted to the current version. Note that the conversion may lead to functional changes. To ensure a consistent state, it is recommended to check the configuration of the tool again after the conversion. The chapter 'MERLIC Backend > Parallel Processing > Error Causes' of the MERLIC manual gives more detailed information about possible error causes. More information.
  • Miscellaneous
    • Protected MERLIC Vision App of previous MERLIC versions cannot be loaded in this MERIC version because the password protection has been improved. You first have to load the application in the previous MERLIC version and remove the password protection. Then you may load the application in MERLIC 4 Preview and define a new password. More information.

Backend

  • New Features
    • The Tool Flow panel has been extended to support the visualization of parallel tool flows. It is now possible to arrange the tools of a MERLIC Vision App side-by-side to indicate the parallel processing of the tools.
    • The Tool Flow panel has been extended by the following modification features:
      • Copy and paste
        • It is now possible to copy any number of selected tools including their currently set parameter values. They can be pasted at an arbitrary position in the Tool Flow panel. For this, the Tool Flow panel has been extended by a new context menu which enables the user to copy and paste the selected tools. Alternatively, the shortcuts 'Ctrl+C' and 'Ctrl+V' can be used for copy and paste.
      • Delete
        • It is now possible to delete a tool directly in the Tool Flow panel via the new context menu of the tool or via the shortcut 'Del'.
      • Move
        • It is now possible to move any number of selected tools within the Tool Flow panel via drag and drop. This enables the user to easily arrange the tools of the MERLIC Vision App according to the requirements.
      • Selection of multiple tools
        • It is now possible to select multiple tools within the Tool Flow panel. This enables the user to apply a specific modification to multiple tools at once, e.g., moving a group of tools. The selection can be defined via a lasso selection or by pressing the 'Ctrl' or 'Shift' key while clicking on the desired tools.
    • The Tool Flow panel has been extended to visualize the connections of all tools. For a better distinction they are visualized in different colors depending on their state:
      • Connections in an erroneous state are highlighted in red.
      • Connections of currently selected tools are highlighted in blue.
      • Connections of currently not selected tools are visualized in dark gray.
    • MERLIC now supports the use of trigger connections. This enables the user to control various aspects in the execution of a MERLIC Vision App:
      • Execution of a specific tool at a specific time
      • Execution order of the tools in parallel processing
      • Synchronization of tools during parallel processing
      For this, the MERLIC tools have been extended by trigger connectors on the right of the Tool Board. They can be used to create a trigger connection between tools. Use the + button on the top right of the tool to define one or more incoming triggers connections. The new output trigger connector 'Default_Trigger' is displayed by default at the bottom right of the tool and can be used to define trigger connections to subsequent tools.
  • Enhancements
    • The Tool Workspace of the MERLIC Backend has been improved in multiple ways.
      • Previously, the workspace displayed the currently selected tool as well as part of the previous and subsequent tool. Now, only the currently selected tool is displayed in the Tool Workspace. The additional area is now used to visualize more information about the connected tools.
      • Previously, only the name of the connected tools were displayed at the connections within the Tool Workspace. Now, the connections also display the name of the respective parameter or result that is connected.
      • Previously, the Tool Workspace offered + buttons on the top right and bottom right of a tool for adding new tools directly from the Tool Workspace. Since the tools can now be processed in parallel and can therefore be arranged side-by-side, these + buttons have been removed. This ensures that the focus in the Tool Workspace is solely on the modification of the currently selected tool. All types of modifications regarding the arrangement of current and new tools can be done in the Tool Flow panel.
    • The naming conventions for tool names, parameter names, and result names have been improved. Previously, the naming conventions for the tools 'Branch on Condition' and 'Evaluate Expression' differed from the naming conventions for other tools. Now, they are consistent for all tools.
      • The following punctuation marks are still allowed:
        • Underscores, e.g., 'Name_2'
        • Hyphens, e.g., 'Name-2'
        • Points, e.g., 'Name.2'
        • Spaces, e.g., 'Tool Name', but only for tool names. For parameter or result names spaces are not allowed.
      • The names of tool parameters and results may not begin with the following characters:
        • Double underscores, e.g., '__Name'
        • Digit, e.g., '1_Name'
        • Point, e.g., '.Name'
      • The following punctuation marks are not allowed anymore:
        • []!"#$%&'()*+,/\:;<=>?@^`{|}~
          
  • Improved Usability
    • The usability of the Tool Library has been improved. Previously, the subcategories and tools were not always sorted in an explicit order. Now, the subcategories and tools are sorted alphabetically.
    • The usability of the MERLIC Backend has been improved. Previously, no visual feedback was displayed in case a user operation took some time, e.g. loading a MERLIC Vision App, which led to the impression that MERLIC hangs. Now, a waiting screen is shown that informs that a user command is still processed.
    • The usability of the context menu of tool parameters and tool results has been improved. The menu entries 'Connect from/to' and 'Disconnect from' now display the available tools in alphabetical order instead of an arbitrary order.
  • FixedProblems
    • If the error message dialog of the Tool Board has been moved with the mouse, parts of the background of the MERLIC Backend were not displayed correctly. This problem has been fixed. The dialog cannot be moved anymore.
    • If the name of a parameter of the tool 'Evaluate Expression' has been set to an empty string, an error message was shown that this parameter name is already in use. This problem has been fixed. Now, the parameter is set to its default name if the name is set to an empty string.
    • If a text part of the Quick Info was selected and dragged with the mouse while the MERLIC Vision App was running continuously, the execution of the application stopped. This problem has been fixed.
    • If a tool error has been resolved by a structural change, the respective tool error message did not disappear. This problem has been fixed.
    • MERLIC crashed, if it was used on a system with Intel HD Graphics 3000. This problem has been fixed.
    • If the context menu of a parameter or result was used to create a connection to other tools, not all available parameters or results were listed in the context menu. This problem has been fixed. Now, all connectable parameters are shown in the context menu.
    • If a MERLIC Vision App has been loaded and then the first tool of the application has been deleted, the visualization in the Tool Flow panel was not correctly updated. This problem has been fixed.
    • Sometimes, tool parameters were displayed as a floating point number instead of an integer number if the value has been adjusted via the slider. This problem has been fixed.
    • If MERLIC was used in Windows 10, a parameter value list could not be opened with a single mouse click on the respective connector. Instead a double-click was necessary to display the list of available parameter values. This problem has been fixed.
    • If a parameter with numeric values has been adjusted by clicking on the arrows < and > at the respective connector, the value was not adjusted correctly in step increments of 1. This problem has been fixed.
    • If a parameter has been changed by easyTouch and the context menu of this parameter was opened while the new parameter value was still being highlighted in blue, the text of the context menu was also displayed in blue. This problem has been fixed.

Designer

  • Fixed Problems
    • The 'Label' widget could be connected to tool parameters and tool results that represented an ROI. This problem has been fixed.
    • In MERLIC Designer newly inserted widgets were not reliably placed atop of all widgets of the current layout. This problem has been fixed. Now, newly inserted widgets are always placed atop of all widgets of the current layout.
    • If a group of widgets has been copied and pasted within the MERLIC Designer, the pasted widgets changed their z-order order randomly. This problem has been fixed. Now, when pasting a copied group of widgets, the z-order of the widgets is kept correctly and the group is placed atop of all widgets of the current layout.
    • If the name of a tab view has been edited within the MERLIC Designer and the input field of the name was still visible when clicking on any place outside of the input field, the changes were not adopted. This problem has been fixed.
    • If multiple views were added and reordered within the MERLIC Designer, the defined order of the views was not correctly stored. In addition, the names of the views were not correctly updated in the 'Tab View' widget if a view has been renamed. These problems have been fixed.
    • If multiple views were used in the MERLIC Designer and a 'Tab View' widget has been copied or cut and then pasted into another view, MERLIC did not mark invalid, i.e., recursive, specifications. This problem has been fixed.
    • If multiple views were renamed and then reordered, the changes were not correctly reversed via the undo functionality. This problem has been fixed.

Frontend

  • Improved Usability
    • The usability of the Frontend menu bar has been improved. It is now possible to open the Frontend in full screen mode using the new menu entry 'View -> Full Screen' or the shortcut F11.
  • Fixed Problems
    • If the 'Image Display' widget was used in the MERLIC Frontend and an invalid image was selected while the application was being executed, the 'Image Display' widget started flickering. This problem has been fixed.
    • If the MERLIC Frontend was started via the command line option, it was not checked, whether the file name or directory of the MVApp existed. This problem has been fixed. Now, the completeness of the command line option is checked as well as whether the specified file or directory exists. If it does not exist, an error message is shown and the application is closed.
    • If a MERLIC Vision App has been started via the context menu entry 'Launch in Frontend' or via the command line with the option '--frontend',  the splash screen showed the message 'Starting MERLIC Backend'. This problem has been fixed.
    • When using the widget 'Training' in combination with the widget 'Image Display', the combo box of the image display did not automatically select the current ROI if the user switched between processing mode and training mode. This problem has been fixed.
    • The Frontend of an unsaved MERLIC Vision App could not be started via a remote connection. This problem has been fixed.
    • The 'Image Display' widget still displayed the previous image in the MERLIC Frontend in case the image of the current iteration was invalid or empty. This problem has been fixed. Now, the 'Image Display' widget shows no image if the image is invalid or empty.
    • The 'Image Display' widget did not display the regions of interest (ROIs) with the edit mode 'Display only' in the configured color. This problem has been fixed. Now, these non-modifiable ROIs are displayed in the color that is defined for the property 'Inactive color'.
    • If an ROI has been moved in the 'Image Display' widget within the MERLIC Frontend, it was temporarily displayed in its previous position. This problem has been fixed.
    • If the 'easyTouch Button' was activated in the MERLIC Frontend and the image in the 'Image Display' widget has been zoomed using the mouse wheel, sometimes the easyTouch preview was no longer visualized while the mouse cursor was being moved over the image. This problem has been fixed.
    • If the widget 'Check Box' was connected to a string parameter, two clicks instead of one single click were required in the Frontend to uncheck the check box correctly. This problem has been fixed.

Tools

  • Enhancements
    • MERLIC now provides the new GigEVision2 interface (Revision 13.0.1) for the tool 'Acquire Image from Camera'. It supports devices complying with the GigE Vision 2.x standard and replaces the old GigEVision interface.
    • The tool 'Branch on Condition' has been improved. It has been completely revised:
      • The different branches are no longer visualized by separate areas.
      • The execution of the tools in the different branches is now initiated by triggers.
      • The output branch triggers 'Condition' and 'Default' have been added to the tool. They can be connected to all tools that should be executed if the condition is true or false, respectively.
      • The parameter properties must be instantly defined if a new parameter is added via the + button. The properties cannot be changed afterwards anymore.
      Note that this change affects the compatibility. Read more.
    • The tools 'Branch on Condition' and 'Evaluate Expression' have been improved. Previously, the user could choose from a wide range of semantic types for a newly added parameter. Now, the list of semantic types that can be selected for a new parameter has been reduced to the basic semantic types 'any', 'double', 'long', and 'string' in order to increase the clarity. The semantic types of existing MERLIC Vision Apps are automatically assigned to one of the basic semantic types.
    • The tool 'Calibrate Camera' has been improved. It has been extended by the new training results 'Marks_Train' and 'Calibration_Error_Train'. They return the contours of the found calibration marks and the calibration error, respectively.
    • The tool 'Check Presence with Gray Features' has been improved. It has been extended by the new training results 'Feature_1_Train_Out' and 'Feature_2_Train_Out'. They return the values that have been used for the training parameters 'Feature_1' and 'Feature_2' in the trained model.
    • The following tools with a training mode have been improved:
      • 'Check Presence with Gray Features'
      • 'Check Presence with Matching'
      • 'Read Aztec Code'
      • 'Read Bar Code'
      • 'Read Data Matrix ECC 200'
      • 'Read PDF417'
      • 'Read QR Code'
      Previously, the current processing image was automatically added as training image when the tool was inserted. Now, the training image must be added manually. This ensures that only the desired images are selected for the training.
      Furthermore, the modes for the training images of the tool 'Check Presence with Matching' are not defined automatically anymore. They must be defined manually for each training image.
       
    • The tool 'Check Presence with Matching' has been improved. The parameter 'Reference Position' is now an additional parameter. Furthermore, the tool has been extended by the following new training parameters:
      • 'Deformation_Tolerance_Train'
      • 'Maximum_Overlap_Train'
      • 'Minimum_Score_Train'
      • 'Orientation_Tolerance_Train'
      In addition the tool has been extended by the new training result 'Highest_Pyramid_Level_Train_Used'. It returns the value that has been used for the training parameter 'Highest_Pyramid_Level' in the trained model.
    • The training parameters of the following tools have been renamed:
      • Determine Alignment with Matching
      • Determine Alignment with Straight Border
      • Check Presence with Gray Features
      • Check Presence with Matching
      • Count with Matching
      • Locate with Matching
      All names of the training parameters now end with the suffix '_Train' to distinguish them from the processing parameters.
    • The tool 'Determine Alignment with Straight Border' has been improved. The processing parameters 'Edge Contrast', 'Edge Width', and 'Edge Transition' have been moved to the training parameters on right side of the tool board to visualize that they are used for the training.
    • The tool 'Read Bar Code' has been improved. It has been extended by the following training results:
      • 'Code_Type_Out'
      • 'Maximum_Element_Width_Out'
      • 'Minimum_Element_Width_Out'
      • 'Minimum_Absolute_Edge_Amplitude_Out'
      • 'Minimum_Relative_Edge_Amplitude_Out'
      • 'Minimum_Bar_Code_Width_Out'
      • 'Orientation_Out'
      • 'Orientation_Tolerance_Out'
      The new training results return the value of the respective processing parameters that were used in the trained model.
    • The following tools of the category 'Reading' have been improved:
      • 'Read Atzec Code'
      • 'Read Bar Code'
      • 'Read Data Matrix ECC200'
      • 'Read PDF417'
      • 'Read QR Code'
      The tools have been adjusted to return the values in the result 'Decoded Data' in a specific order. They are now sorted with respect to their 'row' and 'column' values in which they appear in the image.
    • The tools 'Read Data Matrix ECC 200' and 'Read PDF417' have been improved. They have been extended by the following training results:
      • 'Code_Property_Out'
      • 'Conform_To_Standard_Out'
      • 'Expected_Number_Of_Codes_Out'
      • 'Maximum_Number_Of_Columns_Out'
      • 'Minimum_Number_Of_Columns_Out'
      • 'Maximum_Number_Of_Rows_Out'
      • 'Minimum_Number_Of_Rows_Out'
      • 'Minimum_Contrast_Out'
      • 'Mirrored_Code_Out'
      • 'Robust_Against_Small_Modules_Out'
      Further new training results for the tool 'Read Data Matrix ECC 200' are:
      • 'Contrast_Tolerance_Out'
      • 'Finder_Pattern_Tolerance_Out'
      • 'Maximum_Horizontal_Gap_Width_Out'
      • 'Minimum_Horizontal_Gap_Width_Out'
      • 'Maximum_Module_Size_Out'
      • 'Minimum_Module_Size_Out'
      • 'Maximum_Slant_Out'
      • 'Maximum_Vertical_Gap_Width_Out'
      • 'Minimum_Vertical_Gap_Width_Out'
      • 'Module_Size_Tolerance_Out'
      Further new training results for the tool 'Read QR Code' are:
      • 'Maximum_Module_Aspect_Ratio_Out'
      • 'Minimum_Module_Aspect_Ratio_Out'
      • 'Maximum_Module_Width_Out'
      • 'Minimum_Module_Width_Out'
      The new training results return the value of the respective processing parameters that were used in the trained model.
    • The tools 'Read Atzec Code' and 'Read QR Code' have been improved. They have been extended by the following training results:
      • 'Code_Property_Out'
      • 'Conform_To_Standard_Out'
      • 'Expected_Number_Of_Codes_Out'
      • 'Maximum_Horizontal_Gap_Width_Out'
      • 'Minimum_Horizontal_Gap_Width_Out'
      • 'Maximum_Vertical_Gap_Width_Out'
      • 'Minimum_Vertical_Gap_Width_Out'
      • 'Maximum_Module_Size_Out'
      • 'Minimum_Module_Size_Out'
      • 'Minimum_Contrast_Out'
      • 'Mirrored_Code_Out'
      • 'Robust_Against_Small_Modules_Out'
      Further new training results for the tool 'Read Atzec Code' are:
      • 'Finder_Pattern_Tolerance_Out'
      • 'Maximum_Code_Size_Out'
      • 'Minimum_Code_Size_Out'
      Further new training results for the tool 'Read QR Code' are:
      • 'Maximum_Code_Version_Out'
      • 'Minimum_Code_Version_Out'
      • 'Minimum_Number_Of_Position_Patterns_Out'
      • 'Quiet_Zone_Available_Out'
      The new training results return the value of the respective processing parameters that were used in the trained model.
    • The tool 'Rotate Image' has been improved. It has been extended by the new parameter 'Keep_Image_Size' that enables the user to select if the original image size, i.e., the width and height of the image, is adjusted after the rotation.
    • The tools of the category 'Image Transformation' have been improved. Previously, the tools displayed the resulting image on top of the input image. This could be confusing in some cases. Now, the tools only display the input image and possible input ROIs. The resulting image is shown in all subsequent tools. This faciliates the use and configuration in the input image.
  • Improved Usability
    • The usability of the tool 'Communicate via Digital I/O' has been improved. The tool now offers an additional and editable name for each channel. The names in the list of channels are now composed of an editable channel name and the internal channel name. If a channel is added to the Tool Board as a parameter or result, the new editable name is used for the respective connector. This enables the user to change the channel name.
      In addition, the internal channel names have been adjusted to fit to the general naming conventions of MERLIC. Punctuation marks, i.e., dots and hyphens ('.', '-'), are replaced by underscores.
    • The usability of the tool 'Locate Objects with Similar Gray Values' has been improved. Previously, the parameters 'Minimum Area' and 'Maximum Area' were defined as additional parameters. If they were not added, it was not visible by default that their values are adjusted if easyTouch was used to select the objects. Now, the parameters have been changed to basic parameters and are now visible by default.
  • Fixed Problems
    • If the tool 'Acquire Image from Camera' has been used and some camera parameters with dependencies to other camera parameters were modified, MERLIC crashed. This problem has been fixed.
    • If the currently selected camera of the tool 'Acquire Image from Camera' has been removed, the name of the camera was still displayed in the list of available cameras. This problem has been fixed.
    • The tools 'Branch on Condition' and 'Evaluate Expression' threw an error if the user tried to paste an image into the expression field via 'Ctrl+V'. This problem has been fixed. 
    • When using the tool 'Communicate via Digital I/O', it was possible to change the value range of channels that have been added to the tool as parameters. This problem has been fixed.
    • If the MERLIC Backend was set to a language other than English and the tool 'Create Paraxial Rectangle' was loaded, the tool erroneously showed an error. This problem has been fixed.
    • If a parameter of the tool 'Determine Data History' has been adjusted, constant values were not added to the buffer anymore. This problem has been fixed.
    • If the contour selection in the tool 'Evaluate Contours' has been extended via easyTouch+, the last mouse click was always ignored. This problem has been fixed.
    • If a new parameter with the semantic type 'string' had been added to the tool 'Evaluate Expression' and then an integer result of a previous tool was connected to the parameter, the semantic type of the parameters was converted to 'int'. This problem has been fixed. Now, the semantic type of the connected value is not adjusted anymore and the connected value is processed as a string.
    • If a tool was used that defined a parameter range via two separate minimum and maximum parameters, e.g., 'Evaluate Regions', and these parameters were connected with a previous tool, the parameters could contain inconsistent minimum and maximum values. This problem has been fixed.
    • The values of the parameters 'Minimum_Feature_Value' and 'Maximum_Feature_Value' of the tools 'Evaluate Regions' and 'Evaluate Contours' could not be set higher than the predefined ranges. This problem has been fixed. Now, the ranges can be set to higher values by editing the parameter field or using a parameter with a higher value from a previous tool.
    • The 'Time Format' parameter of the tool 'Get Execution Info' could be set to a format that is not supported if the parameter was connected to a result of a previous tool, e.g., to the result of the tool 'Evaluate Expression'. This problem has been fixed. Now, a warning is shown if a time format is defined that is not supported.
    • If ROIs were drawn in the following tools, they could not be reliably associated with the correct ROI parameter and thus led to errors when these tools were executed.
      • 'Measure Circle to Point'
      • 'Measure Circle to Segment'
      • 'Measure Point to Point'
      • 'Measure Segment to Point'
      • 'Measure Segment to Segment'
      This problem has been fixed. Now, it is no longer possible to draw input ROIs for these tools. The required ROI parameters must be delivered from previous tools, e.g., from the tools of the category 'ROI Creation'.
    • If easyTouch was used to select a circle in the tool 'Measure Circle', sometimes a circle ROI without a valid result was highlighted by the easyTouch preview. This problem has been fixed.
    • If multiple ROIs have been used in the tool 'Measure Circle' and one of the ROIs was moved, a different ROI was selected as active ROI instead of the ROI that has been moved. This problem has been fixed.
    • If very small circles were selected via easyTouch in the tool 'Measure Circle', the resulting ROI sometimes differed from the selected input ROI and the two ROIs were not displayed correctly on top of each other. This problem has been fixed. The correlation of the resulting ROI to the input ROI is now more suitable.
    • The tool 'Measure Opposite Edges' sometimes returned an exception without information about the error cause if only one edge was detected instead of an opposite edge pair. This problem has been fixed. Now, an adequate error message is shown in this case.
    • Sometimes the tool 'Read Data Matrix ECC 200' returned an error if the parameter 'Minimum Number of Columns' or 'Minimum Number of Rows' had been changed. This problem has been fixed.
    • If easyTouch was used in the tool 'Read Text and Numbers', the easyTouch preview did not highlight the result that was returned when the preview was confirmed with a mouse click. This problem has been fixed.
    • If easyTouch has been used in the tool 'Read Text and Numbers', the easyTouch preview sometimes suggested two overlapping regions. This problem has been fixed.
    • The tools 'Write to File' and 'Read from File' could be connected via the 'File Handle' parameter which resulted in an error. This problem has been fixed.
    • The training tools that require only one training data set have been improved. Previously, it was possible to remove the training image which sometimes led to unexpected behavior. Now, the training image can only be replaced with a new one but it cannot be deleted anymore. This ensures that a training data set is always available.

Examples

  • New Features
    • MERLIC has been extended by the new example MERLIC Vision App 'check_bottles_parallel.mvapp'. It shows the parallel inspection of different parts of a bottle.
  • Enhancements
    • The following example MERLIC Vision Apps have been revised. They have been adapted to the new Tool Flow panel, i.e., if applicable, the tools have been rearranged for parallel processing. In addition, the parameter settings of some tools have been optimized.
      • adapt_brightness_for_measuring.mvapp
      • check_bent_leads.mvapp
      • check_pen_parts.mvapp
      • check_presence_of_fuses.mvapp
      • check_saw_angles.mvapp
      • check_single_switches.mvapp
      • detect_scratches_on_metal.mvapp
      • determine_circle_quality.mvapp
      • measure_distance_between_corners.mvapp
      • measure_distance_segment_circle_calibrated.mvapp
      • measure_distance_to_center_led.mvapp
  • Fixed Problems
    • The widget 'Execution State' in the example MERLIC Vision App 'determine_circle_quality.mvapp' always showed the state 'Bad' because some parameters needed to be adjusted. This problem has been fixed. The value of the parameter 'MinimumScore' of the tool 'Evaluate Expression' has been adjusted to a value with two decimal points. In addition the value range of the parameter has been adjusted to 0-1.
    • The Frontend design of the example MERLIC Vision App 'read_lot_number_and_ECC200.mvapp' was missing. This problem has been fixed.
    • The following examples were not up-to-date:
      • calibrate_for_ruler_changes_distance.mvapp
      • calibrate_for_ruler_distorted.mvapp
      • calibrate_for_ruler_simple.mvapp
      • check_bent_leads.mvapp
      • check_presence_of_fuses.mvapp
      • check_saw_angles.mvapp
      • check_single_switches.mvapp
      • count_defect_clusters.mvapp
      • determine_circle_quality.mvapp
      • measure_angle_with_training_mode.mvapp
      • measure_distance_between_corners.mvapp
      The examples still contained an outdated version of the 'Image Display' widget. Therefore, the widget was displayed with the previous name of the widget, i.e., 'CameraView', instead of the current name. This problem has been fixed.

Documentation

  • Enhancements
    • The documentation of the tool 'Measure Segment to Segment' has been improved. Now, it describes the logic behind the selection of the angle.
    • The MERLIC documentation has been improved. The MERLIC manuals have been extended by a new button that enables the user to change the language of the documentation directly within the manual.
    • The documentation of the following tools with a training mode has been improved:
      • 'Calibrate Camera'
      • 'Determine Alignment with Matching'
      • 'Determine Alignment with Straight Border'
      • 'Check Presence with Matching'
      • 'Check Presence with Gray Features'
      • 'Count with Matching'
      • 'Locate with Matching'
      The descriptions of how to define the training settings and search settings have been revised in the tool reference and are now structured more clearly.
    • The documentation of the MERLIC tools has been improved. The reference of a tool now contains a new section 'Application Example' that lists all provided example applications in which the tool is used. 
  • Fixed Problems
    • The documentation of the tool 'Measure Segment to Point' was not clear enough. The description of the result 'Orientation of Distance Segment' did not clearly state that it is returned as a positive real value for counterclockwise angles and a negative value for clockwise angles.
      In addition, the description of the results 'Perpendicular Distance', 'Minimum Segment Distance', and 'Maximum Segment Distance' missed the information that they are returned in world units in case calibration data is used in the tool. These problems have been fixed.

Licensing

  • Fixed Problems
    • If the MERLIC Trial version has been used, the continuous execution of a MERLIC Vision App was sometimes stopped too early. This problem has been fixed. Now, the application is executed up to the maximum time limit of 2 minutes as allowed for MERLIC Trial versions.
    • If the MERLIC Trial version has been used and a second instance of MERLIC was opened, a wrong error message appeared that stated that the trial license has expired. This problem has been fixed. Now, the error message correctly states that only one instance of MERLIC can be used in the MERLIC Trial version.

Miscellaneous

  • The password protection of MERLIC Vision Apps has been improved. The protection is now more secure. Note that this change affects the compatibility. Read more.
  • The configuration of the MERLIC server has been improved. Previously, the configuration of the server needed to be defined in a separate XML configuration file. Now, the configuration settings for the server can also be defined in the MERLIC.ini file.

Reduced Functionality

MERLIC4 Preview offers various new features including a completely revised Tool Flow panel and the parallel processing of your application. However, there are also some functionalities of previous MERLIC version that are not yet available in this MERLIC version but they will be provided for upcoming MERLIC releases.

  • MERLIC Backend
    • In this MERLIC version, the undo functionality is not available in the MERLIC Backend. It is not possible to undo any changes in the Backend.
    • Previously, it was possible to define the colors in which various graphical elements are visualized within a tool. In this MERLIC version, only a small set of colors is supported. Therefore, the 'Colors' tab of the preferences dialog has been reduced to the colors that are currently available.
  • MERLIC Designer
    • This MERLIC version does not support the training functionality in the Frontend. Therefore, the 'Training' widget is not available in this version.
    • In previous versions, it was possible to define customized language settings and translations for the texts in the Designer widgets. This functionality is not supported in this MERLIC version. The respective Designer menu entry 'Localization' has been removed.
  • MERLIC Frontend
    • This MERLIC version does not support the training functionality in the Frontend. Therefore, it is not possible to modify the training data set of a tool within the Frontend. The respective Designer widget 'Training' is also not provided in this version.
    • Previously, the Frontend offered the possibility to display the texts in a previously defined language. This MERLIC version does not support the functionality that is required to define the customized language settings and translations. Therefore, it is not possible to create a MERLIC Vision App with customized language settings. However, you can still use an old MERLIC Vision App with customized language settings from a previous MERLIC version. The defined translations and language settings will still be visible if the application is loaded in MERLIC4 Preview.
  • Tools
    • The configuration of the tool 'Acquire Image from Camera' has been revised. However, it does not offer the full functionality as in the previous MERLIC version:
      • The configuration modes 'Beginner', 'Advanced', and 'Guru' are not available anymore. Therefore, the configuration area lists all camera parameters if the configuration mode is activated.
      • It is not supported to add a camera parameter as a tool parameter to the top of the tool board.
    • The tools 'Communicate Via OPC UA' and 'Stop Execution' are not available in this version.
    • Due to the color restrictions in the MERLIC Backend, the regions in the tools of the category 'Filter' are now visualized with a margin instead of a filled color to ensure that they can still be recognized in the image.
    • If a tool is added, only the automatic connection for image parameters is supported in this MERLIC version. All other types of parameters and results are not automatically connected anymore but need to be connected manually after inserting the tool.
    • Previously, space characters were used to separate the text in the names of tool parameters and tool results. In this version, the names are separated with underscores because parts of the translation functionality is not supported yet.
    • The tools 'Read Aztec Code', 'Read Bar Code', 'Read Data Matrix ECC 200', 'Read PDF417', and 'Read QR Code' do not visualize the decoded data in the easyTouch preview anymore because the required interface procedure is not supported in this version.
    • In previous versions, the MERLIC tools showed an info box
    • If easyTouch+ was used to add another selection that did not fit to the parameter settings of the previous selection, an info box was displayed at the tool as feedback that this selection might not be possible or affects the parameter settings. This functionality is not supported in this MERLIC version.
  • MERLICExamples
    • The example MERLIC Vision App 'measure_angle_with_training_mode.mvapp' is not available in this version because it uses the 'Training' widget to allow modifications at the training data set. Since this MERLIC version does not support the training within the Frontend, the application is not provided.
  • MERLICDocumentation
    • The MERLIC Manual of this version is only provided and up-to-date in English. The documentation of MERLIC 3.0.2 in other languages is still provided. However, the manuals contain no updates. In addition, previous functionality that is currently not provided in this MERLIC version is also marked with a respective note in the English version of the MERLIC Manual. This helps to instantly recognize if a functionality is not available in this version.
  • MERLICTool Development
    • The use of custom tools is not supported in this version. The respective settings for the tool paths and procedure paths have been removed from the preferences dialog of the MERLIC Backend. The tool template examples have been removed in this version. The Tool Development manual of the previous version is still available. However, it does not contain any updates.
  • MERLIC Engine
    • The functionality of the MERLIC Engine is not available in this version. Thus, it is not possible to use a MERLIC Vision App into your own C++ or .Net application or to integrate an MVApp as ActiveX Control in your application. The MERLIC Engine example applications have been removed in this version. The MERLIC Engine manual of the previous version is still available. However, it does not contain any updates.
  • Error Logging
    • Previously, errors were shown in the output console, the tool state, and the bubble help window of the tool. However, in this version the output console is not available. Therefore, errors are only displayed in the bubble help window of the tool and in the tool state. In addition, errors are not aggregated. Only the errors from the last tool execution are displayed.
    • Because errors are not aggregated in this version, it is not possible to create a log file with the errors. The respective setting has been removed from the preferences dialog of the MERLIC Backend.
  • Miscellaneous
    • In previous versions MERLIC was available in multiple languages. However, in the MERLIC4 Preview only the English version of the user interface is up-to-date. Furthermore, only the English version of the MERLIC manual contains the updated documentation of MERLIC. If MERLIC is set to a different language than English, only some parts of the user interface are translated, i.e., the parts that were already translated in the previous version. In addition the documentation including the Quick Info of the tools contains no updates in other languages. Therefore, we recommend to set the language of the user interface to English and to use only the English version of the MERLIC manual to ensure that all information is up-to-date.
    • When MERLIC is started via the command line, several command line options are provided. Previously it was possible to use the command line options -t, -p, and -tool_filter to define the directories for MERLIC tools, MERLIC procedures, and to define the tools that should be loaded. Since the use of custom tools is not supported in this version, these command line options are also not supported anymore.