Acquire Image from File
This tool can be used to acquire a single image or a series of images from file. In contrast to the image acquisition via the Image Source Manager, the configuration of the image source is part of the MERLIC Vision App and cannot be reused in other MVApps.
The tool can be used for testing purpose when creating and configuring MERLIC Vision Apps. It is also used in the provided MVApp examples. However, for productive use, we recommend using the Image Source Manager for the set up of the image acquisition. For more information, see the topic MERLIC Image Source Manager (ISM).
Parameters
Basic Parameters
File Name:
This parameter defines the name of the image file to be acquired. You can select the image files at the corresponding connector. It is possible to select a single image, multiple images or even all images of a directory. To load a single image or multiple images use the file selection dialog of the combo box. To select all images of a directory you can use the drop-down menu of the combo box. It lists a selection of image directories that have been installed or already used in a previous application. You can also type the File Name of the image directly into the input field.
If you select a series of images, only one image of your selection will be displayed at a time. When executing the application once, the tool displays the next image of your selection. Thus you may execute your application stepwise to check your selection of images. Adding or deleting images in the tool "Acquire Image from File" does not affect images already used as training images in subsequent tools.
For a file that contains multiple images as sub files, e.g., a multi-page image in a TIFF file, only the first image is loaded in the tool. Some file type variations that contain multiple images can not be acquired. We recommend using single-page images.
The following image formats are supported: .bmp, .gif, .hobj, .ima, .jp2, .jpeg, .jpg, .jxr, .pbm, .pcx, .pgm, .png, .pnm, .ppm, .ras, .tif, .tiff, .xwd.
Results
Basic Results
Image:
This result represents the acquired image from file. If a series of images has been selected for the acquisition, it represents the image that is currently displayed in the Tool Board.
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
Current File Name:
This result contains the name and file path of the acquired image that is currently displayed in the Tool Board.
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:
- adapt_brightness_for_measuring.mvapp
- calibrate_for_ruler_changed_distance.mvapp
- calibrate_for_ruler_distorted.mvapp
- calibrate_for_ruler_simple.mvapp
- check_bent_leads.mvapp
- check_correct_filling_on_3d_height_images.mvapp
- check_pen_parts.mvapp
- check_presence_of_fuses.mvapp
- check_saw_angles.mvapp
- check_single_switches.mvapp
- classify_pills.mvapp
- classify_and_inspect_wood.mvapp
- count_bottles_with_deep_learning.mvapp
- count_defect_clusters.mvapp
- count_frozen_dough_with_training.mvapp
- demonstrate_evaluate_expression.mvapp
- detect_anomalies_of_bottles.mvapp
- detect_anomalies_of_bottles_in_the_global_context.mvapp
- detect_only_scratches_with_photometric_stereo.mvapp
- determine_circle_quality.mvapp
- evaluate_ecc_200_print_quality.mvapp
- find_and_count_screw_types.mvapp
- measure_distance_between_corners.mvapp
- measure_distance_segment_circle_calibrated.mvapp
- measure_distance_to_center_led.mvapp
- read_best_before_date_with_orientation.mvapp
- read_lot_number_and_ECC200.mvapp
- read_text_in_3d_height_image.mvapp
- recognize_color_of_cables.mvapp
- segment_pill_defects.mvapp
- segment_pills_by_shape.mvapp
