Release 2.2.0 - Addition of 6 New Colors

[AlTimofeyev]

• This update was delayed to August 2025.
• ADDED: Added 6 new colors to the constants.py file to be extracted along with the original 6.
  • Added orange, chartreuse, spring, azure, violet and rose.
  • Adjusted some existing color constants in the process.
• ADDED: Added more color format conversion functions to the conversion_utils.py file.
  • Added hex_to_hsv(), hsv_to_ansi(), ansi_to_hsv(), hex_to_ansi() and ansi_to_hex().
• CHANGED: Changed he constants.py file.
  • Changed the SATURATION_TOLERANCE_RANGE constant value from [10.0, 15.0] to [15.0, 20.0].
  • Changed the PASTEL_SATURATION_RANGE constant value from [15.0, 75.0] to [20.0, 55.0].
• CHANGED: Changed the print_utils.py file.
  • Added print_raw_colors() function to allow for printing raw extracted colors to the Terminal.
    • This is for when the user wants to extract only the raw colors (not palettes) but also wants to print a preview.
  • Added print_palette_preview() function, a simplified version of the prior print palette function that uses already-made palettes.
  • Deprecated the following two functions in favor of print_palette_preview():
    • print_default_palette_preview()
    • print_template_palette_preview()
    • These two functions will remain in this new version update, just in case there might be a use for them.
• CHANGED: Changed the file_utils.py file.
  • Changed the generate_config_file() function to include the new colors.
  • Refactored the save_palettes() function header and the beginning of the function.
    • Removed the pastel optional parameters from the header in favor of an optional dictionary that would contain the same values.
  • Added a export_file_format check at the beginning of all the functions in this file, except generate_config_file(), to make sure it's a supported format.
• CHANGED: Changed the Extractor.py file and class.
  • Added math and stat packages to this file.
  • Moved the image processing portion of the package into the Extractor class.
    • This class now contains a load() function to load the Extractor class with an image before using the run() function.
  • Added support for the 6 new colors.
  • Added generate_mood_palettes() and generate_adaptive_palettes() functions to generate mood and adaptive color palettes.
  • Changed the set_color_format() function to be able to modify the color format of both the extracted colors dictionary or any color palette dictionary that is passed to this function.
    • This function can now change the color format more than once, removing the limit from the last update.
  • Changed the convert_pastel() function so that the saturation is adjusted regardless if it was already set to a proper saturation.
• CHANGED: Changed the extraction_utils.py file.
  • Changed check_missing_color_types() function to use new_bounds[0] + for borrowing color types.
    • Previously, some of the color-type-checks used new_bounds[1] - instead, so I changed that for this update.
  • Changed the linear color ordering to be more intuitive.
    • From (left side)['red', 'rose', 'magenta', 'violet', 'blue', 'azure', 'cyan', 'spring', 'green', 'chartreuse', 'yellow', 'orange'](right side)
    • To (left side)['red', 'orange', 'yellow', 'chartreuse', 'green', 'spring', 'cyan', 'azure', 'blue', 'violet', 'magenta', 'rose'](right side)
    • This will work better for mental visualization in the long run as the latter variation is more intuitive.
  • Changed get_left_and_right_colors() and borrow_color() functions to accommodate the change in linear color ordering.
  • Added the 6 new base colors into the extraction process for some functions.
  • Changed the extract_colors() function by adding a ratios parameter to the function header.
  • Changed the saturation and brightness values for black and white colors in generate_black_and_white() function.
  • Added ration type processing to the sort_by_sat_and_bright_value() function.
    • This will record the percentage/ratios of each color type for each of the base colors.
  • Added get_dominant_color_name() function to get the name of the dominant base color.
  • Added get_hue_shift_value() function to calculate how much to shift a hue based on the hue's range and on the percentage provided.
  • Added calculate_dist_between_2_colors() function to calculate the distance between two HSV colors.
  • Changed check_missing_colors() function to be more concise.
  • Added set_missing_color() function to support the check_missing_colors() function as there was repeated code.
  • Changed find_closest_to_centroid() function to use the new calculate_dist_between_2_colors() function.
• CHANGED: Changed the main.py file.

---

This discussion was created from the release Release 2.2.0 - Addition of 6 New Colors.