Skip to Main Content
コグネックスサポートハブ
Logo
ホーム サポート

Using the Extract Histogram Function to Create a Brightness and Contrast Tool in the Spreadsheet

This article shows the relationship between the Brightness and Contrast tools in EasyBuilder and the underlying tool ExtractHistogram in the Spreadsheet.

2026/01/20

Details

In the EasyBuilder toolbox for Presence/Absence there is a Brightness tool and a Contrast tool that measures the overall Brightness or Contrast in a user specified ROI. These tools can be useful to detect the presence of holes etcetera, and also for detecting scratches, dirt and debris. This article shows the relationship between the Brightness and Contrast tools in EasyBuilder and the underlying tool ExtractHistogram in the Spreadsheet.

Using the ExtractHistogram Function to create a Brightness_image-1

Example of a Contrast tool in EasyBuilder used for detecting the presence of a milled groove.

The Brightness and Contrast tools do not exist in the Spreadsheet environment. However the underlying tool ExtractHistogram does.

Using the ExtractHistogram Function to create a Brightness_image-2

Insert this tool into the Spreadsheet and set the ROI to check for the groove.

Using the ExtractHistogram Function to create a Brightness_image-3

The Automatically inserted results in the Spreadsheet will include Contrast and Average which correspond to the EasyBuilder tools Contrast and Brightness.

Using the ExtractHistogram Function to create a Brightness_image-4

You can then use logical functions such as InRange() or If() to evaluate the results and create PASS/FAIL signals in the same manner that is done in EasyBuilder.

Using the ExtractHistogram Function to create a Brightness_image-5

関連リソース