Skip to content

cronosun/text-to-path-maker-for-flutter

 
 

Repository files navigation

Text to Path Maker

This is a pure Flutter and Dart package that allows you to convert text--both characters and icons--into paths. It can generate SVG path strings and Flutter Path objects too.

Additionally, this package offers a bunch of methods you can use to animate those paths.

At the core of this package is a .ttf file parser, written in pure Dart. You can, if you want to, use it to read the font tables present in your TrueType font file.

Original repository

This is a fork of https://github.com/hathibelagal-dev/text-to-path-maker-for-flutter. These are the main differences:

  • This fork includes tests (tests against material icons, font-awesome icons and ion icons).
  • Fixes some bugs:
    • For some codepoints, the original version could not generate a path (I'm not sure, but I think the problem occurs, when two or more codepoints point to the same glyph). Fix should also improve lookup speed (codepoint -> glyph).
    • hathibelagal-dev#6
  • Stricter typing.
  • Uses a cursor for reading binary data (that's a bit safer against bugs & shorter code).
  • Public API should still be the same.

Demo

Getting started

You must always start by calling the parseTTFAsset() method available in the PMFontReader class to parse your font asset. Currently, only .ttf files are supported.

Once the font has been parsed, you'll have access to a PMFont object. You can call its generatePathForCharacter() method to convert any character into a Path object. Note that this method expects you to pass the character code of the character.

Next, you'll want to use the PMTransform.moveAndScale() method to position and scale the path. This is usually necessary because, by default, the paths can be quite large.

At this point, you can render the Path object onto any Canvas object. If you want to animate the path, however, you must call the PMPieces.breakIntoPieces() method. This method splits the path into tiny paths, depending on the precision you specify. These tiny paths, when rendered sequentially, will create the illusion of the character being drawn.

There's also a utility PMPainter class, which extends the CustomPainter class. You can use this to quickly render your animation using a CustomPaint widget.

Refer to the example code to learn more.

Notes

This package is still a work in progress. It works reasonably well with most fonts, but there's no guarantee that it will handle every single font you have. It has been tested with Roboto, FontAwesome, and Material Icons. If you find a bug, you can raise an issue on this project's GitHub repository.

About

Convert text to paths and animate them with this Flutter package

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dart 97.3%
  • C++ 1.3%
  • CMake 1.1%
  • HTML 0.1%
  • Swift 0.1%
  • C 0.1%