/* Minetest Copyright (C) 2010-2014 sapier 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 #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(gui::IGUIEnvironment* env) : m_env(env) { for (u32 &i : m_default_size) { i = (FontMode) FONT_SIZE_UNSPECIFIED; } assert(g_settings != NULL); // pre-condition assert(m_env != NULL); // pre-condition assert(m_env->getSkin() != NULL); // pre-condition readSettings(); if (m_currentMode != FM_Simple) { g_settings->registerChangedCallback("font_size", font_setting_changed, NULL); g_settings->registerChangedCallback("font_bold", font_setting_changed, NULL); g_settings->registerChangedCallback("font_italic", font_setting_changed, NULL); g_settings->registerChangedCallback("font_path", font_setting_changed, NULL); g_settings->registerChangedCallback("font_path_bold", font_setting_changed, NULL); g_settings->registerChangedCallback("font_path_italic", font_setting_changed, NULL); g_settings->registerChangedCallback("font_path_bolditalic", font_setting_changed, NULL); g_settings->registerChangedCallback("font_shadow", font_setting_changed, NULL); g_settings->registerChangedCallback("font_shadow_alpha", font_setting_changed, NULL); g_settings->registerChangedCallback("fallback_font_path", font_setting_changed, NULL); } g_settings->registerChangedCallback("mono_font_path", font_setting_changed, NULL); g_settings->registerChangedCallback("mono_font_size", font_setting_changed, NULL); g_settings->registerChangedCallback("screen_dpi", font_setting_changed, NULL); g_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) { return getFont(spec, false); } irr::gui::IGUIFont *FontEngine::getFont(FontSpec spec, bool may_fail) { 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; } else if (spec.mode == _FM_Fallback) { // Fallback font doesn't support these either 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); 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; 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] = 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"); m_default_bold = g_settings->getBool("font_bold"); m_default_italic = g_settings->getBool("font_italic"); } else { m_currentMode = FM_Simple; } m_default_size[FM_Simple] = g_settings->getU16("font_size"); m_default_size[FM_SimpleMono] = g_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\"" << g_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 = ""; if (spec.mode == FM_Mono) setting_prefix = "mono_"; std::string setting_suffix = ""; if (spec.bold) setting_suffix.append("_bold"); if (spec.italic) setting_suffix.append("_italic"); u32 size = std::floor(RenderingEngine::getDisplayDensity() * g_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 path_setting; if (spec.mode == _FM_Fallback) path_setting = "fallback_font_path"; else path_setting = setting_prefix + "font_path" + setting_suffix; std::string fallback_settings[] = { g_settings->get(path_setting), Settings::getLayer(SL_DEFAULTS)->get(path_setting) }; #if USE_FREETYPE for (const std::string &font_path : fallback_settings) { gui::CGUITTFont *font = gui::CGUITTFont::createTTFont(m_env, 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; } #else errorstream << "FontEngine: Tried to load TTF font but Minetest was" " compiled without Freetype." << std::endl; #endif return nullptr; } /** 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 = g_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, ending; if (pos_dot != std::string::npos) 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() * g_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; }