[[Vorlage(Getestet, focal)]] {{{#!vorlage Wissen [:Anwendungen_hinzufügen:Anwendungen hinzufügen] [:Terminal:Ein Terminal öffnen] [:Packprogramme:Eine Archivdatei entpacken] [:Editor:Einen Editor öffnen] }}} [[Inhaltsverzeichnis(1)]] [[Vorlage(Bildunterschrift, Tiptoi_digitalpapier.png, 250, "Kodierung", right,)]] [https://tttool.entropia.de/ tttool] {de} ist ein Werkzeug, um '''.gme'''-Dateien für [:tiptoi:] zu analysieren und zu erstellen. Vorhandene Dateien können überarbeitet und eigene Kreationen (für den Hausgebrauch) erschaffen werden. Der Phantasie sind keine Grenzen gesetzt. = Installation = Zunächst die neueste Version von der [https://github.com/entropia/tip-toi-reveng/releases Release-Seite] herunterladen [2] und entpacken [3], z.B. {{{#!vorlage Befehl wget https://github.com/entropia/tip-toi-reveng/releases/download/1.9/tttool-1.9.zip unzip tttool-1.9.zip }}} [[Vorlage(Fremd, Software)]] Danach steht im Ordner '''tttool-1.9''' das Werkzeug '''tttool''' zur Verfügung. = Verwendung = {{{#!vorlage Warnung Anwendung auf eigene Gefahr. Es wird keine Haftung für Schäden am Stift übernommen. }}} Der Aufruf der Werkzeuge erfolgt über das Terminal [2]: {{{#!vorlage Befehl tttool [OPTION] KOMMANDO }}} {{{#!vorlage Tabelle <-2 tablestyle="width: 97%;" rowclass="titel">Programmaufruf +++ Befehl: Beschreibung: +++ ./tttool -h, --help Gibt die verfügbaren Kommandos von tttool aus. +++ ./tttool info DATEI.gme Informationen zu '''DATEI.gme''' anzeigen. +++ ./tttool media DATEI.gme Die Audiodateien von '''Datei.gme''' werden extrahiert. Diese sind fortlaufend nummeriert im Unterordner '''/media''' zu finden. +++ ./tttool explain DATEI.gme Ausgabe der '''.gme'''-Datei als Hex-Code. +++ ./tttool export DATEI.gme Die Steuerdatei wird in lesbarer Form im Ordner angelegt: '''DATEI.yaml''' +++ ./tttool assemble DATEI.yaml Erstellung einer '''DATEI.gme''' aus einer [wikipedia:YAML:]-Datei. +++ ./tttool play DATEI.gme Ermöglicht das Testen einer '''DATEI.gme''' im Terminal durch Eingabe der OID-Code-Nummern. (Benötigt '''sox''') }}} {{{#!vorlage Paketinstallation sox }}} == Überarbeitung == Um vorhandenen Dateien eine persönliche Note zu geben oder um Fehler zu entfernen, kann man die Struktur der Steuerungsdatei überarbeiten und mit Programmen, wie z.B. [:Audacity:]; neue Audiodateien erstellen und vorhandene Dateien ersetzen. Wichtig ist, dass diese als '''.ogg'''-Dateien vorliegen und 22050Hz sowie Mono erfüllen. [[Vorlage(Bildunterschrift, Schatzkarte.png, 250,"[github:michote/Piraten-Geburtstag:Piraten-Geburtstag] von M. Reischuck", right,)]] == Eigenkreation == Um eigene Kreationen zu erstellen, benötigt man eine [wikipedia:YAML:]-Datei, in welcher die auszuführenden Aktionen definiert werden. Eine Beispieldatei ist unter [github:entropia/tip-toi-reveng/blob/master/example.yaml:GitHub] zu finden. Mit einem Editor [4] kann diese bearbeitet und erstellte [#berarbeitung Audiodateien] integriert werden: === example.yaml === {{{ # This is an example source file for a TipToi file # The basic format is YAML # You can compile this running # ./tttool assemble example.yaml example.gme # The product ID must match that of the book you want to use this with product-id: 42 # The media path is optional # The default is "%s", i.e. to look in the current directory # If you use "example/Buch1_%s", here then P(test) will use # the file "example/Buch1_test.ogg". # Ogg files should be Mono, 22050 Hz. # tttool will append .wav or .ogg and uses whatever it finds media-path: example/%s # The comment does not really matter comment: An example GME file # Register initalisation. This is simply list of set-commands. # Every register not set is initialized to 0 init: $mode:=1 # The sounds to play on start-up welcome: bing, hello # This is the interesting part: Scripts. # Technically, this is an assoiative list with the OID as an index, # and a list of strings as the content scripts: # We begin to specify what to do when the area in the book with the OID code # 8066 is touched. 8066: # The following line means: If register $mode is set to 1, then set it to 2, and # increment register $1 by one, and play the sound example/hello.ogg. - $mode==1? $mode:=2 $1+=1 P(hello) # Here, the pen is going to play one of these three sounds randomly. - $mode==2? $mode+=1 P(one,two,three) - $mode==3? $mode:=1 P(back) # You can either refer to a concrete register ($1), or a named register. # tttool will map these to otherwise unused registers. 8067: - $1==0? - $1==1? P(one) - $1==2? P(two) - $1==3? P(three) # Besides == and !=, there are also the comparisons < and >= - $1!=1? $1 != 2? $1 != 3? $1:=0 P(back) }}} === Text2Speach === Für schnelle Tests kann tttool auch Ansagen aus Text erstellen. Dazu werden folgende Pakete benötigt: {{{#!vorlage Paketinstallation libttspico-utils vorbis-tools }}} In der [wikipedia:YAML:]-Datei wird es folgendermaßen eingebunden: {{{ product-id: 781 media-path: oggs/%s comment: Text2Speach sample welcome: start # Spiellogik scripts: 7001: - P(sp_code7001) 7002: - P(sp_code7002) 7003: - P(sp_code7003) speak: - language: de start: "Es kann los gehen." sp_code7001: "Es wurde Code 7001 erkannt" sp_code7002: "Es wurde Code 7002 erkannt" sp_code7003: "Es wurde Code 7003 erkannt" }}} Nach der Konfiguration kann die Datei [#Aufruf '''TITEL.gme'''] mit {{{#!vorlage Befehl ./tttool assemble DATEI.yaml }}} erzeugt und anschließend auf den Stift kopiert werden. Genauere Informationen zur Verwendung sind der [http://tttool.entropia.de/ Projektseite] {de} zu entnehmen. Eine gelungene Eigenkreation ist auf GitHub zu finden: [github:michote/Piraten-Geburtstag:Piraten-Geburtstag] Einige weitere werden auf der [http://tttool.entropia.de/#was-kann-ich-hier-machen Projektseite] {de} vorgestellt. {{{#!vorlage Hinweis Beim Ausdruck ist eine Auflösung von mindestens 1200 dpi nötig, idealerweise auf einem hochauflösenden Laserdrucker. Die Bilder sollten etwas blasser sein, damit der Kontrast besser ist. Es empfiehlt sich, das Bild im ersten Schritt mit einem Farb-Laserdrucker zu drucken und im Folgeschritt die Punkt-Matrix mit einem Schwarz-Weiß-Drucker drüberzulegen. Teilweise ist aber auch ein Ausdruck mit 600 dpi erfolgreich. tttool bietet verschiedene Möglichkeiten beim erstellen der OID-Codes. Etwa das verdoppeln der Pixel pro Code-Punkt. Funktionierende Druckerkonfigurationen listet das [github:entropia/tip-toi-reveng/wiki/Printing:tttool-Wiki] {en} auf. }}} = Links = * [https://tttool.entropia.de/ Projektseite] {de} * [github:entropia/tip-toi-reveng/wiki:Wiki] {en} * [github:entropia/tip-toi-reveng/wiki/Hardware:Hardware] {en} * [https://lists.nomeata.de/mailman/listinfo/tiptoi tiptoi-Mailingliste] {de} * [github:entropia/tip-toi-reveng/wiki/Printing:Tips und Tricks zum Druck] {en} * [https://tttool.readthedocs.io Das tttool-Buch] {de} * [https://www.mikrocontroller.net/topic/214479 Wie funktioniert die Erkennung beim Hörstift TING?] {de} * [https://upload.querysave.de/code.html Tiptoi/TING-Codetester] {en} * [:tiptoi:] - Hauptartikel #tag: Hardware, Spiele, unfreie Software, Kinder, Schule, Bildung, tiptoi