histogram_equalization 0.2.4

Histogram equalization
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

use yuv::{
    bgra_to_ycgco444, rgb_to_ycgco444, rgba_to_ycgco444, ycgco444_alpha_to_bgra,
    ycgco444_alpha_to_rgba,
};

use crate::clahe_declarations_yuv::ycgco444_skip_alpha_to_rgb;
use crate::hist_equal_yuv_impl::equalize_histogram_yuv_impl;

/// Converts image to YUV, performs histogram equalization and reverts back into RGB.
///
/// For optimization purposes YUV histogram bins always 256
///
/// # Arguments
///
/// # Panics
///
/// This function panics if the lengths of the planes or the input data are not valid based
/// on the specified width, height, and strides
pub fn hist_equal_yuv_rgb(
    src: &[u8],
    src_stride: u32,
    dst: &mut [u8],
    dst_stride: u32,
    width: u32,
    height: u32,
) {
    equalize_histogram_yuv_impl::<3>(
        src,
        src_stride,
        dst,
        dst_stride,
        width,
        height,
        rgb_to_ycgco444,
        ycgco444_skip_alpha_to_rgb,
    );
}

/// Converts image to YUV, performs histogram equalization and reverts back into RGBA
///
/// For optimization purposes YUV histogram bins always 256
///
/// # Arguments
///
/// # Panics
///
/// This function panics if the lengths of the planes or the input data are not valid based
/// on the specified width, height, and strides
pub fn hist_equal_yuv_rgba(
    src: &[u8],
    src_stride: u32,
    dst: &mut [u8],
    dst_stride: u32,
    width: u32,
    height: u32,
) {
    equalize_histogram_yuv_impl::<4>(
        src,
        src_stride,
        dst,
        dst_stride,
        width,
        height,
        rgba_to_ycgco444,
        ycgco444_alpha_to_rgba,
    );
}

/// Converts image to YUV, performs histogram equalization and reverts back into BGRA
///
/// For optimization purposes YUV histogram bins always 256
///
/// # Arguments
///
/// # Panics
///
/// This function panics if the lengths of the planes or the input data are not valid based
/// on the specified width, height, and strides
pub fn hist_equal_yuv_bgra(
    src: &[u8],
    src_stride: u32,
    dst: &mut [u8],
    dst_stride: u32,
    width: u32,
    height: u32,
) {
    equalize_histogram_yuv_impl::<4>(
        src,
        src_stride,
        dst,
        dst_stride,
        width,
        height,
        bgra_to_ycgco444,
        ycgco444_alpha_to_bgra,
    );
}