https://github.com/ISSOtm/gb-vwf

A very powerful Variable-Width Font engine for the Game Boy & Game Boy Color.
https://github.com/ISSOtm/gb-vwf

assembly gameboy gameboy-color gbdev

Last synced: 2 months ago
JSON representation

A very powerful Variable-Width Font engine for the Game Boy & Game Boy Color.

• Host: GitHub
• URL: https://github.com/ISSOtm/gb-vwf
• Owner: ISSOtm
• License: mit
• Created: 2018-10-09T20:42:51.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-07-29T16:25:53.000Z (11 months ago)
• Last Synced: 2024-01-08T12:46:50.726Z (5 months ago)
• Topics: assembly, gameboy, gameboy-color, gbdev
• Language: Assembly
• Homepage:
• Size: 62.5 KB
• Stars: 39
• Watchers: 4
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-gbdev - gb-vwf - Library to print variable-width text, comes with a demo. (Programming / ASM)
• awesome-gb-dev-zh - gb-vwf - 库打印可变宽度文本，附带演示。 (编程；编排 / 空对地导弹)

README

        
# gb-vwf

A Variable-Width Font library for the Game Boy & Game Boy Color.

## Demo

https://user-images.githubusercontent.com/15271137/172129074-6d0266de-e0c2-49bb-9519-7779dcb5ac2a.mp4

You can also run [the demo](https://github.com/ISSOtm/gb-vwf/releases/download/v1.0.0/vwf.gb) yourself in your favorite Game Boy emulator.

Do you want to build the demo yourself, or to check out an example of how gb-vwf could be integrated into your project?

Then please browse [the demo's source code](https://github.com/ISSOtm/gb-vwf-demo)!

## Projects using gb-vwf

- [Esprit](https://github.com/eievui5/esprit)

- [Shock Lobster](https://github.com/tbsp/shock-lobster)

Are you using gb-vwf, and would like to be featured in this list?

Open a pull request, or get in touch!

## Known bugs

- Glyphs wider than 5 pixels are truncated, and might cause rendering errors.

- If the “textbox” touches the right edge of the tilemap, newlines may occasionally skip one row of tiles.

## How to use

For detailed instructions, including installation and usage, please check [the wiki](https://github.com/ISSOtm/gb-vwf/wiki) out.

Bugs can be reported on [the issue tracker](https://github.com/ISSOtm/gb-vwf/issues) (please check that it hasn't been reported already!), or by [bugging me on GBDev](https://gbdev.io/chat).

## Licensing

The VWF engine itself is licensed under the MIT license; the example program is public domain, assets included.

According to US law, fonts cannot be copyrighted.

You can find some [here](https://github.com/pinobatch/bitmap-fonts/tree/master/vwf).