imgui/extra_fonts/README.txt

62 lines
2.1 KiB
Plaintext
Raw Normal View History

2014-08-30 23:02:55 +04:00
2015-01-18 15:19:49 +03:00
The code in imgui.cpp embeds a copy of 'ProggyClean.ttf' that you can use without any external files.
2015-04-07 13:15:18 +03:00
Those are only provided as a convenience, you can load your own .TTF files.
2015-01-18 15:19:49 +03:00
2015-01-09 02:49:17 +03:00
---------------------------------
2015-04-07 13:15:18 +03:00
INCLUDED FONTS
2015-01-09 02:49:17 +03:00
---------------------------------
2014-08-30 23:02:55 +04:00
2015-02-01 16:06:56 +03:00
DroidSans.ttf
Copyright (c) Steve Matteson
Apache License, version 2.0
http://www.google.com/fonts/specimen/Droid+Sans
2015-01-18 14:24:06 +03:00
ProggyClean.ttf
2015-01-18 15:19:49 +03:00
Copyright (c) 2004, 2005 Tristan Grimmer
MIT License
recommended loading setting in ImGui: Size = 13.0, DisplayOffset.Y = +1
2015-01-18 14:24:06 +03:00
ProggyTiny.ttf
2015-01-18 15:19:49 +03:00
Copyright (c) 2004, 2005 Tristan Grimmer
MIT License
recommended loading setting in ImGui: Size = 10.0, DisplayOffset.Y = +1
2015-01-18 14:24:06 +03:00
Karla-Regular
2015-01-18 15:19:49 +03:00
Copyright (c) 2012, Jonathan Pinhorn
SIL OPEN FONT LICENSE Version 1.1
---------------------------------
OTHER FONTS
---------------------------------
2015-01-18 14:24:06 +03:00
2015-01-18 15:19:49 +03:00
For Japanese:
M+ fonts by Coji Morishita are free and include most useful Kanjis you would need.
mplus-fonts.sourceforge.jp/mplus-outline-fonts/index-en.html
For Japanese, Chinese, Korean:
You can use Arial Unicode or other Unicode fonts provided with Windows (not sure of their license).
Other suggestions?
2014-08-30 23:02:55 +04:00
2015-01-18 15:19:49 +03:00
---------------------------------
LOADING INSTRUCTIONS
---------------------------------
2014-08-30 23:02:55 +04:00
2015-01-18 15:19:49 +03:00
Load .TTF file with:
ImGuiIO& io = ImGui::GetIO();
io.Fonts->AddFontFromFileTTF("myfontfile.ttf", size_pixels);
2015-01-09 02:49:17 +03:00
2015-01-18 15:19:49 +03:00
Add a third parameter to bake specific font ranges:
2014-08-30 23:02:55 +04:00
2015-01-18 15:19:49 +03:00
io.Fonts->LoadFromFileTTF("myfontfile.ttf", size_pixels, io.Fonts->GetGlyphRangesDefault()); // Basic Latin, Extended Latin
io.Fonts->LoadFromFileTTF("myfontfile.ttf", size_pixels, io.Fonts->GetGlyphRangesJapanese()); // Default + Hiragana, Katakana, Half-Width, Selection of 1946 Ideographs
io.Fonts->LoadFromFileTTF("myfontfile.ttf", size_pixels, io.Fonts->GetGlyphRangesChinese()); // Include full set of about 21000 CJK Unified Ideographs
2014-09-26 04:20:56 +04:00
2015-01-09 02:49:17 +03:00
Offset font by altering the io.Font->DisplayOffset value:
2014-09-26 04:20:56 +04:00
2015-01-18 15:19:49 +03:00
ImFont* font = io.Fonts->AddFontFromFileTTF("myfontfile.ttf", size_pixels);
font->DisplayOffset.y += 1; // Render 1 pixel down
2014-08-30 23:02:55 +04:00