Struct Style 

pub struct Style {
    font_family: Option<FontFamily<Font>>,
    font_size: Option<u8>,
    line_spacing: Option<f32>,
    color: Option<Color>,
    is_bold: bool,
    is_italic: bool,
    font_override: Option<FontFamily<Font>>,
}

A style annotation for a string.

The annotation consists of:

• a font family, see FontFamily (defaults to the FontCache default)
• a font size in points (defaults to 12)
• a line spacing factor, with 1 meaning single line spacing (defaults to 1)
• an outline color, see Color (defaults to black)
• a combination of text effects, see Effect (defaults to none)

All properties are optional. If they are not set, they can be inferred from parent styles or from the defaults.

Fields

font_family: Option<FontFamily<Font>>

font_size: Option<u8>

line_spacing: Option<f32>

color: Option<Color>

is_bold: bool

is_italic: bool

font_override: Option<FontFamily<Font>>

Optional font override for special rendering contexts (e.g., code blocks in monospace). This is used to render specific text with a different font than the document default.

Implementations

impl Style

pub fn new() -> Style

Creates a new style without settings.

Examples

use genpdfi_extended::style::Style;
let s = Style::new();
assert_eq!(s.font_size(), 12);
assert!(!s.is_bold());

pub fn merge(&mut self, style: impl Into<Style>)

Merges the given style into this style.

pub fn and(self, style: impl Into<Style>) -> Style

Combines this style and the given style and returns the result.

Examples

use genpdfi_extended::style::Style;
let a = Style::new().bold();
let b = Style::new().with_font_size(18);
let c = a.and(b);
assert!(c.is_bold());
assert_eq!(c.font_size(), 18);

pub fn combine(left: impl Into<Style>, right: impl Into<Style>) -> Style

Creates a new style by combining the given styles.

pub fn color(&self) -> Option<Color>

Returns the outline color for this style, if set.

pub fn is_bold(&self) -> bool

Returns whether the bold text effect is set.

pub fn is_italic(&self) -> bool

Returns whether the italic text effect is set.

pub fn font_size(&self) -> u8

Returns the font size for this style in points, or 12 if no font size is set.

pub fn line_spacing(&self) -> f32

Returns the line spacing factor for this style, or 1 if no line spacing factor is set.

pub fn set_bold(&mut self)

Sets the bold effect for this style.

pub fn bold(self) -> Style

Sets the bold effect for this style and returns it.

Examples

use genpdfi_extended::style::Style;
let s = Style::new().bold();
assert!(s.is_bold());
let s2 = s.italic();
assert!(s2.is_italic());

pub fn set_italic(&mut self)

Sets the italic effect for this style.

pub fn italic(self) -> Style

Sets the italic effect for this style and returns it.

pub fn set_font_family(&mut self, font_family: FontFamily<Font>)

Sets the font family for this style.

pub fn with_font_family(self, font_family: FontFamily<Font>) -> Style

Sets the font family for this style and returns it.

Examples

use genpdfi_extended::style::Style;
use genpdfi_extended::fonts::{FontData, FontFamily, FontCache};
let data = include_bytes!(concat!(env!("CARGO_MANIFEST_DIR"), "/fonts/NotoSans-Regular.ttf")).to_vec();
let fd = FontData::new(data.clone(), None).expect("font data");
let family_data = FontFamily { regular: fd.clone(), bold: fd.clone(), italic: fd.clone(), bold_italic: fd.clone() };
let mut cache = FontCache::new(family_data);
let family = cache.default_font_family();
let s = Style::new().with_font_family(family);

pub fn set_line_spacing(&mut self, line_spacing: f32)

Sets the line spacing factor for this style.

pub fn with_line_spacing(self, line_spacing: f32) -> Style

Sets the line spacing factor for this style and returns it.

Examples

use genpdfi_extended::style::Style;
let s = Style::new().with_line_spacing(1.5);
assert!((s.line_spacing() - 1.5).abs() < f32::EPSILON);

pub fn set_font_size(&mut self, font_size: u8)

Sets the font size in points for this style.

pub fn with_font_size(self, font_size: u8) -> Style

Sets the font size in points for this style and returns it.

Examples

use genpdfi_extended::style::Style;
let s = Style::new().with_font_size(18);
assert_eq!(s.font_size(), 18);

pub fn set_color(&mut self, color: Color)

Sets the outline color for this style.

pub fn with_color(self, color: Color) -> Self

Sets the outline color for this style and returns it.

pub fn set_font_override(&mut self, font_override: FontFamily<Font>)

Sets the font override for this style.

pub fn with_font_override(self, font_override: FontFamily<Font>) -> Style

Sets the font override for this style and returns it.

pub fn font_override(&self) -> Option<FontFamily<Font>>

Returns the font override for this style, if set.

pub fn char_width(&self, font_cache: &FontCache, c: char) -> Mm

Calculates the width of the given character with this style using the data in the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn char_left_side_bearing(&self, font_cache: &FontCache, c: char) -> Mm

Returns the width of the empty space between the origin of the glyph bounding box and the leftmost edge of the character, for this style using the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn str_width(&self, font_cache: &FontCache, s: &str) -> Mm

Calculates the width of the given string with this style using the data in the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn font_family(&self, font_cache: &FontCache) -> FontFamily<Font>

Returns the font family for this style or the default font family using the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn font(&self, font_cache: &FontCache) -> Font

Returns the font for this style using the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn line_height(&self, font_cache: &FontCache) -> Mm

Calculates the line height for strings with this style using the data in the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn metrics(&self, font_cache: &FontCache) -> Metrics

Calculate the metrics of the font for this style using the data in the given font cache.

If the font family is set, it must have been created by the given FontCache.

pub fn text_width(&self, font_cache: &FontCache, s: &str) -> Mm

Calculate the width of the given string with this style using the data in the given font cache.

If the font family is set, it must have been created by the given FontCache.

Example

use genpdfi_extended::style::Style;
use genpdfi_extended::fonts::{FontData, FontFamily, FontCache};
let data = include_bytes!(concat!(env!("CARGO_MANIFEST_DIR"), "/fonts/NotoSans-Regular.ttf")).to_vec();
let fd = FontData::new(data, None).expect("font data");
let family = FontFamily { regular: fd.clone(), bold: fd.clone(), italic: fd.clone(), bold_italic: fd.clone() };
let cache = FontCache::new(family);
let style = Style::new().with_font_family(cache.default_font_family());
let w = style.text_width(&cache, "abc");
use genpdfi_extended::Mm;
assert!(w > Mm::from(0.0));

Trait Implementations

impl Clone for Style

fn clone(&self) -> Style

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Style

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Style

fn default() -> Style

Returns the “default value” for a type.

impl<T: Into<Style>> Extend<T> for Style

fn extend<I: IntoIterator<Item = T>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl From<Color> for Style

fn from(color: Color) -> Style

Converts to this type from the input type.

impl From<Effect> for Style

fn from(effect: Effect) -> Style

Converts to this type from the input type.

impl From<FontFamily<Font>> for Style

fn from(font_family: FontFamily<Font>) -> Style

Converts to this type from the input type.

impl<T: Into<Style>> FromIterator<T> for Style

fn from_iter<I: IntoIterator<Item = T>>(iter: I) -> Style

Creates a value from an iterator.

impl PartialEq for Style

fn eq(&self, other: &Style) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Style

impl StructuralPartialEq for Style