skia_safe/modules/paragraph/
paragraph_style.rs

1use std::fmt;
2
3use skia_bindings as sb;
4
5use super::{FontFamilies, TextAlign, TextDirection, TextStyle};
6use crate::{
7    interop::{self, AsStr, FromStrs, SetStr},
8    modules::paragraph::TextHeightBehavior,
9    prelude::*,
10    scalar, FontStyle,
11};
12
13pub type StrutStyle = Handle<sb::skia_textlayout_StrutStyle>;
14unsafe_send_sync!(StrutStyle);
15
16impl NativeDrop for sb::skia_textlayout_StrutStyle {
17    fn drop(&mut self) {
18        unsafe { sb::C_StrutStyle_destruct(self) }
19    }
20}
21
22impl NativeClone for sb::skia_textlayout_StrutStyle {
23    fn clone(&self) -> Self {
24        construct(|ss| unsafe { sb::C_StrutStyle_CopyConstruct(ss, self) })
25    }
26}
27
28impl NativePartialEq for sb::skia_textlayout_StrutStyle {
29    fn eq(&self, rhs: &Self) -> bool {
30        unsafe { sb::C_StrutStyle_equals(self, rhs) }
31    }
32}
33
34impl Default for StrutStyle {
35    fn default() -> Self {
36        Self::new()
37    }
38}
39
40impl fmt::Debug for StrutStyle {
41    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
42        f.debug_struct("StrutStyle")
43            .field("font_families", &self.font_families())
44            .field("font_style", &self.font_style())
45            .field("font_size", &self.font_size())
46            .field("height", &self.height())
47            .field("leading", &self.leading())
48            .field("strut_enabled", &self.strut_enabled())
49            .field("force_strut_height", &self.force_strut_height())
50            .field("height_override", &self.height_override())
51            .field("half_leading", &self.half_leading())
52            .finish()
53    }
54}
55
56impl StrutStyle {
57    pub fn new() -> Self {
58        StrutStyle::construct(|ss| unsafe { sb::C_StrutStyle_Construct(ss) })
59    }
60
61    pub fn font_families(&self) -> FontFamilies {
62        unsafe {
63            let mut count = 0;
64            let ptr = sb::C_StrutStyle_getFontFamilies(self.native(), &mut count);
65            FontFamilies(safer::from_raw_parts(ptr, count))
66        }
67    }
68
69    pub fn set_font_families(&mut self, families: &[impl AsRef<str>]) -> &mut Self {
70        let families: Vec<interop::String> = FromStrs::from_strs(families);
71        let families = families.native();
72        unsafe {
73            sb::C_StrutStyle_setFontFamilies(self.native_mut(), families.as_ptr(), families.len());
74        }
75        self
76    }
77
78    pub fn font_style(&self) -> FontStyle {
79        FontStyle::from_native_c(self.native().fFontStyle)
80    }
81
82    pub fn set_font_style(&mut self, font_style: FontStyle) -> &mut Self {
83        self.native_mut().fFontStyle = font_style.into_native();
84        self
85    }
86
87    pub fn font_size(&self) -> scalar {
88        self.native().fFontSize
89    }
90
91    pub fn set_font_size(&mut self, font_size: scalar) -> &mut Self {
92        self.native_mut().fFontSize = font_size;
93        self
94    }
95
96    pub fn set_height(&mut self, height: scalar) -> &mut Self {
97        self.native_mut().fHeight = height;
98        self
99    }
100
101    pub fn height(&self) -> scalar {
102        self.native().fHeight
103    }
104
105    pub fn set_leading(&mut self, leading: scalar) -> &mut Self {
106        self.native_mut().fLeading = leading;
107        self
108    }
109
110    pub fn leading(&self) -> scalar {
111        self.native().fLeading
112    }
113
114    pub fn strut_enabled(&self) -> bool {
115        self.native().fEnabled
116    }
117
118    pub fn set_strut_enabled(&mut self, enabled: bool) -> &mut Self {
119        self.native_mut().fEnabled = enabled;
120        self
121    }
122
123    pub fn force_strut_height(&self) -> bool {
124        self.native().fForceHeight
125    }
126
127    pub fn set_force_strut_height(&mut self, force_height: bool) -> &mut Self {
128        self.native_mut().fForceHeight = force_height;
129        self
130    }
131
132    pub fn height_override(&self) -> bool {
133        self.native().fHeightOverride
134    }
135
136    pub fn set_height_override(&mut self, height_override: bool) -> &mut Self {
137        self.native_mut().fHeightOverride = height_override;
138        self
139    }
140
141    pub fn half_leading(&self) -> bool {
142        self.native().fHalfLeading
143    }
144
145    pub fn set_half_leading(&mut self, half_leading: bool) -> &mut Self {
146        self.native_mut().fHalfLeading = half_leading;
147        self
148    }
149}
150
151// Can't use `Handle<>` here, `std::u16string` maintains an interior pointer.
152pub type ParagraphStyle = RefHandle<sb::skia_textlayout_ParagraphStyle>;
153unsafe_send_sync!(ParagraphStyle);
154
155impl NativeDrop for sb::skia_textlayout_ParagraphStyle {
156    fn drop(&mut self) {
157        unsafe { sb::C_ParagraphStyle_delete(self) }
158    }
159}
160
161impl Clone for ParagraphStyle {
162    fn clone(&self) -> Self {
163        Self::from_ptr(unsafe { sb::C_ParagraphStyle_newCopy(self.native()) }).unwrap()
164    }
165}
166
167impl NativePartialEq for sb::skia_textlayout_ParagraphStyle {
168    fn eq(&self, rhs: &Self) -> bool {
169        unsafe { sb::C_ParagraphStyle_Equals(self, rhs) }
170    }
171}
172
173impl Default for ParagraphStyle {
174    fn default() -> Self {
175        Self::new()
176    }
177}
178
179impl fmt::Debug for ParagraphStyle {
180    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
181        f.debug_struct("ParagraphStyle")
182            .field("strut_style", &self.strut_style())
183            .field("text_style", &self.text_style())
184            .field("text_direction", &self.text_direction())
185            .field("text_align", &self.text_align())
186            .field("max_lines", &self.max_lines())
187            .field("ellipsis", &self.ellipsis())
188            .field("height", &self.height())
189            .field("text_height_behavior", &self.text_height_behavior())
190            .field("unlimited_lines", &self.unlimited_lines())
191            .field("ellipsized", &self.ellipsized())
192            .field("effective_align", &self.effective_align())
193            .field("hinting_is_on", &self.hinting_is_on())
194            .field("replace_tab_characters", &self.replace_tab_characters())
195            .field("fake_missing_font_styles", &self.fake_missing_font_styles())
196            .finish()
197    }
198}
199
200impl ParagraphStyle {
201    pub fn new() -> Self {
202        Self::from_ptr(unsafe { sb::C_ParagraphStyle_new() }).unwrap()
203    }
204
205    pub fn strut_style(&self) -> &StrutStyle {
206        StrutStyle::from_native_ref(&self.native().fStrutStyle)
207    }
208
209    pub fn set_strut_style(&mut self, strut_style: StrutStyle) -> &mut Self {
210        self.native_mut().fStrutStyle.replace_with(strut_style);
211        self
212    }
213
214    pub fn text_style(&self) -> &TextStyle {
215        TextStyle::from_native_ref(&self.native().fDefaultTextStyle)
216    }
217
218    pub fn set_text_style(&mut self, text_style: &TextStyle) -> &mut Self {
219        // TODO: implement the assignment operator in C.
220        self.native_mut()
221            .fDefaultTextStyle
222            .replace_with(text_style.clone());
223        self
224    }
225
226    pub fn text_direction(&self) -> TextDirection {
227        self.native().fTextDirection
228    }
229
230    pub fn set_text_direction(&mut self, direction: TextDirection) -> &mut Self {
231        self.native_mut().fTextDirection = direction;
232        self
233    }
234
235    pub fn text_align(&self) -> TextAlign {
236        self.native().fTextAlign
237    }
238
239    pub fn set_text_align(&mut self, align: TextAlign) -> &mut Self {
240        self.native_mut().fTextAlign = align;
241        self
242    }
243
244    pub fn max_lines(&self) -> Option<usize> {
245        match self.native().fLinesLimit {
246            std::usize::MAX => None,
247            lines => Some(lines),
248        }
249    }
250
251    pub fn set_max_lines(&mut self, lines: impl Into<Option<usize>>) -> &mut Self {
252        self.native_mut().fLinesLimit = lines.into().unwrap_or(usize::MAX);
253        self
254    }
255
256    // TODO: Support u16 ellipsis, but why? Doesn't SkString support UTF-8?
257
258    pub fn ellipsis(&self) -> &str {
259        self.native().fEllipsis.as_str()
260    }
261
262    pub fn set_ellipsis(&mut self, ellipsis: impl AsRef<str>) -> &mut Self {
263        self.native_mut().fEllipsis.set_str(ellipsis);
264        self
265    }
266
267    pub fn height(&self) -> scalar {
268        self.native().fHeight
269    }
270
271    pub fn set_height(&mut self, height: scalar) -> &mut Self {
272        self.native_mut().fHeight = height;
273        self
274    }
275
276    pub fn text_height_behavior(&self) -> TextHeightBehavior {
277        self.native().fTextHeightBehavior
278    }
279
280    pub fn set_text_height_behavior(&mut self, v: TextHeightBehavior) -> &mut Self {
281        self.native_mut().fTextHeightBehavior = v;
282        self
283    }
284
285    pub fn unlimited_lines(&self) -> bool {
286        self.max_lines().is_none()
287    }
288
289    pub fn ellipsized(&self) -> bool {
290        unsafe { sb::C_ParagraphStyle_ellipsized(self.native()) }
291    }
292
293    pub fn effective_align(&self) -> TextAlign {
294        unsafe { self.native().effective_align() }
295    }
296
297    pub fn hinting_is_on(&self) -> bool {
298        self.native().fHintingIsOn
299    }
300
301    pub fn turn_hinting_off(&mut self) -> &mut Self {
302        self.native_mut().fHintingIsOn = false;
303        self
304    }
305
306    pub fn fake_missing_font_styles(&self) -> bool {
307        self.native().fFakeMissingFontStyles
308    }
309
310    pub fn set_fake_missing_font_styles(&mut self, value: bool) -> &mut Self {
311        self.native_mut().fFakeMissingFontStyles = value;
312        self
313    }
314
315    pub fn replace_tab_characters(&self) -> bool {
316        self.native().fReplaceTabCharacters
317    }
318
319    pub fn set_replace_tab_characters(&mut self, value: bool) -> &mut Self {
320        self.native_mut().fReplaceTabCharacters = value;
321        self
322    }
323
324    pub fn apply_rounding_hack(&self) -> bool {
325        self.native().fApplyRoundingHack
326    }
327
328    pub fn set_apply_rounding_hack(&mut self, value: bool) -> &mut Self {
329        self.native_mut().fApplyRoundingHack = value;
330        self
331    }
332}
333
334#[cfg(test)]
335mod tests {
336    use super::ParagraphStyle;
337
338    // Regression test for https://github.com/rust-skia/rust-skia/issues/607
339    #[test]
340    fn paragraph_style_supports_equality() {
341        let a = ParagraphStyle::default();
342        let b = ParagraphStyle::default();
343        assert_eq!(a, b)
344    }
345}
skia_safe/modules/paragraph/paragraph_style.rs

skia_safe/modules/paragraph/
paragraph_style.rs
