Main Content

displayChart

Display test chart with overlaid regions of interest

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.

example

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

Examples

collapse all

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);

Figure eSFR test chart contains an axes. The axes contains 17 objects of type image, text.

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)

Figure Color checker test chart contains an axes. The axes contains an object of type image.

Input Arguments

collapse all

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.

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.

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.

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.

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.

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

[2] X-Rite Photo and Video. "ColorChecker Classic". https://xritephoto.com/colorchecker-classic

Introduced in R2017b