hw2h: Convert warped virtual hue to standard hue

hw2hR Documentation

Convert warped virtual hue to standard hue

Description

Convert warped (virtual) hue to standard HCL hue by colorjam preset

Usage

hw2h(
  h,
  h1 = NULL,
  h2 = NULL,
  direction = 1,
  preset = getOption("colorjam.preset", "custom"),
  ...
)

Arguments

h

numeric vector of color hues between 0 and 360. These hues do not need to be in sequential order.

h1, h2

numeric vector of color hues, which by default are defined in h2hwOptions(), but allowed here in cases where the global options should be overridden but not modified.

direction

numeric indicating the direction of h1 HCL hue relative to h2 virtual hue:

  • 1 indicates both are increasing

  • -1 indicates h1 and h2 differ in direction

preset

character string with a named preset from colorjam_presets(), for which the h1,h2,direction values will be obtained. When preset="custom" then h1 and h2 must be provided.

Details

This function is intended to convert from a vector of warped hue values to the hues defined by colorjam_presets() for the given preset.

Each preset defines a custom set of color hues, for example:

  • converting RGB to RYB color wheel

  • converting RGB to the customized dichromat color wheel

  • reversing a color wheel

Note the output hue uses the standard HCL color hue as defined by colorspace::polarLUV(), with values ranging between 0 and 360. By this standard, 12.2 is defined as red, 120 is defined as green, and 245 is defined as blue.

Value

numeric vector of color hues after applying the transformation from h2 to h1 for the given preset.

numeric vector of hue values after applying the hue warp operation.

See Also

Other colorjam hue warp: add_colorjam_preset(), add_colorjam_step(), adjust_hue_warp(), approx_degrees(), colorjam_presets(), colorjam_steps(), display_degrees(), h2hwOptions(), h2hw(), hcl_to_hsl_hue(), hsl_to_hcl_hue(), mean_angle(), plot_colorjam_preset(), remap_colorjam_preset(), validate_colorjam_preset()

Other colorjam hue warp: add_colorjam_preset(), add_colorjam_step(), adjust_hue_warp(), approx_degrees(), colorjam_presets(), colorjam_steps(), display_degrees(), h2hwOptions(), h2hw(), hcl_to_hsl_hue(), hsl_to_hcl_hue(), mean_angle(), plot_colorjam_preset(), remap_colorjam_preset(), validate_colorjam_preset()

Examples

# It can be useful to create a uniform sequence of angles in warped
# hues, which are visually more uniform than those using an RGB color wheel,
# then convert those hues to standard color hues.
warpedHues <- seq(from=0, to=330, length.out=12);
warpedHues;

# rgb imposes no change
hues <- hw2h(warpedHues, preset="rgb");
hues;

# ryb imposes changes
hues <- hw2h(warpedHues, preset="ryb");
hues;


jmw86069/colorjam documentation built on March 18, 2024, 3:32 a.m.