pub fn equalize_histogram(image: &GrayImage) -> GrayImage {
    let mut out = image.clone();
    equalize_histogram_mut(&mut out);
    out
}
Equalises the histogram of an 8bpp grayscale image. See also
[histogram equalization (wikipedia)](https://en.wikipedia.org/wiki/Histogram_equalization).
src/contrast.rs