meerk40t 0.9.3001__py2.py3-none-any.whl → 0.9.7020__py2.py3-none-any.whl

meerk40t/gui/help_assets/help_assets.py

@@ -1,201 +1,218 @@
-english_wordlist_howto = """
-WordLists allow you to create text elements in your design which contain placeholder text that is replaced at burn time from this WordList. You can then burn several items with different text without having to change your design each time.
-
-A placeholder consists of a name inside curly brackets e.g. '{FIRSTNAME}'. You use the name in the WordList Editor to associate it with the placeholder and the placeholder will be replaced by the text you enter into the associated WordList Contents.
-
-As an example of how this functionality would be used, imagine you want to create a set of dinner party seat reservation tags each with a different person's name. Having created the cut path for the name-tag outline e.g. a rectangle, use the Text drawing tool to create a Text element containing the following:
-'This seat is reserved for {FIRSTNAME}'
-
-Then you use this WordList editor to create one or more entries as follows:
-	|-----------|------|-------|
-	|    Name   | Type | Index |
-	|-----------|------|-------|
-	| firstname | Text |   0   |
-	|-----------|------|-------|
-Then click on the 'firstname' row and add several items to the Contents pane e.g.:
-	Paul
-	David
-	Andy
-Now when you execute the burn, you will get individual place tags which have different names on them e.g. 'This seat is reserved for Andy'.
-
-You can use as many different placeholder names as you like in text fields in your design.
-
-The 'Index' value in the WordList table indicates which entry in the Contents list will be used next, zero meaning the first entry. The index is automatically increased by one at the end of each burn.
-
-But suppose for efficiency you now want to burn two seat reservation tags at the same time each having a different name from the same list. In this case, if the first tag use '{NAME#+0}' and in the second '{NAME#+1}' (note the plus sign). '{NAME}' or '{NAME#+0}' uses the current entry (pointed to by the Index value), '{NAME#+1}' uses the next entry after the current one etc.
-
-With the above usage, you can use these values as many times as you wish in your design. To advance the index you need to click on the Prev / Next buttons in the toolbar.
-
-As an alternative to manually entering the wordlist values using this WordList Editor, you can use a standard comma-separated CSV file. The placeholder names are defined in standard CSV header line (the first line in the CSV file), and the contents are then taken from all the following lines. The easiest way to create a CSV file is using a spreadsheet e.g. Excel, however e.g. for ecommerce sites your website might automatically create the CSV file from the orders placed online by customers.
-
-Entries loaded from a CSV file are shown as Type CSV, and you can set the Index values for all CSV entries at the same time.
-
-Note: If your CSV doesn't have a header line, columns will be named 'column_1', 'column_2' etc.
-
-The Wordlist also contains some special entries (which might be especially useful for calibration designs):
-	* 'version'   - Meerk40t version
-	* 'date'      - Date burn started
-	* 'time'      - Time burn started
-	* 'op_device' - Device you are burning on
-	* 'op_speed'  - Speed of the current operation
-	* 'op_power'  - PPI of the current operation
-	* 'op_dpi'    - DPI of the current (raster) operation
-	* 'op_passes' - Operation passes of the current operation
-
-The placeholders for 'date' and 'time' can also contain formatting directives that allow you to format them according to your local conventions e.g.
-	{date@%d.%m.%Y} - 31.12.2022
-	{time@%H:%M} - 23:59
-
-For a complete set of format-directives see: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
-"""
-
-german_wordlist_howto = """
-Wortlisten erlauben es, innerhalb von Text-Elementen Platzhalter zu verwenden, die beim Brennvorgang durch Inhalte der Wortliste ersetzt werden.
-So ist es möglich, bei jedem Brennvorgang andere Textinhalte zu verwenden, ohne dass dafür jedes mal das Design verändert werden müsste.
-
-Ein Platzhalter besteht aus einem Namen in geschweiften Klammern (etwa '{VORNAME}'). Dieser Name wird im Wortlisten-Editor zusammen mit zugeordneten Texten definiert, so dass er anschließend im Design durch die 'richtigen' Inhalte ersetzt werden kann.
-
-Kommen wir zu unserem Anwendungsfall: wir wollen eine Namensschild-Vorlage für eine Feier erstellen, die leicht wiederverwendbar ist. Erstellen wir also zunächst einen Rahmen (z.B. ein Rechteck) und platzieren mit dem Text-Tool ein Text-Element innerhalb dieses Rahmens. Den Text verändern wir zu:
-'Hier sitzt {VORNAME}'
-
-Mit dem Wortlist-Editor definieren wir nun diesen Platzhalter:
-	|-----------|------|-------|
-	|    Name   | Type | Index |
-	|-----------|------|-------|
-	| vorname   | Text |   0   |
-	|-----------|------|-------|
-Wir klicken auf diesen Eintrag in der linken Liste und fügen auf der rechten Seite mehrere passende Einträge hinzu:
-	Antje
-	David
-	Oma
-
-Wenn wir nun den Brennvorgang starten, erhalten wir individualisierte Platzkarten mit den einzelnen Namen aus der Wortliste, also etwa: 'Hier sitzt Antje'.
-
-Wir können beliebig viele solcher Platzhalter definieren und verwenden.
-
-Der 'Index' Wert in der Wortlist-Tabelle legt fest, welche der auf der rechten Seite angezeigten Einträge das nächste mal verwendet werden soll (wobei der Wert 0 den ersten Eintrag in der Liste meint).
-
-Wir sind nicht beschränkt auf eine einmalige Verwendung eines Platzhalters (nützlich beispielsweise wenn man nicht nur ein Schild sondern gleich mehrere in einem Rutsch brennen will). Die Standardverwendung {VORNAME} nimmt den Wert an der Position #index der geladenen Liste, {VORNAME#+1} (beachte das #+1 am Ende) verwendet den nächsten Eintrag, {VORNAME#+2} den übernächsten usw.
-
-Auf diese Weise können diese Werte beliebig häufig verwendet werden, der Index wird dadurch nicht weitergeschaltet. Mit den Knöpfen 'Vor' und 'Zurück' kann der Index weitergeschaltet werden.
-
-Wir können einen ganzen Satz von Variablen (Wortliste genannt) definieren, der z.B. aus einer Standard Komma-separierten CSV-Datei eingelesen werden kann. Dann hätten wir nicht nur wenige Einträge für 'VORNAME', sondern vielleicht Hunderte davon. Welcher der Mehrfach-Einträge gerade aktiv ist entscheidet der sogenannte Index.
-
-Der einfachste Weg solche Dateien zu erzeugen, ist das Verwenden einer Tabellenkalkulation wie Excel oder LibreCalc, sie kann aber auch anderen Quellen wie einer Webseite stammen, die solche Daten automatisch bei Kundenaufträgen anlegt.
-
-Einträge die aus einer CSV-Datei stammen, werden mit der Typ 'CSV' gekennzeichnet, und der Index aller CSV-Einträge wird zur gleichen Zeit festgelegt.
-
-Achtung: Hat die CSV-Datei keine Kopfzeile mit Spaltennamen, so werden die einzelnen Spalten 'column_1', 'column_2' etc. benannt werden.
-
-Es gibt eine Reihe von vordefinierten Variablen, die Infos zum aktuellen Arbeitsgang (etwa {op_power}, {op_speed} u.a. - nützlich z.B. bei Kalibrier-Tests) oder Datums-Zeit-Infomationen liefern ({date}, {time})."
-	* 'version'   - Meerk40t Version
-	* 'date'      - Datum für den Start des Brennvorgangs
-	* 'time'      - Zeit für den Start des Brennvorgangs
-	* 'op_device' - Name des Geräts auf dem gelasert wird
-	* 'op_speed'  - Geschwindigkeit des aktuellen Arbeitsvorgangs
-	* 'op_power'  - Leistung des aktuellen Arbeitsvorgangs
-	* 'op_dpi'    - DPI (Pixelauflösung) des aktuellen Arbeitsvorgangs
-	* 'op_passes' - Anzahl der Durchläufe des aktuellen Arbeitsvorgangs
-
-Die Platzhalter {date} und {time} können mit einem Format angegeben werden, so dass ihr Aussehen mit lokalen Standards übereinstimmt: z.B.
-    {date@%d.%m.%Y} - 31.12.2022
-    {time@%H:%M} - 23:59
-Für eine komplette Liste der Format-Codes: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
-"""
-
-italian_wordlist_howto = """
-Variabili di testo consente di inserire elementi di testo in un progetto sostituendoli a dei “segnaposto”. Il testo viene sostituito al momento della lavorazione. È quindi possibile produrre più elementi con testi diversi senza dover modificare ogni volta il progetto.
-
-Un segnaposto consiste in una parola all'interno di parentesi graffe, ad esempio '{FIRSTNAME}'. La parola viene associato al segnaposto presente in Gestione variabili di testo e il segnaposto viene sostituito dal testo inserito nel contenuto della variabile di testo associata.
-
-Come esempio di utilizzo di questa funzionalità, immaginiamo di voler creare una serie di etichette per la prenotazione di posti a sedere ad una cena, ognuna con il nome di una persona diversa. Dopo aver creato il percorso di taglio per il contorno dell'etichetta, ad esempio un rettangolo, si utilizza lo strumento di disegno Testo per creare un elemento testo contenente quanto segue:
-
-Questo posto è riservato a {INVITATO}.
-Quindi si utilizza Gestione variabili di testo per creare una o più voci come segue:
-
-	|-----------|------|-------|
-	| Nome      | Tipo | Indice|
-	|-----------|------|-------|
-	| invitato  | Text | 0     |
-	|-----------|------|-------|
-
-Quindi selezionare la riga "invitato" e aggiungere i dati necessari nel pannello Contenuto, ad es:
-
-	Paolo
-	Davide
-	Andy
-
-Eseguendo la lavorazione si otterranno segnaposto individuali con nomi diversi, ad esempio 'Questo posto è riservato a Andy'.
-
-È possibile utilizzare tutti i nomi di segnaposto che si desidera nei campi di testo del progetto.
-
-Il valore Indice di partenza per il campo nella tabella Variabili di testo indica quale voce dell'elenco dei contenuti verrà utilizzata successivamente; zero significa la prima voce. L'indice viene automaticamente aumentato di uno alla fine di ogni singolo elemento processato.
-
-Ma supponiamo, per motivi di efficienza, di voler masterizzare contemporaneamente due tag di prenotazione di posti, ciascuno con un nome diverso dallo stesso elenco. In questo caso, se il primo tag usa '{NAME#+0}' e il secondo '{NAME#+1}' (notare il segno più). '{NAME}' o '{NAME#+0}' utilizza la voce corrente (indicata dal valore dell'indice), '{NAME#+1}' utilizza la voce successiva a quella corrente, ecc.
-
-Con questo sistema, è possibile utilizzare questi valori tutte le volte che si desidera nel proprio progetto. 
-Per far avanzare l'indice è necessario fare clic sui pulsanti Prev / Next della barra degli strumenti.
-
-In alternativa all'inserimento manuale dei valori in Variabili di testo tramite il Gestione variabili di testo, è possibile utilizzare un file CSV standard separato da virgole. I nomi dei segnaposto sono definiti nella riga di intestazione standard del file CSV (la prima riga del file CSV) e i contenuti sono presi da tutte le righe successive. Il modo più semplice per creare un file CSV è utilizzare un foglio di calcolo, ad esempio Excel.
-
-Le voci caricate da un file CSV vengono visualizzate come Tipo CSV ed è possibile impostare i valori dell'indice per tutte le voci CSV contemporaneamente.
-
-Nota: se il CSV non ha una riga di intestazione, le colonne saranno denominate "colonna_1", "colonna_2" ecc.
-
-L'elenco di parole contiene anche alcune voci speciali (che potrebbero essere particolarmente utili per i progetti di calibrazione):
-
-	* 'version' - Versione di Meerk40t
-	* 'date' - Data di inizio dell’incisione
-	* 'time' - Ora di inizio dell’incisione
-	* 'op_device' - Dispositivo su cui si sta effettuando l’incisione
-	* 'op_speed' - Velocità dell'operazione corrente
-	* 'op_power' - PPI dell'operazione corrente
-	* 'op_dpi' - DPI dell'operazione corrente (raster)
-	* 'op_passes' - Passaggi dell'operazione corrente
-
-I segnaposto per "data" e "ora" possono anche contenere istruzioni di formattazione che consentono di formattarli secondo le convenzioni locali, ad esempio
-	{date@%d.%m.%Y} - 31.12.2022
-	{time@%H:%M} - 23:59
-
-Per un insieme completo delle istruzioni di formattazione, vedere: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
-"""
-
-
-def asset(context, asset):
-    language = context.language
-    lang = "english"
-    if language == 0:  # ("en", "English", wx.LANGUAGE_ENGLISH)
-        lang = "english"
-    if language == 1:  # ("it", "italiano", wx.LANGUAGE_ITALIAN),
-        lang = "italian"
-    if language == 2:  # ("fr", "français", wx.LANGUAGE_FRENCH),
-        lang = "french"
-    if language == 3:  # ("de", "Deutsch", wx.LANGUAGE_GERMAN),
-        lang = "german"
-    if language == 4:  # ("es", "español", wx.LANGUAGE_SPANISH),
-        lang = "spanish"
-    if language == 5:  # ("zh", "中文", wx.LANGUAGE_CHINESE),
-        lang = "chinese"
-    if language == 6:  # ("hu", "Magyar", wx.LANGUAGE_HUNGARIAN),
-        lang = "hungarian"
-    if language == 7:  # ("pt_PT", "português", wx.LANGUAGE_PORTUGUESE),
-        lang = "portuguese"
-    if (
-        language == 8
-    ):  # ("pt_BR", "português brasileiro", wx.LANGUAGE_PORTUGUESE_BRAZILIAN),
-        lang = "portuguese_brazilian"
-    if language == 9:  # ("ja", "日本", wx.LANGUAGE_JAPANESE),
-        lang = "japanese"
-    if language == 9:  # ("nl", "Nederlands", wx.LANGUAGE_DUTCH),
-        lang = "dutch"
-    text = ""
-    try:
-        text = globals()[f"{lang}_{asset}"]
-    except KeyError:
-        try:
-            text = globals()["english" + asset]
-        except KeyError as e:
-            pass
-    if text and text[0] == "\n":
-        return text[1:]
-    return text
+english_wordlist_howto = """
+WordLists allow you to create text elements in your design which contain placeholder text that is replaced at burn time from this WordList. You can then burn several items with different text without having to change your design each time.
+
+A placeholder consists of a name inside curly brackets e.g. '{FIRSTNAME}'. You use the name in the WordList Editor to associate it with the placeholder and the placeholder will be replaced by the text you enter into the associated WordList Contents.
+
+As an example of how this functionality would be used, imagine you want to create a set of dinner party seat reservation tags each with a different person's name. Having created the cut path for the name-tag outline e.g. a rectangle, use the Text drawing tool to create a Text element containing the following:
+'This seat is reserved for {FIRSTNAME}'
+
+Then you use this WordList editor to create one or more entries as follows:
+	|-----------|------|-------|
+	|    Name   | Type | Index |
+	|-----------|------|-------|
+	| firstname | Text |   0   |
+	|-----------|------|-------|
+Then click on the 'firstname' row and add several items to the Contents pane e.g.:
+	Paul
+	David
+	Andy
+Now when you execute the burn, you will get individual place tags which have different names on them e.g. 'This seat is reserved for Andy'.
+
+You can use as many different placeholder names as you like in text fields in your design.
+
+The 'Index' value in the WordList table indicates which entry in the Contents list will be used next, zero meaning the first entry. The index is automatically increased by one at the end of each burn.
+
+But suppose for efficiency you now want to burn two seat reservation tags at the same time each having a different name from the same list. In this case, if the first tag use '{NAME#+0}' and in the second '{NAME#+1}' (note the plus sign). '{NAME}' or '{NAME#+0}' uses the current entry (pointed to by the Index value), '{NAME#+1}' uses the next entry after the current one etc.
+
+With the above usage, you can use these values as many times as you wish in your design. To advance the index you need to click on the Prev / Next buttons in the toolbar.
+
+As an alternative to manually entering the wordlist values using this WordList Editor, you can use a standard comma-separated CSV file. The placeholder names are defined in standard CSV header line (the first line in the CSV file), and the contents are then taken from all the following lines. The easiest way to create a CSV file is using a spreadsheet e.g. Excel, however e.g. for ecommerce sites your website might automatically create the CSV file from the orders placed online by customers.
+
+Entries loaded from a CSV file are shown as Type CSV, and you can set the Index values for all CSV entries at the same time.
+
+Note: If your CSV doesn't have a header line, columns will be named 'column_1', 'column_2' etc.
+
+The Wordlist also contains some special entries (which might be especially useful for calibration designs):
+	* 'version'   - Meerk40t version
+	* 'date'      - Date burn started
+	* 'time'      - Time burn started
+	* 'op_device' - Device you are burning on
+	* 'op_speed'  - Speed of the current operation
+	* 'op_power'  - PPI of the current operation
+	* 'op_dpi'    - DPI of the current (raster) operation
+	* 'op_passes' - Operation passes of the current operation
+
+The placeholders for 'date' and 'time' can also contain formatting directives that allow you to format them according to your local conventions e.g.
+	{date@%d.%m.%Y} - 31.12.2022
+	{time@%H:%M} - 23:59
+
+For a complete set of format-directives see: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+
+german_wordlist_howto = """
+Wortlisten erlauben es, innerhalb von Text-Elementen Platzhalter zu verwenden, die beim Brennvorgang durch Inhalte der Wortliste ersetzt werden.
+So ist es möglich, bei jedem Brennvorgang andere Textinhalte zu verwenden, ohne dass dafür jedes mal das Design verändert werden müsste.
+
+Ein Platzhalter besteht aus einem Namen in geschweiften Klammern (etwa '{VORNAME}'). Dieser Name wird im Wortlisten-Editor zusammen mit zugeordneten Texten definiert, so dass er anschließend im Design durch die 'richtigen' Inhalte ersetzt werden kann.
+
+Kommen wir zu unserem Anwendungsfall: wir wollen eine Namensschild-Vorlage für eine Feier erstellen, die leicht wiederverwendbar ist. Erstellen wir also zunächst einen Rahmen (z.B. ein Rechteck) und platzieren mit dem Text-Tool ein Text-Element innerhalb dieses Rahmens. Den Text verändern wir zu:
+'Hier sitzt {VORNAME}'
+
+Mit dem Wortlist-Editor definieren wir nun diesen Platzhalter:
+	|-----------|------|-------|
+	|    Name   | Type | Index |
+	|-----------|------|-------|
+	| vorname   | Text |   0   |
+	|-----------|------|-------|
+Wir klicken auf diesen Eintrag in der linken Liste und fügen auf der rechten Seite mehrere passende Einträge hinzu:
+	Antje
+	David
+	Oma
+
+Wenn wir nun den Brennvorgang starten, erhalten wir individualisierte Platzkarten mit den einzelnen Namen aus der Wortliste, also etwa: 'Hier sitzt Antje'.
+
+Wir können beliebig viele solcher Platzhalter definieren und verwenden.
+
+Der 'Index' Wert in der Wortlist-Tabelle legt fest, welche der auf der rechten Seite angezeigten Einträge das nächste mal verwendet werden soll (wobei der Wert 0 den ersten Eintrag in der Liste meint).
+
+Wir sind nicht beschränkt auf eine einmalige Verwendung eines Platzhalters (nützlich beispielsweise wenn man nicht nur ein Schild sondern gleich mehrere in einem Rutsch brennen will). Die Standardverwendung {VORNAME} nimmt den Wert an der Position #index der geladenen Liste, {VORNAME#+1} (beachte das #+1 am Ende) verwendet den nächsten Eintrag, {VORNAME#+2} den übernächsten usw.
+
+Auf diese Weise können diese Werte beliebig häufig verwendet werden, der Index wird dadurch nicht weitergeschaltet. Mit den Knöpfen 'Vor' und 'Zurück' kann der Index weitergeschaltet werden.
+
+Wir können einen ganzen Satz von Variablen (Wortliste genannt) definieren, der z.B. aus einer Standard Komma-separierten CSV-Datei eingelesen werden kann. Dann hätten wir nicht nur wenige Einträge für 'VORNAME', sondern vielleicht Hunderte davon. Welcher der Mehrfach-Einträge gerade aktiv ist entscheidet der sogenannte Index.
+
+Der einfachste Weg solche Dateien zu erzeugen, ist das Verwenden einer Tabellenkalkulation wie Excel oder LibreCalc, sie kann aber auch anderen Quellen wie einer Webseite stammen, die solche Daten automatisch bei Kundenaufträgen anlegt.
+
+Einträge die aus einer CSV-Datei stammen, werden mit der Typ 'CSV' gekennzeichnet, und der Index aller CSV-Einträge wird zur gleichen Zeit festgelegt.
+
+Achtung: Hat die CSV-Datei keine Kopfzeile mit Spaltennamen, so werden die einzelnen Spalten 'column_1', 'column_2' etc. benannt werden.
+
+Es gibt eine Reihe von vordefinierten Variablen, die Infos zum aktuellen Arbeitsgang (etwa {op_power}, {op_speed} u.a. - nützlich z.B. bei Kalibrier-Tests) oder Datums-Zeit-Infomationen liefern ({date}, {time})."
+	* 'version'   - Meerk40t Version
+	* 'date'      - Datum für den Start des Brennvorgangs
+	* 'time'      - Zeit für den Start des Brennvorgangs
+	* 'op_device' - Name des Geräts auf dem gelasert wird
+	* 'op_speed'  - Geschwindigkeit des aktuellen Arbeitsvorgangs
+	* 'op_power'  - Leistung des aktuellen Arbeitsvorgangs
+	* 'op_dpi'    - DPI (Pixelauflösung) des aktuellen Arbeitsvorgangs
+	* 'op_passes' - Anzahl der Durchläufe des aktuellen Arbeitsvorgangs
+
+Die Platzhalter {date} und {time} können mit einem Format angegeben werden, so dass ihr Aussehen mit lokalen Standards übereinstimmt: z.B.
+    {date@%d.%m.%Y} - 31.12.2022
+    {time@%H:%M} - 23:59
+Für eine komplette Liste der Format-Codes: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+
+italian_wordlist_howto = """
+Variabili di testo consente di inserire elementi di testo in un progetto sostituendoli a dei “segnaposto”. Il testo viene sostituito al momento della lavorazione. È quindi possibile produrre più elementi con testi diversi senza dover modificare ogni volta il progetto.
+
+Un segnaposto consiste in una parola all'interno di parentesi graffe, ad esempio '{FIRSTNAME}'. La parola viene associato al segnaposto presente in Gestione variabili di testo e il segnaposto viene sostituito dal testo inserito nel contenuto della variabile di testo associata.
+
+Come esempio di utilizzo di questa funzionalità, immaginiamo di voler creare una serie di etichette per la prenotazione di posti a sedere ad una cena, ognuna con il nome di una persona diversa. Dopo aver creato il percorso di taglio per il contorno dell'etichetta, ad esempio un rettangolo, si utilizza lo strumento di disegno Testo per creare un elemento testo contenente quanto segue:
+
+Questo posto è riservato a {INVITATO}.
+Quindi si utilizza Gestione variabili di testo per creare una o più voci come segue:
+
+	|-----------|------|-------|
+	| Nome      | Tipo | Indice|
+	|-----------|------|-------|
+	| invitato  | Text | 0     |
+	|-----------|------|-------|
+
+Quindi selezionare la riga "invitato" e aggiungere i dati necessari nel pannello Contenuto, ad es:
+
+	Paolo
+	Davide
+	Andy
+
+Eseguendo la lavorazione si otterranno segnaposto individuali con nomi diversi, ad esempio 'Questo posto è riservato a Andy'.
+
+È possibile utilizzare tutti i nomi di segnaposto che si desidera nei campi di testo del progetto.
+
+Il valore Indice di partenza per il campo nella tabella Variabili di testo indica quale voce dell'elenco dei contenuti verrà utilizzata successivamente; zero significa la prima voce. L'indice viene automaticamente aumentato di uno alla fine di ogni singolo elemento processato.
+
+Ma supponiamo, per motivi di efficienza, di voler masterizzare contemporaneamente due tag di prenotazione di posti, ciascuno con un nome diverso dallo stesso elenco. In questo caso, se il primo tag usa '{NAME#+0}' e il secondo '{NAME#+1}' (notare il segno più). '{NAME}' o '{NAME#+0}' utilizza la voce corrente (indicata dal valore dell'indice), '{NAME#+1}' utilizza la voce successiva a quella corrente, ecc.
+
+Con questo sistema, è possibile utilizzare questi valori tutte le volte che si desidera nel proprio progetto.
+Per far avanzare l'indice è necessario fare clic sui pulsanti Prev / Next della barra degli strumenti.
+
+In alternativa all'inserimento manuale dei valori in Variabili di testo tramite il Gestione variabili di testo, è possibile utilizzare un file CSV standard separato da virgole. I nomi dei segnaposto sono definiti nella riga di intestazione standard del file CSV (la prima riga del file CSV) e i contenuti sono presi da tutte le righe successive. Il modo più semplice per creare un file CSV è utilizzare un foglio di calcolo, ad esempio Excel.
+
+Le voci caricate da un file CSV vengono visualizzate come Tipo CSV ed è possibile impostare i valori dell'indice per tutte le voci CSV contemporaneamente.
+
+Nota: se il CSV non ha una riga di intestazione, le colonne saranno denominate "colonna_1", "colonna_2" ecc.
+
+L'elenco di parole contiene anche alcune voci speciali (che potrebbero essere particolarmente utili per i progetti di calibrazione):
+
+	* 'version' - Versione di Meerk40t
+	* 'date' - Data di inizio dell’incisione
+	* 'time' - Ora di inizio dell’incisione
+	* 'op_device' - Dispositivo su cui si sta effettuando l’incisione
+	* 'op_speed' - Velocità dell'operazione corrente
+	* 'op_power' - PPI dell'operazione corrente
+	* 'op_dpi' - DPI dell'operazione corrente (raster)
+	* 'op_passes' - Passaggi dell'operazione corrente
+
+I segnaposto per "data" e "ora" possono anche contenere istruzioni di formattazione che consentono di formattarli secondo le convenzioni locali, ad esempio
+	{date@%d.%m.%Y} - 31.12.2022
+	{time@%H:%M} - 23:59
+
+Per un insieme completo delle istruzioni di formattazione, vedere: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+
+english_material_howto = """
+The Material Library Manager allows to create, maintain, use and manage operations that are customized to provide a desired effect with a given material (hence the name Material Library).
+The parameters you want to use e.g. for cutting acrylic are very different from the ones you want to use to engrave a picture on slate.
+You can share such a material setting with the MeerK40t community and you can benefit from the contributions of others by loading and using their settings.
+"""
+
+german_material_howto = """
+Die Material-Bibliothek erlaubt es Arbeitsgangs-Einstellungen für spezifische Materialien anzulegen und zu verwalten.
+Die Parameter, die man z.B. für das Schneiden von Acryl benötigt unterscheiden sich deutlich von denen, die man etwa zum Gravieren eine Fotos auf Schiefer braucht.
+Diese Daten können im Übrigen mit der Meerk40t Commnity geteilt werden, un man im Gegenzug von den Beiträgen anderer profitieren.
+"""
+italian_material_howto = """
+Il Gestore della libreria di materiali consente di creare, gestire, memorizzare e utilizzare i parametri di lavorazione per ottenere l'effetto desiderato con un determinato materiale.
+I parametri da utilizzare, ad esempio, per tagliare l'acrilico sono molto diversi da quelli da utilizzare per incidere un'immagine sull'ardesia.
+È possibile condividere tali impostazioni di lavorazione dei materiali con la comunità MeerK40t e beneficiare dei contributi degli altri caricando e utilizzando le loro impostazioni.
+"""
+
+
+def asset(context, asset):
+    language = context.language
+    lang = "english"
+    if language == 0:  # ("en", "English", wx.LANGUAGE_ENGLISH)
+        lang = "english"
+    if language == 1:  # ("it", "italiano", wx.LANGUAGE_ITALIAN),
+        lang = "italian"
+    if language == 2:  # ("fr", "français", wx.LANGUAGE_FRENCH),
+        lang = "french"
+    if language == 3:  # ("de", "Deutsch", wx.LANGUAGE_GERMAN),
+        lang = "german"
+    if language == 4:  # ("es", "español", wx.LANGUAGE_SPANISH),
+        lang = "spanish"
+    if language == 5:  # ("zh", "中文", wx.LANGUAGE_CHINESE),
+        lang = "chinese"
+    if language == 6:  # ("hu", "Magyar", wx.LANGUAGE_HUNGARIAN),
+        lang = "hungarian"
+    if language == 7:  # ("pt_PT", "português", wx.LANGUAGE_PORTUGUESE),
+        lang = "portuguese"
+    if (
+        language == 8
+    ):  # ("pt_BR", "português brasileiro", wx.LANGUAGE_PORTUGUESE_BRAZILIAN),
+        lang = "portuguese_brazilian"
+    if language == 9:  # ("ja", "日本", wx.LANGUAGE_JAPANESE),
+        lang = "japanese"
+    if language == 9:  # ("nl", "Nederlands", wx.LANGUAGE_DUTCH),
+        lang = "dutch"
+    text = ""
+    try:
+        text = globals()[f"{lang}_{asset}"]
+    except KeyError:
+        try:
+            text = globals()["english_" + asset]
+        except KeyError:
+            pass
+    if text and text[0] == "\n":
+        return text[1:]
+    return text

meerk40t/gui/helper.py

@@ -0,0 +1,154 @@
+"""
+    This module displays information about an element
+    that is gathered by periodically (every 0.5 seconds)
+    looking at the window i.e. control under the mouse cursor.
+    It will examine the window if it contains a tooltip text and
+    will display this in a textbox in this panel.
+    The purpose of this helper window is to allow better
+    readability of the otherwise quickly disappearing tooltips.
+"""
+
+import wx
+from wx import aui
+
+from meerk40t.gui.wxutils import wxCheckBox, TextCtrl  # , wxButton
+from meerk40t.kernel import Job, signal_listener
+
+_ = wx.GetTranslation
+
+
+def register_panel_helper(window, context):
+    pane = (
+        aui.AuiPaneInfo()
+        .Left()
+        .Float()
+        .MinSize(225, 110)
+        .FloatingSize(225, 110)
+        .Caption(_("Help"))
+        .CaptionVisible(not context.pane_lock)
+        .Name("helper")
+        .Hide()
+    )
+    pane.dock_proportion = 225
+    pane.control = HelperPanel(window, wx.ID_ANY, context=context)
+    pane.submenu = "~" + _("Help")
+    pane.helptext = _("Permanently displays tooltip information")
+
+    window.on_pane_create(pane)
+    context.register("pane/helper", pane)
+
+
+class HelperPanel(wx.Panel):
+    """
+    Displays information about the GUI element the mouse is currently hovering over
+    """
+
+    def __init__(self, *args, context=None, **kwds):
+        # begin wxGlade: PositionPanel.__init__
+        kwds["style"] = kwds.get("style", 0) | wx.TAB_TRAVERSAL
+        wx.Panel.__init__(self, *args, **kwds)
+        self.context = context
+        self.context.themes.set_window_colors(self)
+        self._lock_updates = None
+        self.text_info = TextCtrl(
+            self, wx.ID_ANY, style=wx.TE_MULTILINE | wx.TE_READONLY
+        )
+        self.check_allow = wxCheckBox(self, wx.ID_ANY, _("Display control-information"))
+        # self.button_webhelp = wxButton(self, wx.ID_ANY, _("Online-Help"))
+        # self.button_webhelp.SetBitmap(icons8_info.GetBitmap(resize = 0.5 * get_default_icon_size(self.context)))
+        self.active = False
+        self.__set_properties()
+        self.__do_layout()
+
+        self._last_help_info = ""
+        self.job = Job(
+            process=self.mouse_query,
+            job_name="helper-check",
+            interval=0.2,
+            run_main=True,
+        )
+        self.lock_updates = False
+        self.Bind(wx.EVT_CHECKBOX, self.on_check_allow, self.check_allow)
+
+    @property
+    def lock_updates(self):
+        return self._lock_updates
+
+    @lock_updates.setter
+    def lock_updates(self, value):
+        if self.lock_updates != value:
+            self._lock_updates = value
+            self.check_allow.SetValue(not value)
+            if not value:
+                # Make sure we get an update immediately
+                self.mouse_query(None)
+
+    def on_check_allow(self, event):
+        value = self.check_allow.GetValue()
+        self.lock_updates = not value
+
+    def mouse_query(self, event=None):
+        """
+        This routine looks periodically (every 0.5 seconds)
+        at the window i.e. control under the mouse cursor.
+        It will examine the window if it contains a tooltip text and
+        will display this in a textbox in this panel.
+        Additionally, it will read the associated HelpText of the control
+        (or its parent if the control does not have any) to construct a
+        Wiki page on GitHub to open an associated online help page.
+        """
+        if self.context.kernel.is_shutdown:
+            return
+        if self._lock_updates:
+            return
+        try:
+            wind, pos = wx.FindWindowAtPointer()
+            if wind is None or wind is self:
+                return
+            if wind.GetParent() is self:
+                return
+            if not hasattr(wind, "GetToolTipText"):
+                return
+            info = wind.GetToolTipText()
+            if info != self._last_help_info:
+                self.text_info.SetValue(info)
+                self._last_help_info = info
+        except RuntimeError:
+            return
+
+    @signal_listener("lock_helper")
+    def helper_locker(self, origin, *args, **kwargs):
+        self.lock_updates = not self.lock_updates
+
+    def pane_show(self, *args):
+        self.context.kernel.schedule(self.job)
+
+    def pane_hide(self, *args):
+        self.context.kernel.unschedule(self.job)
+
+    def __set_properties(self):
+        s = _("Information about the control the mouse is hovering over")
+        self.text_info.SetToolTip(s)
+        self.check_allow.SetToolTip(
+            s
+            + "\n"
+            + _(
+                "If inactive then no more updates will happen until you check this checkbox again"
+            )
+            # + "\n"
+            # + _(
+            #     "Tip: Press Ctrl+Shift+L while hovering over a control to lock the content."
+            # )
+        )
+        # self.button_webhelp.SetToolTip(_("Call online help-page"))
+
+    def __do_layout(self):
+        sizer_main = wx.BoxSizer(wx.VERTICAL)
+        sizer_1 = wx.BoxSizer(wx.VERTICAL)
+        sizer_1.Add(self.check_allow, 0, 0, 0)
+        sizer_1.Add(self.text_info, 1, wx.EXPAND, 0)
+        # sizer_1.Add(self.button_webhelp, 0, wx.ALIGN_RIGHT, 0)
+        sizer_main.Add(sizer_1, 1, wx.EXPAND, 0)
+        self.SetSizer(sizer_main)
+        sizer_main.Fit(self)
+        self.Layout()