c_move(ENTITY* entity,VECTOR* reldist,VECTOR* absdist,var mode)
Bewegt eine Entity über eine bestimmte Entfernung und führt dabei eine Kollisionserkennung, das Auslösen von Kollisions-Events sowie das Entlanggleiten an Hindernissen aus.
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:
entity Zu bewegende Entity
reldist Vektor der Bewegungsstrecke in Entity-Koordinaten (relativer Bewegungsvektor)
absdist Vektor der Bewegungsstrecke in Welt-Koordinaten (absoluter Bewegungsvektor)
mode Kollisionsmodus, siehe unten

Die folgenden mode-flags können kombiniert werden:

IGNORE_YOU Ignoriert die you-Entity bei der Kollisionserkennung (s. Kommentar).
IGNORE_FLAG2 A7.10 Ignoriert alle Entities mit gesetztem FLAG2.
IGNORE_PASSABLE Ignoriert alle passablen Blocks und Entities einschliesslich sämtlicher Wasser-Entities.
IGNORE_PASSENTS Ignoriert passable Modell- und Sprite-Entities, nimmt jedoch noch Wasser-Entities (passable rechteckige Maps oder passable Terrains) wahr. Es setzt die vordefinierten Flag s in_passable und on_passable . Der vordefinierte Pointer passable_ent wird auf die erkannte Wasser-Entity gesetzt. So lässt sich das Playerverhalten beispielsweise auf Schwimmen umschalten.

IGNORE_WORLD Ignoriert alle Level-Blocks und Terrains.
IGNORE_MAPS Ignoriert alle Map- und Terrain-Entities
IGNORE_MODELS Ignoriert sämtliche Models
IGNORE_SPRITES Ignoriert sämtliche Sprites
IGNORE_PUSH Ignoriert alle Entities mit einem niedrigeren push- oder gleichem group-Wert als bzw. wie dem der gegebenen Entity und löst bei diesen Entities den Kollisions-Event EVENT_PUSH aus.
IGNORE_CONTENT Ignoriert Wasser-Entities (s.o.). Die Anweisung wird dadurch etwas schneller ausgeführt.
ACTIVATE_TRIGGER Aktiviert EVENT_TRIGGER während der Bewegung
ACTIVATE_PUSH A7.10 Löst bei der getroffenen Entity unabhängig von deren push- oder group-Wert den Kollisionsevent EVENT_PUSH aus. Liefert die Event-Funktion 1 zurück, wird die getroffene Entity als Hindernis betrachtet, ist der Rückgabewert 0, wird sie ignoriert. So lassen sich individuelle Kollisionsgruppen definieren.

ACTIVATE_SHOOT A7.10 Ermöglicht EVENT_SHOOT-Triggering der getroffenen Entity und verhindert alle anderen Kollisionsevents. Dieses Flag sorgt dafür, dass c_move sich ähnlich verhält wie c_trace.

ACTIVATE_SONAR A7.10 Ermöglicht EVENT_SONAR-Triggering der getroffenen Entity und verhindert alle anderen Kollisionsevents. Dieses Flag sorgt dafür, dass c_move sich ähnlich verhält wie c_trace.

USE_AABB Verwendet anstelle einer mitgedrehten Bounding Box (OBB) eine an Achsen ausgerichtete Kollisionsbox (AABB). Das AABB-System ist schneller, ignoriert aber die Ausrichtung der Entity auf USE_BOX, behandelt Modelle und Sprites als Boxen und erfordert einen BSP-Level. Mehr über den Unterschied zwischen beiden Systemen finden Sie unter Kollision.
USE_POLYGON Benutzt eine polygonale Hülle aller Zielentities auch dann, wenn ihr POLYGON-Flag nicht gesetzt ist. Kann nicht gleichzeitig mit USE_AABB benutzt werden.

GLIDE Gleitet beim Auftreffen an Wänden und Entities entlang.

Abhängig von:
move_friction Reibungsfaktor zum Entlanggleiten an Wänden.
move_min_z Maximale Stufenhöhe (nur OBB).
disable_z_glide Schaltet das Hinaufgleiten an Schrägen ab (nur OBB)

Rückgabewerte:
> 0 zurückgelegte Entfernung.
<= 0 Entity wurde blockiert

Modifiziert:
entity.x, y, z Entity-Position.
target Position des Kontaktpunktes der Kollision
normal Vektor der Normalen der berührten Oberfläche
bounce Vektor der Abprallrichtung
trace_hit Auf ungleich Null gesetzt, wenn etwas getroffen wurde.
in_passable Auf ungleich Null gesetzt, wenn der Start- oder Endpunkt innerhalb einer Wasser-Entity liegt.
on_passable Auf ungleich Null gesetzt, wenn das getroffene Ziel eine Wasser-Entity ist..
passable_ent Ist in_passable oder on_passable gesetzt, ist dieser Pointer auf das ermittelte Wasser-Terrain gesetzt (nur im OBB-System)
event_type Event-Typ bei Auslösung.

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. Dies verursacht, dass die Kollisionserkennung zufallsabhängig hin und wieder versagt, denn you wird von vielen Funktionen (inklusive dieser) modifiziert.
Physics entities lassen sich nicht direkt bewegen - wenden Sie stattdessen eine Kraft oder eine Geschwindigkeit an.
Geschwindigkeit:
Langsam
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);
}
}