From 6f36e0a2dd20720633dc74d44682e0223f4f3669 Mon Sep 17 00:00:00 2001
From: twinaphex <libretro@gmail.com>
Date: Sun, 26 Sep 2021 14:16:09 +0200
Subject: [PATCH] Rename GL driver files + add some comments to D3D drivers -
 gl_core becomes gl3, gl becomes gl2, etc

---
 Makefile.common                                  | 16 ++++++++--------
 gfx/common/{gl_core_common.h => gl3_common.h}    |  2 +-
 gfx/drivers/d3d10.c                              |  7 +++++++
 gfx/drivers/d3d11.c                              |  7 +++++++
 gfx/drivers/d3d12.c                              |  7 +++++++
 gfx/drivers/d3d8.c                               |  7 +++++++
 gfx/drivers/d3d9.c                               |  7 +++++++
 gfx/drivers/gl1.c                                | 10 +++++++---
 gfx/drivers/{gl.c => gl2.c}                      |  6 +++---
 gfx/drivers/{gl_core.c => gl3.c}                 |  6 +++---
 .../{gfx_display_gl.c => gfx_display_gl2.c}      |  0
 .../{gfx_display_gl_core.c => gfx_display_gl3.c} |  4 ++--
 .../{gl_raster_font.c => gl2_raster_font.c}      |  0
 .../{gl_core_raster_font.c => gl3_raster_font.c} |  3 +--
 .../{shader_gl_core.cpp => shader_gl3.cpp}       |  4 ++--
 .../{shader_gl_core.h => shader_gl3.h}           |  0
 griffin/griffin.c                                | 12 ++++++------
 17 files changed, 68 insertions(+), 30 deletions(-)
 rename gfx/common/{gl_core_common.h => gl3_common.h} (98%)
 rename gfx/drivers/{gl.c => gl2.c} (99%)
 rename gfx/drivers/{gl_core.c => gl3.c} (99%)
 rename gfx/drivers_display/{gfx_display_gl.c => gfx_display_gl2.c} (100%)
 rename gfx/drivers_display/{gfx_display_gl_core.c => gfx_display_gl3.c} (99%)
 rename gfx/drivers_font/{gl_raster_font.c => gl2_raster_font.c} (100%)
 rename gfx/drivers_font/{gl_core_raster_font.c => gl3_raster_font.c} (99%)
 rename gfx/drivers_shader/{shader_gl_core.cpp => shader_gl3.cpp} (99%)
 rename gfx/drivers_shader/{shader_gl_core.h => shader_gl3.h} (100%)

diff --git a/Makefile.common b/Makefile.common
index 8fe3b713de..772516fcf5 100644
--- a/Makefile.common
+++ b/Makefile.common
@@ -1446,10 +1446,10 @@ endif
 ifeq ($(HAVE_GL_CONTEXT), 1)
    ifeq ($(HAVE_GL_MODERN), 1)
       DEFINES += -DHAVE_OPENGL
-      OBJ += gfx/drivers/gl.o \
+      OBJ += gfx/drivers/gl2.o \
              $(LIBRETRO_COMM_DIR)/gfx/gl_capabilities.o \
-             gfx/drivers_font/gl_raster_font.o \
-				 gfx/drivers_display/gfx_display_gl.o
+             gfx/drivers_font/gl2_raster_font.o \
+	     gfx/drivers_display/gfx_display_gl2.o
    endif
 
    OBJ += $(LIBRETRO_COMM_DIR)/glsym/rglgen.o
@@ -1458,7 +1458,7 @@ ifeq ($(HAVE_GL_CONTEXT), 1)
       DEFINES += -DHAVE_OPENGL1
       OBJ += gfx/drivers/gl1.o \
              gfx/drivers_font/gl1_raster_font.o \
-				 gfx/drivers_display/gfx_display_gl1.o
+	     gfx/drivers_display/gfx_display_gl1.o
    endif
 
    ifeq ($(HAVE_VIDEOCORE), 1)
@@ -1626,10 +1626,10 @@ ifeq ($(HAVE_VULKAN), 1)
 endif
 
 ifeq ($(HAVE_OPENGL_CORE), 1)
-   OBJ += gfx/drivers/gl_core.o \
-          gfx/drivers_font/gl_core_raster_font.o \
-			 gfx/drivers_shader/shader_gl_core.o \
-			 gfx/drivers_display/gfx_display_gl_core.o
+   OBJ += gfx/drivers/gl3.o \
+          gfx/drivers_font/gl3_raster_font.o \
+	  gfx/drivers_shader/shader_gl3.o \
+	  gfx/drivers_display/gfx_display_gl3.o
 
    DEFINES += -DHAVE_OPENGL_CORE
    NEED_CXX_LINKER  = 1
diff --git a/gfx/common/gl_core_common.h b/gfx/common/gl3_common.h
similarity index 98%
rename from gfx/common/gl_core_common.h
rename to gfx/common/gl3_common.h
index ffc147b1e1..6c48362367 100644
--- a/gfx/common/gl_core_common.h
+++ b/gfx/common/gl3_common.h
@@ -34,7 +34,7 @@
 
 #include "../video_coord_array.h"
 #include "../../retroarch.h"
-#include "../drivers_shader/shader_gl_core.h"
+#include "../drivers_shader/shader_gl3.h"
 
 RETRO_BEGIN_DECLS
 
diff --git a/gfx/drivers/d3d10.c b/gfx/drivers/d3d10.c
index fffca21c2c..4968f7e3ee 100644
--- a/gfx/drivers/d3d10.c
+++ b/gfx/drivers/d3d10.c
@@ -14,6 +14,13 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Direct3D 10 driver.
+ *
+ * Minimum version : Direct3D 10.0 (2006)
+ * Minimum OS      : Windows Vista
+ * Recommended OS  : Windows Vista and/or later
+ */
+
 #define CINTERFACE
 #define COBJMACROS
 
diff --git a/gfx/drivers/d3d11.c b/gfx/drivers/d3d11.c
index 879c8a43b6..17b7ede080 100644
--- a/gfx/drivers/d3d11.c
+++ b/gfx/drivers/d3d11.c
@@ -14,6 +14,13 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Direct3D 11 driver.
+ *
+ * Minimum version : Direct3D 11.0 (Feature Level 11.0) (2009)
+ * Minimum OS      : Windows Vista, Windows 7
+ * Recommended OS  : Windows 7 and/or later
+ */
+
 #define CINTERFACE
 #define COBJMACROS
 
diff --git a/gfx/drivers/d3d12.c b/gfx/drivers/d3d12.c
index 0216b291e0..0d2e7c688e 100644
--- a/gfx/drivers/d3d12.c
+++ b/gfx/drivers/d3d12.c
@@ -14,6 +14,13 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Direct3D 12 driver.
+ *
+ * Minimum version : Direct3D 12.0 (2015)
+ * Minimum OS      : Windows 7, Windows 8
+ * Recommended OS  : Windows 10
+ */
+
 #define CINTERFACE
 
 #include <assert.h>
diff --git a/gfx/drivers/d3d8.c b/gfx/drivers/d3d8.c
index 2bdabe305b..fecc0a733a 100644
--- a/gfx/drivers/d3d8.c
+++ b/gfx/drivers/d3d8.c
@@ -15,6 +15,13 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Direct3D 8 driver.
+ *
+ * Minimum version : Direct3D 8.0 (2000)
+ * Minimum OS      : Windows 95 (8.0a), Windows 98 and XP after 8.0a
+ * Recommended OS  : Windows 98/ME and/or Windows XP
+ */
+
 #define CINTERFACE
 
 #ifdef _XBOX
diff --git a/gfx/drivers/d3d9.c b/gfx/drivers/d3d9.c
index bd81a79846..28fc79d27f 100644
--- a/gfx/drivers/d3d9.c
+++ b/gfx/drivers/d3d9.c
@@ -15,6 +15,13 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Direct3D 9 driver.
+ *
+ * Minimum version : Direct3D 9.0 (2002)
+ * Minimum OS      : Windows 98, Windows 2000, Windows ME
+ * Recommended OS  : Windows XP
+ */
+
 #define CINTERFACE
 
 #ifdef _XBOX
diff --git a/gfx/drivers/gl1.c b/gfx/drivers/gl1.c
index 165119675b..93ab3818f9 100644
--- a/gfx/drivers/gl1.c
+++ b/gfx/drivers/gl1.c
@@ -15,10 +15,14 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* OpenGL driver.
+/* OpenGL 1.x driver. 
  *
- * We are targeting a minimum of OpenGL 1.1 and the Microsoft "GDI Generic" software GL implementation.
- * Any additional features added for later 1.x versions should only be enabled if they are detected at runtime. */
+ * Minimum version : OpenGL 1.1 (1997)
+ *
+ * We are targeting a minimum of OpenGL 1.1 and the Microsoft 
+ * "GDI Generic" * software GL implementation.
+ * Any additional features added for later 1.x versions should only be 
+ * enabled if they are detected at runtime. */
 
 #include <stddef.h>
 #include <retro_miscellaneous.h>
diff --git a/gfx/drivers/gl.c b/gfx/drivers/gl2.c
similarity index 99%
rename from gfx/drivers/gl.c
rename to gfx/drivers/gl2.c
index d578648bee..ff4e828640 100644
--- a/gfx/drivers/gl.c
+++ b/gfx/drivers/gl2.c
@@ -15,10 +15,10 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* Middle of the road OpenGL driver.
+/* Middle of the road OpenGL 2.x driver.
  *
- * Minimum version (desktop): OpenGL 2.0+
- * Minimum version (mobile) : OpenGLES 2.0+
+ * Minimum version (desktop): OpenGL   2.0+ (2004)
+ * Minimum version (mobile) : OpenGLES 2.0+ (2007)
  */
 
 #ifdef _MSC_VER
diff --git a/gfx/drivers/gl_core.c b/gfx/drivers/gl3.c
similarity index 99%
rename from gfx/drivers/gl_core.c
rename to gfx/drivers/gl3.c
index 488d682448..9b82c8af1e 100644
--- a/gfx/drivers/gl_core.c
+++ b/gfx/drivers/gl3.c
@@ -15,15 +15,15 @@
 
 /* Modern OpenGL driver.
  *
- * Minimum version (desktop): OpenGL 3.2+
- * Minimum version (mobile) : OpenGLES 3.0+
+ * Minimum version (desktop): OpenGL   3.2+ (2009)
+ * Minimum version (mobile) : OpenGLES 3.0+ (2012)
  */
 
 #ifdef HAVE_CONFIG_H
 #include "../../config.h"
 #endif
 
-#include "../common/gl_core_common.h"
+#include "../common/gl3_common.h"
 
 #include <gfx/gl_capabilities.h>
 #include <gfx/video_frame.h>
diff --git a/gfx/drivers_display/gfx_display_gl.c b/gfx/drivers_display/gfx_display_gl2.c
similarity index 100%
rename from gfx/drivers_display/gfx_display_gl.c
rename to gfx/drivers_display/gfx_display_gl2.c
diff --git a/gfx/drivers_display/gfx_display_gl_core.c b/gfx/drivers_display/gfx_display_gl3.c
similarity index 99%
rename from gfx/drivers_display/gfx_display_gl_core.c
rename to gfx/drivers_display/gfx_display_gl3.c
index a661ae5f41..c6f4ab4cc5 100644
--- a/gfx/drivers_display/gfx_display_gl_core.c
+++ b/gfx/drivers_display/gfx_display_gl3.c
@@ -15,17 +15,17 @@
  */
 
 #include <retro_miscellaneous.h>
-#include <gfx/common/gl_core_common.h>
 
 #ifdef HAVE_CONFIG_H
 #include "../../config.h"
 #endif
 
+#include "../common/gl3_common.h"
+
 #include "../gfx_display.h"
 
 #include "../font_driver.h"
 #include "../../retroarch.h"
-#include "../common/gl_core_common.h"
 
 static const float gl_core_vertexes[] = {
    0, 0,
diff --git a/gfx/drivers_font/gl_raster_font.c b/gfx/drivers_font/gl2_raster_font.c
similarity index 100%
rename from gfx/drivers_font/gl_raster_font.c
rename to gfx/drivers_font/gl2_raster_font.c
diff --git a/gfx/drivers_font/gl_core_raster_font.c b/gfx/drivers_font/gl3_raster_font.c
similarity index 99%
rename from gfx/drivers_font/gl_core_raster_font.c
rename to gfx/drivers_font/gl3_raster_font.c
index f9a2156f61..b71328607c 100644
--- a/gfx/drivers_font/gl_core_raster_font.c
+++ b/gfx/drivers_font/gl3_raster_font.c
@@ -20,9 +20,8 @@
 #include <encodings/utf.h>
 #include <string/stdstring.h>
 #include <retro_math.h>
-#include <gfx/common/gl_core_common.h>
 
-#include "../common/gl_core_common.h"
+#include "../common/gl3_common.h"
 #include "../font_driver.h"
 #include "../../configuration.h"
 #include "../../verbosity.h"
diff --git a/gfx/drivers_shader/shader_gl_core.cpp b/gfx/drivers_shader/shader_gl3.cpp
similarity index 99%
rename from gfx/drivers_shader/shader_gl_core.cpp
rename to gfx/drivers_shader/shader_gl3.cpp
index bf25964ffd..2a2245d770 100644
--- a/gfx/drivers_shader/shader_gl_core.cpp
+++ b/gfx/drivers_shader/shader_gl3.cpp
@@ -13,7 +13,7 @@
  *  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#include "shader_gl_core.h"
+#include "shader_gl3.h"
 #include "glslang_util.h"
 #include "glslang_util_cxx.h"
 
@@ -32,7 +32,7 @@
 #include "slang_reflection.hpp"
 #include "spirv_glsl.hpp"
 
-#include "../common/gl_core_common.h"
+#include "../common/gl3_common.h"
 
 #include "../../verbosity.h"
 #include "../../msg_hash.h"
diff --git a/gfx/drivers_shader/shader_gl_core.h b/gfx/drivers_shader/shader_gl3.h
similarity index 100%
rename from gfx/drivers_shader/shader_gl_core.h
rename to gfx/drivers_shader/shader_gl3.h
diff --git a/griffin/griffin.c b/griffin/griffin.c
index 9ad3457f20..9d642a55ae 100644
--- a/griffin/griffin.c
+++ b/griffin/griffin.c
@@ -501,13 +501,13 @@ VIDEO DRIVER
 #endif
 
 #ifdef HAVE_OPENGL_CORE
-#include "../gfx/drivers/gl_core.c"
-#include "../gfx/drivers_display/gfx_display_gl_core.c"
+#include "../gfx/drivers/gl3.c"
+#include "../gfx/drivers_display/gfx_display_gl3.c"
 #endif
 
 #ifdef HAVE_OPENGL
-#include "../gfx/drivers/gl.c"
-#include "../gfx/drivers_display/gfx_display_gl.c"
+#include "../gfx/drivers/gl2.c"
+#include "../gfx/drivers_display/gfx_display_gl2.c"
 #endif
 
 #if defined(HAVE_OPENGL) || defined(HAVE_OPENGL_CORE)
@@ -604,11 +604,11 @@ FONTS
 #endif
 
 #if defined(HAVE_OPENGL)
-#include "../gfx/drivers_font/gl_raster_font.c"
+#include "../gfx/drivers_font/gl2_raster_font.c"
 #endif
 
 #ifdef HAVE_OPENGL_CORE
-#include "../gfx/drivers_font/gl_core_raster_font.c"
+#include "../gfx/drivers_font/gl3_raster_font.c"
 #endif
 
 #if defined(_XBOX1)