minetest/src/client/fontengine.cpp

269 lines
7.6 KiB
C++
Raw Normal View History

2014-11-23 13:40:43 +01:00
/*
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.
*/
2014-11-23 13:40:43 +01:00
#include "fontengine.h"
#include <cmath>
#include "client/renderingengine.h"
2014-11-23 13:40:43 +01:00
#include "config.h"
#include "porting.h"
#include "filesys.h"
2019-08-24 18:54:51 +02:00
#include "gettext.h"
#include "irrlicht_changes/CGUITTFont.h"
2014-11-23 13:40:43 +01:00
/** 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;
2014-11-23 13:40:43 +01:00
/** callback to be used on change of font size setting */
static void font_setting_changed(const std::string &name, void *userdata)
{
g_fontengine->readSettings();
2014-11-23 13:40:43 +01:00
}
/******************************************************************************/
FontEngine::FontEngine(gui::IGUIEnvironment* env) :
m_env(env)
2014-11-23 13:40:43 +01:00
{
for (u32 &i : m_default_size) {
i = FONT_SIZE_UNSPECIFIED;
2014-11-23 13:40:43 +01:00
}
assert(g_settings != NULL); // pre-condition
assert(m_env != NULL); // pre-condition
assert(m_env->getSkin() != NULL); // pre-condition
2014-11-23 13:40:43 +01:00
readSettings();
2014-11-23 13:40:43 +01:00
const char *settings[] = {
"font_size", "font_bold", "font_italic", "font_size_divisible_by",
"mono_font_size", "mono_font_size_divisible_by",
"font_shadow", "font_shadow_alpha",
"font_path", "font_path_bold", "font_path_italic", "font_path_bold_italic",
"mono_font_path", "mono_font_path_bold", "mono_font_path_italic",
"mono_font_path_bold_italic",
"fallback_font_path",
"screen_dpi", "gui_scaling",
};
2014-11-23 13:40:43 +01:00
for (auto name : settings)
g_settings->registerChangedCallback(name, font_setting_changed, NULL);
2014-11-23 13:40:43 +01:00
}
/******************************************************************************/
FontEngine::~FontEngine()
{
cleanCache();
}
/******************************************************************************/
void FontEngine::cleanCache()
{
RecursiveMutexAutoLock l(m_font_mutex);
for (auto &font_cache_it : m_font_cache) {
2014-11-23 13:40:43 +01:00
for (auto &font_it : font_cache_it) {
font_it.second->drop();
font_it.second = nullptr;
2014-11-23 13:40:43 +01:00
}
font_cache_it.clear();
2014-11-23 13:40:43 +01:00
}
}
/******************************************************************************/
irr::gui::IGUIFont *FontEngine::getFont(FontSpec spec)
{
return getFont(spec, false);
}
irr::gui::IGUIFont *FontEngine::getFont(FontSpec spec, bool may_fail)
2014-11-23 13:40:43 +01:00
{
if (spec.mode == FM_Unspecified) {
spec.mode = m_currentMode;
} else if (spec.mode == _FM_Fallback) {
// Fallback font doesn't support these
spec.bold = false;
spec.italic = false;
2014-11-23 13:40:43 +01:00
}
// Fallback to default size
if (spec.size == FONT_SIZE_UNSPECIFIED)
spec.size = m_default_size[spec.mode];
RecursiveMutexAutoLock l(m_font_mutex);
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 = initFont(spec);
2014-11-23 13:40:43 +01:00
if (!font && !may_fail) {
errorstream << "Minetest cannot continue without a valid font. "
"Please correct the 'font_path' setting or install the font "
"file in the proper location." << std::endl;
abort();
}
m_font_cache[spec.getHash()][spec.size] = font;
2019-09-10 15:11:26 +02:00
return font;
2014-11-23 13:40:43 +01:00
}
/******************************************************************************/
unsigned int FontEngine::getTextHeight(const FontSpec &spec)
2014-11-23 13:40:43 +01:00
{
gui::IGUIFont *font = getFont(spec);
2014-11-23 13:40:43 +01:00
return font->getDimension(L"Some unimportant example String").Height;
}
/******************************************************************************/
unsigned int FontEngine::getTextWidth(const std::wstring &text, const FontSpec &spec)
2014-11-23 13:40:43 +01:00
{
gui::IGUIFont *font = getFont(spec);
2014-11-23 13:40:43 +01:00
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)
2014-11-23 13:40:43 +01:00
{
gui::IGUIFont *font = getFont(spec);
2014-11-23 13:40:43 +01:00
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 (mode == FM_Unspecified)
return m_default_size[FM_Standard];
return m_default_size[mode];
}
2014-11-23 13:40:43 +01:00
/******************************************************************************/
void FontEngine::readSettings()
{
m_default_size[FM_Standard] = g_settings->getU16("font_size");
m_default_size[_FM_Fallback] = g_settings->getU16("font_size");
m_default_size[FM_Mono] = g_settings->getU16("mono_font_size");
2019-09-10 15:11:26 +02:00
m_default_bold = g_settings->getBool("font_bold");
m_default_italic = g_settings->getBool("font_italic");
2014-11-23 13:40:43 +01:00
cleanCache();
updateFontCache();
updateSkin();
}
/******************************************************************************/
void FontEngine::updateSkin()
{
gui::IGUIFont *font = getFont();
assert(font);
2014-11-23 13:40:43 +01:00
m_env->getSkin()->setFont(font);
2014-11-23 13:40:43 +01:00
}
/******************************************************************************/
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);
2014-11-23 13:40:43 +01:00
}
/******************************************************************************/
gui::IGUIFont *FontEngine::initFont(const FontSpec &spec)
2014-11-23 13:40:43 +01:00
{
assert(spec.mode != FM_Unspecified);
assert(spec.size != FONT_SIZE_UNSPECIFIED);
2014-11-23 13:40:43 +01:00
std::string setting_prefix = "";
if (spec.mode == FM_Mono)
setting_prefix = "mono_";
2014-11-23 13:40:43 +01:00
std::string setting_suffix = "";
if (spec.bold)
setting_suffix.append("_bold");
if (spec.italic)
setting_suffix.append("_italic");
2019-09-10 15:11:26 +02:00
u32 size = std::max<u32>(spec.size * RenderingEngine::getDisplayDensity() *
g_settings->getFloat("gui_scaling"), 1);
2019-09-10 15:11:26 +02:00
// Constrain the font size to a certain multiple, if necessary
u16 divisible_by = g_settings->getU16(setting_prefix + "font_size_divisible_by");
if (divisible_by > 1) {
size = std::max<u32>(
std::round((double)size / divisible_by) * divisible_by, divisible_by);
2014-11-23 13:40:43 +01:00
}
sanity_check(size != 0);
u16 font_shadow = 0;
u16 font_shadow_alpha = 0;
g_settings->getU16NoEx(setting_prefix + "font_shadow", font_shadow);
2019-09-10 15:11:26 +02:00
g_settings->getU16NoEx(setting_prefix + "font_shadow_alpha",
font_shadow_alpha);
std::string path_setting;
if (spec.mode == _FM_Fallback)
path_setting = "fallback_font_path";
else
path_setting = setting_prefix + "font_path" + setting_suffix;
2014-11-23 13:40:43 +01:00
std::string fallback_settings[] = {
g_settings->get(path_setting),
Settings::getLayer(SL_DEFAULTS)->get(path_setting)
};
2014-11-23 13:40:43 +01:00
for (const std::string &font_path : fallback_settings) {
gui::CGUITTFont *font = gui::CGUITTFont::createTTFont(m_env,
2014-11-23 13:40:43 +01:00
font_path.c_str(), size, true, true, font_shadow,
font_shadow_alpha);
if (!font) {
errorstream << "FontEngine: Cannot load '" << font_path <<
"'. Trying to fall back to another path." << std::endl;
continue;
}
if (spec.mode != _FM_Fallback) {
FontSpec spec2(spec);
spec2.mode = _FM_Fallback;
font->setFallback(getFont(spec2, true));
}
return font;
}
return nullptr;
2014-11-23 13:40:43 +01:00
}