c_trace(VECTOR* from, VECTOR* to, var mode)

Parameter:

Die folgenden Modus-Flags können kombiniert werden:

Rückgabewerte:

Modifiziert:

Geschwindigkeit:

Bemerkungen:

• Je grösser der Abstand zwischen der to- und der from-Position, je mehr Entities müssen im Level überprüft werden und umso langsamer ist die Funktion. Verwenden einen so geringen Abstand wie möglich. Zum Beschleunigen der Funktion verwenden Sie wann immer möglich IGNORE-Flags (z. B. IGNORE_CONTENT, IGNORE_SPRITES etc.).
• Im USE_BOX-Modus hängt die Geschwindigkeit der Funktion vom Strahlvolumen ab, es ist daher besonders wichtig, den Abstand zur to-Position kurz zu halten. Setzen Sie also nicht USE_BOX wenn ein Strahlen-Trace genügt.
• Im USE_BOX-Modus werden die Ziele immer polygonal betrachtet (als wäre USE_POLYGON gesetzt). Hülle und Ziel dürfen sich nicht überschneiden. Das zurückgelieferte Ergebnis benennt den Abstand vom Trefferpunkt zum nächstgelegenen Punkt der Hülle der me-Entity. Berührt die Entity das Ziel im USE_BOX-Modus, wird 0 oder ein sehr kleiner Abstandswert zurückgeliefert. Da 0 auch zum Anzeigen für keinen Treffer benutzt wird, prüfen Sie den Wert trace_hit.
• IGNORE_YOU läßt sich zum Vermeiden des Auffindens einer Bestimmten Entity verwenden.  !!  Es ist ein gängiger Anfängerfehler, zwar das Flag IGNORE_YOU zu setzen, nicht aber den you-Pointer. Dies führt dazu, dass die Erkennung zufallsbedingt danebengeht, denn you wird von vielen Funktionen (inklusive dieser) verändert.
• Um eine Entity zu treffen, tracen Sie auf einen Punkt, der deutlich innerhalb der Entity-Mesh liegt, etwa das Zentrum der Entity.  !!  Es ist ein üblicher Anfängerfehler, einen Vertex der Entity-Mesh als Trace-Ziel zu verwenden. Dadurch wird die Entity je nach Zufall nicht getroffen, denn in Abhängigkeit ihrer Position und Ausrichtung, endet der Trace knapp bevor er die Mesh-Oberfläche berührt.
• Um festzustellen, welches Körperteil einer Actor-Entity getroffen wurde, verwenden Sie die Vertexnummer des getroffenen (hit) Strukts und liefern den Namen des Bones mit der Funktion ent_bonename zurück.
• In manchen Fällen lassen sich zum selben Zweck schnellere funktionen benutzen. Die Höhe über Terrain an einer bestimmten Position beispielsweise, kann auch mit den Funktionen ent_nextvertex und ent_getvertex berechnet werden.

Beispiele:

// test the floor texture - trace downwards 1000 quants below
function print_floor_texture()
{
  c_trace (my.x,vector(my.x,my.y,my.z-1000),IGNORE_ME|IGNORE_PASSABLE|SCAN_TEXTURE);
  if (hit.texname) printf("Floor texture: %s",hit.texname);
}

// place an entity onto the ground below
function item_set_to_ground()
{
  c_trace(my.x,vector(my.x,my.y,my.z-1000),IGNORE_ME|IGNORE_SPRITES|IGNORE_CONTENT);
  my.z = hit.z - my.min_z;
}
 
// look if the YOU enemy can be shot at from my position, and if yes, trigger its EVENT_SHOOT event
function shoot_you()
{
  c_trace(my.x,your.x,IGNORE_ME|IGNORE_PASSABLE|ACTIVATE_SHOOT|IGNORE_CONTENT); 
}

Siehe auch:

► Aktuelle Version Online