Running Tools on Images

Creating a Graph

When creating a project, the first step is to:

  • Add your tools.

  • Add links to connect your tools.

    • If necessary, select the link type.

Add an Image Tool

../../../_images/create_graph_1.webp
1. Open the Tool Catalog
2. Open the Acquisition collection
3. Double-click on the Image file tool:

  • The Image file tool is added to the graph.

  • Double-click again if you need several Image file tools.

Add an ROI Tool

1. Open the Tool Catalog
2. Open the Easy collection
3. Double-click on the ROI tool:

  • The ROI tool is added to the graph.

Add a Processing Tool

../../../_images/read_create_reader_1.webp
1. Open the Tool Catalog
2. Open the EasyQRCode collection
3. Double-click on the QRCode Reader tool:

  • The QRCode Reader tool is added to the graph.

Connect Image file to ROI

../../../_images/create_graph_4.webp
1. Click on the Image_file output image port
2. Click on the ROI input input
3. The connection is added to the graph
4. Select the Link type for this connection:

  • It is the format of the image that is transferred between both tools.

Note

  • In most cases, you do not need to select a Link type as the Link type will be automatically set when you complete your graph.

  • The tools are automatically and dynamically positioned on the graph.
    As you start to create a graph by connecting tools, this graph is displayed on the first line while the other non-connected tools are left on the bottom line until you connect them.

Connect ROI to QRCode Reader

../../../_images/create_graph_5.webp
1. Click on the ROI output ROI
2. Click on the QRCode Reader input image port
3. The connection is added to the graph

Configure the Tool

You can now configure your tools according to your application and setup.

Opening Images

In eVision Studio, you can open and process a single image or select multiple images and process them one at a time manually or through on automatic loop at a configurable speed.

Add and Remove Images

In the Setup View of the Image_file tool:

../../../_images/opening_images_add_remove_images.webp
1. To add an image:

  • Click on the folder button:

    • Select your image(s) in the Open dialog box.

    • Use the CTRL and SHIFT keys to select several images.

  • You can also click on the same button directly in the Image_file tool.

2. To remove an image:

  • Click on the image in the list and press the X button or the DEL key.

Select and Process an Image

In the Setup View of the Image_file tool:

../../../_images/opening_images_select_image.webp
1. Use the previous and next buttons:

  • You can also click on the same buttons directly in the Image_file tool.

2. Alternatively, click on an image in the list:

  • The selected image is automatically processed if the graph is operational.

Automatically Loop Images

In the Setup View of the Image_file tool:

../../../_images/opening_images_loop_images.webp
1. Set the image rate:

  • It is the number of images displayed per second in the field Rate (in Hz).

2. Click on the play button:

  • It will start or stop the automatic looping of the images and their processing.

Managing an ROI

In some cases, most often to decrease the processing time or to single-out the object you want to analyze, you do not want to process the whole image but only a part of it.

You can define and use regions of interest (ROI) to restrict the area processed with your vision tool.

  • In eVision:

    • An ROI EBaseROI .NET Python class designates a rectangular region of interest.

    • A region ERegion .NET Python class designates an arbitrarily shaped ROI. With regions, you can determine precisely which part of the image, down to a single pixel, is used for your processing.

See also

This topic explains how to use an ROI, that is a rectangular shape attached to an image. If you want to use another form, consider Working with a Region.

Using the ROI Tool

1. Click on the ROI tool
2. The Setup View opens
3. Position the ROI red rectangle:

  • Click in it and drag it to positions it.

  • Click and drag the handles to adjust its size.

4. Alternatively, enter its position manually

Tool Configuration and Results

Once your image(s), including the ROI if you created one, are ready, you need to configure your tool(s).

Note

When you add a new tool on your graph, all parameters are set to their default value.

Open the Setup View

1. Click on the Image_file tool
2. The Setup View opens
3. The Setup View includes one or several panes next to the resulting image

Adjust Parameters

In the Setup View of the tool:

1. check the Settings pan:

  • It display the parameter pan.

  • It may already be checked.

2. Adjust the parameters
3. Most change in a parameter is automatically propagated:

  • Both the graph and the views are updated accordingly.

Display Results

In the Setup View of the tool:

1. check the Result pan:

  • Click on a pane name to display only this pane content.

  • It may already be checked.

  • Check the box next to a name to add a pane to the displayed panes.

2. The results and other information are displayed

Using the Generated Code

The eVision Studio can translate your graph into code that you can use in your application.

../../../_images/using_code_display_code.webp
1. Click on the Code Generator button:

  • It opens the Code Generation pane.

2. Select a language
3. Copy the code:

  • It is ready to be used in your application

  • You can keep on changing the graph according to your needs.