easyofd-core 0.1.3

Core types, traits, and models for easyofd-rust
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
113
114
115
116
117
118
119
120
121
122
123
124
125

//! 水印和注解支持。

/// 水印配置。支持文本水印和图片水印。
#[derive(Debug, Clone)]
pub struct Watermark {
    /// 水印文本（文本水印）。
    pub text: Option<String>,
    /// 水印图片数据（图片水印）。
    pub image: Option<Vec<u8>>,
    /// 位置 (x, y) mm。
    pub position: (f64, f64),
    /// 文本水印字号。
    pub font_size: f64,
    /// 文本水印字体。
    pub font: String,
    /// 文本颜色 RGB hex。
    pub color: u32,
    /// 透明度 0.0（透明）– 1.0（不透明）。默认 0.3。
    pub opacity: f64,
    /// 旋转角度（度）。默认 45.0（对角线）。
    pub rotation: f64,
    /// 目标页码（1-based）。None = 所有页。
    pub page: Option<usize>,
}

impl Default for Watermark {
    fn default() -> Self {
        Self {
            text: None,
            image: None,
            position: (0.0, 0.0),
            font_size: 24.0,
            font: "SimSun".into(),
            color: 0xCC_CC_CC,
            opacity: 0.3,
            rotation: 45.0,
            page: None,
        }
    }
}

impl Watermark {
    /// 创建文本水印。
    #[must_use]
    pub fn text(content: impl Into<String>) -> Self {
        Self {
            text: Some(content.into()),
            ..Self::default()
        }
    }

    /// 设置位置。
    #[must_use]
    pub fn position(mut self, x: f64, y: f64) -> Self {
        self.position = (x, y);
        self
    }

    /// 设置字号。
    #[must_use]
    pub fn font_size(mut self, size: f64) -> Self {
        self.font_size = size;
        self
    }

    /// 设置透明度。
    #[must_use]
    pub fn opacity(mut self, opacity: f64) -> Self {
        self.opacity = opacity;
        self
    }

    /// 设置旋转角度。
    #[must_use]
    pub fn rotation(mut self, degrees: f64) -> Self {
        self.rotation = degrees;
        self
    }

    /// 设置目标页码。
    #[must_use]
    pub fn page(mut self, page: usize) -> Self {
        self.page = Some(page);
        self
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_watermark_default() {
        let wm = Watermark::default();
        assert!((wm.font_size - 24.0).abs() < f64::EPSILON);
        assert!((wm.opacity - 0.3).abs() < f64::EPSILON);
        assert!((wm.rotation - 45.0).abs() < f64::EPSILON);
        assert!(wm.text.is_none());
        assert!(wm.page.is_none());
    }

    #[test]
    fn test_watermark_text_builder() {
        let wm = Watermark::text("CONFIDENTIAL")
            .position(50.0, 100.0)
            .font_size(36.0)
            .opacity(0.5)
            .rotation(30.0)
            .page(1);
        assert_eq!(wm.text.as_deref(), Some("CONFIDENTIAL"));
        assert_eq!(wm.position, (50.0, 100.0));
        assert!((wm.font_size - 36.0).abs() < f64::EPSILON);
        assert!((wm.opacity - 0.5).abs() < f64::EPSILON);
        assert!((wm.rotation - 30.0).abs() < f64::EPSILON);
        assert_eq!(wm.page, Some(1));
    }

    #[test]
    fn test_watermark_clone_debug() {
        let wm = Watermark::text("test");
        let wm2 = wm.clone();
        assert_eq!(wm2.text, wm.text);
        assert!(format!("{wm:?}").contains("Watermark"));
    }
}