From 1512ec731458d782384f2dc9cec6460aa5540b11 Mon Sep 17 00:00:00 2001
From: Fexty12573 <bogofogo1@gmail.com>
Date: Tue, 30 Jul 2024 11:26:18 +0200
Subject: [PATCH] partially document spl_random

---
 lib/spl/include/spl.h        | 10 +++-------
 lib/spl/include/spl_random.h |  9 +++++++++
 lib/spl/src/unk_020A2354.c   |  2 +-
 3 files changed, 13 insertions(+), 8 deletions(-)
 create mode 100644 lib/spl/include/spl_random.h

diff --git a/lib/spl/include/spl.h b/lib/spl/include/spl.h
index c88a3d1d60..f9aff44abb 100644
--- a/lib/spl/include/spl.h
+++ b/lib/spl/include/spl.h
@@ -7,6 +7,7 @@
 #include "struct_defs/struct_020147B8.h"
 
 #include "spl_list.h"
+#include "spl_random.h"
 
 #define GX_RGB_R(RGB) (((RGB) >> GX_RGB_R_SHIFT) & 31)
 #define GX_RGB_G(RGB) (((RGB) >> GX_RGB_G_SHIFT) & 31)
@@ -482,9 +483,6 @@ void sub_020A05BC(SPLParticle *ptcl, SPLEmitter *emtr, SPLList *list);
 void sub_020A1768(SPLEmitter *emtr);
 void sub_020A1608(VecFx32 *ptclPos, VecFx32 *pos, SPLEmitter *emtr);
 
-void sub_020A2354(VecFx32 *vec);
-void sub_020A23B0(VecFx32 *vec);
-
 void sub_0209D998(SPLEmitter *emtr, UnkSPLStruct4 *res, const VecFx32 *param2);
 void sub_0209CF00(SPLManager *mgr);
 void sub_0209D150(SPLManager *mgr, SPLEmitter *emtr);
@@ -546,12 +544,10 @@ static inline void SPL_UnkInline5 (SPLEmitter * param0, const VecFx16 * param1)
     param0->unk_C0 = *param1;
 }
 
-extern u32 Unk_021C3A38;
-
 static inline u32 rng_next()
 {
-    Unk_021C3A38 = Unk_021C3A38 * 0x5eedf715 + 0x1b0cb173;
-    return Unk_021C3A38;
+    gSPLRandomState = gSPLRandomState * 0x5eedf715 + 0x1b0cb173;
+    return gSPLRandomState;
 }
 
 static inline u32 rng_next_u32(u32 shift)
diff --git a/lib/spl/include/spl_random.h b/lib/spl/include/spl_random.h
new file mode 100644
index 0000000000..c2da6d28e9
--- /dev/null
+++ b/lib/spl/include/spl_random.h
@@ -0,0 +1,9 @@
+#ifndef SPL_RANDOM_H
+#define SPL_RANDOM_H
+
+extern u32 gSPLRandomState;
+
+void sub_020A2354(VecFx32 *vec);
+void sub_020A23B0(VecFx32 *vec);
+
+#endif // SPL_RANDOM_H
diff --git a/lib/spl/src/unk_020A2354.c b/lib/spl/src/unk_020A2354.c
index f4fa695016..274a11fbc7 100644
--- a/lib/spl/src/unk_020A2354.c
+++ b/lib/spl/src/unk_020A2354.c
@@ -2,7 +2,7 @@
 
 #include <nitro/fx/fx.h>
 
-u32 Unk_021C3A38;
+u32 gSPLRandomState;
 
 void sub_020A23B0(VecFx32 *vec)
 {