/* ScummVM - Graphic Adventure Engine * * ScummVM is the legal property of its developers, whose names * are too numerous to list here. Please refer to the COPYRIGHT * file distributed with this source distribution. * * 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 2 * 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, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * */ /* * This code is based on Broken Sword 2.5 engine * * Copyright (c) Malte Thiesen, Daniel Queteschiner and Michael Elsdoerfer * * Licensed under GNU GPL v2 * */ #ifndef SWORD25_TEXT_H #define SWORD25_TEXT_H #include "sword25/kernel/common.h" #include "common/rect.h" #include "sword25/gfx/renderobject.h" namespace Sword25 { class Kernel; class FontResource; class ResourceManager; class Text : public RenderObject { friend class RenderObject; public: /** @brief Setzt den Font mit dem der Text dargestellt werden soll. @param Font der Dateiname der Fontdatei. @return Gibt false zurück, wenn der Font nicht gefunden wurde. */ bool setFont(const Common::String &font); /** @brief Setzt den darzustellenden Text. @param Text der darzustellende Text */ void setText(const Common::String &text); /** @brief Setzt den Alphawert des Textes. @param Alpha der neue Alphawert des Textes (0 = keine Deckung, 255 = volle Deckung). */ void setAlpha(int alpha); /** @brief Legt fest, ob der Text automatisch umgebrochen werden soll. Wenn dieses Attribut auf true gesetzt ist, wird der Text umgebrochen, sofern er länger als GetAutoWrapThreshold() ist. @param AutoWrap gibt an, ob der automatische Umbruch aktiviert oder deaktiviert werden soll. @remark Dieses Attribut wird mit dem Wert false initialisiert. */ void setAutoWrap(bool autoWrap); /** @brief Legt die Längengrenze des Textes in Pixeln fest, ab der ein automatischer Zeilenumbruch vorgenommen wird. @remark Dieses Attribut wird mit dem Wert 300 initialisiert. @remark Eine automatische Formatierung wird nur vorgenommen, wenn diese durch einen Aufruf von SetAutoWrap() aktiviert wurde. */ void setAutoWrapThreshold(uint32 autoWrapThreshold); /** @brief Gibt den dargestellten Text zurück. */ const Common::String &getText() { return _text; } /** @brief Gibt den Namen das momentan benutzten Fonts zurück. */ const Common::String &getFont() { return _font; } /** @brief Setzt die Farbe des Textes. @param Color eine 24-Bit RGB Farbe, die die Farbe des Textes festlegt. */ void setColor(uint32 modulationColor); /** @brief Gibt den Alphawert des Textes zurück. @return Der Alphawert des Textes (0 = keine Deckung, 255 = volle Deckung). */ int getAlpha() const { return _modulationColor >> 24; } /** @brief Gibt die Farbe des Textes zurück. @return Eine 24-Bit RGB Farbe, die die Farbe des Textes angibt. */ int getColor() const { return _modulationColor & 0x00ffffff; } /** @brief Gibt zurück, ob die automatische Formatierung aktiviert ist. */ bool isAutoWrapActive() const { return _autoWrap; } /** @brief Gibt die Längengrenze des Textes in Pixeln zurück, ab der eine automatische Formatierung vorgenommen wird. */ uint32 getAutoWrapThreshold() const { return _autoWrapThreshold; } virtual bool persist(OutputPersistenceBlock &writer); virtual bool unpersist(InputPersistenceBlock &reader); protected: virtual bool doRender(RectangleList *updateRects); private: Text(RenderObjectPtr parentPtr); Text(InputPersistenceBlock &reader, RenderObjectPtr parentPtr, uint handle); uint32 _modulationColor; Common::String _font; Common::String _text; bool _autoWrap; uint32 _autoWrapThreshold; struct Line { Common::Rect bbox; Common::String text; }; Common::Array _lines; void updateFormat(); void updateMetrics(FontResource &fontResource); ResourceManager *getResourceManager(); FontResource *lockFontResource(); }; } // End of namespace Sword25 #endif