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 usvg_tree::{ImageRendering, ShapeRendering, Size, TextRendering};
use crate::ImageHrefResolver;
/// Processing options.
#[derive(Debug)]
pub struct Options {
/// Directory that will be used during relative paths resolving.
///
/// Expected to be the same as the directory that contains the SVG file,
/// but can be set to any.
///
/// Default: `None`
pub resources_dir: Option<std::path::PathBuf>,
/// Target DPI.
///
/// Impacts units conversion.
///
/// Default: 96.0
pub dpi: f32,
/// A default font family.
///
/// Will be used when no `font-family` attribute is set in the SVG.
///
/// Default: Times New Roman
pub font_family: String,
/// A default font size.
///
/// Will be used when no `font-size` attribute is set in the SVG.
///
/// Default: 12
pub font_size: f32,
/// A list of languages.
///
/// Will be used to resolve a `systemLanguage` conditional attribute.
///
/// Format: en, en-US.
///
/// Default: `[en]`
pub languages: Vec<String>,
/// Specifies the default shape rendering method.
///
/// Will be used when an SVG element's `shape-rendering` property is set to `auto`.
///
/// Default: GeometricPrecision
pub shape_rendering: ShapeRendering,
/// Specifies the default text rendering method.
///
/// Will be used when an SVG element's `text-rendering` property is set to `auto`.
///
/// Default: OptimizeLegibility
pub text_rendering: TextRendering,
/// Specifies the default image rendering method.
///
/// Will be used when an SVG element's `image-rendering` property is set to `auto`.
///
/// Default: OptimizeQuality
pub image_rendering: ImageRendering,
/// Default viewport size to assume if there is no `viewBox` attribute and
/// the `width` or `height` attributes are relative.
///
/// Default: `(100, 100)`
pub default_size: Size,
/// Specifies the way `xlink:href` in `<image>` elements should be handled.
///
/// Default: see type's documentation for details
pub image_href_resolver: ImageHrefResolver,
}
impl Default for Options {
fn default() -> Options {
Options {
resources_dir: None,
dpi: 96.0,
// Default font is user-agent dependent so we can use whichever we like.
font_family: "Times New Roman".to_owned(),
font_size: 12.0,
languages: vec!["en".to_string()],
shape_rendering: ShapeRendering::default(),
text_rendering: TextRendering::default(),
image_rendering: ImageRendering::default(),
default_size: Size::from_wh(100.0, 100.0).unwrap(),
image_href_resolver: ImageHrefResolver::default(),
}
}
}
impl Options {
/// Converts a relative path into absolute relative to the SVG file itself.
///
/// If `Options::resources_dir` is not set, returns itself.
pub fn get_abs_path(&self, rel_path: &std::path::Path) -> std::path::PathBuf {
match self.resources_dir {
Some(ref dir) => dir.join(rel_path),
None => rel_path.into(),
}
}
}