Align Image

Use this tool to align an image based on alignment data from a previous tool. This means that you have to determine the data for the alignment before using this tool, e.g., with the tools Determine Alignment with Straight Border or Determine Alignment with Matching. If the alignment data are available in one of these tools, you can connect the result representing the alignment data with the parameter "Alignment Data" of this tool. The connected data will be used to align the image.

This is the only tool that uses "Alignment Data" to align the image. All the other tools in MERLIC that support "Alignment Data" use it only to align a region of interest (ROI).

This tool might increase run time since it aligns the whole image.

Parameters

Basic Parameters

Image:

This parameter represents the input image which is to be aligned.

If a color image is used as an input image, all channels of the color image are used for the processing.

Alignment Data:

This parameter represents the alignment data that are used to align the image. The default value of the parameter "Alignment Data" does not affect the alignment of the image. To align the image according to the desired "Alignment Data", you have to connect the parameter to the respective result of a previous tool such as Determine Alignment with Matching, Determine Alignment with Straight Border, or Rotate Image.

Results

Basic Results

Aligned Image:

This result returns the image that is aligned according to the used "Alignment Data".

Adapted Alignment Data:

This result returns the alignment data aligning the newly aligned image with itself. It represents the alignment identity, i.e., the use of this alignment data will have no visible effect.

Tool State:

"Tool State" returns information about the state of the tool and thus can be used for error handling. For more information, see Tool State Result

Additional Results

Processing Time:

This result returns the duration of the most recent execution of the tool in milliseconds. The result is provided as additional result. Therefore, it is hidden by default but it can be displayed via the button beside the tool results. For more information see the section Processing Time in the tool reference overview.

Application Examples

This tool is used in the following MERLIC Vision App examples:

• check_single_switches.mvapp
• detect_anomalies_of_bottles.mvapp