displayChart

R2026b

Display test chart with overlaid regions of interest

Syntax

displayChart(chart)

displayChart(chart,Name=Value)

Description

displayChart(chart) displays an eSFR or ColorChecker test chart with ROIs overlaid on the 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 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 | SimulatedColorCheckerChart object | SimulatedESFRChart object

Test chart, specified as one of these options:

• esfrChart object — Displays Imatest^® eSFR chart [1]

• colorChecker object — Displays Calibrite ColorChecker^® Classic chart [2]

• SimulatedColorCheckerChart object — Displays a simulated ColorChecker test chart rendered through an optical system (since R2026b)

• SimulatedESFRChart object — Displays an eSFR test chart rendered through an optical system (since R2026b)

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: displayChart(chart,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

R2026b: Display simulated eSFR and ColorChecker test charts

You can now display simulated test charts rendered through an optical system. Use the renderChart object function to render a simulated eSFR or ColorChecker chart as a SimulatedESFRChart or SimulatedColorCheckerChart object, respectively. To display the chart, specify the rendered test chart, chart.

This functionality requires Optical Design and Simulation Library for Image Processing Toolbox™. You can install the Optical Design and Simulation Library for Image Processing Toolbox from Add-On Explorer. For more information about installing add-ons, see Get and Manage Add-Ons.