text_mesher.h

/********************************************************************
 * Copyright (C) 2015 Liangliang Nan <liangliang.nan@gmail.com>
 * https://3d.bk.tudelft.nl/liangliang/
 *
 * This file is part of Easy3D. If it is useful in your research/work,
 * I would be grateful if you show your appreciation by citing it:
 * ------------------------------------------------------------------
 *      Liangliang Nan.
 *      Easy3D: a lightweight, easy-to-use, and efficient C++ library
 *      for processing and rendering 3D data.
 *      Journal of Open Source Software, 6(64), 3255, 2021.
 * ------------------------------------------------------------------
 *
 * Easy3D is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License Version 3
 * as published by the Free Software Foundation.
 *
 * Easy3D 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/>.
 ********************************************************************/
 
 
#ifndef EASY3D_ALGO_TEXT_MESHER_H
#define EASY3D_ALGO_TEXT_MESHER_H
 
#include <string>
 
#include <easy3d/core/types.h>
 
 
namespace easy3d {
 
    class SurfaceMesh;

    class TextMesher {
    public:
        explicit TextMesher(const std::string &font_file, unsigned short quality = 4);
        ~TextMesher();

        void set_font(const std::string &font_file);

        SurfaceMesh *
        generate(const std::string &text, float x, float y, int font_size, float height, bool collision_free = false);

        bool generate(SurfaceMesh *mesh, const std::string &text, float x, float y, int font_size, float height,
                      bool collision_free = false);

        bool generate(const std::string &text, float x, float y, int font_size,
                      std::vector<std::vector<Polygon2> > &contours, bool collision_free);
 
    private:

        bool _generate(SurfaceMesh *mesh, const std::wstring &text, float x, float y, int font_size, float height,
                       bool collision_free);

        bool _generate_contours(const std::wstring &text, float x, float y, int font_size,
                                std::vector<std::vector<Polygon2> > &contours, bool collision_free);

        bool _generate_contours(int codepoint, float &x, float &y, int font_size, std::vector<Polygon2> &contours);
 
    private:
        void *font_;
        bool ready_;
 
        std::string font_file_;
        std::vector<unsigned char> font_data_;
 
        // Controls the smoothness of the curved corners. A greater value results in a smooth transitions but more
        // vertices. Suggested value is 4.
        unsigned short bezier_steps_;
    };
 
}
 
 
#endif  // EASY3D_ALGO_TEXT_MESHER_H