lua-akfavatar(1)                                              lua-akfavatar(1)



NNAAMMEE
       lua-akfavatar - Lua-Interpreter für die AKFAvatar-Benutzeroberfläche

SSYYNNTTAAXX
       lluuaa--aakkffaavvaattaarr [[_O_p_t_i_o_n_e_n]] [[ _S_k_r_i_p_t [[_A_r_g_u_m_e_n_t_e]] ]]

BBEESSCCHHRREEIIBBUUNNGG
       Das  Programm  Lua-AKFAvatar ist der Lua Interpreter für die AKFAvatar-
       Benutzeroberfläche.  Es lädt und führt Lua-Skripte in Form  von  Quell‐
       code  aus (kein Bytecode).  Es können entweder Lua-Skripte geladen wer‐
       den oder „..aavvtt“-Demo-Dateien.  Wenn kein _S_k_r_i_p_t angegeben ist, wird ein
       Dateiauswahl-Dialog angezeigt.

       Die  angegebenen  _A_r_g_u_m_e_n_t_e  sind im _S_k_r_i_p_t als Strings in der globalen
       Tabelle namens aarrgg verfügbar.  Der Name des  _S_k_r_i_p_tes  selber  befindet
       sich in aarrgg[[00]], das erste Argument ist aarrgg[[11]] und so weiter.

       Um  Zugang  zu  den AKFAvatar-spezifischen Funktionen zu bekommen, muss
       man erstmal den Befehl llooccaall _a_v_t == rreeqquuiirree _"_l_u_a_-_a_k_f_a_v_a_t_a_r_" verwenden.

       Mit dem Dateiauswahl-Dialog kann man auch Anleitungen mit der  Dateien‐
       dung  „..aabboouutt“  sehen.   Das  können  einfache Textdateien sein, die in
       UTF-8 oder reinem  ASCII  kodiert  sind.   Man  kann  auch  die  „over‐
       strike“-Technik  verwenden,  um Text fett oder unterstrichen darstellen
       zu können.  Man kann zum Beispiel das Textsatzsystem „groff“ verwenden,
       um solche Dateien zu erstellen.
       Außerdem  können  GNU info Dateien mit der Dateiendung "..iinnffoo" als Text
       dargestellt werden (keine Unterstützung für Querverweise).


OOPPTTIIOONNEENN
       -h
       --help zeigt eine kurze Hilfe an

       -v
       --version
              zeigt die Version an

       -l _[_v_a_r_=_]_N_a_m_e
              ruft rreeqquuiirree((_"_n_a_m_e_")) auf,  bevor  das  Skript  ausgeführt  wird.
              Definiert  eine  globale  Variable  mit dem Namen _N_a_m_e oder _v_a_r.
              Das wird üblicherweise verwendet, um Bibliotheken zu laden.

       -f
       --fullscreen
              starte im Vollbild Modus (nur wenn kein Skript angegeben ist)

       -F
       --Fullscreen
              starte im Vollbild Modus ohne  die  Auflösung  umzustellen  (nur
              wenn kein Skript angegeben ist)

       --dir=_V_e_r_z_e_i_c_h_n_i_s
              starte  den  Dateiauswahl-Dialog in diesem Verzeichnis (nur wenn
              kein Skript angegeben ist)

UUMMGGEEBBUUNNGG
       LUA_PATH_5_2
       LUA_PATH
              Suchpfad für Lua-Module.  Die Suchmuster werden  durch  Semikola
              getrennt.   Ein  Fragezeichen (??)  wird durch den Namen des Mod‐
              ules ersetzt.  Ein Punkt im Modul-Namen wird durch das Verzeich‐
              nis-Trennzeichen  des Systems ersetzt.  Zwei Semikola (;;;;) fügen
              den Standard-Pfad hinzu.

       LUA_CPATH_5_2
       LUA_CPATH
              Suchpfad für  C-Module.   Die  Syntax  ist  die  selbe  wie  bei
              _L_U_A___P_A_T_H.

       AVTDATAPATH
              Suchpfad für Datendateien (Bilder, Audio, Texte...).  Er wird in
              der Variable aavvtt..ddaattaappaatthh abgelegt und  kann  mit  der  Funktion
              aavvtt..sseeaarrcchh((_D_a_t_e_i_n_a_m_e))  verwendet werden.  Die Verzeichnisse wer‐
              den durch Semikola getrennt.  Im  Gegensatz  zu  den  vorherigen
              Pfaden gibt es keine Suchmuster mit Fragezeichen.

BBEEIISSPPIIEELL
       local avt = require "lua-akfavatar"
       avt.encoding("UTF-8")
       avt.title("Mein erstes Programm")
       avt.start()
       avt.avatar_image("default")
       avt.say("Hallo du!\n")
       local Name = avt.ask("Wie heißt du denn? ")
       avt.say("Hallo, ", Name, ". Schön dich zu sehen!\n")
       avt.wait_button()

SSIICCHHEERRHHEEIITT
       Lua  ist  eine vollständige Programmiersprache.  Es gibt keine Sandbox-
       Beschränkungen.  Jede  vollständige,  unbeschränkte  Programmiersprache
       kann  dafür  missbraucht werden, um Schadcode zu schreiben.  Man sollte
       also immer daran denken, dass Lua-Skripte Programme sind  und  mit  der
       selben  Sorgfalt wie andere Programme zu behandeln sind.  Einige andere
       Dateien für Lua-AKFAvatar können ebenfalls Code enthalten.

AAUUTTOORREENN
       AKFAvatar
       Lua-AKFAvatar   Andreas K. Förster

       Lua             R. Ierusalimschy, L. H. de Figueiredo, and W. Celes

HHOOMMEEPPAAGGEE
       http://akfavatar.nongnu.org/

SSIIEEHHEE AAUUCCHH
       lluuaa(1)  lluuaa--aakkffaavvaattaarr--rreeff(3)   aakkffaavvaattaarr--ggrraapphhiicc(3)   aakkffaavvaattaarr--tteerrmm(3)
       aakkffaavvaattaarr..uuttff88(3)

       http://akfavatar.nongnu.org/manual/
       http://www.lua.org/manual/5.2/
       http://lua.coders-online.net/



AKFAvatar                         2013-07-11                  lua-akfavatar(1)
