Millennium Time Capsule/AC2000.BIN/disks/ac13disk/plug_ins/isvm100g/isvm.u

Text File | 1998-09-14 | 5.2 KB | 177 lines

#################################
# Anleitung zu ISVM             #
#                               #
# Letzte Änderung: 14.09.1998   #
#################################

!docinfo [program] ISVM
!docinfo [author] Volker Janzen
!docinfo [address] c/o Mattes
!docinfo [address] Haslacher Weg 17
!docinfo [address] D-89075 Ulm
!docinfo [address] Tel: [phone]
!docinfo [address] MausNet: Volker Janzen @ UL
!docinfo [address] Internet: [e-mail]
!docinfo [address] WWW: http://www.voja.de/gemscript/isvm.html
!docinfo [version] Stand der Anleitung:
!docinfo [date] (!today)
!docinfo [programimage] titel

!code [tos]

!html_textcolor black
!html_vlinkcolor red
!html_alinkcolor green
!html_backcolor #C0C0C0

!html_backpage /gemscript/isvm.html

#!html_merge_subnodes

#!html_modern_layout
#!html_modern_column_width 15
#!html_modern_column_color #C0C0C0

#!html_frames_column_color #C0C0C0
#!html_frames_column_width 125
#!html_frames_layout

!macro elib EasyGEM-Library

!use_auto_subtocs [stg,win]
!use_auto_subsubtocs [stg,win]
!use_auto_subsubsubtocs [stg, win]
!use_mirrored_indices [all]
!use_nodes_inside_index [all]
!use_output_buffer [all]
#!use_short_envs [all]
!use_short_tocs [all]
!use_udo_index [all]
!use_about_udo [all]
!use_chapter_images [html,stg]

!use_auto_subtocs    [info,html,stg,tvh,win]
!use_auto_subsubtocs [info,html,stg,tvh,win]
!no_effects          [asc]

!begin_document
!raw [stg] @options "+zz-s"
!raw [stg] @subject "Dokumentation\Utility"
!maketitle
!tableofcontents

!node Einleitung

Die erste Version von ISVM, das steht für "InterScript Variablen Manager", entstand nach einer Mail
von Holger Weets in der MausNet-Gruppe Atari.Scripter. Er zeigte Möglichkeiten auf, wie zwei Scripte
Variableninhalte austauschen können. Die eine geht über eine Datei, die andere wäre ein externes
Programm, mit dessen Hilfe Scripte Variableninhalte abspeichern und abfragen können. Für diesen Zweck
wurde ISVM programmiert.

!node Rechliches

ISVM (c) 1998 by Volker Janzen

ISVM ist Freeware!

ISVM darf auf PD/Shareware-Disketten kopiert werden, solange der Preis
einer Diskette 5 DM nicht übersteigt. Die Weitergabe auf CD-ROM bedarf
der ausdrücklichen Genehmigung des Autors. Die Verteilung in Mailboxen
mit kostenlosem Gastdownload und per anonymous FTP ist erlaubt und
ausdrücklich erwünscht. Weitere Vertreibsarten müssen mit dem Autor
abgesprochen werden.

!node Installation

(!U)Für Scripter:(!u)

ISVM.PLG in den Ordner PLUGIN von Scripter kopieren -> fertig.

(!U)Für Simple Script:(!u)

ISVM.PLG in ISVM.APP umbenennen. Beim ersten Aufruf von ISVM aus
Simple Script heraus ISVM.APP im Fileselektor auswählen.

!node Befehlsreferenz

ISVM unterstützt in Zusammenarbeit mit Scripter "extern" Variablen.
Lesen Sie bitte hierzu Ihre Scripter Dokumentation.

!subnode SetVar

!begin_verbatim
ret=ISVM.SetVar("Name", Value [, Permanent]);
!end_verbatim

Setzt in der ISVM Variablenverwaltung die Variable Name auf den Wert
Value. ISVM unterscheidet bei den Variablennamen Groß/Kleinschreibung!
"a" ist eine andere Variable wie "A". Da sich alle Scripte ISVM teilen
müssen, sollten die Variablennamen ziemlich eindeutig sein, die
Verwendung der beliebten Variablennamen "a" oder "i" ist nicht sehr
sinnvoll. Value darf alles sein was Scripter als Variable interpretiert,
also eine Zahl oder ein String. Neu seit Beta 2 ist das Flag Permanent:
Wird hier "1" übergeben, sieht ISVM die Variable als permanent an. Wenn
das Plugin beendet wird, merkt sich ISVM alle permanenten Variablen in
einer Datei namens PISV.DAT (Permanente InterScript Variablen). Wird das
Plugin wieder gestartet, werden die permanenten Variablen aus dieser Datei
eingelesen und stehen wieder zur Verfügung.

ret=0: Kein Variablenname angegeben (!nl)
ret=1: Alles OK, Name hat jetzt den Wert Value (!nl)
ret=2: Kein Speicherplatz mehr frei (!nl)

!subnode GetVar

!begin_verbatim
Value=ISVM.GetVar("Name");
!end_verbatim

Fragt ISVM nach dem Inhalt der Variable "Name". Ist Value="" so wurde
die Variable noch nicht angelegt (bzw. ist wirklich ein Leerstring).

!subnode DelVar

!begin_verbatim
ret=ISVM.DelVar("Name");
!end_verbatim

Löscht die Variable "Name". Dieser Befehl wurde zusammen mit den
permanenten Variablen in Beta 2 eingeführt.

ret=0: Variable nicht gefunden (!nl)
ret=1: Variable gelöscht (!nl)

!subnode Quit

!begin_verbatim
ISVM.Quit;
!end_verbatim

ISVM beendet sich. Dabei werden alle temporären Variablen gelöscht!

!node Dank an

!begin_itemize
!item die Guano Apes für ihr Album "proud like a god", das mich zeitweise beim
Programmieren per Kopfhörer ist angemessener Lautstärke ;-) berieselte
!item Joachim Mährdel, der fast alle Bugs in der ersten Beta im Alleingang fand
!item Holger Weets, der mich mit überzeugenden Argumenten ;-) dazu brachte die
GEMScript Unit umzuschreiben, um die unnötigen Beschränkungen der Variablennamen und -inhalte aufzuheben
!item Mark Wherry für die Übersetzung der Doku ins Englische
!end_itemize

!node Kontakt

!begin_verbatim
Volker Janzen
c/o Mattes
Haslacher Weg 17
D-89075 Ulm

MausNet : Volker Janzen @ UL
InterNet: [e-mail]
WWW     : http://www.voja.de/fox/index.html
!end_verbatim

!end_document