refactor(ww3d2): Introduce IRenderBackend interface

Core/Libraries/Source/WWVegas/WW3D2/Backend/DX8Backend.cpp

@@ -0,0 +1,96 @@
+/*
+**	Command & Conquer Generals Zero Hour(tm)
+**	Copyright 2026 TheSuperHackers
+**
+**	This program is free software: you can redistribute it and/or modify
+**	it under the terms of the GNU General Public License as published by
+**	the Free Software Foundation, either version 3 of the License, or
+**	(at your option) any later version.
+**
+**	This program is distributed in the hope that it will be useful,
+**	but WITHOUT ANY WARRANTY; without even the implied warranty of
+**	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+**	GNU General Public License for more details.
+**
+**	You should have received a copy of the GNU General Public License
+**	along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+// TheSuperHackers @refactor bobtista 10/04/2026 DX8Backend forwarding adapter.
+// Every method in this file is a one-line trampoline to the existing
+// DX8Wrapper static API. Keep it that way — if behavior needs to change it
+// should change in DX8Wrapper, not here.
+
+#include "DX8Backend.h"
+#include "RenderBackend.h"
+
+#include "WW3D2/dx8wrapper.h"
+#include "WWMath/vector3.h"
+#include "WW3D2/lightenvironment.h"
+
+DX8Backend::DX8Backend()
+{
+}
+
+DX8Backend::~DX8Backend()
+{
+}
+
+IRenderBackend *Create_Render_Backend()
+{
+    return new DX8Backend();
+}
+
+void DX8Backend::Set_Gamma(float gamma, float bright, float contrast, bool calibrate, bool uselimit)
+{
+    DX8Wrapper::Set_Gamma(gamma, bright, contrast, calibrate, uselimit);
+}
+
+void DX8Backend::Begin_Scene()
+{
+    DX8Wrapper::Begin_Scene();
+}
+
+void DX8Backend::End_Scene(bool flip_frame)
+{
+    DX8Wrapper::End_Scene(flip_frame);
+}
+
+void DX8Backend::Flip_To_Primary()
+{
+    DX8Wrapper::Flip_To_Primary();
+}
+
+void DX8Backend::Clear(bool clear_color, bool clear_z_stencil,
+                       const Vector3 & color,
+                       float dest_alpha, float z, unsigned int stencil)
+{
+    DX8Wrapper::Clear(clear_color, clear_z_stencil, color, dest_alpha, z, stencil);
+}
+
+void DX8Backend::Set_Viewport(const RenderBackendViewport & viewport)
+{
+    D3DVIEWPORT8 vp;
+    vp.X      = viewport.x;
+    vp.Y      = viewport.y;
+    vp.Width  = viewport.width;
+    vp.Height = viewport.height;
+    vp.MinZ   = viewport.min_z;
+    vp.MaxZ   = viewport.max_z;
+    DX8Wrapper::Set_Viewport(&vp);
+}
+
+void DX8Backend::Invalidate_Cached_Render_States()
+{
+    DX8Wrapper::Invalidate_Cached_Render_States();
+}
+
+void DX8Backend::Set_Ambient(const Vector3 & color)
+{
+    DX8Wrapper::Set_Ambient(color);
+}
+
+void DX8Backend::Set_Light_Environment(LightEnvironmentClass * light_env)
+{
+    DX8Wrapper::Set_Light_Environment(light_env);
+}

Core/Libraries/Source/WWVegas/WW3D2/Backend/DX8Backend.h

@@ -0,0 +1,46 @@
+/*
+**	Command & Conquer Generals Zero Hour(tm)
+**	Copyright 2026 TheSuperHackers
+**
+**	This program is free software: you can redistribute it and/or modify
+**	it under the terms of the GNU General Public License as published by
+**	the Free Software Foundation, either version 3 of the License, or
+**	(at your option) any later version.
+**
+**	This program is distributed in the hope that it will be useful,
+**	but WITHOUT ANY WARRANTY; without even the implied warranty of
+**	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+**	GNU General Public License for more details.
+**
+**	You should have received a copy of the GNU General Public License
+**	along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+// TheSuperHackers @refactor bobtista 10/04/2026 DX8Backend is the reference
+// implementation of IRenderBackend that forwards every virtual method to the
+// existing DX8Wrapper static facade. Pure adaptation, no new rendering logic.
+
+#pragma once
+
+#include "WW3D2/IRenderBackend.h"
+
+class DX8Backend : public IRenderBackend
+{
+public:
+    DX8Backend();
+    virtual ~DX8Backend() override;
+
+    virtual void Set_Gamma(float gamma, float bright, float contrast, bool calibrate, bool uselimit) override;
+
+    virtual void Begin_Scene() override;
+    virtual void End_Scene(bool flip_frame) override;
+    virtual void Flip_To_Primary() override;
+    virtual void Clear(bool clear_color, bool clear_z_stencil,
+                       const Vector3 & color,
+                       float dest_alpha, float z, unsigned int stencil) override;
+    virtual void Set_Viewport(const RenderBackendViewport & viewport) override;
+    virtual void Invalidate_Cached_Render_States() override;
+
+    virtual void Set_Ambient(const Vector3 & color) override;
+    virtual void Set_Light_Environment(LightEnvironmentClass * light_env) override;
+};

Core/Libraries/Source/WWVegas/WW3D2/Backend/RenderBackend.h

@@ -0,0 +1,30 @@
+/*
+**	Command & Conquer Generals Zero Hour(tm)
+**	Copyright 2026 TheSuperHackers
+**
+**	This program is free software: you can redistribute it and/or modify
+**	it under the terms of the GNU General Public License as published by
+**	the Free Software Foundation, either version 3 of the License, or
+**	(at your option) any later version.
+**
+**	This program is distributed in the hope that it will be useful,
+**	but WITHOUT ANY WARRANTY; without even the implied warranty of
+**	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+**	GNU General Public License for more details.
+**
+**	You should have received a copy of the GNU General Public License
+**	along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+// TheSuperHackers @refactor bobtista 10/04/2026 Backend selection seam. The
+// build links exactly one backend implementation, and that implementation
+// defines Create_Render_Backend. WW3D owns the instance it returns; use
+// WW3D::Get_Render_Backend() to reach the active backend.
+
+#pragma once
+
+class IRenderBackend;
+
+// Construct the backend selected by the build. Exactly one backend
+// implementation must define this function.
+IRenderBackend *Create_Render_Backend();

Core/Libraries/Source/WWVegas/WW3D2/CMakeLists.txt

@@ -13,6 +13,9 @@ set(WW3D2_SRC
     #assetmgr.h
     assetstatus.cpp
     assetstatus.h
+    Backend/DX8Backend.cpp
+    Backend/DX8Backend.h
+    Backend/RenderBackend.h
     bitmaphandler.cpp
     bitmaphandler.h
     bmp2d.cpp
@@ -90,6 +93,7 @@ set(WW3D2_SRC
     htree.h
     #htreemgr.cpp
     #htreemgr.h
+    IRenderBackend.h
     intersec.cpp
     intersec.h
     intersec.inl

Core/Libraries/Source/WWVegas/WW3D2/IRenderBackend.h

@@ -0,0 +1,68 @@
+/*
+**	Command & Conquer Generals Zero Hour(tm)
+**	Copyright 2026 TheSuperHackers
+**
+**	This program is free software: you can redistribute it and/or modify
+**	it under the terms of the GNU General Public License as published by
+**	the Free Software Foundation, either version 3 of the License, or
+**	(at your option) any later version.
+**
+**	This program is distributed in the hope that it will be useful,
+**	but WITHOUT ANY WARRANTY; without even the implied warranty of
+**	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+**	GNU General Public License for more details.
+**
+**	You should have received a copy of the GNU General Public License
+**	along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+// TheSuperHackers @refactor bobtista 10/04/2026 Abstract W3D-facing rendering
+// interface so WW3D2 rendering can be re-targeted to other backends while the
+// existing DX8 path stays as the reference implementation.
+
+#pragma once
+
+// Forward declarations keep this header includable without pulling in the full
+// WW3D2 header graph. All W3D types below are passed by pointer or reference.
+
+class LightEnvironmentClass;
+class Vector3;
+
+struct RenderBackendViewport
+{
+    unsigned int x;
+    unsigned int y;
+    unsigned int width;
+    unsigned int height;
+    float min_z;
+    float max_z;
+};
+
+// A method appears here once a caller routes through it, not in anticipation of
+// one. The set below is what current callers route through; the rest of the
+// DX8Wrapper API stays reachable through DX8Wrapper's static methods until a
+// caller migrates, at which point the method it needs moves here.
+//
+// Method names intentionally match the existing DX8Wrapper names so migrating a
+// caller is a mechanical DX8Wrapper::X(...) -> Get_Render_Backend()->X(...)
+// rewrite.
+
+class IRenderBackend
+{
+public:
+    virtual ~IRenderBackend() {}
+
+    virtual void Set_Gamma(float gamma, float bright, float contrast, bool calibrate, bool uselimit) = 0;
+
+    virtual void Begin_Scene() = 0;
+    virtual void End_Scene(bool flip_frame) = 0;
+    virtual void Flip_To_Primary() = 0;
+    virtual void Clear(bool clear_color, bool clear_z_stencil,
+                       const Vector3 & color,
+                       float dest_alpha, float z, unsigned int stencil) = 0;
+    virtual void Set_Viewport(const RenderBackendViewport & viewport) = 0;
+    virtual void Invalidate_Cached_Render_States() = 0;
+
+    virtual void Set_Ambient(const Vector3 & color) = 0;
+    virtual void Set_Light_Environment(LightEnvironmentClass * light_env) = 0;
+};

Core/Libraries/Source/WWVegas/WW3D2/dx8wrapper.cpp

@@ -56,6 +56,7 @@
 #include "dx8vertexbuffer.h"
 #include "dx8indexbuffer.h"
 #include "dx8renderer.h"
+#include "IRenderBackend.h"
 #include "ww3d.h"
 #include "camera.h"
 #include "WWLib/wwstring.h"