tw.entity

Cote : Client + Server

Creation, suppression et animations de fondu d'entites. Nettoyage automatique a l'arret de la ressource.

Fonctions Client

tw.entity.create(model, coords, heading?, networked?, fadeDuration?)

Cree une entite (ped, objet ou vehicule) a la position donnee.

Supporte deux signatures d'appel :

• create(model, vec3, heading?, networked?, fadeDuration?)
• create(model, vec4, networked?, fadeDuration?) — le heading est pris depuis coords.w

Parametre	Type	Par defaut	Description
model	string	—	Nom du modele
coords	vector3 ou vector4	—	Position dans le monde
heading	number?	0	Angle de direction (uniquement avec vec3)
networked	boolean?	false	Si l'entite est en reseau
fadeDuration	integer?	0	Duree du fondu d'apparition en ms (0 = instantane)

Retour : integer (handle de l'entite), 0 en cas d'echec (timeout de chargement du modele de 10s)

---

tw.entity.delete(entity)

Supprime une entite si elle existe.

Parametre	Type	Description
entity	integer	Handle de l'entite

---

tw.entity.fadeAndDelete(entity, duration?)

Effectue un fondu de disparition sur l'entite puis la supprime. S'execute dans un thread separe donc ne bloque pas.

Parametre	Type	Par defaut	Description
entity	integer	—	Handle de l'entite
duration	integer?	1000	Duree du fondu de disparition en ms

---

tw.entity.fadeIn(entity, duration?)

Affiche progressivement une entite (alpha de 0 a 255). Gere les wagons et les attelages de chevaux.

Parametre	Type	Par defaut	Description
entity	integer	—	Handle de l'entite
duration	integer?	1000	Duree du fondu d'apparition en ms

---

tw.entity.fadeOut(entity, duration?)

Masque progressivement une entite (alpha de 255 a 0).

Parametre	Type	Par defaut	Description
entity	integer	—	Handle de l'entite
duration	integer?	1000	Duree du fondu de disparition en ms

---

tw.entity.requestControl(entity)

Demande le controle reseau d'une entite. Bloque jusqu'a l'obtention du controle.

Parametre	Type	Description
entity	integer	Handle de l'entite

Fonctions Server

tw.entity.delete(entity)

Supprime une entite si elle existe (cote serveur).

Parametre	Type	Description
entity	integer	Handle de l'entite

Exemples

Creer un ped avec fondu d'apparition

local ped = tw.entity.create("a_m_m_rancher_01", vec3(-301.62, 783.04, 117.75), 180.0, false, 1000)

Creer avec vec4 (heading depuis le composant w)

local ped = tw.entity.create("a_m_m_rancher_01", vec4(-301.62, 783.04, 117.75, 180.0), false, 1000)

Supprimer avec fondu de disparition

tw.entity.fadeAndDelete(ped, 500)

Controle manuel du fondu

-- Masquer une entite progressivement
tw.entity.fadeOut(ped, 2000)

-- La reafficher
tw.entity.fadeIn(ped, 2000)

Notes

• Toutes les entites creees sont suivies et automatiquement supprimees lorsque la ressource s'arrete.
• Le chargement du modele a un timeout de 10 secondes. Si le modele echoue a se charger, la fonction retourne 0.
• fadeAndDelete s'execute de maniere asynchrone dans son propre thread, donc votre code continue immediatement apres l'appel.
• fadeIn et fadeOut gerent automatiquement les wagons et leurs attelages de chevaux.