font_loader/lib.rs
1// The MIT License (MIT)
2// Copyright (c) 2016 font-loader Developers
3//
4// Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
5// associated documentation files (the "Software"), to deal in the Software without restriction,
6// including without limitation the rights to use, copy, modify, merge, publish, distribute,
7// sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
8// furnished to do so, subject to the following conditions:
9//
10// The above copyright notice and this permission notice shall be included in all copies or
11// substantial portions of the Software.
12//
13// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
14// NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
15// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
16// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
17// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
19//! # Font-Loader
20//! A font loading utility written in and for Rust.
21//!
22//! Currently supported platforms:
23//!
24//! * Windows
25//! * Mac
26//! * *nix systems
27//!
28//! # Usage
29//! ## Linux, Unix:
30//! Fontconfig is required on Linux and Unix, as it is the default Fontmanagement utility on these
31//! platforms.
32//!
33//! ```shell
34//! sudo apt-get install libfontconfig libfontconfig1-dev
35//! ```
36//!
37//! # Example
38//! ## Cargo.toml
39//! ```toml
40//! [dependencies]
41//! font-loader = "https://github.com/matprec/rust-font-loader"
42//! ```
43//!
44//! ## main.rs:
45//! ```rust
46//! extern crate font_loader as fonts;
47//!
48//! use fonts::system_fonts;
49//!
50//! fn main() {
51//! // Enumerate all fonts
52//! let sysfonts = system_fonts::query_all();
53//! for string in &sysfonts {
54//! println!("{}", string);
55//! }
56//!
57//! let mut property = system_fonts::FontPropertyBuilder::new().monospace().build();
58//! let sysfonts = system_fonts::query_specific(&mut property);
59//! for string in &sysfonts {
60//! println!("Monospaced font: {}", string);
61//! }
62//!
63//! let property = system_fonts::FontPropertyBuilder::new().family("Arial").build();
64//! let (font, _) = system_fonts::get(&property).unwrap();
65//! println!("{:?}", &font[..50]);
66//! }
67//! ```
68
69
70extern crate libc;
71
72#[cfg(target_os = "windows")]
73extern crate winapi;
74
75#[cfg(target_os = "windows")]
76mod win32;
77#[cfg(target_os = "windows")]
78pub use win32::*;
79
80#[cfg(target_os = "macos")]
81extern crate core_text;
82#[cfg(target_os = "macos")]
83extern crate core_foundation;
84#[cfg(target_os = "macos")]
85mod macos;
86#[cfg(target_os = "macos")]
87pub use macos::*;
88
89#[cfg(all(unix, not(target_os = "macos")))]
90extern crate fontconfig as servo_fontconfig;
91#[cfg(all(unix, not(target_os = "macos")))]
92mod fontconfig;
93#[cfg(all(unix, not(target_os = "macos")))]
94pub use fontconfig::*;