ubuntuusers.de

tttool

Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:


Du möchtest den Artikel für eine weitere Ubuntu-Version testen? Mitarbeit im Wiki ist immer willkommen! Dazu sind die Hinweise zum Testen von Artikeln zu beachten.

Tiptoi_digitalpapier.png
Kodierung

tttool 🇩🇪 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 Release-Seite herunterladen [2] und entpacken [3], z.B.

wget https://github.com/entropia/tip-toi-reveng/releases/download/1.9/tttool-1.9.zip
unzip tttool-1.9.zip 

Hinweis!

Fremdsoftware kann das System gefährden.

Danach steht im Ordner tttool-1.9 das Werkzeug tttool zur Verfügung.

Verwendung

Achtung!

Anwendung auf eigene Gefahr. Es wird keine Haftung für Schäden am Stift übernommen.

Der Aufruf der Werkzeuge erfolgt über das Terminal [2]:

tttool [OPTION] KOMMANDO 

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 YAML-Datei.
./tttool play DATEI.gme Ermöglicht das Testen einer DATEI.gme im Terminal durch Eingabe der OID-Code-Nummern. (Benötigt sox)
  • sox

Befehl zum Installieren der Pakete:

sudo apt-get install sox 

Oder mit apturl installieren, Link: apt://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.

Schatzkarte.png
Piraten-Geburtstag von M. Reischuck

Eigenkreation

Um eigene Kreationen zu erstellen, benötigt man eine YAML-Datei, in welcher die auszuführenden Aktionen definiert werden. Eine Beispieldatei ist unter GitHub zu finden. Mit einem Editor [4] kann diese bearbeitet und erstellte 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:

  • libttspico-utils

  • vorbis-tools

Befehl zum Installieren der Pakete:

sudo apt-get install libttspico-utils vorbis-tools 

Oder mit apturl installieren, Link: apt://libttspico-utils,vorbis-tools

In der 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 TITEL.gme mit

./tttool assemble DATEI.yaml 

erzeugt und anschließend auf den Stift kopiert werden. Genauere Informationen zur Verwendung sind der Projektseite 🇩🇪 zu entnehmen. Eine gelungene Eigenkreation ist auf GitHub zu finden: Piraten-Geburtstag Einige weitere werden auf der Projektseite 🇩🇪 vorgestellt.

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 tttool-Wiki 🇬🇧 auf.

Diese Revision wurde am 14. Februar 2021 19:09 von damoasda erstellt.
Die folgenden Schlagworte wurden dem Artikel zugewiesen: unfreie Software, tiptoi, Schule, Hardware, Kinder, Bildung, Spiele