d_a_e_fz work, doxygen revamp (#2127)

* initial freezard actor struct + setActionMode OK

* daE_FZ_Draw

* setReflectAngle

* mBoundSoundset

* daE_FZ_Execute & execute

* demoDelete

* daE_FZ_Delete & _delete

* CreateHeap

* useHeapInit

* cc_set

* mtx_set

* action WIP

* way_gake_check

* executeRollMove

* executeMove

* draw WIP

* executeDamage

* checkpoint

* create

* checkpoint

* daE_FZ_c::executeWait

* checkpoint

* daE_FZ_c::damage_check almost done

* rm asm

* rm headers

* setup_profile WIP + doxygen update

* fix merge issues

* docs fix?

* fix2

* doxygen updates

* setup g_profile_E_FZ, profile setup script WIP

* update github actions

* update progress.md

include/JSystem/JParticle/JPABaseShape.h

@@ -1,12 +1,15 @@
 #ifndef JPABASESHAPE_H
 #define JPABASESHAPE_H
 
-#include "dolphin/gx/GXEnum.h"
 #include "dolphin/gx/GXStruct.h"
 
 class JPAEmitterWorkData;
 class JKRHeap;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPABaseShapeData {
     // Common header.
     /* 0x00 */ u8 mMagic[4];
@@ -36,6 +39,10 @@ struct JPABaseShapeData {
     /* 0x30 */ u8 mTexAnmRndmMask;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPABaseShape {
 public:
     /* 8027A6DC */ JPABaseShape(u8 const*, JKRHeap*);
@@ -125,6 +132,10 @@ public:
     /* 0x10 */ GXColor* mpEnvClrAnmTbl;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPAClrAnmKeyData {
     /* 0x0 */ s16 index;
     /* 0x2 */ GXColor color;

include/JSystem/JParticle/JPAChildShape.h

@@ -3,6 +3,10 @@
 
 #include "dolphin/gx/GXStruct.h"
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPAChildShapeData {
     // Common header.
     /* 0x00 */ u8 mMagic[4];
@@ -29,6 +33,10 @@ struct JPAChildShapeData {
     /* 0x46 */ s16 mRotSpeed;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAChildShape {
 public:
     /* 8027B038 */ JPAChildShape(u8 const*);

include/JSystem/JParticle/JPADrawInfo.h

@@ -3,6 +3,10 @@
 
 #include "dolphin/mtx.h"
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPADrawInfo {
 public:
     JPADrawInfo(Mtx param_0, f32 fovY, f32 aspect) {

include/JSystem/JParticle/JPADynamicsBlock.h

@@ -7,6 +7,10 @@
 
 class JPAEmitterWorkData;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPADynamicsBlockData {
     // Common header.
     /* 0x00 */ u8 mMagic[4];
@@ -50,6 +54,10 @@ enum {
     JPADynFlag_FollowEmtrChld = 0x10,
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPADynamicsBlock {
 public:
     /* 8027BB18 */ JPADynamicsBlock(u8 const*);

include/JSystem/JParticle/JPAEmitter.h

@@ -1,7 +1,6 @@
 #ifndef JPAEMITTER_H
 #define JPAEMITTER_H
 
-#include "dolphin/gx/GXEnum.h"
 #include "dolphin/gx/GXStruct.h"
 #include "JSystem/JParticle/JPAResource.h"
 #include "JSystem/JParticle/JPAList.h"
@@ -15,6 +14,10 @@ class JPABaseEmitter;
 class JPAEmitterManager;
 class JPAParticleCallBack;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPAEmitterWorkData {
     /* 0x00 */ JPABaseEmitter* mpEmtr;
     /* 0x04 */ JPAResource* mpRes;
@@ -58,6 +61,10 @@ struct JPAEmitterWorkData {
     /* 0x216 */ u8 mDrawCount;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAEmitterCallBack {
 public:
     /* 80050368 */ virtual void execute(JPABaseEmitter*);
@@ -78,6 +85,10 @@ enum {
     JPAEmtrStts_Immortal = 0x40,
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPABaseEmitter {
 public:
     /* 8027E5EC */ ~JPABaseEmitter();
@@ -105,6 +116,13 @@ public:
     void setDirectionalSpeed(f32 i_speed) { mDirSpeed = i_speed; }
     void setEmitterCallBackPtr(JPAEmitterCallBack* ptr) { mpEmtrCallBack = ptr; }
     void setGlobalRTMatrix(const Mtx m) { JPASetRMtxTVecfromMtx(m, mGlobalRot, &mGlobalTrs); }
+    void setGlobalSRTMatrix(const Mtx m) { 
+        JPASetRMtxSTVecfromMtx(m, mGlobalRot, &mGlobalScl, &mGlobalTrs);
+
+        // set is actually used here in debug
+        mGlobalPScl.x = mGlobalScl.x;
+        mGlobalPScl.y = mGlobalScl.y;
+    }
     void setGlobalTranslation(f32 x, f32 y, f32 z) { mGlobalTrs.set(x, y, z); }
     void setGlobalTranslation(const JGeometry::TVec3<f32>& trs) { mGlobalTrs.set(trs); }
     void getLocalTranslation(JGeometry::TVec3<f32>& vec) { vec.set(mLocalTrs); }
@@ -119,6 +137,9 @@ public:
     void setVolumeSize(u16 size) { mVolumeSize = size; }
     void setLifeTime(s16 lifetime) { mLifeTime = lifetime; }
 
+    void setGlobalParticleHeightScale(f32 height) {
+        mGlobalPScl.y = height;
+    }
     void setGlobalParticleScale(const JGeometry::TVec3<f32>& scale) {
         mGlobalPScl.set(scale.x, scale.y);
     }

include/JSystem/JParticle/JPAEmitterManager.h

@@ -15,6 +15,10 @@ class JPABaseParticle;
 class JKRHeap;
 struct JPAEmitterWorkData;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAEmitterManager {
 public:
     /* 8027DCA0 */ JPAEmitterManager(u32, u32, JKRHeap*, u8, u8);

include/JSystem/JParticle/JPAExTexShape.h

@@ -3,6 +3,10 @@
 
 #include "dolphin/types.h"
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPAExTexShapeData {
     // Common header.
     /* 0x00 */ u8 mMagic[4];
@@ -15,6 +19,10 @@ struct JPAExTexShapeData {
     /* 0x26 */ s8 mSecTexIdx;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAExTexShape {
 public:
     /* 8027B13C */ JPAExTexShape(u8 const*);

include/JSystem/JParticle/JPAExtraShape.h

@@ -3,6 +3,10 @@
 
 #include "dolphin/types.h"
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPAExtraShapeData {
     // Common header.
     /* 0x00 */ u8 mMagic[4];
@@ -33,6 +37,10 @@ struct JPAExtraShapeData {
     /* 0x5C */ f32 mRotateDirection;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAExtraShape {
 public:
     /* 8027AD88 */ JPAExtraShape(u8 const*);

include/JSystem/JParticle/JPAKeyBlock.h

@@ -3,6 +3,10 @@
 
 #include "dolphin/types.h"
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPAKeyBlock {
     /* 8027D730 */ JPAKeyBlock(u8 const*);
     /* 8027D740 */ void calc(f32);

include/JSystem/JParticle/JPAList.h

@@ -1,7 +1,10 @@
 #ifndef JPALIST_H
 #define JPALIST_H
 
-
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 template <class T>
 struct JPANode {
     JPANode() {
@@ -17,6 +20,10 @@ struct JPANode {
     T mData;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 template <class T>
 struct JPAList {
     JPANode<T>* mpFirst;

include/JSystem/JParticle/JPAParticle.h

@@ -2,7 +2,6 @@
 #define JPAPARTICLE_H
 
 #include "dolphin/gx/GXStruct.h"
-#include "dolphin/types.h"
 
 #include "JSystem/JGeometry.h"
 
@@ -17,6 +16,10 @@ class JPAParticleCallBack;
 class JPAResourceManager;
 struct JPAEmitterWorkData;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPABaseParticle {
 public:
     /* 8027EFEC */ void init_p(JPAEmitterWorkData*);
@@ -70,6 +73,10 @@ public:
     /* 0x96 */ u8 mPrmColorAlphaAnm;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAParticleCallBack {
 public:
     JPAParticleCallBack() {}

include/JSystem/JParticle/JPARandom.h

@@ -1,7 +1,10 @@
 #ifndef JPARANDOM_H
 #define JPARANDOM_H
 
-
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPARandom {
 public:
     JPARandom() { mSeed = 0; }

include/JSystem/JParticle/JPAResource.h

@@ -16,6 +16,10 @@ class JPADynamicsBlock;
 class JPAFieldBlock;
 class JPAKeyBlock;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAResource {
 public:
     /* 80274010 */ JPAResource();

include/JSystem/JParticle/JPAResourceLoader.h

@@ -1,5 +1,4 @@
 #ifndef JPARESOURCELOADER_H
 #define JPARESOURCELOADER_H
 
-
 #endif /* JPARESOURCELOADER_H */

include/JSystem/JParticle/JPAResourceManager.h

@@ -2,12 +2,15 @@
 #define JPARESOURCEMANAGER_H
 
 #include "JSystem/JParticle/JPATexture.h"
-#include "dolphin/types.h"
 
 class JKRHeap;
 class JPAResource;
 struct ResTIMG;
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPAResourceManager {
 public:
     /* 80273E10 */ JPAResourceManager(void const*, JKRHeap*);

include/JSystem/JParticle/JPATexture.h

@@ -2,8 +2,11 @@
 #define JPATEXTURE_H
 
 #include "JSystem/JUtility/JUTTexture.h"
-#include "dolphin/types.h"
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 struct JPATextureData {
     // Probably magic / size / flags up top here, but they're unused.
     /* 0x00 */ char field_0x00[0x0C];
@@ -11,6 +14,10 @@ struct JPATextureData {
     /* 0x20 */ ResTIMG mResTIMG;
 };
 
+/**
+ * @ingroup jsystem-jparticle
+ * 
+ */
 class JPATexture {
 public:
     JPATexture(u8 const*);