PRT_SET_POS_1 <par> <formel> <koord_nr> <art>
Beschreibung: Setzt die Position von Partikeln nach einer arithmetischen Formel. Bearbeitet alle Partikel des aktuellen Bereiches (siehe PRT_SET_RANGE). Bei diesen Partikeln wird die Formel ausgewertet und der ermittelte Wert in die Koordinate <koord_nr> der Position des Punktes gesetzt oder addiert.
<art>=0: Koordinate wird gesetzt.
<art>=1: Koordinate wird addiert.
In der Formel können neben den Werten, Funktionen, Skriptvariablen auch noch zwei besondere Schlüsselwörter verwendet werden:
PNR liefert die aktuelle Partikelnummer, die gerade bearbeitet wird
PDATA0 liefert den Wert aus dem Datenfeld 0
PDATA1 liefert den Wert aus dem Datenfeld 1
usw.
Dies wird oft gebraucht, um die gespeicherten Daten der Partikel zur Positionsbestimmung in der Formel zu verwenden.
Parameter: <par> das betreffende Partikelobjekt
<formel> eine arithmetische Formel, die der Formelinterpreter von monzoom® auswerten kann
<koord_nr> Index der Koordinaten, die gesetzt oder verändert werden
soll (0=x, 1=y, 2=z)
<art> eine Nummer, die steuert, ob die Koordinate gesetzt (art=0) oder addiert werden soll (art=1)
Ergebnis: -
Fehler:
  • unbekanntes Objekt
  • kein Partikelobjekt
  • Variable ist nicht definiert
  • Variable ist nicht numerisch
  • unerlaubte Zeichen in Formel
  • Fehler in Formel
Beispiele: ; Setzen der Z-Koordinate der Partikel von Partikelobjekt hugo
; entlang einer Sinuskurve.
; alle punkte sollen gesetzt werden (s.u. PRT_SET_RANGE)
PRT_SET_RANGE hugo 0
GEO_NPTS hugo
GET_RESULT npts
; x-koordinate
PRT_SET_POS_1 hugo PNR/npts*3.14159 0 0
; y-koordinate
PRT_SET_POS_1 hugo 0 1 0
; z-Koordinate
PRT_SET_POS_1 hugo SIN(PNR/npts*3.14159)*amplitude 2 1