esoc-gfx 0.1.0

Low-level 2D vector graphics engine — SVG-first, zero deps by default
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

// SPDX-License-Identifier: MIT OR Apache-2.0
//! # esoc-gfx
//!
//! Low-level 2D vector graphics engine for esoc-chart.
//! SVG output with zero dependencies; optional PNG via resvg.

#![warn(missing_docs)]
#![deny(unsafe_code)]
#![allow(clippy::format_push_string)]

#[allow(deprecated)]
pub mod backend;
pub mod canvas;
pub mod color;
#[allow(deprecated)]
pub mod element;
pub mod error;
pub mod geom;
pub mod layer;
#[allow(deprecated)]
pub mod palette;
pub mod path;
pub mod scene_svg;
#[allow(deprecated)]
pub mod style;
pub mod text;
pub mod transform;

/// Build resvg/usvg options with system fonts loaded.
#[cfg(feature = "png")]
pub(crate) fn usvg_options_with_fonts() -> resvg::usvg::Options<'static> {
    let mut opt = resvg::usvg::Options::default();
    let fontdb = opt.fontdb_mut();
    fontdb.load_system_fonts();
    opt
}

/// Convenience re-exports.
pub mod prelude {
    pub use crate::backend::svg::{render_svg, save_svg, SvgBackend};
    pub use crate::backend::RenderBackend;
    pub use crate::canvas::Canvas;
    #[allow(deprecated)]
    pub use crate::color::Color;
    pub use crate::element::{DrawElement, Element};
    pub use crate::error::{GfxError, Result};
    pub use crate::geom::{Point, Rect, Size};
    pub use crate::layer::Layer;
    pub use crate::palette::Palette;
    pub use crate::path::PathBuilder;
    pub use crate::style::{DashPattern, Fill, FontStyle, Stroke, TextAnchor};
    pub use crate::text::{HeuristicTextMeasurer, TextMeasurer};
    pub use crate::transform::{AxisTransform, CoordinateTransform, ViewportTransform};

    #[cfg(feature = "png")]
    pub use crate::backend::png::{save_png, PngBackend};
}