Skip to content

Update CMatrix class for SA #284

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Aldrin-John-Olaer-Manalansan wants to merge 12 commits into
base: master
Choose a base branch
from
Open

Update CMatrix class for SA #284

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
0e1661b
Update CMatrix
Aldrin-John-Olaer-Manalansan Dec 13, 2025
5b63247
Reverted member names into "at" and "up" to match universal naming ac…
Aldrin-John-Olaer-Manalansan Dec 13, 2025
50621d8
Local Variable naming updates for CMatrix
Aldrin-John-Olaer-Manalansan Dec 14, 2025
04930a0
Added default conversion flags
Aldrin-John-Olaer-Manalansan Dec 15, 2025
8040034
Update CMatrix:
Aldrin-John-Olaer-Manalansan Dec 22, 2025
76e11b6
Update PluginSA CMatrix
Aldrin-John-Olaer-Manalansan Dec 22, 2025
d017a51
Update CMatrix
Aldrin-John-Olaer-Manalansan Dec 22, 2025
8a7f80f
Update PluginSA CMatrix
Aldrin-John-Olaer-Manalansan Dec 22, 2025
b4ef64a
Added MultiplyTransposed3x3 function to PluginSA -> common
Aldrin-John-Olaer-Manalansan Dec 25, 2025
6af47b1
Revised euler angle conversion flags declaration at PluginSA -> CMatr…
Aldrin-John-Olaer-Manalansan Dec 25, 2025
6def66d
Major Update for PluginSA -> CMatrix
Aldrin-John-Olaer-Manalansan Dec 28, 2025
357556e
Conducted PluginSA's CMatrix Unit Test
Aldrin-John-Olaer-Manalansan Jan 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 56 additions & 16 deletions plugin_sa/game_sa/CMatrix.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,57 +73,77 @@ void CMatrix::SetScale(float scale)
((void (__thiscall *)(CMatrix *, float))0x59AED0)(this, scale);
}

void CMatrix::SetScale(CVector const &scale) {
SetScale(pos.x, pos.y, pos.z);
Copy link
Contributor

@MiranDMC MiranDMC Dec 13, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

?

Copy link
Author

@Aldrin-John-Olaer-Manalansan Aldrin-John-Olaer-Manalansan Dec 14, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

?

Addessed this incorrect passed parameter in 50621d8

}

// scale on three axes
void CMatrix::SetScale(float x, float y, float z)
{
((void (__thiscall *)(CMatrix *, float, float, float))0x59AF00)(this, x, y, z);
}

void CMatrix::SetTranslateOnly(CVector const &pos) {
SetTranslateOnly(pos.x, pos.y, pos.z);
}

void CMatrix::SetTranslateOnly(float x, float y, float z)
{
((void (__thiscall *)(CMatrix *, float, float, float))0x59AF80)(this, x, y, z);
}

void CMatrix::SetTranslate(CVector const &pos) {
SetTranslate(pos.x, pos.y, pos.z);
}

// like previous + reset orientation
void CMatrix::SetTranslate(float x, float y, float z)
{
((void (__thiscall *)(CMatrix *, float, float, float))0x59AF40)(this, x, y, z);
}

void CMatrix::SetRotateXOnly(float angle)
void CMatrix::SetRotateXOnly(float pitch)
{
((void (__thiscall *)(CMatrix *, float))0x59AFA0)(this, angle);
((void (__thiscall *)(CMatrix *, float))0x59AFA0)(this, pitch);
}

void CMatrix::SetRotateYOnly(float angle)
void CMatrix::SetRotateYOnly(float roll)
{
((void (__thiscall *)(CMatrix *, float))0x59AFE0)(this, angle);
((void (__thiscall *)(CMatrix *, float))0x59AFE0)(this, roll);
}

void CMatrix::SetRotateZOnly(float angle)
void CMatrix::SetRotateZOnly(float yaw)
{
((void (__thiscall *)(CMatrix *, float))0x59B020)(this, angle);
((void (__thiscall *)(CMatrix *, float))0x59B020)(this, yaw);
}

void CMatrix::SetRotateX(float angle)
void CMatrix::SetRotateX(float pitch)
{
((void (__thiscall *)(CMatrix *, float))0x59B060)(this, angle);
((void (__thiscall *)(CMatrix *, float))0x59B060)(this, pitch);
}

void CMatrix::SetRotateY(float angle)
void CMatrix::SetRotateY(float roll)
{
((void (__thiscall *)(CMatrix *, float))0x59B0A0)(this, angle);
((void (__thiscall *)(CMatrix *, float))0x59B0A0)(this, roll);
}

void CMatrix::SetRotateZ(float angle)
void CMatrix::SetRotateZ(float yaw)
{
((void (__thiscall *)(CMatrix *, float))0x59B0E0)(this, angle);
((void (__thiscall *)(CMatrix *, float))0x59B0E0)(this, yaw);
}

void CMatrix::SetRotate(CVector const &rotation) {
SetRotate(rotation.x, rotation.y, rotation.z);
}

// set rotate on 3 axes
void CMatrix::SetRotate(float x, float y, float z)
void CMatrix::SetRotate(float roll, float pitch, float yaw)
{
((void (__thiscall *)(CMatrix *, float, float, float))0x59B120)(this, x, y, z);
((void (__thiscall *)(CMatrix *, float, float, float))0x59B120)(this, roll, pitch, yaw);
}

void CMatrix::Translate(CVector const &offset) {
pos += offset;
}

void CMatrix::Translate(float x, float y, float z)
Expand All @@ -148,10 +168,14 @@ void CMatrix::RotateZ(float angle)
((void (__thiscall *)(CMatrix *, float))0x59B390)(this, angle);
}

void CMatrix::Rotate(CVector const &rotation) {
Rotate(rotation.x, rotation.y, rotation.z);
}

// rotate on 3 axes
void CMatrix::Rotate(float x, float y, float z)
void CMatrix::Rotate(float roll, float pitch, float yaw)
{
((void (__thiscall *)(CMatrix *, float, float, float))0x59B460)(this, x, y, z);
((void (__thiscall *)(CMatrix *, float, float, float))0x59B460)(this, roll, pitch, yaw);
}

void CMatrix::Reorthogonalise()
Expand All @@ -178,6 +202,22 @@ void CMatrix::Scale(float x, float y, float z) {
plugin::CallMethod<0x459350, CMatrix *, float, float, float>(this, x, y, z);
}

CVector CMatrix::ConvertToEulerAngles(CMatrix::t_EulerAngleConversionFlags flags) {
CVector toRotation;
((void(__thiscall*)(::CMatrix*, float*, float*, float*, t_EulerAngleConversionFlags))0x59A840)
(this, &toRotation.x, &toRotation.y, &toRotation.z, flags);
return toRotation;
}

void CMatrix::ConvertFromEulerAngles(float x, float y, float z, CMatrix::t_EulerAngleConversionFlags flags) {
((void(__thiscall*)(::CMatrix*, float, float, float, t_EulerAngleConversionFlags))0x59AA40)
(this, x, y, z, flags);
}

void CMatrix::ConvertFromEulerAngles(CVector fromRotation, CMatrix::t_EulerAngleConversionFlags flags) {
ConvertFromEulerAngles(fromRotation.x, fromRotation.y, fromRotation.z, flags);
}

void CMatrix::operator=(CMatrix const& rvalue)
{
((void (__thiscall *)(CMatrix *, CMatrix const&))0x59BBC0)(this, rvalue);
Expand Down
52 changes: 38 additions & 14 deletions plugin_sa/game_sa/CMatrix.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,27 @@

class CMatrix {
public:
enum class e_EulerAngleType : uint8_t {
TaitBryan, // three distinct axes (yaw/pitch/roll style)
ProperEuler // repeated axis (e.g. ZXZ, XYX)
};

struct t_EulerAngleConversionFlags {
uint8_t swapXAndZ: 1; // if set, treats the X axis as Yaw, Z-axis at Pitch
uint8_t angleType: 1; // see e_EulerAngleType
uint8_t isFlipped: 1; // if set negate all three angles
uint8_t primaryAxisIndex: 2; // index (0..3) into byte_866D9C[] that selects primary axis/order
// NOTE: the game always uses 0x15 as the convertion flags
};

VALIDATE_SIZE(t_EulerAngleConversionFlags, 1);

// RwV3d-like:
CVector right;
CVector right; // x-axis
unsigned int flags;
CVector up;
CVector up; // y-axis, the member name is supposed to be "forward"
unsigned int pad1;
CVector at;
CVector at; // z-axis, the member name is supposed to be "up"
unsigned int pad2;
CVector pos;
unsigned int pad3;
Expand All @@ -43,20 +58,29 @@ class CMatrix {
void SetUnity();
void ResetOrientation();
void SetScale(float scale); // set (scaled)
void SetScale(CVector const &scale);
void SetScale(float x, float y, float z); // set (scaled)
void SetTranslateOnly(CVector const &pos);
void SetTranslateOnly(float x, float y, float z);
void SetTranslate(CVector const &pos);
void SetTranslate(float x, float y, float z); // like previous + reset orientation
void SetRotateXOnly(float angle);
void SetRotateYOnly(float angle);
void SetRotateZOnly(float angle);
void SetRotateX(float angle);
void SetRotateY(float angle);
void SetRotateZ(float angle);
void SetRotate(float x, float y, float z); // set rotate on 3 axes
void RotateX(float angle);
void RotateY(float angle);
void RotateZ(float angle);
void Rotate(float x, float y, float z); // rotate on 3 axes
void SetRotateXOnly(float pitch);
void SetRotateYOnly(float roll);
void SetRotateZOnly(float yaw);
void SetRotateX(float pitch);
void SetRotateY(float roll);
void SetRotateZ(float yaw);
void SetRotate(CVector const &rotation);
void SetRotate(float pitch, float roll, float yaw); // sets the rotation on 3 axes + resets the position to origin(0, 0, 0)
void RotateX(float pitch);
void RotateY(float roll);
void RotateZ(float yaw);
void Rotate(CVector const &rotation);
void Rotate(float pitch, float roll, float yaw); // rotate on 3 axes
CVector ConvertToEulerAngles(t_EulerAngleConversionFlags flags);
void ConvertFromEulerAngles(CVector rotation, t_EulerAngleConversionFlags flags);
void ConvertFromEulerAngles(float x, float y, float z, t_EulerAngleConversionFlags flags);
void Translate(CVector const &offset);
void Translate(float x, float y, float z); // move the position
void Reorthogonalise();
void CopyToRwMatrix(RwMatrix *matrix); // similar to UpdateRW(RwMatrixTag *)
Expand Down