ofxUnicode
Description
An openFrameworks addon that wraps various Unicode algorithms.
Features
- Unicode Line / Word Breaking.
- Unicode BiDi Formatting.
- Unicode Case Folding (
toUpper(...)
,toLower(...)
, etc). - Unicode Normalization.
- Unicode codepoint queries (
isTitle(...)
,isUpper(...)
). - UTF8 ⬌ UTF16 ⬌ UTF32 conversion.
- Case-insensitive Unicode string comparisons (with case folding and normalization).
This addon employs the following 3rd party libraries:
- harfbuzz (MIT)
- fribidi (LGPL-2.0)
- libraqm (MIT)
- libiconv(LGPL)
- ucdn (ISC)
- unibreak (Zlib)
- utf8proc (MIT)
Getting Started
To build and install the 3rd party libraries, run scripts/build.sh
.
To get started, generate the example project files using the openFrameworks Project Generator.
Documentation
API documentation can be found here.
Build Status
Compatibility
Branches
The stable
branch of this repository is meant to be compatible with the openFrameworks stable branch, which corresponds to the latest official openFrameworks release.
The master
branch of this repository is meant to be compatible with the openFrameworks master branch.
Some past openFrameworks releases are supported via tagged versions, but only stable
and master
branches are actively supported.
Requirements
- None
Versioning
This project uses Semantic Versioning, although strict adherence will only come into effect at version 1.0.0.
Licensing
See LICENSE.md.
Contributing
Pull Requests are always welcome, so if you make any improvements please feel free to float them back upstream :)
- Fork this repository.
- Create your feature branch (
git checkout -b my-new-feature
). - Commit your changes (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin my-new-feature
). - Create new Pull Request.