colorfindr (version 0.1.5)

plot_colors_3d: Create interactive 3D scatterplots of image color compositions

Description

plot_colors_3d calls plot_ly and creates an interactive 3D scatterplot of colors extracted from Windows BMP, JPEG, PNG, TIFF, and SVG format images with the get_colors function in the RGB color space.

Usage

plot_colors_3d(
  data,
  sample_size = 5000,
  marker_size = 2.5,
  color_space = "RGB"
)

Arguments

data

a data.frame from a get_colors call consisting of the columns col_hex, col_freq, col_share.

sample_size

the number of pixels to randomly select.

marker_size

size of marker.

color_space

specifies color space. By default, the colors are displayed in the "RGB" color space (x-axis: red, y-axis: blue, z-axis: green). Alternatively, the color spaces "HSL" (hue, saturation, lightness) and "HSV" (hue, saturation, value) can be used.

Examples

# Extract all colors
pic1 <- system.file("extdata", "pic5.png", package = "colorfindr")
col <- get_colors(pic1)

# Plot image composition
plot_colors_3d(col)