c_scan

c_scan (VECTOR* pos, ANGLE* ang, VECTOR* sector, var mode);

Ermittelt Entities oder andere Objekte innerhalb eines Kegels oder einer Kugel und
löst ihren Event EVENT_SCAN aus.

Parameter:

pos	Scan-Ursprung.
ang	Scan-Richtung, Eulerwinkel.
sector.x	horizontaler Scanbereich, oder Scankegelbreite in Grad (360 für eine komplette Kugel).
sector.y	vertikaler Scanbereich in Grad, oder 0 für einen kreisrunden Scankegel.
sector.z	Scanbereich in Quants.
mode	Scanmodus (s.unten).

Folgende mode-Werte können gesetzt werden:

IGNORE_ME	Ignoriert die my-Entity; kann mit SCAN_ENTS kombiniert werden.
IGNORE_YOU	Ignoriert die you-Entity und setzt den you-Pointer nicht; kann mit SCAN_ENTS kombiniert werden.
IGNORE_PASSABLE	A7.20 LC Ignoriert Entities mit dem Flag PASSABLE; kann mit SCAN_ENTS kombiniert werden. Zum Ignorieren bestimmter Entity-Gruppen, rufen Sie c_ignore vor c_scan auf.
IGNORE_FLAG2	A7.20 LC Ignoriert Entities mit FLAG2; kann mit SCAN_ENTS kombiniert werden.
IGNORE_WORLD	A7.82 Ignoriert sämtliche Terrains; kann mit SCAN_ENTS kombiniert werden.
IGNORE_MAPS	A7.82 Ignoriert alle Map-Entities; kann mit SCAN_ENTS kombiniert werden.
IGNORE_MODELS	A7.82 Ignoriert alle Modelle; kann mit SCAN_ENTS kombiniert werden.
IGNORE_SPRITES	A7.82 Ignoriert alle Sprites; kann mit SCAN_ENTS kombiniert werden.
SCAN_ENTS	Scannt innerhalb des Kegels nach Entities und löst ihren EVENT_SCAN- Event aus.
SCAN_POS	Scannt nach im Level platzierten Kamerapositionen.
SCAN_PATHS	Scannt nach Startpostitionen von Pfaden.
SCAN_NODES	Scannt nach Positionen von Pfad-Wegpunkten.
SCAN_LIGHTS	Scannt nach statischen Lichtern.
SCAN_LIMIT	Ermittelt nur Entities mit gesetztem ENABLE_SCAN oder ausschließlich statische Lichter, deren Reichweite bis zum Scan-Ursprung reicht. Kann mit SCAN_ENTS und SCAN_LIGHTS kombiniert werden.
SCAN_FLAG2	A7.20 LC Gegenteil von IGNORE_FLAG2: findet nur Entities mit FLAG2. kann mit SCAN_ENTS kombiniert werden.

Rückgabewerte:

Abstand zum nächstgelegenen gefundenen Objekt oder 0, falls kein Objekt ermittelt wurde.

Modifiziert:

you	Pointer zur nächstgelegenen ermittelten Entity.
result	Abstand zum nächstgelegenen ermittelten Objekt.
target	Position des nächstgelegenen ermittelten Objekts.
bounce	Ausrichtung zur nächstgelegenen ermittelten Kameraposition im Level.
tex_color	Farbe des nächstgelegenen ermittelten statischen Lichts.

Bemerkungen:

SCAN_ENTS scannt lediglich nach dem Ursprung des Objekts. Falls Sie ein großes Objekt haben, sorgen Sie dafür, daß der Ursprung innerhalb des Scan-Kegels liegt.
Falls eine Entity mit gesetztem ENABLE_SCAN, deren Zentrum innerhalb des Scan-Bereichs liegt, ermittelt wird, wird ihre event-Funktion ausgelöst. Dabei wird event_type auf EVENT_SCAN gesetzt, result auf den Abstand und you, falls vorhanden, auf die scannende Entity.
Hat die my-Entity ENABLE_DETECT gesetzt, wird ihre event-Funktion jeweils einmal für jede ermittelte Entity ausgelöst. Währenddessen wird event_type auf EVENT_DETECT und you auf die ermittelte Entity gesetzt. Auf diese Weise lassen sich ermittelte Entities aufzählen.
Um zu verhindern, dass eine scannende Entity sich selbst auslöst, setzen Sie IGNORE_ME. Um eine bestimmte Entity zu ignorieren, setzen Sie me oder you auf den Entity-Pointer.
Die Funktion scannt durch Wände - verwenden Sie sie also nicht für Gewehrschüsse (dafür nehmen Sie c_trace). Zum Öffnen von Türen, dem Setzen von Schaltern, Ermitteln oder Alarmieren von Feinden, dem Anbringen von Explosionsschäden usw. ist sie jedoch sehr nützlich.

Geschwindigkeit:

Langsam

Beispiel:

function operate() // scanne in der Nähe von Türen oder Schaltern, um sie zu betätigen
{
 	c_scan(camera.x,camera.pan,vector(120,0,200),SCAN_ENTS | SCAN_LIMIT);
}
...
on_space = operate;

Seiehe auch:

c_trace, path_scan, EVENT_DETECT, EVENT_SCAN

► Aktuelle Version Online