1 unstable release
0.1.0 | Jul 28, 2024 |
---|
#294 in Images
34 downloads per month
52KB
1K
SLoC
xbrz-rs
This project is a Rust port of the C++ implementation of the xBRZ pixel scaling algorithm, originally created by Zenju. You can download the original C++ version on SourceForge. Both the C++ version and this port are licensed under the GNU General Public License v3.
See the example images section for a comparison of this library's output with nearest neighbour scaling.
Usage
There is currently one public function called scale_rgba
, which can scale an RGBA format image from 2x up to 6x the
original resolution:
use std::path::Path;
fn upscale_image(input_path: &Path, output_path: &Path, factor: usize) -> Result<(), image::ImageError> {
let in_image = image::open(input_path)?;
let width = in_image.width();
let height = in_image.height();
let rgba = image::RgbaImage::from(in_image);
let out_rgba = xbrz::scale_rgba(
&rgba,
width as usize,
height as usize,
factor
);
let out_width = width * factor as u32;
let out_height = height * factor as u32;
image::save_buffer(
output_path,
&out_rgba,
out_width,
out_height,
image::ExtendedColorType::Rgba8,
)
}
Features
To compare pixels, the RGB values are converted into YCbCr representation. To do this efficiently, this package creates a lookup table (LUT) which converts between an RGB difference and scalar difference computed with YCbCr coordinates.
By default, this lookup table uses compressed 5-bit per channel indices such that the LUT only uses 128 KiB of memory.
However, by enabling the large_lut
feature, the full range of 8-bit differences is used, which causes the LUT to
take up 64 MiB of memory. The difference will be negligible, but you may enable it if you wish for higher accuracy.
Example images
Also see the test/images directory for examples at more scaling factors.
Sample I
Nearest Neighbour x3 | xBRZ algorithm (xbrz-rs) x3 |
---|---|
Sample II
Nearest Neighbour x3 | xBRZ algorithm (xbrz-rs) x3 |
---|---|
Yoshi
Nearest Neighbour x6 | xBRZ algorithm (xbrz-rs) x6 |
---|---|
Dependencies
~1.6–6.5MB
~38K SLoC