-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b304917
commit aacc382
Showing
1 changed file
with
85 additions
and
12 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,23 +1,96 @@ | ||
| # colortransfer | ||
|
|
||
| `colortransfer` is a small tool that transfers the color distribution of one | ||
| image to another image. The final image will have the mean and standard | ||
| deviation of its color channels adjusted to match the mean and standard | ||
| deviation of the color channels of the source image. It's a clone of | ||
| <https://github.com/jrosebr1/color_transfer> but it works on the YCbCr color | ||
| space, and it is written in Haskell. | ||
| `colortransfer` is a small tool that transfers the color distribution | ||
| of one image to another image. It offers two methods of color transfer, | ||
| histogram matching and ellipsoid transformation. | ||
|
|
||
| ## Color Transfer Methods | ||
|
|
||
| ### Histogram Matching | ||
|
|
||
| This method adjusts the mean and standard deviation of the color channels | ||
| in the input image to match those of the reference image. It's a simple | ||
| and effective approach for many cases, but it may not capture more | ||
| complex color relationships. | ||
|
|
||
| ### Ellipsoid Transformation | ||
|
|
||
| The ellipsoid transformation method offers a more advanced approach to | ||
| color transfer: | ||
|
|
||
| - It models the color distributions of both the input and reference | ||
| images as 3D ellipsoids in the color space. | ||
| - The method then computes a transformation that maps the input image's | ||
| color ellipsoid to match the reference image's color ellipsoid. | ||
| - This transformation takes into account not just the mean and standard | ||
| deviation, but also the covariance between color channels, allowing for | ||
| a more nuanced color transfer. | ||
| - The result often preserves the relative relationships between colors | ||
| better than simple histogram matching, potentially leading to more | ||
| natural-looking results, especially for images with complex color | ||
| distributions. | ||
|
|
||
| ## Run | ||
|
|
||
| ```shell | ||
| nix run github:damianfral/colortransfer -- \ | ||
| --source nice-colors.jpg \ | ||
| --target my-photo.jpg \ | ||
| --output my-photo-with-nice-colors.jpg | ||
| --input my-photo.jpg \ | ||
| --reference nice-colors.jpg \ | ||
| --output my-photo-with-nice-colors.jpg \ | ||
| ``` | ||
|
|
||
| ## Options | ||
|
|
||
| - `--input`: The image to be used as the color source | ||
| - `--reference`: The image we want to transform | ||
| - `--output`: The output image | ||
| - `--method`: The color transfer method to use (default: 2) | ||
| - 1: Histogram matching | ||
| - 2: Ellipsoid transformation | ||
|
|
||
| ## Examples | ||
|
|
||
|  | ||
|  | ||
|  | ||
| | Input Image | Reference Image | Histogram Matching | Ellipsoid Transformation | ||
| |-------------|-----------------|--------------------|-------------------------- | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  |  | ||
| |  |  |  | ![ET](./test-resources/processed/tania-miron--ravi-sharma--histogram-matching.jpe |