1.3.4

• CHANGED: The image rescale function in image_utils.py.
  • Images are now rescaled according to a proper mathematical formula and maintain their aspect ratio instead of hard-rescaling images to 480p with a 16:9 or 9:16 aspect ratio.
  • The math behind rescaling the image came from: https://math.stackexchange.com/a/3078131
  • If an image is smaller the required sampling size of 480p, it is not rescaled.

1.3.3

• ADDED: Added a --save-check option to ask if the user wants to save the extracted color palettes.
• ADDED: Added a --preview option to show a preview of extracted color palette.
• ADDED: Added a --preview-check option to show preview AND ask if the user wants to save extracted the color palette.
• ADDED: Added a hex_to_rgb() function to the conversion_utils.py file.
• ADDED: Added a print_utils.py file to handle printing previews to the screen and a file_utils.py file to handle different file saving options..
  • This is a potential point for contributors to add different printing and file saving options.
  • NOTE: The terminal needs to be able to display ANSI colors and ASCII characters to properly use the default preview option (this issue could be avoided by showing preview in separate GUI).
• CHANGED: Tested package against Python 3.6.15 and confirmed everything works as it should, added compatibility for Python 3.6 to setup.py file.
• CHANGED: Extractor class no longer organizes the extracted color palettes into color schemes, that will be done by the saving options in file_utils.py.
  • The Extractor class x will orgnaize the color palettes into a dictionary of default format that looks like this: {light background, light foreground, dark background, dark foreground, light palette, normal palette, dark palette}
• CHANGED: Changed the light background brightness from 94% to 95%.
• CHANGED: Changed the light foreground saturation and brightness from (4%, 92%) to (3%, 95%).
• REMOVED: Removed file saving function from image_utils.py file.
  • This function was moved to the file_utils.py file.

1.3.2

• Changed __main__.py:
  • Fixed bug where extractor.color_palette_dict was not renamed to extractor.color_schemes_dict when changes were made in PyPalEx 1.3.1.

1.3.1

• Added saturation preference options to PyPalEx for those that prefer more saturated colors.
• Added --sat_pref option to extract more saturated colors of all color palettes.
• Added --sat_pref-light option to extract more saturated colors of the light color palette.
• Added --sat_pref-normal option to extract more saturated colors of the normal color palette.
• Added --sat_pref-dark option to extract more saturated colors of the dark color palette.

1.3.0

• Refactored codebase.
• Added multiprocessing to extraction process in palex.extraction_utils.py.
  • Optimized color extraction for single image files with multiprocessing.
  • Removed multiprocessing for multiple image files (refer to extract_color_palettes() function of palex.__main__.py v1.2.0).
    • PyPalEx will continue to maintain the functionality to process multiple image files, but multiprocessing will only be applied to the color extraction process of individual images.
• Added hsv_to_hex() function to palex.conversion_utils.py.
• Added enforcement of RGB color space in process_image() function of palex.image_utils.py.
• Added constants for Pastel color range to palex.constants.py.
• Changed color space that is used in the extraction process from HSL to HSV.
• Changed -d --directory option to -p --path option.
• Changed -p --pastel option to --pastel.
• Removed normal palette scheme.
• Added CI/CD automation with GitHub Actions to automatically build and publish new release versions of PyPalEx to PyPI.

1.2.0

• Added -p --pastel option to convert all extracted color palettes to pastel.
• Added --pastel-light option to convert only the light color palette to pastel.
• Added --pastel-normal option to convert only the normal color palette to pastel.
• Added --pastel-dark option to convert only the dark color palette to pastel.
• Changed the order of the colors in JSON file.
  • Changed from [black, red, yellow, green, cyan, blue, magenta, white] to
    [black, red, green, yellow, blue, magenta, cyan white].

1.1.0

• Added -v --version to print the PyPalEx version.
• Changed lighting adjustment threshold:
  • Some colors were still too bright or too dark to distinguish in the previous version.
  • Lightness threshold for bright colors decreased from 95% to 90%
    • Random range changed from [85.0, 95.0] to [80.0, 90.0].
  • Lightness threshold for dark colors increased from 5% to 15%
    • Random range changed from [5.0, 10.0] to [15.0, 25.0].
• Changed black color's normal saturation and lightness.
  • Saturation was decreased from 60% to 50%.
  • Lightness was increased from 10% to 15%.
• Changed Normal palette's foreground lightness.
  • Foreground lightness decreased from 88% to 85%.

1.0.6

First Release of PyPalEx