displayChart

Display test chart with overlaid regions of interest

Syntax

displayChart(chart)

displayChart(chart,Name,Value)

Description

displayChart(chart) displays an Imatest^® eSFR chart [1] or a Calibrite ColorChecker^® Classic chart [2] with ROIs overlaid on detected features of the chart.

displayChart(chart,Name,Value) controls aspects of the chart display using name-value arguments.

Examples

Display Color Patch ROIs on an eSFR Chart

Read an image of an eSFR chart into the workspace.

I = imread('eSFRTestImage.jpg');

Create an esfrChart object that stores information about the test chart.

chart = esfrChart(I);

Display only the color patch ROIs. To accomplish this, turn off the display of slanted edge ROIs, gray patch ROIs, and registration points.

displayChart(chart,'displayEdgeROIs',false,'displayGrayROIs',false,'displayRegistrationPoints',false);

Display Registration Points on ColorChecker Chart

Read an image of a ColorChecker® chart into the workspace.

I = imread("colorCheckerTestImage.jpg");

Create a colorChecker object by performing automatic chart detection on the image.

chart = colorChecker(I);

Display the chart with the detected corner registration points only. Turn off the display of the color patch ROIs.

displayChart(chart,"displayColorROIs",false)

Input Arguments

chart — Test chart

esfrChart object | colorChecker object

Test chart, specified as an esfrChart object or a colorChecker object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'displayRegistrationPoints',false turns off the overlay of registration points on the chart.

displayEdgeROIs — Display slanted edge ROIs

true or 1 (default) | false or 0

Display slanted edge ROIs, specified as a numeric or logical 1 (true) or 0 (false). When displayEdgeROIs is true, the 60 slanted-edge bounding boxes are overlaid on the image in pale yellow.

This argument is supported by eSFR test charts only.

displayGrayROIs — Display gray patch ROIs

true or 1 (default) | false or 0

Display gray patch ROIs, specified as a numeric or logical 1 (true) or 0 (false). When displayGrayROIs is true, the 20 gray patch bounding boxes are overlaid on the image in blue.

This argument is supported by eSFR test charts only.

displayColorROIs — Display color patch ROIs

true or 1 (default) | false or 0

Display color patch ROIs, specified as a numeric or logical 1 (true) or 0 (false). When displayColorROIs is true, the 16 color patch bounding boxes are overlaid on the image in dark yellow.

displayRegistrationPoints — Display registration points

true or 1 (default) | false or 0

Display registration points, specified as a numeric or logical 1 (true) or 0 (false). When displayRegistrationPoints is true, the four registration points are indicated with a red diamond overlay.

Parent — Axes handle of displayed image object

axes handle

Axes handle of the displayed image object, specified as an axes handle. Parent specifies the parent of the image object created by displayChart.

References

[1] Imatest. "Esfr". https://www.imatest.com/mathworks/esfr/.

[2] Calibrite. "ColorChecker Classic". https://calibrite.com/us/product/colorchecker-classic/.

Version History

Introduced in R2017b