🥮 mooncakes.io
    Sign in

    fonts

    Experimental package to manipulate open source font data.

    html5 canvas
    pdf
    svg
    open source
    fonts
    Download zip
    Author
    Version
    0.15.14
    License
    Apache-2.0
    Repository
    Last updated
    last year
    Downloads
    13K

    #gmlewis/moonbit-fonts

    check

    This is an experimental package to manipulate open source fonts with MoonBit.

    All fonts are open source and their licenses can all be found in their corresponding repos which are organized by the first letter of the name of the font:

    • font: https://github.com/gmlewis/mbt-fonts-a/tree/master/aaarghnormal
    • license: https://github.com/gmlewis/go-fonts-a/tree/master/fonts/aaarghnormal
    • ...
    • font: https://github.com/gmlewis/mbt-fonts-b/tree/master/baloo
    • license: https://github.com/gmlewis/go-fonts-b/tree/master/fonts/baloo
    • ...
    • font: https://github.com/gmlewis/mbt-fonts-z/tree/master/znikomitno24
    • license: https://github.com/gmlewis/go-fonts-z/tree/master/fonts/znikomitno24

    #Examples

    #checkerboard

    checkerboard is a simple example to create a draw.Graphic using the @draw API.

    #canvas-checkerboard

    canvas-checkerboard renders the checkerboard Graphic to an HTML5 canvas. Type ./run-canvas-checkerboard.sh in a terminal then open your browser to http://localhost:8080/examples/canvas-checkerboard to view it.

    #svg-checkerboard

    svg-checkerboard "renders" the checkerboard Graphic to an SVG file. Type moon run examples/svg-checkerboard > examples/svg-checkerboard/checkerboard.svg in a terminal then open this file in your browser to view it. For example, google-chrome examples/svg-checkerboard/checkerboard.svg.

    #Status

    The code has been updated to support compiler:

    $ moon version --all
moon 0.1.20250612 (2a026e0 2025-06-12) ~/.moon/bin/moon
moonc v0.1.20250612+600461c34 ~/.moon/bin/moonc
moonrun 0.1.20250612 (2a026e0 2025-06-12) ~/.moon/bin/moonrun

    Enjoy!

    #License

    Please note that all fonts have their own licenses which are included in their respective original directories (see above).

    Copyright 2019-2024 Glenn M. Lewis. All Rights Reserved.

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

    AbsoluteCmd

    source
    pub(all) enum AbsoluteCmd {
      M
      L
      C
      Q
      Z
    }

    AbsoluteCmd represents a supported absolute SVG command.
    impl Eq for AbsoluteCmd
    impl Show for AbsoluteCmd

    Anchor

    source
    pub(all) enum Anchor {
      Unchanged
      TopLeft
      TopCenter
      TopRight
      CenterLeft
      Center
      CenterRight
      BaselineLeft
      BaselineCenter
      BaselineRight
      BottomLeft
      BottomCenter
      BottomRight
      RatioXY(Double, Double)
    }

    Anchor represents where to place the origin (0,0) of the glyph relative to its minimum bounding box.
    impl Eq for Anchor
    impl Show for Anchor

    Cmd

    source
    type Cmd

    Cmd represents an SVG command along with its parameters.
    impl Eq for Cmd
    impl Show for Cmd

    Font

    source
    pub(all) struct Font {
      id : String
      horiz_adv_x : Double
      units_per_em : Double
      ascent : Double
      descent : Double
      glyphs : Map[String, Glyph]
    }

    Font represents an entire font.
    impl Eq for Font
    impl Show for Font
    impl ToJson for Font
    impl FromJson for Font

    Font::gen_path

    source
    fn Font::gen_path(self : Font, text : String, anchor~ : Anchor = .., y_up~ : Bool = ..) -> Glyph raise FontError

    gen_path "renders" the provided text string into an SVG path using the provided font information. It performs the necessary path translations in order to combine the individual glyphs into a "super glyph" that can be rendered as a whole.

    Note that gen_path operates on the string as a left-justified whole and anchors the entire path relative to anchor accordingly.

    If you want multiple lines centered horizontally, use gen_paths instead.

    Note that the SVG standard states that positive-Y is "down" with origin coordinates in the upper-left, however, all SVG fonts appear to have their origin in the lower left with positive-Y moving "up". This package attempts to convert the SVG paths such that the font is equally readable in both the "y_up=false" SVG canvas environment or in a 3D "y_up=true" rendering environment.

    Font::gen_paths

    source
    fn Font::gen_paths(self : Font, lines : Array[String], anchor~ : Anchor = .., y_up~ : Bool = ..) -> Array[Glyph] raise FontError

    gen_paths handles multiple strings independently so that they can be aligned and distributed more flexibly.

    FontError

    source
    pub(all) type! FontError String

    impl Eq for FontError
    impl Show for FontError

    GerberLP

    source
    pub(all) enum GerberLP {
      Dark
      Clear
    }

    GerberLP represents whether a subpath is Dark or Clear.
    impl Eq for GerberLP
    impl Show for GerberLP

    Glyph

    source
    pub(all) struct Glyph {
      char : String
      horiz_adv_x : Double
      gerber_lp : String
      d : String
      xmin : Double
      ymin : Double
      xmax : Double
      ymax : Double
    }

    Glyph represents a single glyph within each Font and also represents multiple glyphs combined together (for example after using Font.gen_path and switching back and forth between Glyphs which are optimized for storage, and Paths which are optimized for processing).
    impl Eq for Glyph
    impl Show for Glyph
    impl ToJson for Glyph
    impl FromJson for Glyph

    ParamPair

    source
    pub(all) struct ParamPair {
      x : Double
      y : Double
    }

    ParamPair represents an X,Y absolute coordinate pair of parameters.
    impl Eq for ParamPair

    ParamPair::to_string

    source
    fn ParamPair::to_string(self : ParamPair) -> String

    Params

    source
    type Params

    Params represents the parameters to an SVG command.
    impl Eq for Params
    impl Show for Params

    Params::length

    source
    fn Params::length(self : Params) -> Int

    Path

    source
    pub(all) struct Path {
      char : String
      cmds : Array[PathCmd]
      xmin : Double
      ymin : Double
      xmax : Double
      ymax : Double
    }

    A Path is identical to a Glyph but has been optimized internally for further manipulation, whereas a Glyph is optimized for compact storage of font data within all the font packages. A Path can be converted to a Glpyh and vice versa.
    impl Eq for Path
    impl Show for Path

    Path::clone

    source
    fn Path::clone(self : Path) -> Path

    clone makes a deep copy of a Path.

    Path::from_glyph

    source
    fn Path::from_glyph(g : Glyph, path_cmd_fn? : PathCmdFn) -> Path raise FontError

    from_glyph returns a Path from a Glyph, optionally processing every Cmd with a processing function. Note that apart from path_cmd_fn, from_glyph makes no attempt to process the invidual glyphs and simply transforms the representation.

    Path::to_glyph

    source
    fn Path::to_glyph(self : Path, path_cmd_fn? : PathCmdFn) -> Glyph

    to_glyph returns a "super" Glyph from a Path, optionally processing every PathCmd with a processing function. Note that apart from path_cmd_fn, to_glyph makes no attempt to process the invidual glyphs and simply transforms the representation.

    PathCmd

    source
    pub(all) struct PathCmd {
      cmd : AbsoluteCmd
      gerber_lp : GerberLP
      params : Array[ParamPair]
    }

    Cmd represents an individual absolute SVG command.
    impl Eq for PathCmd
    impl Show for PathCmd

    PathCmd::bbox

    source
    fn PathCmd::bbox(self : PathCmd) -> Rectangle

    bbox returns the minimum bounding box of a PathCmd.

    PathCmd::clone

    source
    fn PathCmd::clone(self : PathCmd) -> PathCmd

    clone makes a deep copy of a PatchCmd.

    PathCmd::from_svg_cmd

    source
    fn PathCmd::from_svg_cmd(svg_cmd : Cmd, gerber_lp : GerberLP) -> PathCmd raise FontError

    PathCmd::to_svg_cmd

    source
    fn PathCmd::to_svg_cmd(self : PathCmd) -> (Cmd, String)

    PathCmdFn

    source
    pub(all) type PathCmdFn (Int, PathCmd) -> PathCmd

    PathCmdFn represents a function that processes or transforms individual commands. The first argument is the index within the command.

    Point

    source
    pub(all) struct Point {
      x : Double
      y : Double
    }

    impl Eq for Point
    impl Show for Point

    Point::div

    source
    fn Point::div(self : Point, k : Double) -> Point

    div returns the vector p/k.

    Point::is_in

    source
    fn Point::is_in(self : Point, r : Rectangle) -> Bool

    is_in reports whether p is in r.

    Point::mul

    source
    fn Point::mul(self : Point, k : Double) -> Point

    mul returns the vector p*k.

    Point::op_add

    source
    fn Point::op_add(self : Point, q : Point) -> Point

    op_add (+) returns the vector p+q.

    Point::op_equal

    source
    fn Point::op_equal(self : Point, q : Point) -> Bool

    op_equal reports whether p and q are equal.

    Point::op_sub

    source
    fn Point::op_sub(self : Point, q : Point) -> Point

    op_sub (-) returns the vector p-q.

    Point::to_string

    source
    fn Point::to_string(self : Point) -> String

    to_string returns a string representation of p like "(3,4)".

    Rectangle

    source
    pub(all) struct Rectangle {
      min : Point
      max : Point
    }

    A Rectangle contains the points with Min.X <= X < Max.X, Min.Y <= Y < Max.Y. It is well-formed if Min.X <= Max.X and likewise for Y. Points are always well-formed. A rectangle's methods always return well-formed outputs for well-formed inputs.

    A Rectangle is also an [Image] whose bounds are the rectangle itself. At returns color.Opaque for points in the rectangle and color.Transparent otherwise.
    impl Eq for Rectangle
    impl Show for Rectangle

    Rectangle::add

    source
    fn Rectangle::add(self : Rectangle, p : Point) -> Rectangle

    add returns the rectangle r translated by p.

    Rectangle::bounds

    source
    fn Rectangle::bounds(self : Rectangle) -> (Double, Double, Double, Double)

    bounds returns the tuple (xmin, ymin, xmax, ymax).

    Rectangle::canon

    source
    fn Rectangle::canon(self : Rectangle) -> Rectangle

    canon returns the canonical version of r. The returned rectangle has minimum and maximum coordinates swapped if necessary so that it is well-formed.

    Rectangle::clone

    source
    fn Rectangle::clone(self : Rectangle) -> Rectangle

    clone makes a copy of the provided rectangle without changing it.

    Rectangle::dx

    source
    fn Rectangle::dx(self : Rectangle) -> Double

    dx returns r's width.

    Rectangle::dy

    source
    fn Rectangle::dy(self : Rectangle) -> Double

    dy returns r's height.

    Rectangle::empty

    source
    fn Rectangle::empty(self : Rectangle) -> Bool

    empty reports whether the rectangle contains no points.

    Rectangle::extend

    source
    fn Rectangle::extend(self : Rectangle, pt : Point) -> Unit

    extend extends the current rectangle to include the provided point.

    Rectangle::inset

    source
    fn Rectangle::inset(self : Rectangle, n : Double) -> Rectangle

    inset returns the rectangle r inset by n, which may be negative. If either of r's dimensions is less than 2*n then an empty rectangle near the center of r will be returned.

    Rectangle::intersect

    source
    fn Rectangle::intersect(self : Rectangle, s : Rectangle) -> Rectangle

    intersect returns the largest rectangle contained by both r and s. If the two rectangles do not overlap then the zero rectangle will be returned.

    Rectangle::is_in

    source
    fn Rectangle::is_in(self : Rectangle, s : Rectangle) -> Bool

    is_in reports whether every point in r is in s.

    Rectangle::new

    source
    fn Rectangle::new() -> Rectangle

    Rectangle::new returns an empty (all zeros) rectangle.

    Rectangle::op_equal

    source
    fn Rectangle::op_equal(self : Rectangle, s : Rectangle) -> Bool

    op_equal reports whether r and s contain the same set of points. All empty rectangles are considered equal.

    Rectangle::overlaps

    source
    fn Rectangle::overlaps(self : Rectangle, s : Rectangle) -> Bool

    overlaps reports whether r and s have a non-empty intersection.

    Rectangle::size

    source
    fn Rectangle::size(self : Rectangle) -> Point

    size returns r's width and height.

    Rectangle::sub

    source
    fn Rectangle::sub(self : Rectangle, p : Point) -> Rectangle

    sub returns the rectangle r translated by -p.

    Rectangle::to_string

    source
    fn Rectangle::to_string(self : Rectangle) -> String

    to_string returns a string representation of r like "(3,4)-(6,5)".

    Rectangle::union

    source
    fn Rectangle::union(self : Rectangle, s : Rectangle) -> Rectangle

    union returns the smallest rectangle that contains both r and s.

    add

    source
    fn add(self : Rectangle, p : Point) -> Rectangle

    add returns the rectangle r translated by p.

    all_fonts

    source
    let all_fonts : Array[String]

    bbox

    source
    fn bbox(self : PathCmd) -> Rectangle

    bbox returns the minimum bounding box of a PathCmd.

    bounds

    source
    fn bounds(self : Rectangle) -> (Double, Double, Double, Double)

    bounds returns the tuple (xmin, ymin, xmax, ymax).

    canon

    source
    fn canon(self : Rectangle) -> Rectangle

    canon returns the canonical version of r. The returned rectangle has minimum and maximum coordinates swapped if necessary so that it is well-formed.

    clone

    source
    fn clone(self : Rectangle) -> Rectangle

    clone makes a copy of the provided rectangle without changing it.

    div

    source
    fn div(self : Point, k : Double) -> Point

    div returns the vector p/k.
    fn dx(self : Rectangle) -> Double

    dx returns r's width.
    fn dy(self : Rectangle) -> Double

    dy returns r's height.

    empty

    source
    fn empty(self : Rectangle) -> Bool

    empty reports whether the rectangle contains no points.

    extend

    source
    fn extend(self : Rectangle, pt : Point) -> Unit

    extend extends the current rectangle to include the provided point.

    gen_path

    source
    fn gen_path(self : Font, text : String, anchor~ : Anchor = .., y_up~ : Bool = ..) -> Glyph raise FontError

    gen_path "renders" the provided text string into an SVG path using the provided font information. It performs the necessary path translations in order to combine the individual glyphs into a "super glyph" that can be rendered as a whole.

    Note that gen_path operates on the string as a left-justified whole and anchors the entire path relative to anchor accordingly.

    If you want multiple lines centered horizontally, use gen_paths instead.

    Note that the SVG standard states that positive-Y is "down" with origin coordinates in the upper-left, however, all SVG fonts appear to have their origin in the lower left with positive-Y moving "up". This package attempts to convert the SVG paths such that the font is equally readable in both the "y_up=false" SVG canvas environment or in a 3D "y_up=true" rendering environment.

    gen_paths

    source
    fn gen_paths(self : Font, lines : Array[String], anchor~ : Anchor = .., y_up~ : Bool = ..) -> Array[Glyph] raise FontError

    gen_paths handles multiple strings independently so that they can be aligned and distributed more flexibly.

    glyph_bbox

    source
    fn glyph_bbox(d : String) -> Rectangle raise FontError

    glyph_bbox returns the conservative bounding box of a Glyph path. It only supports the absolute SVG commands: M, L, C, Q, Z.

    Note that this function does NOT fully analyze the Cubic or Quadratic Bézier curves to determine their exact bounding boxes, but instead takes a naive and concervative approach by encapsulating the bounds of all control points in addition to curve anchor points which may result in returning a much larger bounding box than is actually needed to fully contain the glyph.

    inset

    source
    fn inset(self : Rectangle, n : Double) -> Rectangle

    inset returns the rectangle r inset by n, which may be negative. If either of r's dimensions is less than 2*n then an empty rectangle near the center of r will be returned.

    intersect

    source
    fn intersect(self : Rectangle, s : Rectangle) -> Rectangle

    intersect returns the largest rectangle contained by both r and s. If the two rectangles do not overlap then the zero rectangle will be returned.

    is_in

    source
    fn is_in(self : Point, r : Rectangle) -> Bool

    is_in reports whether p is in r.

    length

    source
    fn length(self : Params) -> Int

    mul

    source
    fn mul(self : Point, k : Double) -> Point

    mul returns the vector p*k.

    op_add

    source
    fn op_add(self : Point, q : Point) -> Point

    op_add (+) returns the vector p+q.

    op_equal

    source
    fn op_equal(self : Point, q : Point) -> Bool

    op_equal reports whether p and q are equal.

    op_sub

    source
    fn op_sub(self : Point, q : Point) -> Point

    op_sub (-) returns the vector p-q.

    overlaps

    source
    fn overlaps(self : Rectangle, s : Rectangle) -> Bool

    overlaps reports whether r and s have a non-empty intersection.
    fn pt(x : Double, y : Double) -> Point

    pt is shorthand for [Point]{X, Y}.

    rect

    source
    fn rect(x0 : Double, y0 : Double, x1 : Double, y1 : Double) -> Rectangle

    rect is shorthand for Rectangle::{min: pt(x0, y0), max: pt(x1, y1)}. The returned rectangle has minimum and maximum coordinates swapped if necessary so that it is well-formed.

    size

    source
    fn size(self : Rectangle) -> Point

    size returns r's width and height.

    sub

    source
    fn sub(self : Rectangle, p : Point) -> Rectangle

    sub returns the rectangle r translated by -p.

    to_glyph

    source
    fn to_glyph(self : Path, path_cmd_fn? : PathCmdFn) -> Glyph

    to_glyph returns a "super" Glyph from a Path, optionally processing every PathCmd with a processing function. Note that apart from path_cmd_fn, to_glyph makes no attempt to process the invidual glyphs and simply transforms the representation.

    to_string

    source
    fn to_string(self : Point) -> String

    to_string returns a string representation of p like "(3,4)".

    translate_path

    source
    fn translate_path(d : String, x : Double, y : Double, invert_y~ : Bool = ..) -> String raise FontError

    translate_path translates (moves) an SVG path by the provided offsets. If invert_y is true, all y values are scaled by -1.

    union

    source
    fn union(self : Rectangle, s : Rectangle) -> Rectangle

    union returns the smallest rectangle that contains both r and s.

    Source Files

    Powered by MoonBit

    Site sourceReport issuePackagesBuild queueSkillsStatistics

    © 2026 mooncakes.io