forked from Mirrorlandia_minetest/minetest
14ef2b445a
Add documentation, move files to a proper place and avoid memory leaks. Make it work with most kind of texts, and allow backgrounds too.
269 lines
7.9 KiB
C++
269 lines
7.9 KiB
C++
// Copyright (C) 2002-2012 Nikolaus Gebhardt
|
|
// Copyright (C) 2016 Nathanaël Courant
|
|
// Modified this class to work with EnrichedStrings too
|
|
// This file is part of the "Irrlicht Engine".
|
|
// For conditions of distribution and use, see copyright notice in irrlicht.h
|
|
|
|
#ifndef __C_GUI_STATIC_TEXT_H_INCLUDED__
|
|
#define __C_GUI_STATIC_TEXT_H_INCLUDED__
|
|
|
|
#include "IrrCompileConfig.h"
|
|
#ifdef _IRR_COMPILE_WITH_GUI_
|
|
|
|
#include "IGUIStaticText.h"
|
|
#include "irrArray.h"
|
|
|
|
#include "log.h"
|
|
|
|
#include <vector>
|
|
|
|
#include "util/enriched_string.h"
|
|
#include "config.h"
|
|
#include <IGUIEnvironment.h>
|
|
|
|
#if USE_FREETYPE
|
|
|
|
namespace irr
|
|
{
|
|
|
|
namespace gui
|
|
{
|
|
|
|
const EGUI_ELEMENT_TYPE EGUIET_ENRICHED_STATIC_TEXT = (EGUI_ELEMENT_TYPE)(0x1000);
|
|
|
|
class StaticText : public IGUIStaticText
|
|
{
|
|
public:
|
|
|
|
//! constructor
|
|
StaticText(const EnrichedString &text, bool border, IGUIEnvironment* environment,
|
|
IGUIElement* parent, s32 id, const core::rect<s32>& rectangle,
|
|
bool background = false);
|
|
|
|
//! destructor
|
|
virtual ~StaticText();
|
|
|
|
//! draws the element and its children
|
|
virtual void draw();
|
|
|
|
//! Sets another skin independent font.
|
|
virtual void setOverrideFont(IGUIFont* font=0);
|
|
|
|
//! Gets the override font (if any)
|
|
virtual IGUIFont* getOverrideFont() const;
|
|
|
|
//! Get the font which is used right now for drawing
|
|
virtual IGUIFont* getActiveFont() const;
|
|
|
|
//! Sets another color for the text.
|
|
virtual void setOverrideColor(video::SColor color);
|
|
|
|
//! Sets another color for the background.
|
|
virtual void setBackgroundColor(video::SColor color);
|
|
|
|
//! Sets whether to draw the background
|
|
virtual void setDrawBackground(bool draw);
|
|
|
|
//! Gets the background color
|
|
virtual video::SColor getBackgroundColor() const;
|
|
|
|
//! Checks if background drawing is enabled
|
|
virtual bool isDrawBackgroundEnabled() const;
|
|
|
|
//! Sets whether to draw the border
|
|
virtual void setDrawBorder(bool draw);
|
|
|
|
//! Checks if border drawing is enabled
|
|
virtual bool isDrawBorderEnabled() const;
|
|
|
|
//! Sets alignment mode for text
|
|
virtual void setTextAlignment(EGUI_ALIGNMENT horizontal, EGUI_ALIGNMENT vertical);
|
|
|
|
//! Gets the override color
|
|
#if IRRLICHT_VERSION_MAJOR == 1 && IRRLICHT_VERSION_MINOR <= 7
|
|
virtual const video::SColor& getOverrideColor() const;
|
|
#else
|
|
virtual video::SColor getOverrideColor() const;
|
|
#endif
|
|
|
|
//! Sets if the static text should use the overide color or the
|
|
//! color in the gui skin.
|
|
virtual void enableOverrideColor(bool enable);
|
|
|
|
//! Checks if an override color is enabled
|
|
virtual bool isOverrideColorEnabled() const;
|
|
|
|
//! Set whether the text in this label should be clipped if it goes outside bounds
|
|
virtual void setTextRestrainedInside(bool restrainedInside);
|
|
|
|
//! Checks if the text in this label should be clipped if it goes outside bounds
|
|
virtual bool isTextRestrainedInside() const;
|
|
|
|
//! Enables or disables word wrap for using the static text as
|
|
//! multiline text control.
|
|
virtual void setWordWrap(bool enable);
|
|
|
|
//! Checks if word wrap is enabled
|
|
virtual bool isWordWrapEnabled() const;
|
|
|
|
//! Sets the new caption of this element.
|
|
virtual void setText(const wchar_t* text);
|
|
|
|
//! Returns the height of the text in pixels when it is drawn.
|
|
virtual s32 getTextHeight() const;
|
|
|
|
//! Returns the width of the current text, in the current font
|
|
virtual s32 getTextWidth() const;
|
|
|
|
//! Updates the absolute position, splits text if word wrap is enabled
|
|
virtual void updateAbsolutePosition();
|
|
|
|
//! Set whether the string should be interpreted as right-to-left (RTL) text
|
|
/** \note This component does not implement the Unicode bidi standard, the
|
|
text of the component should be already RTL if you call this. The
|
|
main difference when RTL is enabled is that the linebreaks for multiline
|
|
elements are performed starting from the end.
|
|
*/
|
|
virtual void setRightToLeft(bool rtl);
|
|
|
|
//! Checks if the text should be interpreted as right-to-left text
|
|
virtual bool isRightToLeft() const;
|
|
|
|
//! Writes attributes of the element.
|
|
virtual void serializeAttributes(io::IAttributes* out, io::SAttributeReadWriteOptions* options) const;
|
|
|
|
//! Reads attributes of the element
|
|
virtual void deserializeAttributes(io::IAttributes* in, io::SAttributeReadWriteOptions* options);
|
|
|
|
virtual bool hasType(EGUI_ELEMENT_TYPE t) const {
|
|
return (t == EGUIET_ENRICHED_STATIC_TEXT) || (t == EGUIET_STATIC_TEXT);
|
|
};
|
|
|
|
virtual bool hasType(EGUI_ELEMENT_TYPE t) {
|
|
return (t == EGUIET_ENRICHED_STATIC_TEXT) || (t == EGUIET_STATIC_TEXT);
|
|
};
|
|
|
|
void setText(const EnrichedString &text);
|
|
|
|
private:
|
|
|
|
//! Breaks the single text line.
|
|
void breakText();
|
|
|
|
EGUI_ALIGNMENT HAlign, VAlign;
|
|
bool Border;
|
|
bool OverrideColorEnabled;
|
|
bool OverrideBGColorEnabled;
|
|
bool WordWrap;
|
|
bool Background;
|
|
bool RestrainTextInside;
|
|
bool RightToLeft;
|
|
|
|
video::SColor OverrideColor, BGColor;
|
|
gui::IGUIFont* OverrideFont;
|
|
gui::IGUIFont* LastBreakFont; // stored because: if skin changes, line break must be recalculated.
|
|
|
|
EnrichedString cText;
|
|
core::array< EnrichedString > BrokenText;
|
|
};
|
|
|
|
|
|
} // end namespace gui
|
|
|
|
} // end namespace irr
|
|
|
|
inline irr::gui::IGUIStaticText *addStaticText(
|
|
irr::gui::IGUIEnvironment *guienv,
|
|
const EnrichedString &text,
|
|
const core::rect< s32 > &rectangle,
|
|
bool border = false,
|
|
bool wordWrap = true,
|
|
irr::gui::IGUIElement *parent = NULL,
|
|
s32 id = -1,
|
|
bool fillBackground = false)
|
|
{
|
|
if (parent == NULL) {
|
|
// parent is NULL, so we must find one, or we need not to drop
|
|
// result, but then there will be a memory leak.
|
|
//
|
|
// What Irrlicht does is to use guienv as a parent, but the problem
|
|
// is that guienv is here only an IGUIEnvironment, while it is a
|
|
// CGUIEnvironment in Irrlicht, which inherits from both IGUIElement
|
|
// and IGUIEnvironment.
|
|
//
|
|
// A solution would be to dynamic_cast guienv to a
|
|
// IGUIElement*, but Irrlicht is shipped without rtti support
|
|
// in some distributions, causing the dymanic_cast to segfault.
|
|
//
|
|
// Thus, to find the parent, we create a dummy StaticText and ask
|
|
// for its parent, and then remove it.
|
|
irr::gui::IGUIStaticText *dummy_text =
|
|
guienv->addStaticText(L"", rectangle, border, wordWrap,
|
|
parent, id, fillBackground);
|
|
parent = dummy_text->getParent();
|
|
dummy_text->remove();
|
|
}
|
|
irr::gui::IGUIStaticText *result = new irr::gui::StaticText(
|
|
text, border, guienv, parent,
|
|
id, rectangle, fillBackground);
|
|
|
|
result->setWordWrap(wordWrap);
|
|
result->drop();
|
|
return result;
|
|
}
|
|
|
|
inline void setStaticText(irr::gui::IGUIStaticText *static_text, const EnrichedString &text)
|
|
{
|
|
// dynamic_cast not possible due to some distributions shipped
|
|
// without rtti support in irrlicht
|
|
if (static_text->hasType(irr::gui::EGUIET_ENRICHED_STATIC_TEXT)) {
|
|
irr::gui::StaticText* stext = static_cast<irr::gui::StaticText*>(static_text);
|
|
stext->setText(text);
|
|
} else {
|
|
static_text->setText(text.c_str());
|
|
}
|
|
}
|
|
|
|
#else // USE_FREETYPE
|
|
|
|
inline irr::gui::IGUIStaticText *addStaticText(
|
|
irr::gui::IGUIEnvironment *guienv,
|
|
const EnrichedString &text,
|
|
const core::rect< s32 > &rectangle,
|
|
bool border = false,
|
|
bool wordWrap = true,
|
|
irr::gui::IGUIElement *parent = NULL,
|
|
s32 id = -1,
|
|
bool fillBackground = false)
|
|
{
|
|
return guienv->addStaticText(text.c_str(), rectangle, border, wordWrap, parent, id, fillBackground);
|
|
}
|
|
|
|
inline void setStaticText(irr::gui::IGUIStaticText *static_text, const EnrichedString &text)
|
|
{
|
|
static_text->setText(text.c_str());
|
|
}
|
|
|
|
#endif
|
|
|
|
inline irr::gui::IGUIStaticText *addStaticText(
|
|
irr::gui::IGUIEnvironment *guienv,
|
|
const wchar_t *text,
|
|
const core::rect< s32 > &rectangle,
|
|
bool border = false,
|
|
bool wordWrap = true,
|
|
irr::gui::IGUIElement *parent = NULL,
|
|
s32 id = -1,
|
|
bool fillBackground = false) {
|
|
return addStaticText(guienv, EnrichedString(text), rectangle, border, wordWrap, parent, id, fillBackground);
|
|
}
|
|
|
|
inline void setStaticText(irr::gui::IGUIStaticText *static_text, const wchar_t *text)
|
|
{
|
|
setStaticText(static_text, EnrichedString(text));
|
|
}
|
|
|
|
#endif // _IRR_COMPILE_WITH_GUI_
|
|
|
|
#endif // C_GUI_STATIC_TEXT_H_INCLUDED
|