xfont 0.4.0

font query.
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198

#![allow(non_upper_case_globals)]
use std::ops::Deref;
use std::ptr;

use super::foundation::*;
use super::graphics_types::*;

pub type CTFontDescriptorRef = CFValueRef;
pub struct CTFontDescriptor(pub CFValue);
impl Deref for CTFontDescriptor {
	type Target = CFValue;
	fn deref(&self) -> &Self::Target {
		&self.0
	}
}
impl From<CTFontDescriptor> for CFValue {
	fn from(value: CTFontDescriptor) -> Self {
		value.0
	}
}
impl CTFontDescriptor {
	pub fn from_attributes(attributes: &CFDictionary) -> CTFontDescriptor {
		unsafe {
			let result: CTFontDescriptorRef = CTFontDescriptorCreateWithAttributes(attributes.as_ref());
			Self(CFValue::create_rule(result))
		}
	}
}

pub type CTFontRef = CFValueRef;
pub struct CTFont(pub CFValue);
impl Deref for CTFont {
	type Target = CFValue;
	fn deref(&self) -> &Self::Target {
		&self.0
	}
}
impl From<CTFont> for CFValue {
	fn from(value: CTFont) -> Self {
		value.0
	}
}
impl CTFont {
	pub fn from_descriptor(desc: &CTFontDescriptor, pt_size: f64) -> Self {
		unsafe {
			let font_ref = CTFontCreateWithFontDescriptor(desc.as_ref(), pt_size as CGFloat, ptr::null());
			Self(CFValue::create_rule(font_ref))
		}
	}
	pub fn ui_for_language(ui_type: CTFontUIFontType, size: CGFloat, language: CFStringRef) -> Self {
		unsafe {
			let font_ref = CTFontCreateUIFontForLanguage(ui_type, size, language);
			Self(CFValue::create_rule(font_ref))
		}
	}
	pub fn for_string(&self, string: CFStringRef, range: CFRange) -> Self {
		unsafe {
			let result = CTFontCreateForString(self.as_ref(), string, range);
			Self(CFValue::create_rule(result))
		}
	}
	pub fn unique_id(&self) -> Option<String> {
		unsafe {
			let value = CTFontCopyName(self.as_ref(), kCTFontUniqueNameKey);
			if value.is_null() {
				return None;
			}
			let s = CFString(CFValue::get_rule(value as CFValueRef));
			Some(s.to_string())
		}
	}
	pub fn family(&self) -> Option<String> {
		unsafe {
			let value = CTFontCopyName(self.as_ref(), kCTFontFamilyNameKey);
			if value.is_null() {
				return None;
			}
			let s = CFString(CFValue::get_rule(value as CFValueRef));
			Some(s.to_string())
		}
	}
	pub fn font_path(&self) -> Option<std::path::PathBuf> {
		unsafe {
			let value = CTFontCopyAttribute(self.as_ref(), kCTFontURLAttribute);
			if value.is_null() {
				return None;
			}
			let url = CFURL(CFValue::get_rule(value as CFValueRef));
			url.to_path()
		}
	}
}

pub const kCTFontClassMaskShift: u32 = 28;
pub type CTFontSymbolicTraits = u32;
pub const kCTFontItalicTrait: CTFontSymbolicTraits = 1 << 0;
pub const kCTFontBoldTrait: CTFontSymbolicTraits = 1 << 1;
pub const kCTFontExpandedTrait: CTFontSymbolicTraits = 1 << 5;
pub const kCTFontCondensedTrait: CTFontSymbolicTraits = 1 << 6;
pub const kCTFontMonoSpaceTrait: CTFontSymbolicTraits = 1 << 10;
pub const kCTFontVerticalTrait: CTFontSymbolicTraits = 1 << 11;
pub const kCTFontUIOptimizedTrait: CTFontSymbolicTraits = 1 << 12;
pub const kCTFontColorGlyphsTrait: CTFontSymbolicTraits = 1 << 13;
pub const kCTFontClassMaskTrait: CTFontSymbolicTraits = 15 << kCTFontClassMaskShift;

pub type CTFontUIFontType = u32;
// kCTFontNoFontType: CTFontUIFontType = -1;
pub const kCTFontUserFontType: CTFontUIFontType = 0;
pub const kCTFontUserFixedPitchFontType: CTFontUIFontType = 1;
pub const kCTFontSystemFontType: CTFontUIFontType = 2;
pub const kCTFontEmphasizedSystemFontType: CTFontUIFontType = 3;
pub const kCTFontSmallSystemFontType: CTFontUIFontType = 4;
pub const kCTFontSmallEmphasizedSystemFontType: CTFontUIFontType = 5;
pub const kCTFontMiniSystemFontType: CTFontUIFontType = 6;
pub const kCTFontMiniEmphasizedSystemFontType: CTFontUIFontType = 7;
pub const kCTFontViewsFontType: CTFontUIFontType = 8;
pub const kCTFontApplicationFontType: CTFontUIFontType = 9;
pub const kCTFontLabelFontType: CTFontUIFontType = 10;
pub const kCTFontMenuTitleFontType: CTFontUIFontType = 11;
pub const kCTFontMenuItemFontType: CTFontUIFontType = 12;
pub const kCTFontMenuItemMarkFontType: CTFontUIFontType = 13;
pub const kCTFontMenuItemCmdKeyFontType: CTFontUIFontType = 14;
pub const kCTFontWindowTitleFontType: CTFontUIFontType = 15;
pub const kCTFontPushButtonFontType: CTFontUIFontType = 16;
pub const kCTFontUtilityWindowTitleFontType: CTFontUIFontType = 17;
pub const kCTFontAlertHeaderFontType: CTFontUIFontType = 18;
pub const kCTFontSystemDetailFontType: CTFontUIFontType = 19;
pub const kCTFontEmphasizedSystemDetailFontType: CTFontUIFontType = 20;
pub const kCTFontToolbarFontType: CTFontUIFontType = 21;
pub const kCTFontSmallToolbarFontType: CTFontUIFontType = 22;
pub const kCTFontMessageFontType: CTFontUIFontType = 23;
pub const kCTFontPaletteFontType: CTFontUIFontType = 24;
pub const kCTFontToolTipFontType: CTFontUIFontType = 25;
pub const kCTFontControlContentFontType: CTFontUIFontType = 26;

#[link(kind = "framework", name = "CoreText")]
extern "C" {
	pub static kCTFontSymbolicTrait: CFStringRef;
	pub static kCTFontWeightTrait: CFStringRef;
	pub static kCTFontWidthTrait: CFStringRef;
	pub static kCTFontSlantTrait: CFStringRef;

	//  CTFontDescriptor.h
	pub static kCTFontURLAttribute: CFStringRef; // value: CFURLRef
	pub static kCTFontNameAttribute: CFStringRef; // value: CFStringRef
	pub static kCTFontDisplayNameAttribute: CFStringRef; // value: CFStringRef
	pub static kCTFontFamilyNameAttribute: CFStringRef; // value: CFStringRef
	pub static kCTFontStyleNameAttribute: CFStringRef; // value: CFStringRef
	pub static kCTFontTraitsAttribute: CFStringRef;
	pub static kCTFontVariationAttribute: CFStringRef;
	pub static kCTFontSizeAttribute: CFStringRef;
	pub static kCTFontMatrixAttribute: CFStringRef;
	pub static kCTFontCascadeListAttribute: CFStringRef;
	pub static kCTFontCharacterSetAttribute: CFStringRef;
	pub static kCTFontLanguagesAttribute: CFStringRef;
	pub static kCTFontBaselineAdjustAttribute: CFStringRef;
	pub static kCTFontMacintoshEncodingsAttribute: CFStringRef;
	pub static kCTFontFeaturesAttribute: CFStringRef;
	pub static kCTFontFeatureSettingsAttribute: CFStringRef;
	pub static kCTFontFixedAdvanceAttribute: CFStringRef;
	pub static kCTFontOrientationAttribute: CFStringRef;
	pub static kCTFontFormatAttribute: CFStringRef;
	pub static kCTFontRegistrationScopeAttribute: CFStringRef;
	pub static kCTFontPriorityAttribute: CFStringRef;
	pub static kCTFontEnabledAttribute: CFStringRef;
	// CTFont.h
	pub static kCTFontCopyrightNameKey: CFStringRef;
	pub static kCTFontFamilyNameKey: CFStringRef;
	pub static kCTFontSubFamilyNameKey: CFStringRef;
	pub static kCTFontStyleNameKey: CFStringRef;
	pub static kCTFontUniqueNameKey: CFStringRef;
	pub static kCTFontFullNameKey: CFStringRef;
	pub static kCTFontVersionNameKey: CFStringRef;
	pub static kCTFontPostScriptNameKey: CFStringRef;
	pub static kCTFontTrademarkNameKey: CFStringRef;
	pub static kCTFontManufacturerNameKey: CFStringRef;
	pub static kCTFontDesignerNameKey: CFStringRef;
	pub static kCTFontDescriptionNameKey: CFStringRef;
	pub static kCTFontVendorURLNameKey: CFStringRef;
	pub static kCTFontDesignerURLNameKey: CFStringRef;
	pub static kCTFontLicenseNameKey: CFStringRef;
	pub static kCTFontLicenseURLNameKey: CFStringRef;
	pub static kCTFontSampleTextNameKey: CFStringRef;
	pub static kCTFontPostScriptCIDNameKey: CFStringRef;

	pub fn CTFontCreateForString(currentFont: CTFontRef, string: CFStringRef, range: CFRange) -> CTFontRef;
	pub fn CTFontCreateWithFontDescriptor(descriptor: CTFontDescriptorRef, size: CGFloat, matrix: *const CGAffineTransform) -> CTFontRef;
	pub fn CTFontCreateUIFontForLanguage(uiType: CTFontUIFontType, size: CGFloat, language: CFStringRef) -> CTFontRef;
	pub fn CTFontCopyFontDescriptor(font: CTFontRef) -> CTFontDescriptorRef;
	pub fn CTFontCopyAttribute(font: CTFontRef, attribute: CFStringRef) -> CFRef;
	pub fn CTFontCopyName(font: CTFontRef, nameKey: CFStringRef) -> CFStringRef;

	pub fn CTFontDescriptorCreateWithAttributes(attributes: CTFontDescriptorRef) -> CTFontDescriptorRef;
	pub fn CTFontDescriptorCopyAttribute(descriptor: CTFontDescriptorRef, attribute: CFStringRef) -> CFRef;

	pub fn CTFontManagerCopyAvailableFontFamilyNames() -> CFArrayRef;
	pub fn CTFontManagerCopyAvailablePostScriptNames() -> CFArrayRef;
}