From 4f32e5dbf0a90cb7bd35a29f6a65719fd5d62492 Mon Sep 17 00:00:00 2001
From: ook_3d <47336113+ook3D@users.noreply.github.com>
Date: Fri, 8 Mar 2024 07:26:10 -0500
Subject: [PATCH] Update AddDecal.md (#1047)

* Update AddDecal.md

add descriptions for each parameter and update the unknown ones.

* Update AddDecal.md

Add return value and remove text from inside the enum's fenced code block.

* Update AddDecal.md

Almost forgot to reference the enum.

---------

Co-authored-by: ammonia-cfx <38232208+4mmonium@users.noreply.github.com>
---
 GRAPHICS/AddDecal.md | 48 +++++++++++++++++++++++---------------------
 1 file changed, 25 insertions(+), 23 deletions(-)

diff --git a/GRAPHICS/AddDecal.md b/GRAPHICS/AddDecal.md
index 6887106cc..2fe17c663 100644
--- a/GRAPHICS/AddDecal.md
+++ b/GRAPHICS/AddDecal.md
@@ -5,11 +5,12 @@ ns: GRAPHICS
 
 ```c
 // 0xB302244A1839BDAD 0xEAD0C412
-int ADD_DECAL(int decalType, float posX, float posY, float posZ, float p4, float p5, float p6, float p7, float p8, float p9, float width, float height, float rCoef, float gCoef, float bCoef, float opacity, float timeout, BOOL p17, BOOL p18, BOOL p19);
+int ADD_DECAL(int decalType, float posX, float posY, float posZ, float dirX, float dirY, float dirZ, float sideX, float sideY, float sideZ, float width, float height, float rCoef, float gCoef, float bCoef, float opacity, float timeout, BOOL isLongRange, BOOL isDynamic, BOOL useComplexColn);
 ```
 
-```
-decal types:  
+Places a decal into the world
+
+```cs
 public enum DecalTypes  
 {  
     splatters_blood = 1010,  
@@ -68,25 +69,26 @@ public enum DecalTypes
 ```
 
 ## Parameters
-* **decalType**: 
-* **posX**: 
-* **posY**: 
-* **posZ**: 
-* **p4**: 
-* **p5**: 
-* **p6**: 
-* **p7**: 
-* **p8**: 
-* **p9**: 
-* **width**: 
-* **height**: 
-* **rCoef**: 
-* **gCoef**: 
-* **bCoef**: 
-* **opacity**: 
-* **timeout**: 
-* **p17**: 
-* **p18**: 
-* **p19**: 
+* **decalType**: which type of decal to place, based on the ID, see `DecalTypes` enum.
+* **posX**: X position coordinate.
+* **posY**: Y position coordinate.
+* **posZ**: Z position coordinate.
+* **dirX**: X Orientation.
+* **dirY**: Y Orientation.
+* **dirZ**: Z Orientation.
+* **sideX**: Usually set to 0.
+* **sideY**: Usually set to 1.
+* **sideZ**: Usually set to 0.
+* **width**: Width of the decal.
+* **height**: Height of the decal.
+* **rCoef**: Red Color.
+* **gCoef**: Green Color.
+* **bCoef**: Blue Color.
+* **opacity**: Alpha Color.
+* **timeout**: The lifetime of the decal.
+* **isLongRange**: toggle further LOD draw distance.
+* **isDynamic**: toggle dynamics.
+* **useComplexColn**: use complex coloring.
 
 ## Return value
+An integer value representing the added decal index, will return `0` if the decal cannot be added.