display_modpack/font_api/init.lua

--[[
    font_api mod for Minetest - Library to add font display capability
    to display_api mod.
    (c) Pierre-Yves Rollo

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 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 General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
--]]

-- Global variables
-------------------

font_api = {}
font_api.name = minetest.get_current_modname()
font_api.path = minetest.get_modpath(font_api.name)

-- Inclusions
-------------

dofile(font_api.path.."/font.lua")
dofile(font_api.path.."/registry.lua")
dofile(font_api.path.."/fontform.lua")

--- Standard on_display_update entity callback.
-- Node should have a corresponding display_entity with size, resolution and
-- maxlines fields and optionally halign, valign and color fields
-- @param pos Node position
-- @param objref Object reference of entity

function font_api.on_display_update(pos, objref)
	local meta = minetest.get_meta(pos)
	local text = meta:get_string("display_text")
	local ndef = minetest.registered_nodes[minetest.get_node(pos).name]
	local entity = objref:get_luaentity()

	if entity and ndef.display_entities[entity.name] then
		local def = ndef.display_entities[entity.name]
		local font = font_api.get_font(meta:get_string("font") ~= ""
			and meta:get_string("font") or def.font_name)

		-- Compute entity resolution accroding to given attributes
		local texturew, textureh
		textureh = font:get_height(def.lines or def.maxlines or 1)

		if def.columns then
			if font.fixedwidth then
				texturew = def.columns * font.fixedwidth
				if def.aspect_ratio then
					minetest.log('warning', "[font_api] 'aspect_ratio' ignored because 'columns' is specified")
				end
			else
				minetest.log('warning', "[font_api] 'columns' ignored because '"..font.name.."' is not a fixed width font.")
			end
		end

		if not texturew then
			if not def.aspect_ratio then
				minetest.log('warning', "[font_api] No 'aspect_ratio' specified, using default 1.")
			end
			texturew = textureh * def.size.x / def.size.y	/ (def.aspect_ratio or 1)
		end

		objref:set_properties({
			textures={font:make_text_texture(text, texturew, textureh,
				def.maxlines, def.halign, def.valign, def.color)},
			visual_size = def.size
		})
	end
end

-- Compatibility
font_lib = font_api