av-scenechange 0.23.0

Estimates frames in a video where a scenecut would be ideal
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

use v_frame::pixel::Pixel;

use crate::{
    data::{
        hadamard::{hadamard4x4, hadamard8x8},
        plane::{Area, PlaneRegion, Rect},
        sad::get_sad,
    },
    math::msb,
};

/// Sum of absolute transformed differences over a block.
/// w and h can be at most 128, the size of the largest block.
/// Use the sum of 4x4 and 8x8 hadamard transforms for the transform, but
/// revert to sad on edges when these transforms do not fit into w and h.
/// 4x4 transforms instead of 8x8 transforms when width or height < 8.
#[cfg_attr(all(asm_x86_64, target_feature = "avx2"), cold)]
#[cfg_attr(asm_neon, cold)]
pub(super) fn get_satd_internal<T: Pixel>(
    plane_org: &PlaneRegion<'_, T>,
    plane_ref: &PlaneRegion<'_, T>,
    w: usize,
    h: usize,
    bit_depth: usize,
) -> u32 {
    assert!(w <= 128 && h <= 128);
    assert!(plane_org.rect().width >= w && plane_org.rect().height >= h);
    assert!(plane_ref.rect().width >= w && plane_ref.rect().height >= h);

    // Size of hadamard transform should be 4x4 or 8x8
    // 4x* and *x4 use 4x4 and all other use 8x8
    let size: usize = w.min(h).min(8);
    let tx2d = if size == 4 { hadamard4x4 } else { hadamard8x8 };

    let mut sum: u64 = 0;

    // Loop over chunks the size of the chosen transform
    for chunk_y in (0..h).step_by(size) {
        let chunk_h = (h - chunk_y).min(size);
        for chunk_x in (0..w).step_by(size) {
            let chunk_w = (w - chunk_x).min(size);
            let chunk_area = Area::Rect(Rect {
                x: chunk_x as isize,
                y: chunk_y as isize,
                width: chunk_w,
                height: chunk_h,
            });
            let chunk_org = plane_org.subregion(chunk_area);
            let chunk_ref = plane_ref.subregion(chunk_area);

            // Revert to sad on edge blocks (frame edges)
            if chunk_w != size || chunk_h != size {
                sum += get_sad(&chunk_org, &chunk_ref, chunk_w, chunk_h, bit_depth) as u64;
                continue;
            }

            let buf: &mut [i32] = &mut [0; 8 * 8][..size * size];

            // Move the difference of the transforms to a buffer
            for (row_diff, (row_org, row_ref)) in buf
                .chunks_mut(size)
                .zip(chunk_org.rows_iter().zip(chunk_ref.rows_iter()))
            {
                for (diff, (a, b)) in row_diff.iter_mut().zip(row_org.iter().zip(row_ref.iter())) {
                    let a = a.to_i32().expect("value should fit in i32");
                    let b = b.to_i32().expect("value should fit in i32");
                    *diff = a - b;
                }
            }

            // Perform the hadamard transform on the differences
            // SAFETY: A sufficient number elements exist for the size of the transform.
            unsafe {
                tx2d(buf);
            }

            // Sum the absolute values of the transformed differences
            sum += buf.iter().map(|a| a.unsigned_abs() as u64).sum::<u64>();
        }
    }

    // Normalize the results
    let ln = msb(size as i32) as u64;
    ((sum + (1 << ln >> 1)) >> ln) as u32
}