dwrote 0.11.5

Lightweight binding to DirectWrite.
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

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

use std::cell::UnsafeCell;
use std::ptr;
use winapi::um::dwrite::IDWriteLocalizedStrings;
use winapi::um::dwrite::{IDWriteFont, IDWriteFontCollection, IDWriteFontFamily};
use wio::com::ComPtr;

use super::*;
use helpers::*;

pub struct FontFamily {
    native: UnsafeCell<ComPtr<IDWriteFontFamily>>,
}

impl FontFamily {
    pub fn take(native: ComPtr<IDWriteFontFamily>) -> FontFamily {
        FontFamily {
            native: UnsafeCell::new(native),
        }
    }

    pub unsafe fn as_ptr(&self) -> *mut IDWriteFontFamily {
        (*self.native.get()).as_raw()
    }

    #[deprecated(note = "Use `family_name` instead.")]
    pub fn name(&self) -> String {
        self.family_name().unwrap()
    }

    pub fn family_name(&self) -> Result<String, HRESULT> {
        let mut family_names: *mut IDWriteLocalizedStrings = ptr::null_mut();
        unsafe {
            let hr = (*self.native.get()).GetFamilyNames(&mut family_names);
            if hr != 0 {
                return Err(hr);
            }
            Ok(get_locale_string(&mut ComPtr::from_raw(family_names)))
        }
    }

    #[deprecated(note = "Use `first_matching_font` instead.")]
    pub fn get_first_matching_font(
        &self,
        weight: FontWeight,
        stretch: FontStretch,
        style: FontStyle,
    ) -> Font {
        self.first_matching_font(weight, stretch, style).unwrap()
    }

    pub fn first_matching_font(
        &self,
        weight: FontWeight,
        stretch: FontStretch,
        style: FontStyle,
    ) -> Result<Font, HRESULT> {
        let mut font: *mut IDWriteFont = ptr::null_mut();
        unsafe {
            let hr = (*self.native.get()).GetFirstMatchingFont(
                weight.t(),
                stretch.t(),
                style.t(),
                &mut font,
            );
            if hr != 0 {
                return Err(hr);
            }
            Ok(Font::take(ComPtr::from_raw(font)))
        }
    }

    #[deprecated(note = "Use `font_collection` instead.")]
    pub fn get_font_collection(&self) -> FontCollection {
        self.font_collection().unwrap()
    }

    pub fn font_collection(&self) -> Result<FontCollection, HRESULT> {
        let mut collection: *mut IDWriteFontCollection = ptr::null_mut();
        unsafe {
            let hr = (*self.native.get()).GetFontCollection(&mut collection);
            if hr != 0 {
                return Err(hr);
            }
            Ok(FontCollection::take(ComPtr::from_raw(collection)))
        }
    }

    pub fn get_font_count(&self) -> u32 {
        unsafe { (*self.native.get()).GetFontCount() }
    }

    #[deprecated(note = "Use `font` instead.")]
    pub fn get_font(&self, index: u32) -> Font {
        self.font(index).unwrap()
    }

    pub fn font(&self, index: u32) -> Result<Font, HRESULT> {
        let mut font: *mut IDWriteFont = ptr::null_mut();
        unsafe {
            let hr = (*self.native.get()).GetFont(index, &mut font);
            if hr != 0 {
                return Err(hr);
            }
            Ok(Font::take(ComPtr::from_raw(font)))
        }
    }
}