forked from Mirrorlandia_minetest/minetest
2bec83eec0
* Add FormSpec font styling options * Change multiplication to stof * Remove extraneous check
412 lines
12 KiB
C++
412 lines
12 KiB
C++
/*
|
|
Minetest
|
|
Copyright (C) 2010-2014 sapier <sapier at gmx dot net>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License along
|
|
with this program; if not, write to the Free Software Foundation, Inc.,
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
|
|
#include "fontengine.h"
|
|
#include <cmath>
|
|
#include "client/renderingengine.h"
|
|
#include "config.h"
|
|
#include "porting.h"
|
|
#include "filesys.h"
|
|
#include "gettext.h"
|
|
|
|
#if USE_FREETYPE
|
|
#include "irrlicht_changes/CGUITTFont.h"
|
|
#endif
|
|
|
|
/** maximum size distance for getting a "similar" font size */
|
|
#define MAX_FONT_SIZE_OFFSET 10
|
|
|
|
/** reference to access font engine, has to be initialized by main */
|
|
FontEngine* g_fontengine = NULL;
|
|
|
|
/** callback to be used on change of font size setting */
|
|
static void font_setting_changed(const std::string &name, void *userdata)
|
|
{
|
|
g_fontengine->readSettings();
|
|
}
|
|
|
|
/******************************************************************************/
|
|
FontEngine::FontEngine(Settings* main_settings, gui::IGUIEnvironment* env) :
|
|
m_settings(main_settings),
|
|
m_env(env)
|
|
{
|
|
|
|
for (u32 &i : m_default_size) {
|
|
i = (FontMode) FONT_SIZE_UNSPECIFIED;
|
|
}
|
|
|
|
assert(m_settings != NULL); // pre-condition
|
|
assert(m_env != NULL); // pre-condition
|
|
assert(m_env->getSkin() != NULL); // pre-condition
|
|
|
|
readSettings();
|
|
|
|
if (m_currentMode == FM_Standard) {
|
|
m_settings->registerChangedCallback("font_size", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_bold", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_italic", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_path", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_path_bold", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_path_italic", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_path_bolditalic", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_shadow", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("font_shadow_alpha", font_setting_changed, NULL);
|
|
}
|
|
else if (m_currentMode == FM_Fallback) {
|
|
m_settings->registerChangedCallback("fallback_font_size", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("fallback_font_path", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("fallback_font_shadow", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("fallback_font_shadow_alpha", font_setting_changed, NULL);
|
|
}
|
|
|
|
m_settings->registerChangedCallback("mono_font_path", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("mono_font_size", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("screen_dpi", font_setting_changed, NULL);
|
|
m_settings->registerChangedCallback("gui_scaling", font_setting_changed, NULL);
|
|
}
|
|
|
|
/******************************************************************************/
|
|
FontEngine::~FontEngine()
|
|
{
|
|
cleanCache();
|
|
}
|
|
|
|
/******************************************************************************/
|
|
void FontEngine::cleanCache()
|
|
{
|
|
for (auto &font_cache_it : m_font_cache) {
|
|
|
|
for (auto &font_it : font_cache_it) {
|
|
font_it.second->drop();
|
|
font_it.second = NULL;
|
|
}
|
|
font_cache_it.clear();
|
|
}
|
|
}
|
|
|
|
/******************************************************************************/
|
|
irr::gui::IGUIFont *FontEngine::getFont(FontSpec spec)
|
|
{
|
|
if (spec.mode == FM_Unspecified) {
|
|
spec.mode = m_currentMode;
|
|
} else if (m_currentMode == FM_Simple) {
|
|
// Freetype disabled -> Force simple mode
|
|
spec.mode = (spec.mode == FM_Mono ||
|
|
spec.mode == FM_SimpleMono) ?
|
|
FM_SimpleMono : FM_Simple;
|
|
// Support for those could be added, but who cares?
|
|
spec.bold = false;
|
|
spec.italic = false;
|
|
}
|
|
|
|
// Fallback to default size
|
|
if (spec.size == FONT_SIZE_UNSPECIFIED)
|
|
spec.size = m_default_size[spec.mode];
|
|
|
|
const auto &cache = m_font_cache[spec.getHash()];
|
|
auto it = cache.find(spec.size);
|
|
if (it != cache.end())
|
|
return it->second;
|
|
|
|
// Font does not yet exist
|
|
gui::IGUIFont *font = nullptr;
|
|
if (spec.mode == FM_Simple || spec.mode == FM_SimpleMono)
|
|
font = initSimpleFont(spec);
|
|
else
|
|
font = initFont(spec);
|
|
|
|
m_font_cache[spec.getHash()][spec.size] = font;
|
|
|
|
return font;
|
|
}
|
|
|
|
/******************************************************************************/
|
|
unsigned int FontEngine::getTextHeight(const FontSpec &spec)
|
|
{
|
|
irr::gui::IGUIFont *font = getFont(spec);
|
|
|
|
// use current skin font as fallback
|
|
if (font == NULL) {
|
|
font = m_env->getSkin()->getFont();
|
|
}
|
|
FATAL_ERROR_IF(font == NULL, "Could not get skin font");
|
|
|
|
return font->getDimension(L"Some unimportant example String").Height;
|
|
}
|
|
|
|
/******************************************************************************/
|
|
unsigned int FontEngine::getTextWidth(const std::wstring &text, const FontSpec &spec)
|
|
{
|
|
irr::gui::IGUIFont *font = getFont(spec);
|
|
|
|
// use current skin font as fallback
|
|
if (font == NULL) {
|
|
font = m_env->getSkin()->getFont();
|
|
}
|
|
FATAL_ERROR_IF(font == NULL, "Could not get font");
|
|
|
|
return font->getDimension(text.c_str()).Width;
|
|
}
|
|
|
|
|
|
/** get line height for a specific font (including empty room between lines) */
|
|
unsigned int FontEngine::getLineHeight(const FontSpec &spec)
|
|
{
|
|
irr::gui::IGUIFont *font = getFont(spec);
|
|
|
|
// use current skin font as fallback
|
|
if (font == NULL) {
|
|
font = m_env->getSkin()->getFont();
|
|
}
|
|
FATAL_ERROR_IF(font == NULL, "Could not get font");
|
|
|
|
return font->getDimension(L"Some unimportant example String").Height
|
|
+ font->getKerningHeight();
|
|
}
|
|
|
|
/******************************************************************************/
|
|
unsigned int FontEngine::getDefaultFontSize()
|
|
{
|
|
return m_default_size[m_currentMode];
|
|
}
|
|
|
|
unsigned int FontEngine::getFontSize(FontMode mode)
|
|
{
|
|
if (m_currentMode == FM_Simple) {
|
|
if (mode == FM_Mono || mode == FM_SimpleMono)
|
|
return m_default_size[FM_SimpleMono];
|
|
else
|
|
return m_default_size[FM_Simple];
|
|
}
|
|
|
|
if (mode == FM_Unspecified)
|
|
return m_default_size[FM_Standard];
|
|
|
|
return m_default_size[mode];
|
|
}
|
|
|
|
/******************************************************************************/
|
|
void FontEngine::readSettings()
|
|
{
|
|
if (USE_FREETYPE && g_settings->getBool("freetype")) {
|
|
m_default_size[FM_Standard] = m_settings->getU16("font_size");
|
|
m_default_size[FM_Fallback] = m_settings->getU16("fallback_font_size");
|
|
m_default_size[FM_Mono] = m_settings->getU16("mono_font_size");
|
|
|
|
/*~ DO NOT TRANSLATE THIS LITERALLY!
|
|
This is a special string. Put either "no" or "yes"
|
|
into the translation field (literally).
|
|
Choose "yes" if the language requires use of the fallback
|
|
font, "no" otherwise.
|
|
The fallback font is (normally) required for languages with
|
|
non-Latin script, like Chinese.
|
|
When in doubt, test your translation. */
|
|
m_currentMode = is_yes(gettext("needs_fallback_font")) ?
|
|
FM_Fallback : FM_Standard;
|
|
|
|
m_default_bold = m_settings->getBool("font_bold");
|
|
m_default_italic = m_settings->getBool("font_italic");
|
|
|
|
} else {
|
|
m_currentMode = FM_Simple;
|
|
}
|
|
|
|
m_default_size[FM_Simple] = m_settings->getU16("font_size");
|
|
m_default_size[FM_SimpleMono] = m_settings->getU16("mono_font_size");
|
|
|
|
cleanCache();
|
|
updateFontCache();
|
|
updateSkin();
|
|
}
|
|
|
|
/******************************************************************************/
|
|
void FontEngine::updateSkin()
|
|
{
|
|
gui::IGUIFont *font = getFont();
|
|
|
|
if (font)
|
|
m_env->getSkin()->setFont(font);
|
|
else
|
|
errorstream << "FontEngine: Default font file: " <<
|
|
"\n\t\"" << m_settings->get("font_path") << "\"" <<
|
|
"\n\trequired for current screen configuration was not found" <<
|
|
" or was invalid file format." <<
|
|
"\n\tUsing irrlicht default font." << std::endl;
|
|
|
|
// If we did fail to create a font our own make irrlicht find a default one
|
|
font = m_env->getSkin()->getFont();
|
|
FATAL_ERROR_IF(font == NULL, "Could not create/get font");
|
|
|
|
u32 text_height = font->getDimension(L"Hello, world!").Height;
|
|
infostream << "FontEngine: measured text_height=" << text_height << std::endl;
|
|
}
|
|
|
|
/******************************************************************************/
|
|
void FontEngine::updateFontCache()
|
|
{
|
|
/* the only font to be initialized is default one,
|
|
* all others are re-initialized on demand */
|
|
getFont(FONT_SIZE_UNSPECIFIED, FM_Unspecified);
|
|
}
|
|
|
|
/******************************************************************************/
|
|
gui::IGUIFont *FontEngine::initFont(const FontSpec &spec)
|
|
{
|
|
assert(spec.mode != FM_Unspecified);
|
|
assert(spec.size != FONT_SIZE_UNSPECIFIED);
|
|
|
|
std::string setting_prefix = "";
|
|
|
|
switch (spec.mode) {
|
|
case FM_Fallback:
|
|
setting_prefix = "fallback_";
|
|
break;
|
|
case FM_Mono:
|
|
case FM_SimpleMono:
|
|
setting_prefix = "mono_";
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
std::string setting_suffix = "";
|
|
if (spec.bold)
|
|
setting_suffix.append("_bold");
|
|
if (spec.italic)
|
|
setting_suffix.append("_italic");
|
|
|
|
u32 size = std::floor(RenderingEngine::getDisplayDensity() *
|
|
m_settings->getFloat("gui_scaling") * spec.size);
|
|
|
|
if (size == 0) {
|
|
errorstream << "FontEngine: attempt to use font size 0" << std::endl;
|
|
errorstream << " display density: " << RenderingEngine::getDisplayDensity() << std::endl;
|
|
abort();
|
|
}
|
|
|
|
u16 font_shadow = 0;
|
|
u16 font_shadow_alpha = 0;
|
|
g_settings->getU16NoEx(setting_prefix + "font_shadow", font_shadow);
|
|
g_settings->getU16NoEx(setting_prefix + "font_shadow_alpha",
|
|
font_shadow_alpha);
|
|
|
|
std::string wanted_font_path;
|
|
wanted_font_path = g_settings->get(setting_prefix + "font_path" + setting_suffix);
|
|
|
|
std::string fallback_settings[] = {
|
|
wanted_font_path,
|
|
m_settings->get("fallback_font_path"),
|
|
m_settings->getDefault(setting_prefix + "font_path")
|
|
};
|
|
|
|
#if USE_FREETYPE
|
|
for (const std::string &font_path : fallback_settings) {
|
|
irr::gui::IGUIFont *font = gui::CGUITTFont::createTTFont(m_env,
|
|
font_path.c_str(), size, true, true, font_shadow,
|
|
font_shadow_alpha);
|
|
|
|
if (font)
|
|
return font;
|
|
|
|
errorstream << "FontEngine: Cannot load '" << font_path <<
|
|
"'. Trying to fall back to another path." << std::endl;
|
|
}
|
|
|
|
|
|
// give up
|
|
errorstream << "minetest can not continue without a valid font. "
|
|
"Please correct the 'font_path' setting or install the font "
|
|
"file in the proper location" << std::endl;
|
|
#else
|
|
errorstream << "FontEngine: Tried to load freetype fonts but Minetest was"
|
|
" not compiled with that library." << std::endl;
|
|
#endif
|
|
abort();
|
|
}
|
|
|
|
/** initialize a font without freetype */
|
|
gui::IGUIFont *FontEngine::initSimpleFont(const FontSpec &spec)
|
|
{
|
|
assert(spec.mode == FM_Simple || spec.mode == FM_SimpleMono);
|
|
assert(spec.size != FONT_SIZE_UNSPECIFIED);
|
|
|
|
const std::string &font_path = m_settings->get(
|
|
(spec.mode == FM_SimpleMono) ? "mono_font_path" : "font_path");
|
|
|
|
size_t pos_dot = font_path.find_last_of('.');
|
|
std::string basename = font_path;
|
|
std::string ending = lowercase(font_path.substr(pos_dot));
|
|
|
|
if (ending == ".ttf") {
|
|
errorstream << "FontEngine: Found font \"" << font_path
|
|
<< "\" but freetype is not available." << std::endl;
|
|
return nullptr;
|
|
}
|
|
|
|
if (ending == ".xml" || ending == ".png")
|
|
basename = font_path.substr(0, pos_dot);
|
|
|
|
u32 size = std::floor(
|
|
RenderingEngine::getDisplayDensity() *
|
|
m_settings->getFloat("gui_scaling") *
|
|
spec.size);
|
|
|
|
irr::gui::IGUIFont *font = nullptr;
|
|
std::string font_extensions[] = { ".png", ".xml" };
|
|
|
|
// Find nearest matching font scale
|
|
// Does a "zig-zag motion" (positibe/negative), from 0 to MAX_FONT_SIZE_OFFSET
|
|
for (s32 zoffset = 0; zoffset < MAX_FONT_SIZE_OFFSET * 2; zoffset++) {
|
|
std::stringstream path;
|
|
|
|
// LSB to sign
|
|
s32 sign = (zoffset & 1) ? -1 : 1;
|
|
s32 offset = zoffset >> 1;
|
|
|
|
for (const std::string &ext : font_extensions) {
|
|
path.str(""); // Clear
|
|
path << basename << "_" << (size + offset * sign) << ext;
|
|
|
|
if (!fs::PathExists(path.str()))
|
|
continue;
|
|
|
|
font = m_env->getFont(path.str().c_str());
|
|
|
|
if (font) {
|
|
verbosestream << "FontEngine: found font: " << path.str() << std::endl;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (font)
|
|
break;
|
|
}
|
|
|
|
// try name direct
|
|
if (font == NULL) {
|
|
if (fs::PathExists(font_path)) {
|
|
font = m_env->getFont(font_path.c_str());
|
|
if (font)
|
|
verbosestream << "FontEngine: found font: " << font_path << std::endl;
|
|
}
|
|
}
|
|
|
|
return font;
|
|
}
|