AFX_DEFINE_OBJ_VAR <afx> <nr> <art> <var_name> <min> <max>
Beschreibung: Definiert beim AnimFX-Objekt <afx> die Variable nr <nr>. Die Variable bekommt die Art <art>, den Namen <var_name> und sollte von <min> bis <max> gehen.
<art> besagt, ob die Variable eine Integer (art=0) oder eine Real-Variable (art=1) sein soll. (Intern sind Objektvariablen immer Real-Variablen, die Art besagt nur, wie sie für den Benutzer im Objekteditorfenster erscheinen.)
<var_name> ist die Bezeichnung für die Variable. Der Name erscheint im Parameterfenster links neben dem Eingabefeld.
<min> und <max> sind die Minimal- und Maximalwerte, die für den Schieberegler eingestellt werden. Hier sollte der sinnvolle-Bereich für die Variable definiert werden.
Achtung! Der Benutzer kann im Eingabefeld der Variable auch Werte einstellen, die außerhalb dieses Bereiches liegen. Es ist Sache des Skripts, beim Lesen der Variablen zu prüfen, ob es dann noch sinnvolle Werte sind, um dementsprechend zu reagieren. Beim Animieren kann dann mit dem Objekt-Befehl OBJ_GET_VAR <afx> <nr> der aktuelle Wert der Variable erfragt werden.
Parameter:
  • <afx> das betreffende AnimFX-Objekt
  • <nr> Nummer der Objektvariablen (von 0 bis <Variablenanzahl>-1)
  • <art> 0=Integer-Variable, ungleich 0=Real-Variable
  • <var_name> Name der Variable (für Objekteditfenste)
  • <min> <max> sinnvoller Bereich für Werte der Variable (wird für Einstellung des Schiebereglers verwendet)
Ergebnis: -
Fehler:
  • unbekanntes Objekt
  • kein AnimFX-Objekt
  • Objektvariablennummer falsch: Wenn eine falsche Nummer für die Variable angegeben wird
Beispiel: ; zuerst Platz für zwei Variablen anfordern:
AFX_SET_N_OBJ_VARS ich 2
; jetzt die Schieber mit Werten belegen.
; zuerst ein Schieber mit Real-Werten
AFX_DEFINE_OBJ_VAR ich 0 1 Faktor 0.2 3.7
; danach einer mit Integer-Werten
AFX_DEFINE_OBJ_VAR ich 1 0 Stufen 1 5

Beispielrequester unter Windows