v0.1.14 - 2024-12-11

Release Notes

🔖 Version Tag

• 🚀 New Features: Added background color support to ImagePlotter, added unique ID to ImagePlotter, updated show
  command to handle multiple files, added image item selection and hover states, added new image plotting functionality,
  added image plotting functionality to Image Handling.
• 🔧 Improvements: Simplified image data conversion and update type references in ImageShower, refactored image data
  handling and update show method in Image Handling, simplified image selection logic in ImageShower, added parameter to
  show_only and update plot settings in ImagePlotter.
• 🐛 Bug Fixes: Fixed RLE decoding and handle empty image data in icu_lib.
• 🔄 Version Bump: Version was bumped to 0.1.14 to reflect the updates and improvements.

Install icu_tool 0.1.14

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.14/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.14/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/cellar/icu_tool

Download icu_tool 0.1.14

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
icu_tool-aarch64-unknown-linux-musl.tar.xz	ARM64 MUSL Linux	checksum
icu_tool-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum

v0.1.13 - 2024-12-02

Release Notes

🔖 Version Tag

• 🚀 New Features: Added file drag and drop functionality to ImageShower, allowing users to easily drop files into
  the application for processing. (commit 89d234a)
• 🚀 New Features: Enabled persistence of app state with serde serialization for AppContext struct, including
  settings like show_grid and anti_alias. (commit 7350fce)
• 🚀 New Features: Added anti-aliasing option to ImageShower, enhancing image quality with linear filtering when
  enabled. (commit c7571d7)
• 🚀 New Features: Implemented show grid option in ImageShower, allowing users to toggle the grid display for better
  visualization. (commit d697686)
• 🔧 Improvements: Improved dropped files handling in ImageShower, accurately representing file information and
  preparing image data for display. (commit 589aa16)
• 🔧 Improvements: Corrected typo in anti-aliasing toggle label and updated grid display settings for a cleaner
  look. (commit 783c825)
• 🔧 Improvements: Simplified position checks in label formatter and improved image display with cursor interaction
  enhancements. (commit 693ccf5)
• 🔧 Improvements: Updated grid display and coordinate formatting for precision, and removed unused imports to
  maintain code cleanliness. (commit 2aee817)
• 🛠 Refactoring: Refactored RLE encoding logic and LVGL handling, including updates to RleCoder and compression
  methods. (commits 2969fa9, 0b58b33)
• 🛠 Refactoring: Cleaned up icu_lib/src by removing unnecessary references and updating function calls for
  efficiency. (commit 5997968)
• 🐛 Bug Fixes: Fixed errors in image header stride handling and data size mismatches in icu_lib. (commit
  f63632b)
• 📚 Documentation: Updated README files and added serialization details for better project understanding. (commits
  1996dfa, fde03ac)
• 🔄 Version Bump: Version was bumped to 0.1.13 to reflect the updates and improvements.

Install icu_tool 0.1.13

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.13/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.13/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/cellar/icu_tool

Download icu_tool 0.1.13

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
icu_tool-aarch64-unknown-linux-musl.tar.xz	ARM64 MUSL Linux	checksum
icu_tool-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum

v0.1.12-1 - 2024-11-08

Release Notes

🔖 Version Tag

• 🚀 New Features: support custom dither params, support 1 to 30 levels. 1 is the best level.
• 🔄 Version Bump: Version was bumped to 0.1.12 to reflect the updates and improvements.

Install icu_tool 0.1.12-1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.12-1/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.12-1/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/cellar/icu_tool

Download icu_tool 0.1.12-1

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
icu_tool-aarch64-unknown-linux-musl.tar.xz	ARM64 MUSL Linux	checksum
icu_tool-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum

v0.1.12 - 2024-11-08

Release Notes

🔖 Version Tag

• 🚀 New Features: support custom dither params, support 1 to 30 levels. 1 is the best level.
• 🔄 Version Bump: Version was bumped to 0.1.12 to reflect the updates and improvements.

Install icu_tool 0.1.12

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.12/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.12/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/homebrew-cellar/icu_tool

Download icu_tool 0.1.12

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.11-1 - 2024-05-01

Release Notes

🔖 Version Tag

劳动节快乐🎉
Happy Labor Day🎉

• 🚀 New Features: Added support for PNG indexes 1/2/4/8.
  • Now you can easily convert by using the -C option with i1/2/4/8 color format.
• 🚀 New Features: Added support for Dither feature! By using --dither option you can make your pictures better and more natural.
• 🔄 Version Bump: Version was bumped to 0.1.11 to reflect the updates and improvements.

Install icu_tool 0.1.11-1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.11-1/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.11-1/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/homebrew-cellar/icu_tool

Download icu_tool 0.1.11-1

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.11 - 2024-05-01

Release Notes

🔖 Version Tag

劳动节快乐🎉
Happy Labor Day🎉

• 🚀 New Features: Added support for PNG indexes 1/2/4/8.
  • Now you can easily convert by using the -C option with i1/2/4/8 color format.
• 🚀 New Features: Added support for Dither feature! By using --dither option you can make your pictures better and more natural.
• 🔄 Version Bump: Version was bumped to 0.1.11 to reflect the updates and improvements.

Install icu_tool 0.1.11

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.11/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.11/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/homebrew-cellar/icu_tool

Download icu_tool 0.1.11

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.10 - 2024-03-12

Release Notes

🔖 Version Tag

• 🚧 Refactoring: Refactored code to improve maintainability and readability.
• 🚧 Refactoring: Refactored error handling to improve user experience and reduce code complexity.
• 🚀 New Features: The way to display the path is more reasonable.
• 🚀 New Features: Added support for Auto-Complete feature for the command line interface. See README.md for more information.
• 🔄 Version Bump: Version was bumped to 0.1.10 to reflect the updates and improvements.

Install icu_tool 0.1.10

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.10/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.10/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/homebrew-cellar/icu_tool

Download icu_tool 0.1.10

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.9 - 2024-03-06

Release Notes

🔖 Version Tag

• 🚀 New Features: Added support for LVGL version 8 encode and decode.
• 🚀 New Features: Added support for image show for LVGL version 8.
• 🚀 New Features: Added support for more image information logging for LVGL version 8 and 9.
• 🔄 Version Bump: Version was bumped to 0.1.9 to reflect the updates and improvements.

Install icu_tool 0.1.9

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.9/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.9/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/homebrew-cellar/icu_tool

Download icu_tool 0.1.9

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.8

Updates

• 🆕 Add new info command for showing an information of an image
  • for more information run icu info -h
• 🐛 Bug fix

Install icu_tool 0.1.8

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/icu/releases/download/v0.1.8/icu_tool-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/W-Mai/icu/releases/download/v0.1.8/icu_tool-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/homebrew-icu/icu_tool

Download icu_tool 0.1.8

File	Platform	Checksum
icu_tool-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icu_tool-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icu_tool-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icu_tool-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
icu_tool-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.7

Big Update

• ❤️ Support converting image from a folder to another folder an keep sub folder file structures now!
• 🐛 Some bug fix

Examples

Convert an common image format to an common image format

if you want to converting images with logs out put, you can use -vv option.

$ icu -vv convert res/img_0.png res/img_0.jpeg --output-format webp`

[2024-02-29T13:05:06Z INFO  icu] Start converting files
[2024-02-29T13:05:06Z INFO  icu] 
[2024-02-29T13:05:06Z INFO  icu] took 0.002740s for converting [res/img_0.png] to [res/img_0.webp] with format [WEBP] 
[2024-02-29T13:05:06Z INFO  icu] took 0.002257s for converting [res/img_0.jpeg] to [res/img_0.webp] with format [WEBP] 
[2024-02-29T13:05:06Z INFO  icu] 
[2024-02-29T13:05:06Z INFO  icu] Total converting time:
[2024-02-29T13:05:06Z INFO  icu]        Consuming  : 0.005121s for 2 files
[2024-02-29T13:05:06Z INFO  icu]        User   time: 0.004998s
[2024-02-29T13:05:06Z INFO  icu]        System time: 0.000123s

or in a short form:

$ icu -vv convert res/img_0.png res/img_0.jpeg -F webp

Convert some images in a folder to another specific folder

convert all images in the res folder to jpeg format and save them in the res/output folder, if the output file
already exists, it will override it (you should use -r --override-output option).

if and the output folder will keep the same structure as the input folder.

$ icu convert res -O res/output --output-format jpeg --override-output

or in a short form:

$ icu convert res -O res/output -F jpeg -r

Convert an LVGL image format to an common image format

Convert an LVGL image format to an common image format.
And if you specify the --overide-output option, ICU will override the output file if it already exists.
And you will get a warning message for sure if the output file already exists.

$ icu -vv convert res/img_0.bin -O res/output -F jpeg -r

[2024-03-03T16:08:01Z INFO  icu] Start converting file
[2024-03-03T16:08:01Z INFO  icu] 
[2024-03-03T16:08:01Z WARN  icu] Override output file <res/output/img_0.jpeg> for converting <res/img_0.bin>
[2024-03-03T16:08:01Z INFO  icu] took 0.007022s for converting <res/img_0.bin> to <res/output/img_0.jpeg> with format <JPEG>
[2024-03-03T16:08:01Z INFO  icu] 
[2024-03-03T16:08:01Z INFO  icu] Total converting time:
[2024-03-03T16:08:01Z INFO  icu]        Consuming  : 0.008715s for 1 files
[2024-03-03T16:08:01Z INFO  icu]        User   time: 0.007022s
[2024-03-03T16:08:01Z INFO  icu]        System time: 0.001693s

Convert an common image format to an LVGL image format

Convert an common image format to an LVGL image format, you need to specify the output color format and lvgl version.
But if you don't specify the lvgl version, ICU will use the default version (v9).

$ icu convert res/img_0.png -O res/output -F lvgl -C i8 -r

Convert an common image format to an LVGL image format with stride align

Convert an common image format to an LVGL image format with stride align, you need to specify the output color format,
lvgl version, and stride align (default is 1).

4 means the stride of the output image will be 4 bytes aligned.

$ icu convert res/img_0.png -O res/output -F lvgl -C i8 -S 4 -r

Full Changelog: v0.1.5...v0.1.7 with ❤️