🛠️Module Utils (Client / Shared)

Le module Eko.Utils regroupe des fonctions utilitaires génériques utilisées par l’ensemble du framework. Il est composé de sous-modules spécialisés (Math, Table, String, Streaming, Sprites) et d’outil

---

📦 API globale

Eko.Utils:Draw3DText(coords, text, size?, distance, linebreak?)

Affiche du texte en 3D dans le monde.

• Paramètres

  • coords (vector3): Position.

  • text (string): Contenu.

  • size (number, optionnel): Taille du texte.

  • distance (number): Distance maximale d’affichage.

  • linebreak (boolean, optionnel): Autoriser les retours à la ligne.

---

Eko.Utils:Draw2DText(screenX, screenY, text, size, linebreak?)

Affiche du texte en 2D à l’écran.

---

Eko.Utils:KeyRegister(control, controlName, description, callback)

Enregistre un raccourci clavier.

• Paramètres

  • control (string): Nom du contrôle (ex.: "INPUT_CONTEXT").

  • controlName (string): Libellé.

  • description (string): Description.

  • callback (function): Fonction appelée lors de l’appui.

---

Eko.Utils:KeyboardInput(textEntry, maxLength, text)

Affiche une saisie clavier bloquante.

• Retour

  • string?: Texte saisi ou nil.

---

Eko.Utils:PaymentPopup(price, onSuccess, onFail, reason)

Affiche un popup de paiement.

• Paramètres

  • price (integer): Montant.

  • onSuccess (function): Callback en cas de validation.

  • onFail (function): Callback en cas d’échec.

  • reason (any): Informations complémentaires.

---

Eko.Utils:HexToRGB(hex)

Convertit une couleur hexadécimale en RGB.

• Retour

  • table: { r, g, b }

---

Eko.Utils:try(fn, ...)

Exécute une fonction en capturant les erreurs.

• Retour

  • boolean: Succès.

  • ...: Valeur(s) retournée(s) par la fonction.

---

Eko.Utils:DisableControlsForUI(keepCamera?)

Désactive les contrôles joueur pour l’UI.

---

Eko.Utils:GetControlHash(command)

Récupère le hash d’un contrôle GTA.

• Retour

  • number: Hash unique.

---

Eko.Utils:ValidateDeletion(cb)

Affiche une confirmation de suppression.

• Paramètres

  • cb (function): Fonction appelée si validé.

---

🧮 Sous-module : Utils.Math

• RotationToDirection(rotation) : Transforme une rotation en direction (vector3).

• Clamp(value, min, max) : Limite une valeur.

• Distance(v1, v2) : Distance entre deux vecteurs.

• RotateVector(vector, angleDegrees) : Tourne un vecteur.

• Dot(v1, v2) : Produit scalaire.

---

🗂️ Sous-module : Utils.Table

• compare(a, b) : Compare deux tables.

• compareMetadatas(a, b) : Compare deux tables de métadonnées.

• count(tbl) : Nombre d’éléments.

• map(tbl, cb) : Transforme chaque élément.

• PairsByKeys(t, f) : Trie les paires par clé.

• find(table, cb) : Trouve un élément.

• has(table, value, key?) : Contient une valeur.

• index(table, value) : Index d’un élément.

• diff(t1, t2) : Différence entre deux tables.

• IsEmpty(tbl) : Vérifie si vide.

---

📝 Sous-module : Utils.String

• split(str, sep) : Divise une chaîne.

---

📦 Sous-module : Utils.Streaming

• RequestAnimDict(animDict, timeout?)

• RequestAnimSet(animSet, timeout?)

• RequestModel(model, timeout?)

• RequestStreamedTextureDict(textureDict, timeout?)

• RequestNamedPtfxAsset(fxName, timeout?)

• LoadCollisionsAroundEntity(entity)

Chaque méthode télécharge la ressource et retourne un identifiant.

---

🖼️ Sous-module : Utils.Sprites

• Scale(ratio, dist, max) : Ajuste la taille selon la distance.

• Draw(textureDict, textureName, width, height, coords, maxDist)

• DrawNoColor(textureDict, textureName, width, height, coords, maxDist)

• DrawNoScale(textureDict, textureName, width, height, coords, maxDist)

• DrawCrosshair() : Affiche un réticule.

---

🛠️ Exemple d’utilisation

-- Diviser une chaîne
local parts = Eko.Utils.String.split("a,b,c", ",")

-- Calculer une distance
local dist = Eko.Utils.Math.Distance(vector3(0,0,0), vector3(5,0,0))
print("Distance:", dist)

-- Copier et transformer une table
local t = Eko.Utils.Table.map({1,2,3}, function(v) return v*2 end)

-- Charger un modèle
Eko.Utils.Streaming.RequestModel("prop_box_wood01a")

-- Dessiner un sprite
Eko.Utils.Sprites.Draw("commonmenu", "shop_box_tick", 0.02, 0.02, vector3(0,0,72), 10.0)

-- Afficher un texte 3D
Eko.Utils.Draw3DText(vector3(0,0,72), "Hello World", 0.4, 15.0)

-- Saisie clavier
local input = Eko.Utils.KeyboardInput("Entrez un code", 10, "")
if input then
    print("Saisi:", input)
end

---

⚠️ Notes

• Ces fonctions sont disponibles côté client et côté shared, sauf les méthodes d’affichage qui sont client uniquement.

• Les modules Streaming et Sprites nécessitent un environnement GTA actif.

• try() permet de capturer les erreurs sans interrompre l’exécution.