/*************************************************************************/ /* rich_text_label.h */ /*************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /*************************************************************************/ /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */ /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */ /* */ /* 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. */ /*************************************************************************/ #ifndef RICH_TEXT_LABEL_H #define RICH_TEXT_LABEL_H #include "rich_text_effect.h" #include "scene/gui/scroll_bar.h" class RichTextLabel : public Control { GDCLASS(RichTextLabel, Control); public: enum Align { ALIGN_LEFT, ALIGN_CENTER, ALIGN_RIGHT, ALIGN_FILL }; enum InlineAlign { INLINE_ALIGN_TOP, INLINE_ALIGN_CENTER, INLINE_ALIGN_BASELINE, INLINE_ALIGN_BOTTOM }; enum ListType { LIST_NUMBERS, LIST_LETTERS, LIST_DOTS }; enum ItemType { ITEM_FRAME, ITEM_TEXT, ITEM_IMAGE, ITEM_NEWLINE, ITEM_FONT, ITEM_COLOR, ITEM_UNDERLINE, ITEM_STRIKETHROUGH, ITEM_ALIGN, ITEM_INDENT, ITEM_LIST, ITEM_TABLE, ITEM_FADE, ITEM_SHAKE, ITEM_WAVE, ITEM_TORNADO, ITEM_RAINBOW, ITEM_META, ITEM_CUSTOMFX }; protected: static void _bind_methods(); private: struct Item; struct Line { Item *from; Vector offset_caches; Vector height_caches; Vector ascent_caches; Vector descent_caches; Vector space_caches; int height_cache; int height_accum_cache; int char_count; int minimum_width; int maximum_width; Line() { from = nullptr; char_count = 0; } }; struct Item { int index; Item *parent; ItemType type; List subitems; List::Element *E; int line; void _clear_children() { while (subitems.size()) { memdelete(subitems.front()->get()); subitems.pop_front(); } } Item() { parent = nullptr; E = nullptr; line = 0; } virtual ~Item() { _clear_children(); } }; struct ItemFrame : public Item { int parent_line; bool cell; Vector lines; int first_invalid_line; ItemFrame *parent_frame; ItemFrame() { type = ITEM_FRAME; parent_frame = nullptr; cell = false; parent_line = 0; } }; struct ItemText : public Item { String text; ItemText() { type = ITEM_TEXT; } }; struct ItemImage : public Item { Ref image; Size2 size; InlineAlign align; ItemImage() { type = ITEM_IMAGE; align = INLINE_ALIGN_BASELINE; } }; struct ItemFont : public Item { Ref font; ItemFont() { type = ITEM_FONT; } }; struct ItemColor : public Item { Color color; ItemColor() { type = ITEM_COLOR; } }; struct ItemUnderline : public Item { ItemUnderline() { type = ITEM_UNDERLINE; } }; struct ItemStrikethrough : public Item { ItemStrikethrough() { type = ITEM_STRIKETHROUGH; } }; struct ItemMeta : public Item { Variant meta; ItemMeta() { type = ITEM_META; } }; struct ItemAlign : public Item { Align align; ItemAlign() { type = ITEM_ALIGN; } }; struct ItemIndent : public Item { int level; ItemIndent() { type = ITEM_INDENT; } }; struct ItemList : public Item { ListType list_type; ItemList() { type = ITEM_LIST; } }; struct ItemNewline : public Item { ItemNewline() { type = ITEM_NEWLINE; } }; struct ItemTable : public Item { struct Column { bool expand; int expand_ratio; int min_width; int max_width; int width; }; Vector columns; int total_width; ItemTable() { type = ITEM_TABLE; } }; struct ItemFade : public Item { int starting_index; int length; ItemFade() { type = ITEM_FADE; } }; struct ItemFX : public Item { float elapsed_time; ItemFX() { elapsed_time = 0.0f; } }; struct ItemShake : public ItemFX { int strength; float rate; uint64_t _current_rng; uint64_t _previous_rng; ItemShake() { strength = 0; rate = 0.0f; _current_rng = 0; type = ITEM_SHAKE; } void reroll_random() { _previous_rng = _current_rng; _current_rng = Math::rand(); } uint64_t offset_random(int index) { return (_current_rng >> (index % 64)) | (_current_rng << (64 - (index % 64))); } uint64_t offset_previous_random(int index) { return (_previous_rng >> (index % 64)) | (_previous_rng << (64 - (index % 64))); } }; struct ItemWave : public ItemFX { float frequency; float amplitude; ItemWave() { frequency = 1.0f; amplitude = 1.0f; type = ITEM_WAVE; } }; struct ItemTornado : public ItemFX { float radius; float frequency; ItemTornado() { radius = 1.0f; frequency = 1.0f; type = ITEM_TORNADO; } }; struct ItemRainbow : public ItemFX { float saturation; float value; float frequency; ItemRainbow() { saturation = 0.8f; value = 0.8f; frequency = 1.0f; type = ITEM_RAINBOW; } }; struct ItemCustomFX : public ItemFX { Ref char_fx_transform; Ref custom_effect; ItemCustomFX() { type = ITEM_CUSTOMFX; char_fx_transform.instance(); } virtual ~ItemCustomFX() { _clear_children(); char_fx_transform.unref(); custom_effect.unref(); } }; ItemFrame *main; Item *current; ItemFrame *current_frame; VScrollBar *vscroll; bool scroll_visible; bool scroll_follow; bool scroll_following; bool scroll_active; int scroll_w; bool scroll_updated; bool updating_scroll; int current_idx; int visible_line_count; int tab_size; bool underline_meta; bool override_selected_font_color; Align default_align; ItemMeta *meta_hovering; Variant current_meta; Vector> custom_effects; void _invalidate_current_line(ItemFrame *p_frame); void _validate_line_caches(ItemFrame *p_frame); void _add_item(Item *p_item, bool p_enter = false, bool p_ensure_newline = false); void _remove_item(Item *p_item, const int p_line, const int p_subitem_line); struct ProcessState { int line_width; }; enum ProcessMode { PROCESS_CACHE, PROCESS_DRAW, PROCESS_POINTER }; struct Selection { Item *click; int click_char; Item *from; int from_char; Item *to; int to_char; bool active; // anything selected? i.e. from, to, etc. valid? bool enabled; // allow selections? bool drag_attempt; }; Selection selection; bool deselect_on_focus_loss_enabled; int visible_characters; float percent_visible; bool _is_click_inside_selection() const; int _process_line(ItemFrame *p_frame, const Vector2 &p_ofs, int &y, int p_width, int p_line, ProcessMode p_mode, const Ref &p_base_font, const Color &p_base_color, const Color &p_font_color_shadow, bool p_shadow_as_outline, const Point2 &shadow_ofs, const Point2i &p_click_pos = Point2i(), Item **r_click_item = nullptr, int *r_click_char = nullptr, bool *r_outside = nullptr, int p_char_count = 0); void _find_click(ItemFrame *p_frame, const Point2i &p_click, Item **r_click_item = nullptr, int *r_click_char = nullptr, bool *r_outside = nullptr); Ref _find_font(Item *p_item); int _find_margin(Item *p_item, const Ref &p_base_font); Align _find_align(Item *p_item); Color _find_color(Item *p_item, const Color &p_default_color); bool _find_underline(Item *p_item); bool _find_strikethrough(Item *p_item); bool _find_meta(Item *p_item, Variant *r_meta, ItemMeta **r_item = nullptr); bool _find_layout_subitem(Item *from, Item *to); bool _find_by_type(Item *p_item, ItemType p_type); void _fetch_item_fx_stack(Item *p_item, Vector &r_stack); void _update_scroll(); void _update_fx(ItemFrame *p_frame, float p_delta_time); void _scroll_changed(double); void _gui_input(Ref p_event); Item *_get_next_item(Item *p_item, bool p_free = false); Item *_get_prev_item(Item *p_item, bool p_free = false); Rect2 _get_text_rect(); Ref _get_custom_effect_by_code(String p_bbcode_identifier); virtual Dictionary parse_expressions_for_values(Vector p_expressions); bool use_bbcode; String bbcode; int fixed_width; bool fit_content_height; protected: void _notification(int p_what); public: String get_text(); void add_text(const String &p_text); void add_image(const Ref &p_image, const int p_width = 0, const int p_height = 0, RichTextLabel::InlineAlign p_align = INLINE_ALIGN_BASELINE); void add_newline(); bool remove_line(const int p_line); void push_font(const Ref &p_font); void push_normal(); void push_bold(); void push_bold_italics(); void push_italics(); void push_mono(); void push_color(const Color &p_color); void push_underline(); void push_strikethrough(); void push_align(Align p_align); void push_indent(int p_level); void push_list(ListType p_list); void push_meta(const Variant &p_meta); void push_table(int p_columns); void push_fade(int p_start_index, int p_length); void push_shake(int p_strength, float p_rate); void push_wave(float p_frequency, float p_amplitude); void push_tornado(float p_frequency, float p_radius); void push_rainbow(float p_saturation, float p_value, float p_frequency); void push_customfx(Ref p_custom_effect, Dictionary p_environment); void set_table_column_expand(int p_column, bool p_expand, int p_ratio = 1); int get_current_table_column() const; void push_cell(); void pop(); void clear(); void set_offset(int p_pixel); void set_meta_underline(bool p_underline); bool is_meta_underlined() const; void set_override_selected_font_color(bool p_override_selected_font_color); bool is_overriding_selected_font_color() const; void set_scroll_active(bool p_active); bool is_scroll_active() const; void set_scroll_follow(bool p_follow); bool is_scroll_following() const; void set_tab_size(int p_spaces); int get_tab_size() const; void set_fit_content_height(bool p_enabled); bool is_fit_content_height_enabled() const; bool search(const String &p_string, bool p_from_selection = false, bool p_search_previous = false); void scroll_to_line(int p_line); int get_line_count() const; int get_visible_line_count() const; int get_content_height() const; VScrollBar *get_v_scroll() { return vscroll; } virtual CursorShape get_cursor_shape(const Point2 &p_pos) const; virtual Variant get_drag_data(const Point2 &p_point); void set_selection_enabled(bool p_enabled); bool is_selection_enabled() const; String get_selected_text(); void selection_copy(); void set_deselect_on_focus_loss_enabled(const bool p_enabled); bool is_deselect_on_focus_loss_enabled() const; void deselect(); Error parse_bbcode(const String &p_bbcode); Error append_bbcode(const String &p_bbcode); void set_use_bbcode(bool p_enable); bool is_using_bbcode() const; void set_bbcode(const String &p_bbcode); String get_bbcode() const; void set_text(const String &p_string); void set_visible_characters(int p_visible); int get_visible_characters() const; int get_total_character_count() const; void set_percent_visible(float p_percent); float get_percent_visible() const; void set_effects(const Vector &effects); Vector get_effects(); void install_effect(const Variant effect); void set_fixed_size_to_width(int p_width); virtual Size2 get_minimum_size() const; RichTextLabel(); ~RichTextLabel(); }; VARIANT_ENUM_CAST(RichTextLabel::Align); VARIANT_ENUM_CAST(RichTextLabel::InlineAlign); VARIANT_ENUM_CAST(RichTextLabel::ListType); VARIANT_ENUM_CAST(RichTextLabel::ItemType); #endif // RICH_TEXT_LABEL_H