2023-01-10 14:26:54 +00:00
|
|
|
/**************************************************************************/
|
|
|
|
/* font.h */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/**************************************************************************/
|
2018-01-04 23:50:27 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
#ifndef FONT_H
|
|
|
|
#define FONT_H
|
|
|
|
|
2018-09-11 16:13:45 +00:00
|
|
|
#include "core/map.h"
|
|
|
|
#include "core/resource.h"
|
2014-02-10 01:10:30 +00:00
|
|
|
#include "scene/resources/texture.h"
|
2022-11-16 18:12:16 +00:00
|
|
|
#include "servers/visual/visual_server_canvas_helper.h"
|
2016-04-29 01:21:18 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
class Font : public Resource {
|
2017-03-05 15:44:50 +00:00
|
|
|
GDCLASS(Font, Resource);
|
2016-04-29 01:21:18 +00:00
|
|
|
|
|
|
|
protected:
|
|
|
|
static void _bind_methods();
|
|
|
|
|
|
|
|
public:
|
2022-05-22 11:57:57 +00:00
|
|
|
enum ContourPointTag {
|
|
|
|
CONTOUR_CURVE_TAG_ON = 0x01,
|
|
|
|
CONTOUR_CURVE_TAG_OFF_CONIC = 0x00,
|
|
|
|
CONTOUR_CURVE_TAG_OFF_CUBIC = 0x02
|
|
|
|
};
|
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
virtual float get_height() const = 0;
|
2016-04-29 01:21:18 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
virtual float get_ascent() const = 0;
|
|
|
|
virtual float get_descent() const = 0;
|
2022-11-12 20:02:54 +00:00
|
|
|
virtual int get_spacing_char() const = 0;
|
2016-04-29 01:21:18 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
virtual Size2 get_char_size(CharType p_char, CharType p_next = 0) const = 0;
|
|
|
|
Size2 get_string_size(const String &p_string) const;
|
2019-03-13 18:14:50 +00:00
|
|
|
Size2 get_wordwrap_string_size(const String &p_string, float p_width) const;
|
2020-11-28 17:54:59 +00:00
|
|
|
Size2 total_size_of_lines(Vector<String> p_lines);
|
2016-04-29 01:21:18 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
virtual bool is_distance_field_hint() const = 0;
|
2016-04-29 01:21:18 +00:00
|
|
|
|
2018-03-17 08:44:34 +00:00
|
|
|
void draw(RID p_canvas_item, const Point2 &p_pos, const String &p_text, const Color &p_modulate = Color(1, 1, 1), int p_clip_w = -1, const Color &p_outline_modulate = Color(1, 1, 1)) const;
|
|
|
|
void draw_halign(RID p_canvas_item, const Point2 &p_pos, HAlign p_align, float p_width, const String &p_text, const Color &p_modulate = Color(1, 1, 1), const Color &p_outline_modulate = Color(1, 1, 1)) const;
|
|
|
|
|
|
|
|
virtual bool has_outline() const { return false; }
|
2022-11-16 18:12:16 +00:00
|
|
|
float draw_char(RID p_canvas_item, const Point2 &p_pos, CharType p_char, CharType p_next = 0, const Color &p_modulate = Color(1, 1, 1), bool p_outline = false) const { return draw_char_ex(p_canvas_item, p_pos, p_char, p_next, p_modulate, p_outline); }
|
|
|
|
virtual float draw_char_ex(RID p_canvas_item, const Point2 &p_pos, CharType p_char, CharType p_next = 0, const Color &p_modulate = Color(1, 1, 1), bool p_outline = false, MultiRect *p_multirect = nullptr) const = 0;
|
2016-04-29 01:21:18 +00:00
|
|
|
|
2022-05-21 17:12:12 +00:00
|
|
|
virtual RID get_char_texture(CharType p_char, CharType p_next, bool p_outline) const = 0;
|
|
|
|
virtual Size2 get_char_texture_size(CharType p_char, CharType p_next, bool p_outline) const = 0;
|
|
|
|
|
|
|
|
virtual Vector2 get_char_tx_offset(CharType p_char, CharType p_next, bool p_outline) const = 0;
|
|
|
|
virtual Size2 get_char_tx_size(CharType p_char, CharType p_next, bool p_outline) const = 0;
|
|
|
|
virtual Rect2 get_char_tx_uv_rect(CharType p_char, CharType p_next, bool p_outline) const = 0;
|
|
|
|
|
2022-05-22 11:57:57 +00:00
|
|
|
virtual Dictionary get_char_contours(CharType p_char, CharType p_next = 0) const { return Dictionary(); }
|
|
|
|
|
2016-07-18 12:59:31 +00:00
|
|
|
void update_changes();
|
2016-04-29 01:21:18 +00:00
|
|
|
Font();
|
|
|
|
};
|
|
|
|
|
2018-03-17 08:44:34 +00:00
|
|
|
// Helper class to that draws outlines immediately and draws characters in its destructor.
|
|
|
|
class FontDrawer {
|
|
|
|
const Ref<Font> &font;
|
|
|
|
Color outline_color;
|
|
|
|
bool has_outline;
|
2022-11-16 18:12:16 +00:00
|
|
|
MultiRect multirect;
|
2018-03-17 08:44:34 +00:00
|
|
|
|
|
|
|
struct PendingDraw {
|
|
|
|
RID canvas_item;
|
|
|
|
Point2 pos;
|
|
|
|
CharType chr;
|
|
|
|
CharType next;
|
|
|
|
Color modulate;
|
|
|
|
};
|
|
|
|
|
|
|
|
Vector<PendingDraw> pending_draws;
|
|
|
|
|
|
|
|
public:
|
2022-11-16 18:12:16 +00:00
|
|
|
FontDrawer(const Ref<Font> &p_font, const Color &p_outline_color);
|
2018-03-17 08:44:34 +00:00
|
|
|
|
|
|
|
float draw_char(RID p_canvas_item, const Point2 &p_pos, CharType p_char, CharType p_next = 0, const Color &p_modulate = Color(1, 1, 1)) {
|
|
|
|
if (has_outline) {
|
|
|
|
PendingDraw draw = { p_canvas_item, p_pos, p_char, p_next, p_modulate };
|
|
|
|
pending_draws.push_back(draw);
|
|
|
|
}
|
2022-11-16 18:12:16 +00:00
|
|
|
return font->draw_char_ex(p_canvas_item, p_pos, p_char, p_next, has_outline ? outline_color : p_modulate, has_outline, &multirect);
|
2018-03-17 08:44:34 +00:00
|
|
|
}
|
2022-11-16 18:12:16 +00:00
|
|
|
MultiRect &get_multirect() { return multirect; }
|
2023-07-15 12:52:10 +00:00
|
|
|
void flush();
|
2018-03-17 08:44:34 +00:00
|
|
|
|
2022-11-16 18:12:16 +00:00
|
|
|
~FontDrawer();
|
2018-03-17 08:44:34 +00:00
|
|
|
};
|
|
|
|
|
2016-04-29 01:21:18 +00:00
|
|
|
class BitmapFont : public Font {
|
2017-03-05 15:44:50 +00:00
|
|
|
GDCLASS(BitmapFont, Font);
|
2017-06-15 22:44:11 +00:00
|
|
|
RES_BASE_EXTENSION("font");
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2021-05-04 12:20:36 +00:00
|
|
|
Vector<Ref<Texture>> textures;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
|
|
|
public:
|
|
|
|
struct Character {
|
|
|
|
int texture_idx;
|
|
|
|
Rect2 rect;
|
|
|
|
float v_align;
|
|
|
|
float h_align;
|
|
|
|
float advance;
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
Character() {
|
|
|
|
texture_idx = 0;
|
|
|
|
v_align = 0;
|
|
|
|
}
|
2014-02-10 01:10:30 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct KerningPairKey {
|
|
|
|
union {
|
|
|
|
struct {
|
2017-03-05 15:44:50 +00:00
|
|
|
uint32_t A, B;
|
2014-02-10 01:10:30 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
uint64_t pair;
|
|
|
|
};
|
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
_FORCE_INLINE_ bool operator<(const KerningPairKey &p_r) const { return pair < p_r.pair; }
|
2014-02-10 01:10:30 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
private:
|
2021-11-05 10:45:47 +00:00
|
|
|
HashMap<int32_t, Character> char_map;
|
2017-03-05 15:44:50 +00:00
|
|
|
Map<KerningPairKey, int> kerning_map;
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
float height;
|
|
|
|
float ascent;
|
2015-03-21 03:43:33 +00:00
|
|
|
bool distance_field_hint;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
void _set_chars(const PoolVector<int> &p_chars);
|
2017-01-07 21:25:37 +00:00
|
|
|
PoolVector<int> _get_chars() const;
|
2017-03-05 15:44:50 +00:00
|
|
|
void _set_kernings(const PoolVector<int> &p_kernings);
|
2017-01-07 21:25:37 +00:00
|
|
|
PoolVector<int> _get_kernings() const;
|
2017-03-05 15:44:50 +00:00
|
|
|
void _set_textures(const Vector<Variant> &p_textures);
|
2014-02-10 01:10:30 +00:00
|
|
|
Vector<Variant> _get_textures() const;
|
|
|
|
|
2016-04-29 01:21:18 +00:00
|
|
|
Ref<BitmapFont> fallback;
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
protected:
|
2014-02-10 01:10:30 +00:00
|
|
|
static void _bind_methods();
|
|
|
|
|
|
|
|
public:
|
2017-03-05 15:44:50 +00:00
|
|
|
Error create_from_fnt(const String &p_file);
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
void set_height(float p_height);
|
|
|
|
float get_height() const;
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
void set_ascent(float p_ascent);
|
2016-03-08 23:00:52 +00:00
|
|
|
float get_ascent() const;
|
2014-02-10 01:10:30 +00:00
|
|
|
float get_descent() const;
|
2022-11-12 20:02:54 +00:00
|
|
|
int get_spacing_char() const {
|
|
|
|
return 0;
|
|
|
|
}
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
void add_texture(const Ref<Texture> &p_texture);
|
2021-11-05 10:45:47 +00:00
|
|
|
void add_char(int32_t p_char, int p_texture_idx, const Rect2 &p_rect, const Size2 &p_align, float p_advance = -1);
|
2014-02-10 01:10:30 +00:00
|
|
|
|
|
|
|
int get_character_count() const;
|
2021-11-05 10:45:47 +00:00
|
|
|
Vector<int32_t> get_char_keys() const;
|
|
|
|
Character get_character(int32_t p_char) const;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
|
|
|
int get_texture_count() const;
|
|
|
|
Ref<Texture> get_texture(int p_idx) const;
|
|
|
|
|
2021-11-05 10:45:47 +00:00
|
|
|
void add_kerning_pair(int32_t p_A, int32_t p_B, int p_kerning);
|
|
|
|
int get_kerning_pair(int32_t p_A, int32_t p_B) const;
|
2014-02-10 01:10:30 +00:00
|
|
|
Vector<KerningPairKey> get_kerning_pair_keys() const;
|
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
Size2 get_char_size(CharType p_char, CharType p_next = 0) const;
|
2015-12-11 02:02:40 +00:00
|
|
|
|
2016-04-29 01:21:18 +00:00
|
|
|
void set_fallback(const Ref<BitmapFont> &p_fallback);
|
|
|
|
Ref<BitmapFont> get_fallback() const;
|
2015-12-11 02:02:40 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
void clear();
|
2015-03-21 03:43:33 +00:00
|
|
|
|
|
|
|
void set_distance_field_hint(bool p_distance_field);
|
|
|
|
bool is_distance_field_hint() const;
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2022-11-16 18:12:16 +00:00
|
|
|
float draw_char_ex(RID p_canvas_item, const Point2 &p_pos, CharType p_char, CharType p_next = 0, const Color &p_modulate = Color(1, 1, 1), bool p_outline = false, MultiRect *p_multirect = nullptr) const;
|
2016-03-08 23:00:52 +00:00
|
|
|
|
2022-05-21 17:12:12 +00:00
|
|
|
RID get_char_texture(CharType p_char, CharType p_next, bool p_outline) const;
|
|
|
|
Size2 get_char_texture_size(CharType p_char, CharType p_next, bool p_outline) const;
|
|
|
|
|
|
|
|
Vector2 get_char_tx_offset(CharType p_char, CharType p_next, bool p_outline) const;
|
|
|
|
Size2 get_char_tx_size(CharType p_char, CharType p_next, bool p_outline) const;
|
|
|
|
Rect2 get_char_tx_uv_rect(CharType p_char, CharType p_next, bool p_outline) const;
|
|
|
|
|
2016-04-29 01:21:18 +00:00
|
|
|
BitmapFont();
|
|
|
|
~BitmapFont();
|
2014-02-10 01:10:30 +00:00
|
|
|
};
|
|
|
|
|
2018-01-16 20:57:36 +00:00
|
|
|
class ResourceFormatLoaderBMFont : public ResourceFormatLoader {
|
|
|
|
public:
|
2022-06-25 19:51:37 +00:00
|
|
|
virtual RES load(const String &p_path, const String &p_original_path = "", Error *r_error = nullptr, bool p_no_subresource_cache = false);
|
2018-01-16 20:57:36 +00:00
|
|
|
virtual void get_recognized_extensions(List<String> *p_extensions) const;
|
|
|
|
virtual bool handles_type(const String &p_type) const;
|
|
|
|
virtual String get_resource_type(const String &p_path) const;
|
|
|
|
};
|
|
|
|
|
2022-05-22 11:57:57 +00:00
|
|
|
VARIANT_ENUM_CAST(Font::ContourPointTag);
|
|
|
|
|
2022-07-25 10:33:41 +00:00
|
|
|
#endif // FONT_H
|