add help tab to lettering (#2948)

4 files changed, 539 insertions, 0 deletions

diff --git a/lib/gui/lettering/__init__.py b/lib/gui/lettering/__init__.py
new file mode 100644
index 00000000..970ebca8
--- /dev/null
+++ b/lib/gui/lettering/__init__.py
@@ -0,0 +1,8 @@
+# Authors: see git history
+#
+# Copyright (c) 2024 Authors
+# Licensed under the GNU GPL version 3.0 or later.  See the file LICENSE for details.
+
+from .help_panel import LetteringHelpPanel
+from .option_panel import LetteringOptionsPanel
+from .main_panel import LetteringPanel
diff --git a/lib/gui/lettering/help_panel.py b/lib/gui/lettering/help_panel.py
new file mode 100644
index 00000000..648da180
--- /dev/null
+++ b/lib/gui/lettering/help_panel.py
@@ -0,0 +1,51 @@
+# Authors: see git history
+#
+# Copyright (c) 2024 Authors
+# Licensed under the GNU GPL version 3.0 or later.  See the file LICENSE for details.
+
+import wx
+
+from ...i18n import _
+
+
+class LetteringHelpPanel(wx.Panel):
+    def __init__(self, parent):
+        wx.Panel.__init__(self, parent)
+        help_sizer = wx.BoxSizer(wx.VERTICAL)
+
+        help_text = wx.StaticText(
+            self,
+            wx.ID_ANY,
+            _("Add text to your design."),
+            style=wx.ALIGN_LEFT
+        )
+        help_text.Wrap(500)
+        help_sizer.Add(help_text, 0, wx.ALL, 8)
+
+        website_link = wx.adv.HyperlinkCtrl(
+            self,
+            wx.ID_ANY,
+            _("https://inkstitch.org/docs/lettering/#lettering-tool"),
+            _("https://inkstitch.org/docs/lettering/#lettering-tool")
+        )
+        website_link.Bind(wx.adv.EVT_HYPERLINK, self.on_link_clicked)
+        help_sizer.Add(website_link, 0, wx.ALL, 8)
+
+        help_sizer.Add((20, 20), 0, 0, 0)
+
+        website_info = wx.StaticText(self, wx.ID_ANY, _("A font library with full description and embroidered examples can be found on our website:"))
+        help_sizer.Add(website_info, 0, wx.ALL, 8)
+
+        fontlibrary_link = wx.adv.HyperlinkCtrl(
+            self,
+            wx.ID_ANY,
+            _("https://inkstitch.org/fonts/font-library/"),
+            _("https://inkstitch.org/fonts/font-library/")
+        )
+        fontlibrary_link.Bind(wx.adv.EVT_HYPERLINK, self.on_link_clicked)
+        help_sizer.Add(fontlibrary_link, 0, wx.ALL, 8)
+
+        self.SetSizer(help_sizer)
+
+    def on_link_clicked(self, event):
+        event.Skip()
diff --git a/lib/gui/lettering/main_panel.py b/lib/gui/lettering/main_panel.py
new file mode 100644
index 00000000..eb3d61a4
--- /dev/null
+++ b/lib/gui/lettering/main_panel.py
@@ -0,0 +1,375 @@
+# Authors: see git history
+#
+# Copyright (c) 2010 Authors
+# Licensed under the GNU GPL version 3.0 or later.  See the file LICENSE for details.
+
+import json
+from base64 import b64decode
+
+import inkex
+import wx
+import wx.adv
+
+from ...elements import nodes_to_elements
+from ...i18n import _
+from ...lettering import FontError, get_font_list
+from ...lettering.categories import FONT_CATEGORIES
+from ...stitch_plan import stitch_groups_to_stitch_plan
+from ...svg.tags import INKSCAPE_LABEL, INKSTITCH_LETTERING, SVG_PATH_TAG
+from ...utils import DotDict, cache
+from ...utils.threading import ExitThread, check_stop_flag
+from .. import PresetsPanel, PreviewRenderer, info_dialog
+from . import LetteringHelpPanel, LetteringOptionsPanel
+
+
+class LetteringPanel(wx.Panel):
+    DEFAULT_FONT = "small_font"
+
+    def __init__(self, parent, simulator, group, metadata=None, background_color='white'):
+        self.parent = parent
+        self.simulator = simulator
+        self.group = group
+        self.metadata = metadata or dict()
+        self.background_color = background_color
+
+        super().__init__(parent, wx.ID_ANY)
+
+        self.SetWindowStyle(wx.FRAME_FLOAT_ON_PARENT | wx.DEFAULT_FRAME_STYLE)
+
+        outer_sizer = wx.BoxSizer(wx.VERTICAL)
+
+        self.preview_renderer = PreviewRenderer(self.render_stitch_plan, self.on_stitch_plan_rendered)
+
+        # notebook
+        self.notebook = wx.Notebook(self, wx.ID_ANY)
+        self.options_panel = LetteringOptionsPanel(self.notebook, self)
+        self.notebook.AddPage(self.options_panel, _("Options"))
+        help_panel = LetteringHelpPanel(self.notebook)
+        self.notebook.AddPage(help_panel, _("Help"))
+        outer_sizer.Add(self.notebook, 1, wx.EXPAND | wx.ALL, 10)
+
+        # presets
+        self.presets_panel = PresetsPanel(self)
+        outer_sizer.Add(self.presets_panel, 0, wx.EXPAND | wx.ALL, 10)
+
+        # buttons
+        self.apply_button = wx.Button(self, wx.ID_ANY, _("Apply and Quit"))
+        self.apply_button.Bind(wx.EVT_BUTTON, self.apply)
+        self.cancel_button = wx.Button(self, wx.ID_ANY, _("Cancel"))
+        self.cancel_button.Bind(wx.EVT_BUTTON, self.cancel)
+        self.Bind(wx.EVT_CLOSE, self.cancel)
+        buttons_sizer = wx.BoxSizer(wx.HORIZONTAL)
+        buttons_sizer.Add(self.cancel_button, 0, wx.RIGHT, 10)
+        buttons_sizer.Add(self.apply_button, 0, wx.RIGHT | wx.BOTTOM, 10)
+        outer_sizer.Add(buttons_sizer, 0, wx.ALIGN_RIGHT, 10)
+
+        # set font list
+        self.update_font_list()
+        self.set_font_list()
+
+        self.SetSizer(outer_sizer)
+        self.Layout()
+
+        # SetSizerAndFit determined the minimum size that fits all the controls
+        # and set the window's minimum size so that the user can't make it
+        # smaller.  It also set the window to that size.  We'd like to give the
+        # user a bit more room for text, so we'll add some height.
+        size = self.options_panel.GetSize()
+        size.height = size.height + 200
+        self.options_panel.SetSize(size)
+
+        self.load_settings()
+        self.apply_settings()
+
+    def load_settings(self):
+        """Load the settings saved into the SVG group element"""
+
+        self.settings = DotDict({
+            "text": "",
+            "back_and_forth": False,
+            "font": None,
+            "scale": 100,
+            "trim_option": 0,
+            "use_trim_symbols": False
+        })
+
+        if INKSTITCH_LETTERING in self.group.attrib:
+            try:
+                self.settings.update(json.loads(self.group.get(INKSTITCH_LETTERING)))
+            except json.decoder.JSONDecodeError:
+                # legacy base64 encoded (changed in v2.0)
+                try:
+                    self.settings.update(json.loads(b64decode(self.group.get(INKSTITCH_LETTERING))))
+                except (TypeError, ValueError):
+                    pass
+            except (TypeError, ValueError):
+                pass
+
+    def apply_settings(self):
+        """Make the settings in self.settings visible in the UI."""
+        self.options_panel.back_and_forth_checkbox.SetValue(bool(self.settings.back_and_forth))
+        self.options_panel.trim_option_choice.SetSelection(self.settings.trim_option)
+        self.options_panel.use_trim_symbols.SetValue(bool(self.settings.use_trim_symbols))
+        self.options_panel.text_editor.SetValue(self.settings.text)
+        self.options_panel.scale_spinner.SetValue(self.settings.scale)
+        self.set_initial_font(self.settings.font)
+
+    def save_settings(self):
+        """Save the settings into the SVG group element."""
+        self.group.set(INKSTITCH_LETTERING, json.dumps(self.settings))
+
+    @property
+    @cache
+    def font_list(self):
+        return get_font_list()
+
+    def update_font_list(self):
+        self.fonts = {}
+        self.fonts_by_id = {}
+
+        # font size filter value
+        filter_size = self.options_panel.font_size_filter.GetValue()
+        filter_glyph = self.options_panel.font_glyph_filter.GetValue()
+        filter_category = self.options_panel.font_category_filter.GetSelection() - 1
+
+        # glyph filter string without spaces
+        glyphs = [*self.options_panel.text_editor.GetValue().replace(" ", "").replace("\n", "")]
+
+        for font in self.font_list:
+            if filter_glyph and glyphs and not set(glyphs).issubset(font.available_glyphs):
+                continue
+
+            if filter_category != -1:
+                category = FONT_CATEGORIES[filter_category].id
+                if category not in font.keywords:
+                    continue
+
+            if filter_size != 0 and (filter_size < font.size * font.min_scale or filter_size > font.size * font.max_scale):
+                continue
+
+            self.fonts[font.marked_custom_font_name] = font
+            self.fonts_by_id[font.marked_custom_font_id] = font
+
+    def set_font_list(self):
+        self.options_panel.font_chooser.Clear()
+        for font in self.fonts.values():
+            image = font.preview_image
+
+            if image is not None:
+                image = wx.Image(image)
+                """
+                # I would like to do this but Windows requires all images to be the exact same size
+                # It might work with an updated wxpython version - so let's keep it here
+
+                # Scale to max 20 height
+                img_height = 20
+                width, height = image.GetSize()
+                scale_factor = height / img_height
+                width = int(width / scale_factor)
+                image.Rescale(width, img_height, quality=wx.IMAGE_QUALITY_HIGH)
+                """
+                # Windows requires all images to have the exact same size
+                image.Rescale(300, 20, quality=wx.IMAGE_QUALITY_HIGH)
+                self.options_panel.font_chooser.Append(font.marked_custom_font_name, wx.Bitmap(image))
+            else:
+                self.options_panel.font_chooser.Append(font.marked_custom_font_name)
+
+    def get_font_descriptions(self):
+        return {font.name: font.description for font in self.fonts.values()}
+
+    def set_initial_font(self, font_id):
+        if font_id:
+            if font_id not in self.fonts_by_id:
+                message = '''This text was created using the font "%s", but Ink/Stitch can't find that font.  ''' \
+                          '''A default font will be substituted.'''
+                info_dialog(self, _(message) % font_id)
+        try:
+            font = self.fonts_by_id[font_id].marked_custom_font_name
+        except KeyError:
+            font = self.default_font.marked_custom_font_name
+        self.options_panel.font_chooser.SetValue(font)
+
+        self.on_font_changed()
+
+    @property
+    def default_font(self):
+        try:
+            return self.fonts_by_id[self.DEFAULT_FONT]
+        except KeyError:
+            return list(self.fonts.values())[0]
+
+    def on_change(self, attribute, event):
+        self.settings[attribute] = event.GetEventObject().GetValue()
+        if attribute == "text" and self.options_panel.font_glyph_filter.GetValue() is True:
+            self.on_filter_changed()
+        self.preview_renderer.update()
+
+    def on_trim_option_change(self, event=None):
+        self.settings.trim_option = self.options_panel.trim_option_choice.GetCurrentSelection()
+        self.preview_renderer.update()
+
+    def on_font_changed(self, event=None):
+        font = self.fonts.get(self.options_panel.font_chooser.GetValue(), self.default_font)
+        self.settings.font = font.marked_custom_font_id
+
+        filter_size = self.options_panel.font_size_filter.GetValue()
+        self.options_panel.scale_spinner.SetRange(int(font.min_scale * 100), int(font.max_scale * 100))
+        if filter_size != 0:
+            self.options_panel.scale_spinner.SetValue(int(filter_size / font.size * 100))
+        self.settings['scale'] = self.options_panel.scale_spinner.GetValue()
+
+        font_variants = []
+        try:
+            font_variants = font.has_variants()
+        except FontError:
+            pass
+
+        # Update font description
+        color = wx.NullColour
+        description = font.description
+        if len(font_variants) == 0:
+            color = (255, 0, 0)
+            description = _('This font has no available font variant. Please update or remove the font.')
+        self.options_panel.font_description.SetLabel(description)
+        self.options_panel.font_description.SetForegroundColour(color)
+        self.options_panel.font_description.Wrap(self.options_panel.GetSize().width - 50)
+
+        if font.reversible:
+            self.options_panel.back_and_forth_checkbox.Enable()
+            self.options_panel.back_and_forth_checkbox.SetValue(bool(self.settings.back_and_forth))
+        else:
+            # The creator of the font banned the possibility of writing in reverse with json file: "reversible": false
+            self.options_panel.back_and_forth_checkbox.Disable()
+            self.options_panel.back_and_forth_checkbox.SetValue(False)
+
+        self.update_preview()
+        self.Layout()
+
+    def on_filter_changed(self, event=None):
+        self.update_font_list()
+
+        if not self.fonts:
+            # No fonts for filtered size
+            self.options_panel.font_chooser.Clear()
+            self.options_panel.filter_box.SetForegroundColour("red")
+            return
+        else:
+            self.options_panel.filter_box.SetForegroundColour(wx.NullColour)
+
+        filter_size = self.options_panel.font_size_filter.GetValue()
+        previous_font = self.options_panel.font_chooser.GetValue()
+        self.set_font_list()
+        font = self.fonts.get(previous_font, self.default_font)
+        self.options_panel.font_chooser.SetValue(font.marked_custom_font_name)
+        if font.marked_custom_font_name != previous_font:
+            self.on_font_changed()
+        elif filter_size != 0:
+            self.options_panel.scale_spinner.SetValue(int(filter_size / font.size * 100))
+            self.settings['scale'] = self.options_panel.scale_spinner.GetValue()
+
+    def resize(self, event=None):
+        description = self.options_panel.font_description.GetLabel().replace("\n", " ")
+        self.options_panel.font_description.SetLabel(description)
+        self.options_panel.font_description.Wrap(self.options_panel.GetSize().width - 50)
+        self.Layout()
+
+    def update_preview(self, event=None):
+        self.preview_renderer.update()
+
+    def update_lettering(self, raise_error=False):
+        # return if there is no font in the font list (possibly due to a font size filter)
+        if not self.options_panel.font_chooser.GetValue():
+            return
+
+        del self.group[:]
+
+        if self.settings.scale == 100:
+            destination_group = self.group
+        else:
+            destination_group = inkex.Group(attrib={
+                # L10N The user has chosen to scale the text by some percentage
+                # (50%, 200%, etc).  If you need to use the percentage symbol,
+                # make sure to double it (%%).
+                INKSCAPE_LABEL: _("Text scale %s%%") % self.settings.scale
+            })
+            self.group.append(destination_group)
+
+        font = self.fonts.get(self.options_panel.font_chooser.GetValue(), self.default_font)
+        try:
+            font.render_text(self.settings.text, destination_group, back_and_forth=self.settings.back_and_forth,
+                             trim_option=self.settings.trim_option, use_trim_symbols=self.settings.use_trim_symbols)
+
+        except FontError as e:
+            if raise_error:
+                inkex.errormsg(_("Error: Text cannot be applied to the document.\n%s") % e)
+                return
+            else:
+                pass
+
+        # destination_group isn't always the text scaling group (but also the parent group)
+        # the text scaling group label is dependend on the user language, so it would break in international file exchange if we used it
+        # scaling (correction transform) on the parent group is already applied, so let's use that for recognition
+        if self.settings.scale != 100 and not destination_group.get('transform', None):
+            destination_group.attrib['transform'] = 'scale(%s)' % (self.settings.scale / 100.0)
+
+    def render_stitch_plan(self):
+        stitch_groups = []
+
+        try:
+            self.update_lettering()
+            elements = nodes_to_elements(self.group.iterdescendants(SVG_PATH_TAG))
+
+            for element in elements:
+                check_stop_flag()
+
+                stitch_groups.extend(element.embroider(None))
+
+            if stitch_groups:
+                return stitch_groups_to_stitch_plan(
+                    stitch_groups,
+                    collapse_len=self.metadata['collapse_len_mm'],
+                    min_stitch_len=self.metadata['min_stitch_len_mm']
+                )
+        except SystemExit:
+            raise
+        except ExitThread:
+            raise
+        except Exception:
+            raise
+            # Ignore errors.  This can be things like incorrect paths for
+            # satins or division by zero caused by incorrect param values.
+            pass
+
+    def on_stitch_plan_rendered(self, stitch_plan):
+        self.simulator.stop()
+        self.simulator.load(stitch_plan)
+        self.simulator.go()
+
+    def get_preset_data(self):
+        # called by self.presets_panel
+        settings = dict(self.settings)
+        del settings["text"]
+        return settings
+
+    def apply_preset_data(self, preset_data):
+        settings = DotDict(preset_data)
+        settings["text"] = self.settings.text
+        self.settings = settings
+        self.apply_settings()
+
+    def get_preset_suite_name(self):
+        # called by self.presets_panel
+        return "lettering"
+
+    def apply(self, event):
+        self.update_lettering(True)
+        self.save_settings()
+        self.close()
+
+    def close(self):
+        self.simulator.stop()
+        wx.CallAfter(self.GetTopLevelParent().close)
+
+    def cancel(self, event):
+        self.simulator.stop()
+        wx.CallAfter(self.GetTopLevelParent().cancel)
diff --git a/lib/gui/lettering/option_panel.py b/lib/gui/lettering/option_panel.py
new file mode 100644
index 00000000..ab123f83
--- /dev/null
+++ b/lib/gui/lettering/option_panel.py
@@ -0,0 +1,105 @@
+import wx
+
+from ...i18n import _
+from ...lettering.categories import FONT_CATEGORIES, FontCategory
+
+
+class LetteringOptionsPanel(wx.Panel):
+    def __init__(self, parent, panel):
+        self.panel = panel
+        wx.Panel.__init__(self, parent)
+
+        outer_sizer = wx.BoxSizer(wx.VERTICAL)
+
+        # font selection
+        self.font_chooser = wx.adv.BitmapComboBox(self, wx.ID_ANY, style=wx.CB_READONLY | wx.CB_SORT)
+        self.font_chooser.Bind(wx.EVT_COMBOBOX, self.panel.on_font_changed)
+
+        self.font_description = wx.StaticText(self, wx.ID_ANY)
+        self.panel.Bind(wx.EVT_SIZE, self.panel.resize)
+
+        self.font_selector_box = wx.StaticBox(self, wx.ID_ANY, label=_("Font"))
+        font_selector_sizer = wx.StaticBoxSizer(self.font_selector_box, wx.VERTICAL)
+        font_selector_box = wx.BoxSizer(wx.HORIZONTAL)
+        font_selector_box.Add(self.font_chooser, 4, wx.EXPAND | wx.TOP | wx.BOTTOM | wx.RIGHT, 10)
+        font_selector_sizer.Add(font_selector_box, 0, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT, 10)
+        font_selector_sizer.Add(self.font_description, 1, wx.EXPAND | wx.ALL, 10)
+        outer_sizer.Add(font_selector_sizer, 0, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT, 10)
+
+        # filter font list
+        self.font_size_filter = wx.SpinCtrlDouble(self, min=0, max=100, inc=0.1, initial=0, style=wx.SP_WRAP)
+        self.font_size_filter.SetDigits(2)
+        self.font_size_filter.Bind(wx.EVT_SPINCTRLDOUBLE, self.panel.on_filter_changed)
+        self.font_size_filter.SetToolTip(_("Font size filter (mm). 0 for all sizes."))
+
+        self.font_glyph_filter = wx.CheckBox(self, label=_("Glyphs"))
+        self.font_glyph_filter.Bind(wx.EVT_CHECKBOX, self.panel.on_filter_changed)
+        self.font_glyph_filter.SetToolTip(_("Filter fonts by available glyphs."))
+
+        self.font_category_filter = wx.ComboBox(self, wx.ID_ANY, choices=[], style=wx.CB_DROPDOWN | wx.CB_READONLY)
+        unfiltered = FontCategory('unfiltered', "---")
+        self.font_category_filter.Append(unfiltered.name, unfiltered)
+        for category in FONT_CATEGORIES:
+            self.font_category_filter.Append(category.name, category)
+        self.font_category_filter.SetToolTip(_("Filter fonts by category."))
+        self.font_category_filter.SetSelection(0)
+        self.font_category_filter.Bind(wx.EVT_COMBOBOX, self.panel.on_filter_changed)
+
+        self.filter_box = wx.StaticBox(self, wx.ID_ANY, label=_("Font Filter"))
+        filter_sizer = wx.StaticBoxSizer(self.filter_box, wx.HORIZONTAL)
+        filter_size_label = wx.StaticText(self, wx.ID_ANY, _("Size"))
+        filter_sizer.Add(filter_size_label, 0, wx.LEFT | wx.TOP | wx.BOTTOM, 10)
+        filter_sizer.AddSpacer(5)
+        filter_sizer.Add(self.font_size_filter, 1, wx.RIGHT | wx.TOP | wx.BOTTOM, 10)
+        filter_sizer.AddSpacer(5)
+        filter_sizer.Add(self.font_glyph_filter, 1, wx.RIGHT | wx.TOP | wx.BOTTOM, 10)
+        filter_sizer.Add(self.font_category_filter, 1, wx.RIGHT | wx.TOP | wx.BOTTOM, 10)
+        outer_sizer.Add(filter_sizer, 0, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT, 10)
+
+        # options
+        self.options_box = wx.StaticBox(self, wx.ID_ANY, label=_("Options"))
+
+        self.scale_spinner = wx.SpinCtrl(self, wx.ID_ANY, min=0, max=1000, initial=100)
+        self.scale_spinner.Bind(wx.EVT_SPINCTRL, lambda event: self.panel.on_change("scale", event))
+
+        self.back_and_forth_checkbox = wx.CheckBox(self, label=_("Stitch lines of text back and forth"))
+        self.back_and_forth_checkbox.Bind(wx.EVT_CHECKBOX, lambda event: self.panel.on_change("back_and_forth", event))
+
+        self.trim_option_choice = wx.Choice(self, choices=[_("Never"), _("after each line"), _("after each word"), _("after each letter")],
+                                            name=_("Add trim command"))
+        self.trim_option_choice.Bind(wx.EVT_CHOICE, lambda event: self.panel.on_trim_option_change(event))
+
+        self.use_trim_symbols = wx.CheckBox(self, label=_("Use command symbols"))
+        self.use_trim_symbols.Bind(wx.EVT_CHECKBOX, lambda event: self.panel.on_change("use_trim_symbols", event))
+        self.use_trim_symbols.SetToolTip(_('Uses command symbols if enabled. When disabled inserts trim commands as params.'))
+
+        left_option_sizer = wx.BoxSizer(wx.VERTICAL)
+        left_option_sizer.Add(self.back_and_forth_checkbox, 1, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT, 5)
+
+        trim_option_sizer = wx.BoxSizer(wx.HORIZONTAL)
+        trim_option_sizer.Add(wx.StaticText(self, wx.ID_ANY, _("Add trims")), 0, wx.LEFT | wx.ALIGN_TOP, 5)
+        trim_option_sizer.Add(self.trim_option_choice, 1, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT | wx.BOTTOM, 5)
+        trim_option_sizer.Add(self.use_trim_symbols, 1, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT | wx.BOTTOM, 5)
+        left_option_sizer.Add(trim_option_sizer, 0, wx.ALIGN_LEFT, 5)
+
+        font_scale_sizer = wx.BoxSizer(wx.HORIZONTAL)
+        font_scale_sizer.Add(wx.StaticText(self, wx.ID_ANY, _("Scale")), 0, wx.LEFT | wx.ALIGN_CENTRE_VERTICAL, 0)
+        font_scale_sizer.Add(self.scale_spinner, 0, wx.LEFT, 10)
+        font_scale_sizer.Add(wx.StaticText(self, wx.ID_ANY, "%"), 0, wx.LEFT | wx.ALIGN_CENTRE_VERTICAL, 3)
+
+        options_sizer = wx.StaticBoxSizer(self.options_box, wx.HORIZONTAL)
+        options_sizer.Add(left_option_sizer, 1, wx.EXPAND, 10)
+        options_sizer.Add(font_scale_sizer, 0, wx.RIGHT, 10)
+        outer_sizer.Add(options_sizer, 0, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT, 10)
+
+        # text input
+        self.text_input_box = wx.StaticBox(self, wx.ID_ANY, label=_("Text"))
+        self.text_editor = wx.TextCtrl(self, style=wx.TE_MULTILINE | wx.TE_DONTWRAP)
+        self.text_editor.Bind(wx.EVT_TEXT, lambda event: self.panel.on_change("text", event))
+
+        text_input_sizer = wx.StaticBoxSizer(self.text_input_box, wx.VERTICAL)
+        text_input_sizer.Add(self.text_editor, 1, wx.EXPAND | wx.LEFT | wx.RIGHT | wx.BOTTOM, 10)
+        outer_sizer.Add(text_input_sizer, 2, wx.EXPAND | wx.LEFT | wx.TOP | wx.RIGHT, 10)
+
+        # set panel sizer
+        self.SetSizer(outer_sizer)