https://github.com/teascade/bmfont_parser

Parses .sfl and .fnt bitmap font files, usable in any renderer!
https://github.com/teascade/bmfont_parser

Last synced: 12 months ago
JSON representation

Parses .sfl and .fnt bitmap font files, usable in any renderer!

• Host: GitHub
• URL: https://github.com/teascade/bmfont_parser
• Owner: Teascade
• License: mit
• Created: 2019-01-14T16:55:47.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2019-01-16T21:35:01.000Z (over 7 years ago)
• Last Synced: 2025-03-14T04:29:38.592Z (over 1 year ago)
• Language: Rust
• Size: 110 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-IOSEVKA.md

Awesome Lists containing this project

README

          
# bmfont_parser

[![Build Status](https://travis-ci.org/Teascade/bmfont_parser.svg?branch=0.2.0)](https://travis-ci.org/Teascade/sfl_parser)

[![Docs](https://docs.rs/bmfont_parser/badge.svg)](https://docs.rs/bmfont_parser)

[![Crates.io](https://img.shields.io/crates/v/bmfont_parser.svg)](https://crates.io/crates/bmfont_parser)

A lightweight and easy-to-use .sfl and .fnt file (bitmap font) parser made with Rust.

Test fonts are generated with [Fontbuilder](https://github.com/Teascade/fontbuilder)

### How to use

Documentation at [docs.rs][docs] or simply:

1. Add the following to your dependencies:  

   ```toml

   [dependencies]

   bmfont_parser="0.2"

   ```

2. To your Rust project add the following line:

   ```rust

   extern crate bmfont_parser;

   ```

3. You're done! Here is an example of how to use it:

   ```rust

    use bmfont_parser::{BMFont, Format};

    let bmfont = match BMFont::from_path(Format::SFL, "examples/fonts/iosevka.sfl") {

        Ok(bmfont) => bmfont,

        Err(_) => panic!("Failed to load iosevka.sfl"),

    };

    println!("bmfont: {}", bmfont);

    // Or Alternatively

    let iosevka_sfl = include_str!("examples/fonts/iosevka.sfl");

    let bmfont = match BMFont::from_loaded(Format::SFL, iosevka_sfl, "examples/fonts/iosevka.sfl") {

        Ok(bmfont) => bmfont,

        Err(_) => panic!("Failed to load iosevka.sfl"),

    };

    println!("bmfont: {}", bmfont);

   ```

### License

This crate is distributed under the terms of [the MIT License][license].

[license]: LICENSE.md

[docs]: https://docs.rs/bmfont_parser