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.