// Copyright (C) 2002-2012 Nikolaus Gebhardt // This file is part of the "Irrlicht Engine". // For conditions of distribution and use, see copyright notice in irrlicht.h #include "CGUIFont.h" #include "os.h" #include "coreutil.h" #include "IGUIEnvironment.h" #include "IReadFile.h" #include "IVideoDriver.h" #include "IGUISpriteBank.h" namespace irr { namespace gui { //! constructor CGUIFont::CGUIFont(IGUIEnvironment *env, const io::path &filename) : Driver(0), SpriteBank(0), Environment(env), WrongCharacter(0), MaxHeight(0), GlobalKerningWidth(0), GlobalKerningHeight(0) { if (Environment) { // don't grab environment, to avoid circular references Driver = Environment->getVideoDriver(); SpriteBank = Environment->getSpriteBank(filename); if (!SpriteBank) // could be default-font which has no file SpriteBank = Environment->addEmptySpriteBank(filename); if (SpriteBank) SpriteBank->grab(); } if (Driver) Driver->grab(); setInvisibleCharacters(L" "); } //! destructor CGUIFont::~CGUIFont() { if (Driver) Driver->drop(); if (SpriteBank) { SpriteBank->drop(); // TODO: spritebank still exists in gui-environment and should be removed here when it's // reference-count is 1. Just can't do that from here at the moment. // But spritebank would not be able to drop textures anyway because those are in texture-cache // where they can't be removed unless materials start reference-couting 'em. } } void CGUIFont::setMaxHeight() { if (!SpriteBank) return; MaxHeight = 0; core::array> &p = SpriteBank->getPositions(); for (u32 i = 0; i < p.size(); ++i) { const s32 t = p[i].getHeight(); if (t > MaxHeight) MaxHeight = t; } } void CGUIFont::pushTextureCreationFlags(bool (&flags)[3]) { flags[0] = Driver->getTextureCreationFlag(video::ETCF_ALLOW_NON_POWER_2); flags[1] = Driver->getTextureCreationFlag(video::ETCF_CREATE_MIP_MAPS); flags[2] = Driver->getTextureCreationFlag(video::ETCF_ALLOW_MEMORY_COPY); Driver->setTextureCreationFlag(video::ETCF_ALLOW_NON_POWER_2, true); Driver->setTextureCreationFlag(video::ETCF_CREATE_MIP_MAPS, false); Driver->setTextureCreationFlag(video::ETCF_ALLOW_MEMORY_COPY, true); } void CGUIFont::popTextureCreationFlags(const bool (&flags)[3]) { Driver->setTextureCreationFlag(video::ETCF_ALLOW_NON_POWER_2, flags[0]); Driver->setTextureCreationFlag(video::ETCF_CREATE_MIP_MAPS, flags[1]); Driver->setTextureCreationFlag(video::ETCF_ALLOW_MEMORY_COPY, flags[2]); } //! loads a font file, native file needed, for texture parsing bool CGUIFont::load(io::IReadFile *file) { if (!Driver) return false; return loadTexture(Driver->createImageFromFile(file), file->getFileName()); } //! loads a font file, native file needed, for texture parsing bool CGUIFont::load(const io::path &filename) { if (!Driver) return false; return loadTexture(Driver->createImageFromFile(filename), filename); } //! load & prepare font from ITexture bool CGUIFont::loadTexture(video::IImage *image, const io::path &name) { if (!image || !SpriteBank) return false; s32 lowerRightPositions = 0; video::IImage *tmpImage = image; bool deleteTmpImage = false; switch (image->getColorFormat()) { case video::ECF_R5G6B5: tmpImage = Driver->createImage(video::ECF_A1R5G5B5, image->getDimension()); image->copyTo(tmpImage); deleteTmpImage = true; break; case video::ECF_A1R5G5B5: case video::ECF_A8R8G8B8: break; case video::ECF_R8G8B8: tmpImage = Driver->createImage(video::ECF_A8R8G8B8, image->getDimension()); image->copyTo(tmpImage); deleteTmpImage = true; break; default: os::Printer::log("Unknown texture format provided for CGUIFont::loadTexture", ELL_ERROR); return false; } readPositions(tmpImage, lowerRightPositions); WrongCharacter = getAreaFromCharacter(L' '); // output warnings if (!lowerRightPositions || !SpriteBank->getSprites().size()) os::Printer::log("Either no upper or lower corner pixels in the font file. If this font was made using the new font tool, please load the XML file instead. If not, the font may be corrupted.", ELL_ERROR); else if (lowerRightPositions != (s32)SpriteBank->getPositions().size()) os::Printer::log("The amount of upper corner pixels and the lower corner pixels is not equal, font file may be corrupted.", ELL_ERROR); bool ret = (!SpriteBank->getSprites().empty() && lowerRightPositions); if (ret) { bool flags[3]; pushTextureCreationFlags(flags); SpriteBank->addTexture(Driver->addTexture(name, tmpImage)); popTextureCreationFlags(flags); } if (deleteTmpImage) tmpImage->drop(); image->drop(); setMaxHeight(); return ret; } void CGUIFont::readPositions(video::IImage *image, s32 &lowerRightPositions) { if (!SpriteBank) return; const core::dimension2d size = image->getDimension(); video::SColor colorTopLeft = image->getPixel(0, 0); colorTopLeft.setAlpha(255); image->setPixel(0, 0, colorTopLeft); video::SColor colorLowerRight = image->getPixel(1, 0); video::SColor colorBackGround = image->getPixel(2, 0); video::SColor colorBackGroundTransparent = 0; image->setPixel(1, 0, colorBackGround); // start parsing core::position2d pos(0, 0); for (pos.Y = 0; pos.Y < (s32)size.Height; ++pos.Y) { for (pos.X = 0; pos.X < (s32)size.Width; ++pos.X) { const video::SColor c = image->getPixel(pos.X, pos.Y); if (c == colorTopLeft) { image->setPixel(pos.X, pos.Y, colorBackGroundTransparent); SpriteBank->getPositions().push_back(core::rect(pos, pos)); } else if (c == colorLowerRight) { // too many lower right points if (SpriteBank->getPositions().size() <= (u32)lowerRightPositions) { lowerRightPositions = 0; return; } image->setPixel(pos.X, pos.Y, colorBackGroundTransparent); SpriteBank->getPositions()[lowerRightPositions].LowerRightCorner = pos; // add frame to sprite bank SGUISpriteFrame f; f.rectNumber = lowerRightPositions; f.textureNumber = 0; SGUISprite s; s.Frames.push_back(f); s.frameTime = 0; SpriteBank->getSprites().push_back(s); // add character to font SFontArea a; a.overhang = 0; a.underhang = 0; a.spriteno = lowerRightPositions; a.width = SpriteBank->getPositions()[lowerRightPositions].getWidth(); Areas.push_back(a); // map letter to character wchar_t ch = (wchar_t)(lowerRightPositions + 32); CharacterMap[ch] = lowerRightPositions; ++lowerRightPositions; } else if (c == colorBackGround) image->setPixel(pos.X, pos.Y, colorBackGroundTransparent); } } } //! set an Pixel Offset on Drawing ( scale position on width ) void CGUIFont::setKerningWidth(s32 kerning) { GlobalKerningWidth = kerning; } core::vector2di CGUIFont::getKerning(const wchar_t thisLetter, const wchar_t previousLetter) const { core::vector2di ret(GlobalKerningWidth, GlobalKerningHeight); if (thisLetter) { ret.X += Areas[getAreaFromCharacter(thisLetter)].overhang; if (previousLetter) ret.X += Areas[getAreaFromCharacter(previousLetter)].underhang; } return ret; } //! set an Pixel Offset on Drawing ( scale position on height ) void CGUIFont::setKerningHeight(s32 kerning) { GlobalKerningHeight = kerning; } //! returns the sprite number from a given character u32 CGUIFont::getSpriteNoFromChar(const wchar_t *c) const { return Areas[getAreaFromCharacter(*c)].spriteno; } s32 CGUIFont::getAreaFromCharacter(const wchar_t c) const { auto n = CharacterMap.find(c); if (n != CharacterMap.end()) return n->second; else return WrongCharacter; } void CGUIFont::setInvisibleCharacters(const wchar_t *s) { Invisible = s; } //! returns the dimension of text core::dimension2d CGUIFont::getDimension(const wchar_t *text) const { core::dimension2d dim(0, 0); core::dimension2d thisLine(0, MaxHeight); for (const wchar_t *p = text; *p; ++p) { bool lineBreak = false; if (*p == L'\r') { // Mac or Windows breaks lineBreak = true; if (p[1] == L'\n') // Windows breaks ++p; } else if (*p == L'\n') { // Unix breaks lineBreak = true; } if (lineBreak) { dim.Height += thisLine.Height; if (dim.Width < thisLine.Width) dim.Width = thisLine.Width; thisLine.Width = 0; continue; } const SFontArea &area = Areas[getAreaFromCharacter(*p)]; thisLine.Width += area.underhang; thisLine.Width += area.width + area.overhang + GlobalKerningWidth; } dim.Height += thisLine.Height; if (dim.Width < thisLine.Width) dim.Width = thisLine.Width; return dim; } //! draws some text and clips it to the specified rectangle if wanted void CGUIFont::draw(const core::stringw &text, const core::rect &position, video::SColor color, bool hcenter, bool vcenter, const core::rect *clip) { if (!Driver || !SpriteBank) return; core::dimension2d textDimension; // NOTE: don't make this u32 or the >> later on can fail when the dimension width is < position width core::position2d offset = position.UpperLeftCorner; if (hcenter || vcenter || clip) textDimension = getDimension(text.c_str()); if (hcenter) offset.X += (position.getWidth() - textDimension.Width) >> 1; if (vcenter) offset.Y += (position.getHeight() - textDimension.Height) >> 1; if (clip) { core::rect clippedRect(offset, textDimension); clippedRect.clipAgainst(*clip); if (!clippedRect.isValid()) return; } core::array indices(text.size()); core::array offsets(text.size()); for (u32 i = 0; i < text.size(); i++) { wchar_t c = text[i]; bool lineBreak = false; if (c == L'\r') { // Mac or Windows breaks lineBreak = true; if (text[i + 1] == L'\n') // Windows breaks c = text[++i]; } else if (c == L'\n') { // Unix breaks lineBreak = true; } if (lineBreak) { offset.Y += MaxHeight; offset.X = position.UpperLeftCorner.X; if (hcenter) { offset.X += (position.getWidth() - textDimension.Width) >> 1; } continue; } SFontArea &area = Areas[getAreaFromCharacter(c)]; offset.X += area.underhang; if (Invisible.findFirst(c) < 0) { indices.push_back(area.spriteno); offsets.push_back(offset); } offset.X += area.width + area.overhang + GlobalKerningWidth; } SpriteBank->draw2DSpriteBatch(indices, offsets, clip, color); } //! Calculates the index of the character in the text which is on a specific position. s32 CGUIFont::getCharacterFromPos(const wchar_t *text, s32 pixel_x) const { s32 x = 0; s32 idx = 0; while (text[idx]) { const SFontArea &a = Areas[getAreaFromCharacter(text[idx])]; x += a.width + a.overhang + a.underhang + GlobalKerningWidth; if (x >= pixel_x) return idx; ++idx; } return -1; } IGUISpriteBank *CGUIFont::getSpriteBank() const { return SpriteBank; } } // end namespace gui } // end namespace irr