lyrics-core 0.5.0

Core types, traits, and helpers for lyrics processing
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use crate::models::{LineInfo, LyricsAlignment};

/// 将音节级同步歌词降级为行级同步，递归处理子行。
pub fn downgrade_to_line_synced(lines: &mut [LineInfo]) {
    for line in lines.iter_mut() {
        downgrade_line(line);
    }
}

/// 将单行音节级同步歌词降级为行级同步。
///
/// 已是行级同步的歌词仅递归更新子行；音节为空的异常情况保持原样。
pub fn downgrade_line(line: &mut LineInfo) {
    // 先递归处理子行
    if let Some(sub) = line.sub_line_mut() {
        downgrade_line(sub);
    }

    if !line.is_syllable() {
        return;
    }

    // 取出音节行，按需重建为行级歌词
    let placeholder = LineInfo::Line {
        text: String::new(),
        start_time: None,
        end_time: None,
        alignment: LyricsAlignment::Unspecified,
        sub_line: None,
    };
    let owned = std::mem::replace(line, placeholder);

    let (syllables, start_time, end_time, alignment, sub_line, translations, pronunciation) =
        match owned {
            LineInfo::Syllable {
                syllables,
                start_time,
                end_time,
                alignment,
                sub_line,
            } => (
                syllables, start_time, end_time, alignment, sub_line, None, None,
            ),
            LineInfo::FullSyllable {
                syllables,
                start_time,
                end_time,
                alignment,
                sub_line,
                translations,
                pronunciation,
            } => (
                syllables,
                start_time,
                end_time,
                alignment,
                sub_line,
                Some(translations),
                pronunciation,
            ),
            other => {
                *line = other;
                return;
            }
        };

    if syllables.is_empty() {
        // 没有音节数据的异常情况：保持原样
        *line = match translations {
            Some(translations) => LineInfo::FullSyllable {
                syllables,
                start_time,
                end_time,
                alignment,
                sub_line,
                translations,
                pronunciation,
            },
            None => LineInfo::Syllable {
                syllables,
                start_time,
                end_time,
                alignment,
                sub_line,
            },
        };
        return;
    }

    let text = LineInfo::text_from_syllables(&syllables);
    let start_time = start_time.or_else(|| syllables.first().map(|s| s.start_time()));
    let end_time = end_time.or_else(|| syllables.last().map(|s| s.end_time()));

    *line = match translations {
        Some(translations) => LineInfo::FullLine {
            text,
            start_time,
            end_time,
            alignment,
            sub_line,
            translations,
            pronunciation,
        },
        None => LineInfo::Line {
            text,
            start_time,
            end_time,
            alignment,
            sub_line,
        },
    };
}