c_move(ENTITY* entity,VECTOR* reldist,VECTOR* absdist,var mode)

Der erste Vektor, reldist, gibt eine relative Stecke und Richtung in gedrehten Entity-Koordinaten, d.h. in Blickrichtung der Entity, an. Der zweite Vektor absdist gibt eine absolute Strecke und Richtung in Weltkoordinaten an. Die daraus resultierende Bewegung besteht aus einer Kombination beider Strecken. Üblicherweise wird der erste Vektor für die Antriebsgeschwindigkeit der Entity und der zweite für äußere Kräfte, wie etwa Schwerkraft und Drift, benutzt. Um einen dieser Vektoren auf Null zu setzen, kann der vordefinierte nullvector angegeben werden.

Die Funktion liefert den Wert der zurückgelegten Entfernung zurück. Wird die Entity von Hindernissen blockiert und konnte sich überhaupt nicht bewegen, wird ein negativer Wert oder 0 zurückgegeben. Sind die Kollisions-Events aktiviert, werden Sie sowohl für die Entity, als auch für das Hindernis ausgelöst. Im Verlauf eines Kollisions-Events werden zur Angabe des Kollisions-Typus einige vordefinierte Variablen gesetzt (siehe unten). Diese können in der Event-Funktion zu jeglicher Art von Beeinflussung des Kollisions- bzw. Abprallverhaltens ausgewertet werden..

Parameter:

Die folgenden mode-flags können kombiniert werden:

Abhängig von:

Rückgabewerte:

Modifiziert:

Bemerkungen:

• Die folgenden Kollisionsevents lassen sich durch c_move-Kollisionen auslösen: EVENT_BLOCK bei Kollisionen mit dem Level und EVENT_ENTITY bei Kollisionen mit Entities. Getroffene Entity: EVENT_IMPACT, EVENT_PUSH, EVENT_SONAR, oder EVENT_SHOOT je nach c_move-Modus.
• Erstellen Sie die Kollisionsgeometrie so, dass sich Entities nicht miteinander verheddern. Entities, die in Bewegung sind können bei einer Kollision mit polygonalen Objekten, die 'Haken' oder 'Lücken', die in der Grösse auf die sich bewegende Entity passen, hängenbleiben. Verwenden Sie eine nicht-polygonale Hülle oder das Flag PASSABLE für alle Objekte, die so geformt sind, dass sich Entities darin verheddern könnten. Für alle anderen Modelle - wie etwa Rampen oder Treppen - die sich nicht bewegen und als Hindernisse dienen sollen, setzen Sie den POLYGON-Flag.
• Die Geschwindigkeit der Funktion hängt davon ab, ob eine Kollision erkant wurde oder nicht und ob die Entity gleitet oder nicht. Achten Sie beim Bewegen einer Entity darauf, ihre Bounding-Box (min_x/max_x) zum Vermeiden unnötiger Kollisionen klein genug zu halten.  !!  Es ist ein gängiger Anfängerfehler ist das Ausweiten der Bounding-Box einer Entity bis hinunter zu den Füssen und dann Gravitation anzuwenden, damit die Entity auf den Boden gedrückt wird. Das wird nicht nur aufgrund der ständigen Kollisionen mit dem Boden langsam, sondern bewirkt auch, dass die Entity in jedem kleinen Bodenspalte hängenbleibt und verhindert, dass sie Treppen oder Schrägen erklimmen kann. Verwenden Sie besser c_trace, um die Bounding-Box der Entity auf einen Abstand zum Boden zu halten und wenden Sie Schwerkraft nur überhalb dieses Abstands an. Das Beispiel unten zeigt eine einfache Bewegungsfunktion
• Um eine Entity vo dem Erklimmen einer Treppe abzuhalten, werden Sie entweder sein Vorwärtsmomentun reduzieren, oder die Schwerkraft erhöhen müssen. Wollen Sie andererseits, dass eine Entity eine ganz bestimmte, hohe Stufe erklimmen soll, werden Sie ihre Vorwärtsgeschwindigkeit erhöhen oder die Schwerkraft verringern. Gibt man ihr genügend große Geschwindigkeiten, kann eine Entity jede Stufe von einer Höhe bis zur Hälfte ihrer Größe erklimmen (vorausgesetzt, c_setminmax wurde dazu verwendet, dem Ellipsoiden dieselbe Höhe wie die Entity zu geben). Aus diesen Gründen verwenden GameStudios Template-Skripte stattdessen zwei c_move-Aufrufe. Einen, um die Schwekraft abzuwickeln, den zweiten zum Handhaben der Kräfte, die auf den Player einwirklen. Dies ist eine flexiblere Lösung, welche mehr Kontrolle ermöglicht, ist natürlich aber langsamer als ein einziger c_move-Aufruf.
• Hörte die Bewegung innerhalb eines passablen Blocks auf, wird die vordefinierte Variable in_passable auf 1 gesetzt. Endete die Bewegung inerhalb eines soliden Blocks (was nur dann geschehen kann, wenn passable Entities bewegt werden), wird die Variable in_solid auf 1 gesetzt.
• Ist GLIDE gesetzt, wird die Funktion veruchen, so weit als möglich an der Oberfläche entlangzugleiten oder einen Weg um Hindernisse herum zu finden. Die Variable move_friction (Bereich 0..1, default 0.25) bestimmt die Stärke der Reibung beim Entlanggleiten an Oberflächen. Bei 0 ist gar keine Reibung vorhanden und bei 1 klebt die Entity an der Oberfläche fest und und gleitet kein bisschen. Ist die vordefinierte Variable disable_z_glide auf einen Wert ungleich 0 gesetzt, deaktiviert sie das Hinaufgleiten an Schrägen oder anderen Objekten.
• Um dem Modell das Entlanggleiten an Wänden und anderen Objekten zu ermöglichen, wird die interne Bewegungsfunktion bei gesetztem GLIDE etliche (bis zu 6) Male ausgeführt. GLIDE kann daher die Bewegung verlangsamen und dazu führen, dass das Model an unerwarteter Stelle landet. Benutzen Sie GLIDE niemals für Türen, Lifte usw.
• st ACTIVATE_TRIGGER gesetzt, wird die Event-Funktion einer sich in der Nähe befindlichen Entity ausgelöst, sofern diese den Flag ENABLE_TRIGGER gesetzt hat und entweder a) die Summe der trigger_ranges beider Entities größer ist als die Distanz zwischen der Move-Target-Position der ersten und dem Zentrum zweiten Entity oder b) der trigger_range der Entity, die sich in der Nähe befindet, Null ist, ihr Flag passable gesetzt ist und die Move-Target-Position innerhalb der Bounding-Box liegt.
• Die Variablen move_min_z und move_friction legen die maximale Schritthöhe und das Gleitverhalten fest.
• IGNORE_YOU kann verwendet werden um zu verhindern, dass ein Geschoss gleich im Gewehrlauf oder in der Entity, die sie abfeuert, stecken bleibt.  !!  Es ist ein üblicher Anfängerfehler, das Flag IGNORE_YOU, nicht aber den you-Pointer zu setzen. Die Kollisionserkennung wird dann falsche Ergebnisse zurückliefern, denn you wird von vielen Funktionen modifiziert und kan daher auf eine andere als die erwartete Entity zeigen.
• Zum Bewegen von Physik-Entities verwenden Sie pXent_move.

Geschwindigkeit:

Beispiel (lite-C)::

// simple function for walking over ground
// control the player with the WASD keys
// player origin must be at the model center
// bounding box must be smaller than the player!
action player_walk()
{ 
// if necessary, adjust the bounding box to give the entity 'floor room' (see remarks) 
// my.min_z *= 0.5;

   var speed_down = 0;   // downward speed by gravity
   var anim_percent = 0; // animation percentage
   VECTOR vFeet;
   vec_for_min(vFeet,me); // vFeet.z = distance from player origin to lowest vertex

   while (1)
   {
// rotate the player using the [A] and [D] keys      
      my.pan += 5*(key_a-key_d)*time_step; 

// determine the ground distance by a downwards trace
      var dist_down; 
      if (c_trace(my.x,vector(my.x,my.y,my.z-5000),IGNORE_ME | IGNORE_PASSABLE | USE_BOX) > 0)
         dist_down = my.z + vFeet.z - target.z; // get distance between player's feet and the ground
      else
         dist_down = 0;

// apply gravity when the player is in the air
      if (dist_down > 0)  // above floor, fall down with increasing speed
         dist_down = clamp(dist_down,0,accelerate(speed_down,5,0.1));
      else                // on or below floor, set downward speed to zero
         speed_down = 0;

// move the player using the [W] and [S] keys      
      var dist_ahead = 5*(key_w-key_s)*time_step;
      dist_ahead = sign(dist_ahead)*(abs(dist_ahead) + 0.5*dist_down); // adapt the speed on slopes
      c_move(me,vector(dist_ahead,0,0),vector(0,0,-dist_down),IGNORE_PASSABLE | GLIDE); // move the player

// animate the player according to its moved distance
      if (dist_ahead != 0) // player is moving ahead
      {
         anim_percent += 1.3*dist_ahead; // 1.3 = walk cycle percentage per quant
         ent_animate(me,"walk",anim_percent,ANM_CYCLE); // play the "walk" animation
      }
      else // player stands still
      { 
         anim_percent += 5*time_step; 
         ent_animate(me,"stand",anim_percent,ANM_CYCLE); // play the "stand" animation
      }
      wait(1);
   }
}

Siehe auch:

► Aktuelle Version Online