188 lines
11 KiB
Markdown
188 lines
11 KiB
Markdown
Support development of IconFontCppHeaders through [GitHub Sponsors](https://github.com/sponsors/dougbinks) or [Patreon](https://www.patreon.com/enkisoftware)
|
|
|
|
[<img src="https://img.shields.io/static/v1?logo=github&label=Github&message=Sponsor&color=#ea4aaa" width="200"/>](https://github.com/sponsors/dougbinks) [<img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" alt="Become a Patron" width="150"/>](https://www.patreon.com/enkisoftware)
|
|
|
|
|
|
# IconFontCppHeaders
|
|
|
|
[https://github.com/juliettef/IconFontCppHeaders](https://github.com/juliettef/IconFontCppHeaders)
|
|
|
|
C and C++ headers, C# and Python classes, Rust files and Go package for icon fonts Font Awesome, Fork Awesome, Google Material Design icons, Kenney game icons, Fontaudio and Codicons.
|
|
|
|
A set of header files and classes for using icon fonts in C, C++, C#, Python, Rust and Go, along with the python generator used to create the files.
|
|
|
|
Each header contains defines for one font, with each icon code point defined as ICON_*, along with the min, max and max 16 bit code points for font loading purposes. The min excludes the ASCII characters code points. The max 16 bit is for use with libraries that only support 16 bit code points, for example Dear ImGui.
|
|
|
|
In addition the python script can be used to convert ttf font files to C and C++ headers.
|
|
Each ttf icon font file is converted to a C and C++ header file containing a single array of bytes.
|
|
To enable conversion, run the GenerateIconFontCppHeaders.py script with 'ttf2headerC = True'.
|
|
|
|
## Icon Fonts
|
|
|
|
### Font Awesome
|
|
* [fontawesome.com](https://fontawesome.com)
|
|
* [github.com/FortAwesome/Font-Awesome](https://github.com/FortAwesome/Font-Awesome)
|
|
|
|
#### Font Awesome 4
|
|
* [github.com/FortAwesome/Font-Awesome/tree/4.x](https://github.com/FortAwesome/Font-Awesome/tree/4.x)
|
|
* [icons.yml](https://github.com/FortAwesome/Font-Awesome/blob/4.x/src/icons.yml)
|
|
* [fontawesome-webfont.ttf](https://github.com/FortAwesome/Font-Awesome/blob/4.x/fonts/fontawesome-webfont.ttf)
|
|
|
|
#### Font Awesome 5 free
|
|
* [github.com/FortAwesome/Font-Awesome/tree/5.x](https://github.com/FortAwesome/Font-Awesome/tree/5.x)
|
|
* [icons.yml](https://github.com/FortAwesome/Font-Awesome/blob/5.x/metadata/icons.yml)
|
|
* [fa-brands-400.ttf](https://github.com/FortAwesome/Font-Awesome/blob/5.x/webfonts/fa-brands-400.ttf)
|
|
* [fa-regular-400.ttf](https://github.com/FortAwesome/Font-Awesome/blob/5.x/webfonts/fa-regular-400.ttf)
|
|
* [fa-solid-900.ttf](https://github.com/FortAwesome/Font-Awesome/blob/5.x/webfonts/fa-solid-900.ttf)
|
|
|
|
#### Font Awesome 5 pro
|
|
* Paid product, see [notes about generating the header files](#notes-about-font-awesome-5-and-6)
|
|
|
|
#### Font Awesome 6 free
|
|
* [github.com/FortAwesome/Font-Awesome/tree/6.x](https://github.com/FortAwesome/Font-Awesome/tree/6.x)
|
|
* [icons.yml](https://github.com/FortAwesome/Font-Awesome/blob/6.x/metadata/icons.yml)
|
|
* [fa-brands-400.ttf](https://github.com/FortAwesome/Font-Awesome/blob/6.x/webfonts/fa-brands-400.ttf)
|
|
* [fa-regular-400.ttf](https://github.com/FortAwesome/Font-Awesome/blob/6.x/webfonts/fa-regular-400.ttf)
|
|
* [fa-solid-900.ttf](https://github.com/FortAwesome/Font-Awesome/blob/6.x/webfonts/fa-solid-900.ttf)
|
|
|
|
#### Font Awesome 6 pro
|
|
* Commercial product, not supported but [generation should be similar to FA5 Pro](#notes-about-font-awesome-5-and-6), or see [@jakerieger's fork](https://github.com/jakerieger/IconFontCppHeaders)
|
|
|
|
### Fork Awesome
|
|
* [forkawesome.github.io/Fork-Awesome](https://forkawesome.github.io/Fork-Awesome)
|
|
* [github.com/ForkAwesome/Fork-Awesome](https://github.com/ForkAwesome/Fork-Awesome)
|
|
* [icons.yml](https://github.com/ForkAwesome/Fork-Awesome/blob/master/src/icons/icons.yml)
|
|
* [forkawesome-webfont.ttf](https://github.com/ForkAwesome/Fork-Awesome/blob/master/fonts/forkawesome-webfont.ttf)
|
|
|
|
### Google Material Design icons
|
|
* [design.google.com/icon](https://design.google.com/icons)
|
|
* [github.com/google/material-design-icons](https://github.com/google/material-design-icons)
|
|
* [codepoints](https://github.com/google/material-design-icons/blob/master/font/MaterialIcons-Regular.codepoints)
|
|
* [MaterialIcons-Regular.ttf](https://github.com/google/material-design-icons/blob/master/font/MaterialIcons-Regular.ttf)
|
|
|
|
### Kenney Game icons and expansion
|
|
* [kenney.nl/assets/game-icons](http://kenney.nl/assets/game-icons) and [kenney.nl/assets/game-icons-expansion](http://kenney.nl/assets/game-icons-expansion)
|
|
* [github.com/nicodinh/kenney-icon-font](https://github.com/nicodinh/kenney-icon-font)
|
|
* [kenney-icons.css](https://github.com/nicodinh/kenney-icon-font/blob/master/css/kenney-icons.css)
|
|
* [kenney-icon-font.ttf](https://github.com/nicodinh/kenney-icon-font/blob/master/fonts/kenney-icon-font.ttf)
|
|
|
|
### Fontaudio
|
|
* [github.com/fefanto/fontaudio](https://github.com/fefanto/fontaudio)
|
|
* [fontaudio.css](https://github.com/fefanto/fontaudio/blob/master/font/fontaudio.css)
|
|
* [fontaudio.ttf](https://github.com/fefanto/fontaudio/blob/master/font/fontaudio.ttf)
|
|
|
|
### Codicons
|
|
* [github.com/microsoft/vscode-codicons](https://github.com/microsoft/vscode-codicons)
|
|
* [codicon.css](https://github.com/microsoft/vscode-codicons/blob/main/dist/codicon.css)
|
|
* [codicon.ttf](https://github.com/microsoft/vscode-codicons/blob/main/dist/codicon.ttf)
|
|
|
|
### Ionicons and webfont Material Design Icons
|
|
* Unsupported as of 29 Apr 2020. See [Issue #16](https://github.com/juliettef/IconFontCppHeaders/issues/16).
|
|
|
|
### Notes about Font Awesome 5 and 6
|
|
#### Codepoints grouping
|
|
Font Awesome 5 and 6 split the different styles of icons into different font files with identical codepoints for *light*, *regular* and *solid* styles, and a different set of codepoints for *brands*. We have put the brands into a separate header file.
|
|
#### Generating Pro header files (Font Awesome 5)
|
|
Download the Font Awesome Pro Web package from [fontawesome.com](https://fontawesome.com). To generate the headers, drop *icons.yml* in the same directory as *GenerateIconFontCppHeaders.py* before running the script. The file *icons.yml* is under *..\fontawesome-pro-n.n.n-web\metadata\icons.yml* where *n.n.n* is the version number.
|
|
|
|
Icon files:
|
|
|
|
* ..\fontawesome-pro-n.n.n-web\metadata\icons.yml
|
|
* ..\fontawesome-pro-n.n.n-web\webfonts\fa-brands-400.ttf
|
|
* ..\fontawesome-pro-n.n.n-web\webfonts\fa-light-300.ttf
|
|
* ..\fontawesome-pro-n.n.n-web\webfonts\fa-regular-400.ttf
|
|
* ..\fontawesome-pro-n.n.n-web\webfonts\fa-solid-900.ttf
|
|
|
|
|
|
## Example Code
|
|
|
|
Using [Dear ImGui](https://github.com/ocornut/imgui) as an example UI library:
|
|
|
|
```Cpp
|
|
|
|
#include "IconsFontAwesome5.h"
|
|
|
|
ImGuiIO& io = ImGui::GetIO();
|
|
io.Fonts->AddFontDefault();
|
|
float baseFontSize = 13.0f; // 13.0f is the size of the default font. Change to the font size you use.
|
|
float iconFontSize = baseFontSize * 2.0f / 3.0f; // FontAwesome fonts need to have their sizes reduced by 2.0f/3.0f in order to align correctly
|
|
|
|
// merge in icons from Font Awesome
|
|
static const ImWchar icons_ranges[] = { ICON_MIN_FA, ICON_MAX_16_FA, 0 };
|
|
ImFontConfig icons_config;
|
|
icons_config.MergeMode = true;
|
|
icons_config.PixelSnapH = true;
|
|
icons_config.GlyphMinAdvanceX = iconFontSize;
|
|
io.Fonts->AddFontFromFileTTF( FONT_ICON_FILE_NAME_FAS, iconFontSize, &icons_config, icons_ranges );
|
|
// use FONT_ICON_FILE_NAME_FAR if you want regular instead of solid
|
|
|
|
// in an imgui window somewhere...
|
|
ImGui::Text( ICON_FA_PAINT_BRUSH " Paint" ); // use string literal concatenation
|
|
// outputs a paint brush icon and 'Paint' as a string.
|
|
```
|
|
|
|
## Projects using the font icon header files
|
|
|
|
### Avoyd
|
|
Voxel editor and 6 degree of freedom FPS game with editable environments. The voxel editor's UI uses Dear ImGui with Font Awesome icon fonts.
|
|
[www.avoyd.com](https://www.avoyd.com)
|
|
|
|
|
|
|
|
### bgfx
|
|
Cross-platform rendering library
|
|
[bkaradzic.github.io/bgfx/overview](https://bkaradzic.github.io/bgfx/overview.html)
|
|
[github.com/bkaradzic/bgfx](https://github.com/bkaradzic/bgfx)
|
|
|
|
### glChAoS.P
|
|
Real time 3D strange attractors scout
|
|
[www.michelemorrone.eu/glchaosp](https://www.michelemorrone.eu/glchaosp)
|
|
[github.com/BrutPitt/glChAoS.P](https://github.com/BrutPitt/glChAoS.P)
|
|
|
|
|
|
|
|
### iPlug2
|
|
Cross platform C++ audio plug-in framework
|
|
[iplug2.github.io](https://iplug2.github.io)
|
|
[github.com/iplug2/iplug2](https://github.com/iplug2/iplug2)
|
|
|
|
### Lumix Engine
|
|
3D C++ open source game engine
|
|
[github.com/nem0/LumixEngine](https://github.com/nem0/LumixEngine)
|
|
|
|
|
|
|
|
### Tracy Profiler
|
|
Real time, nanosecond resolution, remote telemetry frame profiler for games and other applications.
|
|
[bitbucket.org/wolfpld/tracy](https://bitbucket.org/wolfpld/tracy)
|
|
|
|
[](https://www.youtube.com/watch?v=uJkrFgriuOo)
|
|
|
|
### Visual 6502 Remix
|
|
Transistor level 6502 Hardware Simulation
|
|
[floooh.github.io/visual6502remix](https://floooh.github.io/visual6502remix)
|
|
[github.com/floooh/v6502r](https://github.com/floooh/v6502r)
|
|
|
|
## Related Tools
|
|
|
|
### ImGuiFontStudio
|
|
Create font subsets
|
|
[github.com/aiekick/ImGuiFontStudio](https://github.com/aiekick/ImGuiFontStudio)
|
|
|
|
## Credits
|
|
|
|
Development - [Juliette Foucaut](http://www.enkisoftware.com/about.html#juliette) - [@juliettef](https://github.com/juliettef)
|
|
Requirements - [Doug Binks](http://www.enkisoftware.com/about.html#doug) - [@dougbinks](https://github.com/dougbinks)
|
|
None language implementation and [refactoring](https://gist.github.com/paniq/4a734e9d8e86a2373b5bc4ca719855ec) - [Leonard Ritter](http://www.leonard-ritter.com/) - [@paniq](https://github.com/paniq)
|
|
Suggestion to add a define for the ttf file name - [Sean Barrett](https://nothings.org/) - [@nothings](https://github.com/nothings)
|
|
Initial Font Awesome 5 implementation - [Codecat](https://codecat.nl/) - [@codecat](https://github.com/codecat)
|
|
Suggestion to add Fork Awesome - [Julien Deswaef](http://xuv.be/) - [@xuv](https://github.com/xuv)
|
|
Suggestion to add Ionicons - [Omar Cornut](http://www.miracleworld.net/) - [@ocornut](https://github.com/ocornut)
|
|
C# language implementation - Rokas Kupstys - [@rokups](https://github.com/rokups)
|
|
Suggestion to add Material Design Icons - Gustav Madeso - [@madeso](https://github.com/madeso)
|
|
Fontaudio implementation - [Oli Larkin](https://www.olilarkin.co.uk/) - [@olilarkin](https://github.com/olilarkin)
|
|
Initial ttf to C and C++ headers conversion implementation - Charles Mailly - [@Caerind](https://github.com/Caerind)
|
|
Python language implementation - Hang Yu - [@yhyu13](https://github.com/yhyu13)
|
|
Go language implementation - Matt Pharr - [@mpp](https://github.com/mmp)
|
|
Codicons implementation - Robert Ryan - [@rtryan98](https://github.com/rtryan98)
|
|
Rust language implementation - Gaeel Bradshaw-Rodriguez - [@Bradshaw](https://github.com/Bradshaw)
|