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 an X-Rite^® 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 an X-Rite® 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 Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

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 the comma-separated pair consisting of 'displayEdgeROIs' and 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 the comma-separated pair consisting of 'displayGrayROIs' and 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 the comma-separated pair consisting of 'displayColorROIs' and 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 the comma-separated pair consisting of 'displayRegistrationPoints' and 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 the comma-separated pair consisting of 'Parent' and 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] X-Rite Photo and Video. "ColorChecker Classic". https://xritephoto.com/colorchecker-classic