#ifndef slic3r_Emboss_hpp_ #define slic3r_Emboss_hpp_ #include #include #include #include #include // indexed_triangle_set #include "Polygon.hpp" #include "ExPolygon.hpp" #include "TextConfiguration.hpp" namespace Slic3r { /// /// class with only static function add ability to engraved OR raised /// text OR polygons onto model surface /// class Emboss { public: Emboss() = delete; // every glyph's shape point is divided by SHAPE_SCALE - increase precission of fixed point value static double SHAPE_SCALE; /// /// Collect fonts registred inside OS /// /// OS registred TTF font files(full path) with names static EmbossStyles get_font_list(); #ifdef _WIN32 static EmbossStyles get_font_list_by_register(); static EmbossStyles get_font_list_by_enumeration(); static EmbossStyles get_font_list_by_folder(); #endif /// /// OS dependent function to get location of font by its name descriptor /// /// Unique identificator for font /// File path to font when found static std::optional get_font_path(const std::wstring &font_face_name); // description of one letter struct Glyph { // NOTE: shape is scaled by SHAPE_SCALE // to be able store points without floating points ExPolygons shape; // values are in font points int advance_width=0, left_side_bearing=0; }; // cache for glyph by unicode using Glyphs = std::map; /// /// keep information from file about font /// (store file data itself) /// + cache data readed from buffer /// struct FontFile { // loaded data from font file // must store data size for imgui rasterization // To not store data on heap and To prevent unneccesary copy // data are stored inside unique_ptr std::unique_ptr> data; struct Info { // vertical position is "scale*(ascent - descent + lineGap)" int ascent, descent, linegap; // for convert font units to pixel int unit_per_em; }; // info for each font in data std::vector infos; FontFile(std::unique_ptr> data, std::vector &&infos) : data(std::move(data)), infos(std::move(infos)) { assert(this->data != nullptr); assert(!this->data->empty()); } bool operator==(const FontFile &other) const { if (data->size() != other.data->size()) return false; //if(*data != *other.data) return false; for (size_t i = 0; i < infos.size(); i++) if (infos[i].ascent != other.infos[i].ascent || infos[i].descent == other.infos[i].descent || infos[i].linegap == other.infos[i].linegap) return false; return true; } }; /// /// Add caching for shape of glyphs /// struct FontFileWithCache { // Pointer on data of the font file std::shared_ptr font_file; // Cache for glyph shape // IMPORTANT: accessible only in plater job thread !!! // main thread only clear cache by set to another shared_ptr std::shared_ptr cache; FontFileWithCache() : font_file(nullptr), cache(nullptr) {} FontFileWithCache(std::unique_ptr font_file) : font_file(std::move(font_file)) , cache(std::make_shared()) {} bool has_value() const { return font_file != nullptr && cache != nullptr; } }; /// /// Load font file into buffer /// /// Location of .ttf or .ttc font file /// Font object when loaded. static std::unique_ptr create_font_file(const char *file_path); // data = raw file data static std::unique_ptr create_font_file(std::unique_ptr> data); #ifdef _WIN32 // fix for unknown pointer HFONT using HFONT = void*; static void * can_load(HFONT hfont); static std::unique_ptr create_font_file(HFONT hfont); #endif // _WIN32 /// /// convert letter into polygons /// /// Define fonts /// Index of font in collection /// One character defined by unicode codepoint /// Precision of lettter outline curve in conversion to lines /// inner polygon cw(outer ccw) static std::optional letter2glyph(const FontFile &font, unsigned int font_index, int letter, float flatness); /// /// Convert text into polygons /// /// Define fonts + cache, which could extend /// Characters to convert /// User defined property of the font /// Inner polygon cw(outer ccw) static ExPolygons text2shapes(FontFileWithCache &font, const char *text, const FontProp &font_prop); /// /// Use data from font property to modify transformation /// /// Z-move as surface distance(FontProp::distance) /// Z-rotation as angle to Y axis(FontProp::angle) /// In / Out transformation to modify by property static void apply_transformation(const FontProp &font_prop, Transform3d &transformation); /// /// Read information from naming table of font file /// search for italic (or oblique), bold italic (or bold oblique) /// /// Selector of font /// Index of font in collection /// True when the font description contains italic/obligue otherwise False static bool is_italic(const FontFile &font, unsigned int font_index); /// /// Create unique character set from string with filtered from text with only character from font /// /// Source vector of glyphs /// Font descriptor /// Define font in collection /// True when text contain glyph unknown in font /// Unique set of character from text contained in font static std::string create_range_text(const std::string &text, const FontFile &font, unsigned int font_index, bool* exist_unknown = nullptr); /// /// calculate scale for glyph shape convert from shape points to mm /// /// /// /// Conversion to mm static double get_shape_scale(const FontProp &fp, const FontFile &ff); /// /// Project spatial point /// class IProject3f { public: virtual ~IProject3f() = default; /// /// Move point with respect to projection direction /// e.g. Orthogonal projection will move with point by direction /// e.g. Spherical projection need to use center of projection /// /// Spatial point coordinate /// Projected spatial point virtual Vec3f project(const Vec3f &point) const = 0; }; /// /// Project 2d point into space /// Could be plane, sphere, cylindric, ... /// class IProjection : public IProject3f { public: virtual ~IProjection() = default; /// /// convert 2d point to 3d points /// /// 2d coordinate /// /// first - front spatial point /// second - back spatial point /// virtual std::pair create_front_back(const Point &p) const = 0; }; /// /// Create triangle model for text /// /// text or image /// Define transformation from 2d to 3d(orientation, position, scale, ...) /// Projected shape into space static indexed_triangle_set polygons2model(const ExPolygons &shape2d, const IProjection& projection); /// /// Create transformation for emboss text object to lay on surface point /// /// Position of surface point /// Normal of surface point /// Is compared with normal.z to suggest up direction /// Transformation onto surface point static Transform3d create_transformation_onto_surface( const Vec3f &position, const Vec3f &normal, float up_limit = 0.9f); class ProjectZ : public IProjection { public: ProjectZ(float depth) : m_depth(depth) {} // Inherited via IProject std::pair create_front_back(const Point &p) const override; Vec3f project(const Vec3f &point) const override; float m_depth; }; class ProjectScale : public IProjection { std::unique_ptr core; float m_scale; public: ProjectScale(std::unique_ptr core, float scale) : core(std::move(core)), m_scale(scale) {} // Inherited via IProject std::pair create_front_back(const Point &p) const override { auto res = core->create_front_back(p); return std::make_pair(res.first * m_scale, res.second * m_scale); } Vec3f project(const Vec3f &point) const override{ return core->project(point); } }; class OrthoProject3f : public Emboss::IProject3f { // size and direction of emboss for ortho projection Vec3f m_direction; public: OrthoProject3f(Vec3f direction) : m_direction(direction) {} Vec3f project(const Vec3f &point) const override{ return point + m_direction;} }; class OrthoProject: public Emboss::IProjection { Transform3d m_matrix; // size and direction of emboss for ortho projection Vec3f m_direction; public: OrthoProject(Transform3d matrix, Vec3f direction) : m_matrix(matrix), m_direction(direction) {} // Inherited via IProject std::pair create_front_back(const Point &p) const override; Vec3f project(const Vec3f &point) const override; }; }; } // namespace Slic3r #endif // slic3r_Emboss_hpp_