Text.hpp

//
// SFML - Simple and Fast Multimedia Library
// Copyright (C) 2007-2014 Laurent Gomila (laurent.gom@gmail.com)
//
// This software is provided 'as-is', without any express or implied warranty.
// In no event will the authors be held liable for any damages arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it freely,
// subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented;
//    you must not claim that you wrote the original software.
//    If you use this software in a product, an acknowledgment
//    in the product documentation would be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such,
//    and must not be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
//

#ifndef CPP3DS_TEXT_HPP
#define CPP3DS_TEXT_HPP

// Headers
#include <cpp3ds/Graphics/Drawable.hpp>
#include <cpp3ds/Graphics/Transformable.hpp>
#include <cpp3ds/Graphics/Font.hpp>
#include <cpp3ds/Graphics/Rect.hpp>
#include <cpp3ds/Graphics/VertexArray.hpp>
#include <cpp3ds/System/String.hpp>
#include <string>
#include <vector>


namespace cpp3ds
{
class Text : public Drawable, public Transformable
{
public :

    enum Style
    {
        Regular    = 0,      
        Bold       = 1 << 0, 
        Italic     = 1 << 1, 
        Underlined = 1 << 2  
    };

    Text();

    Text(const String& string, const Font& font, unsigned int characterSize = 30);

    void setString(const String& string);

    void setFont(const Font& font);

    void setCharacterSize(unsigned int size);

    void setStyle(Uint32 style);

    void setColor(const Color& color);

    const String& getString() const;

    const Font* getFont() const;

    unsigned int getCharacterSize() const;

    Uint32 getStyle() const;

    const Color& getColor() const;

    Vector2f findCharacterPos(std::size_t index) const;

    FloatRect getLocalBounds() const;

    FloatRect getGlobalBounds() const;

    // Override position functions from Transformable.
    // The 3DS text renders poorly without rounded coordinates.
    void setPosition(float x, float y);
    void setPosition(const Vector2f& position);

private :

    virtual void draw(RenderTarget& target, RenderStates states) const;

    void ensureGeometryUpdate() const;

    // Member data
    String              m_string;             
    const Font*         m_font;               
    unsigned int        m_characterSize;      
    Uint32              m_style;              
    Color               m_color;              
    mutable VertexArray m_vertices;           
    mutable FloatRect   m_bounds;             
    mutable bool        m_geometryNeedUpdate; 
};

} // namespace cpp3ds


#endif