pXent_settype

pXent_settype (ENTITY* entity, var type, var hull )

Registriert bzw. löscht eine Entity aus dem Physiksystem. Sobald sie registriert ist, wird die Entity vom Physiksystem kontrolliert und ein "PhysX Actor" wird erstellt (die Entity-Gruppen-ID wird automatisch auf 1 gesetzt). Nach dem Löschen der Registrierung wird der Actor gelöscht und die Entity nicht mehr von der Physik kontrolliert.

Parameter:

entity	Entity-Pointer, der registriert bzw. gelöscht werden soll, oder NULL wenn das Level registriert wird.
type	PH_STATIC = registriert die Entiy als statisches Hindernis. PH_RIGID = registriert die Entity als dynamischen, starren Körper, der sich bewegen kann (nur Modell-Entities). PH_CHAR = registriert die Entity als einen Charaktersteuerer (nur Modell-Entities). 0 = löscht die Registrierung der Entity aus dem Physiksystem.unregister the entity from the physics ystem.
hull	PH_BOX - Rechteckige, als Box geformte Hülle. PH_SPHERE - Runde Hülle. PH_CAPSULE - Zylindrische Kollisionshülle mit einer Halbkugel oben und unten. PH_POLY - Polygonale Hülle, nur für statische (PH_STATIC) Actors. PH_CONVEX - Einfache polygonale Hülle für dynamische Actors - maximal 256 Polygone. PH_TERRAIN - Höhenmap; PH_POLY - funktioniert oftmals besser für Terrain. PH_PLANE - Grundebene bei der Position z=0. Add PH_MODIFIED zum Wieder-Registrieren einer geänderten PH_POLY- oder PH_CONVEX -Hülle.

Rückgabewerte:

Bei Erfolg, gegenwärtige Anzahl von PhysX-Actors, ansonsten 0.

Bemerkungen:

Diese Funktion muß nach dem Einstellen von Position und Skalierung des Objektes und vor dem Ausführen irgendwelcher anderer pXent_-Funktionen aufgerufen werden.
Beim ersten Mal wird eine bestimmte Entity registirert. Diese Anweisung ist langsam, wenn ein Kollisions-Mesh erstellt werden muß.
Bervor eine Entity entfernt wird oder das Level gewechselt wird, muß die Entity aus der Registrierung gelöscht werden. Normalerweise wird die von physX_open automatisch erledigt.
Während Sie weiterhin Position und Winkel einer registrierten Entity lesen können, können Sie aber deren Position (x,y,z), Ausrichtung (pan, tilt, roll) oder Skalierung nicht mehr direkt beeinflussen. Verwenden Sie stattdessen pXent_addforce oder Ähnliches, um Kräfte auf die Entity wirken zu lassen. Müssen Sie Position oder Ausrichtung der Entity direkt verändern, läßt sich die Entity mithilfe von pXent_enable deaktivieren.
Die Kollisionshülle benutzt die tatsächliche Größe der Entity und nimmt keine Rücksicht auf min_x / max_x. Um eine andere Hüllengröße zu bekommen, setzen Sie den scale_x-vektor der Entity vor dem Registrieren auf den gewünschten Skalierungsfaktor und setzen ihn dann danach wieder zurück.
Verwenden Sie keine PH_POLY-Hüllen für dynamische Actors. Zum Erstellen dynamischer Actors mit komplexen Formen benutzen Sie entweder PH_CONVEX oder Sie rufen pXent_addshape auf.
Benutzen Sie pXent_settype nicht für Räder - Räder erstellen Sie mit pXcon_add.
Sehr kleine dynamische Objekte, die sich pro Frame um mehr als die Hälfte ihres Durchmessers bewegen können brauchen CCD-Kollisionserkennung.
Wenn Sie PH_CHAR verwenden, machen sie hinter pXent_settype eine wait(1)-Pause ehe Sie die Funktion pXent_movechar starten. PH_CHAR funktioniert nur mit einer PH_BOX- oder PH_CAPSULE-Hülle (alle anderen Hüllen setzen PH_CAPSULE).
Der NxActor-Pointer des Physik-Actors wird in den body-Parametern der Entity gespeichert.

Geschwindigkeit:

Langsam

Beispiel 1:

ENTITY* myCrate;
// ...
// on startup
myCrate = ent_create( "crate.mdl", nullvector, any_function );
pXent_settype( myCrate, PH_RIGID, PH_BOX ); 
pXent_settype( myCrate, 0, 0 );
// ...
// during gameplay let's have fun with a crate:
var position;
pXent_settype( myCrate, PH_RIGID, PH_BOX );
position= myCrate.x; // this will give you an approximate position
//myCrate.x = position + 10; // this won't work!
pXent_settype( myCrate, 0, 0 );
myCrate.x = position + 10; // unregistered - now we can change the position

pXent_settype( myCrate, PH_RIGID, PH_BOX ); // restart from new position

Beispiel 2:

function f_ball()
{
  VECTOR vKick;
  vec_set(vKick,vector(300,0,100));
  pXent_settype(my, PH_RIGID, 1);
  pXent_setfriction(my, 100);
  pXent_setelasticity(my, 10);
  vec_rotate(vKick,camera.pan);
  pXent_addvelcentral(my, vKick);
}

function on_mouse_right_event()
{
  while (mouse_left) {wait (1);}
  ENTITY* ball = ent_create ("explosion.mdl", camera.x, f_ball);
  set(ball,PASSABLE);
}

Siehe auch:

pXent_addshape, pXent_removeshape