colorcloud

Display 3-D color gamut as point cloud in specified color space

Syntax

colorcloud(rgb)

colorcloud(rgb,colorspace)

colorcloud(___,Name=Value)

hPanel = colorcloud(___)

Description

colorcloud(rgb) displays the full color gamut of the color image rgb as a point cloud. By default, colorcloud uses the RGB color space.

colorcloud(rgb,colorspace) displays the full color gamut of the color image rgb as a point cloud in the color space specified by colorspace.

colorcloud(___,Name=Value) displays the full color gamut using name-value pairs to control aspects of the visualization.

hPanel = colorcloud(___) returns the uipanel object created by colorcloud.

Examples

View 3-D Color Gamut of RGB Image in HSV Color Space

Read an RGB image.

RGB = imread("peppers.png");

View the color gamut in the HSV color space.

colorcloud(RGB,"hsv");

Input Arguments

rgb — Color image

m-by-n-by-3 numeric array

Color image, specified as an m-by-n-by-3 numeric array.

Data Types: single | double | uint8 | uint16

colorspace — Color space name

"rgb" (default) | "hsv" | "ycbcr" | "lab"

Color space name, specified as one of these values:

Value	Description
"hsv"	Color gamut in HSV color space
"lab"	Color gamut in CIE 1976 L*a*b* color space
"rgb"	Color gamut in RGB color space
"ycbcr"	Color gamut in YCbCr color space

Data Types: char | string

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: "BackgroundColor","w"

Parent — Parent of object created by colorcloud

new figure (default)

Parent of the object created by colorcloud, specified as a figure or a uipanel object. If you do not specify a valid object, then the colorcloud function creates a new figure window.

BackgroundColor — Background color

[0.94 0.94 0.94] (default) | RGB triplet | hexadecimal color code | color name | short color name

Background color to the color cloud, specified as an RGB triplet, a hexadecimal color code, a color name, or a short color name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Therefore, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and the hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Example: BackgroundColor="r"

Example: BackgroundColor="green"

Example: BackgroundColor=[0 0.4470 0.7410]

Example: BackgroundColor="#00FFFF"

WireFrameColor — Color of wire frame

"black" (default) | "none" | RGB triplet | hexadecimal color code (since R2026a) | color name | short color name

Color of the wire frame, specified as an RGB triplet, a hexadecimal color code (since R2026a), a color name, a short color name, or "none". If you specify the value "none", then colorcloud deletes the wire frame.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Therefore, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and the hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Example: WireFrameColor="r"

Example: WireFrameColor="green"

Example: WireFrameColor=[0.8500 0.3250 0.0980]

Example: WireFrameColor="#00FFFF"

OrientationAxesColor — Color of orientation axes and labels

"black" (default) | "none" | RGB triplet | hexadecimal color code (since R2026a) | color name | short color name

Color of the orientation axes and labels, specified as an RGB triplet, a hexadecimal color code (since R2026a), a color name, a short color name, or "none". If you specify the value "none", then colorcloud deletes the labels.

For a custom color, specify an RGB triplet or a hexadecimal color code.

• An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7].

• A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Therefore, the color codes "#FF8800", "#ff8800", "#F80", and "#f80" are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and the hexadecimal color codes.

Color Name	Short Name	RGB Triplet	Hexadecimal Color Code	Appearance
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Example: OrientationAxesColor="r"

Example: OrientationAxesColor="green"

Example: OrientationAxesColor=[0.9290 0.6940 0.1250]

Example: OrientationAxesColor="#00FFFF"

Output Arguments

hPanel — Color gamut point cloud

uipanel object

Color gamut point cloud, returned as a uipanel object.

Version History

Introduced in R2016b

R2026a: Specify colors using hexadecimal color codes

You can now specify the BackgroundColor, WireFrameColor, and OrientationAxesColor name-value arguments as hexadecimal color codes.