From 353a222c62aa2d2a582318081ebe9e365cadfa7d Mon Sep 17 00:00:00 2001
From: ChestnutYueyue <952134128@qq.com>
Date: Thu, 26 Feb 2026 01:00:58 +0800
Subject: [PATCH] =?UTF-8?q?refactor(graphics):=20=E9=87=8D=E5=91=BD?=
 =?UTF-8?q?=E5=90=8D=20render=5Fbackend=20=E4=B8=BA=20renderer=20=E4=BB=A5?=
 =?UTF-8?q?=E7=BB=9F=E4=B8=80=E5=91=BD=E5=90=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

将渲染后端接口文件 render_backend.h 重命名为 renderer.h，并更新所有相关引用。这一修改旨在使命名更加清晰统一，renderer 更能准确描述该接口的职责。
---
 include/app/application.h                     |  3 +-
 include/extra2d.h                             | 51 +++++++++++--------
 include/graphics/opengl/gl_renderer.h         |  2 +-
 .../graphics/{render_backend.h => renderer.h} |  0
 include/scene/node.h                          |  2 +-
 src/app/application.cpp                       |  2 +-
 src/graphics/render_backend.cpp               |  2 +-
 src/scene/scene.cpp                           |  3 +-
 src/scene/scene_manager.cpp                   |  3 +-
 src/scene/shape_node.cpp                      |  3 +-
 src/scene/sprite.cpp                          |  3 +-
 src/scene/transition_box_scene.cpp            |  2 +-
 src/scene/transition_fade_scene.cpp           |  3 +-
 src/scene/transition_flip_scene.cpp           |  3 +-
 src/scene/transition_scale_scene.cpp          |  3 +-
 src/scene/transition_scene.cpp                |  3 +-
 src/scene/transition_slide_scene.cpp          |  3 +-
 src/ui/button.cpp                             |  2 +-
 src/ui/check_box.cpp                          |  2 +-
 src/ui/label.cpp                              |  2 +-
 src/ui/progress_bar.cpp                       |  2 +-
 src/ui/radio_button.cpp                       |  2 +-
 src/ui/slider.cpp                             |  2 +-
 src/ui/text.cpp                               |  2 +-
 24 files changed, 57 insertions(+), 48 deletions(-)
 rename include/graphics/{render_backend.h => renderer.h} (100%)

diff --git a/include/app/application.h b/include/app/application.h
index c3c48fc..abdf0e3 100644
--- a/include/app/application.h
+++ b/include/app/application.h
@@ -2,11 +2,10 @@
 
 #include <core/string.h>
 #include <core/types.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <memory>
 #include <platform/window.h>
 
-
 namespace extra2d {
 
 // 前向声明
diff --git a/include/extra2d.h b/include/extra2d.h
index 7eda29c..c19b6ec 100644
--- a/include/extra2d.h
+++ b/include/extra2d.h
@@ -4,21 +4,24 @@
 // 包含所有公共 API
 
 // Core
-#include <core/types.h>
-#include <core/string.h>
 #include <core/color.h>
 #include <core/math_types.h>
+#include <core/string.h>
+#include <core/types.h>
+
 
 // Platform
-#include <platform/window.h>
 #include <platform/input.h>
+#include <platform/window.h>
+
 
 // Graphics
-#include <graphics/render_backend.h>
-#include <graphics/texture.h>
-#include <graphics/font.h>
 #include <graphics/camera.h>
+#include <graphics/font.h>
+#include <graphics/renderer.h>
 #include <graphics/shader_system.h>
+#include <graphics/texture.h>
+
 
 #include <graphics/render_target.h>
 #include <graphics/vram_manager.h>
@@ -26,38 +29,42 @@
 // Scene
 #include <scene/node.h>
 #include <scene/scene.h>
-#include <scene/sprite.h>
-#include <scene/shape_node.h>
 #include <scene/scene_manager.h>
-#include <scene/transition_scene.h>
-#include <scene/transition_fade_scene.h>
-#include <scene/transition_slide_scene.h>
-#include <scene/transition_scale_scene.h>
-#include <scene/transition_flip_scene.h>
+#include <scene/shape_node.h>
+#include <scene/sprite.h>
 #include <scene/transition_box_scene.h>
+#include <scene/transition_fade_scene.h>
+#include <scene/transition_flip_scene.h>
+#include <scene/transition_scale_scene.h>
+#include <scene/transition_scene.h>
+#include <scene/transition_slide_scene.h>
+
 
 // Animation
 #include <animation/sprite_frame.h>
 #include <animation/sprite_frame_cache.h>
-#include <animation/tween_easing.h>
 #include <animation/tween.h>
+#include <animation/tween_easing.h>
+
 
 // UI
-#include <ui/widget.h>
 #include <ui/button.h>
-#include <ui/text.h>
+#include <ui/check_box.h>
 #include <ui/label.h>
 #include <ui/progress_bar.h>
-#include <ui/check_box.h>
 #include <ui/radio_button.h>
 #include <ui/slider.h>
+#include <ui/text.h>
+#include <ui/widget.h>
+
 
 // Event
 #include <event/event.h>
-#include <event/event_queue.h>
 #include <event/event_dispatcher.h>
+#include <event/event_queue.h>
 #include <event/input_codes.h>
 
+
 // Audio
 #include <audio/audio_engine.h>
 #include <audio/sound.h>
@@ -66,17 +73,19 @@
 #include <resource/resource_manager.h>
 
 // Utils
-#include <utils/logger.h>
-#include <utils/timer.h>
 #include <utils/data.h>
+#include <utils/logger.h>
 #include <utils/random.h>
+#include <utils/timer.h>
+
 
 // Spatial
-#include <spatial/spatial_index.h>
 #include <spatial/quadtree.h>
 #include <spatial/spatial_hash.h>
+#include <spatial/spatial_index.h>
 #include <spatial/spatial_manager.h>
 
+
 // Application
 #include <app/application.h>
 
diff --git a/include/graphics/opengl/gl_renderer.h b/include/graphics/opengl/gl_renderer.h
index 731f970..fef9e4e 100644
--- a/include/graphics/opengl/gl_renderer.h
+++ b/include/graphics/opengl/gl_renderer.h
@@ -2,7 +2,7 @@
 
 #include <graphics/opengl/gl_shader.h>
 #include <graphics/opengl/gl_sprite_batch.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 
 #include <array>
 #include <glad/glad.h>
diff --git a/include/graphics/render_backend.h b/include/graphics/renderer.h
similarity index 100%
rename from include/graphics/render_backend.h
rename to include/graphics/renderer.h
diff --git a/include/scene/node.h b/include/scene/node.h
index c2fa96b..71cf3a9 100644
--- a/include/scene/node.h
+++ b/include/scene/node.h
@@ -6,7 +6,7 @@
 #include <core/types.h>
 #include <event/event_dispatcher.h>
 #include <functional>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <memory>
 #include <string>
 #include <vector>
diff --git a/src/app/application.cpp b/src/app/application.cpp
index e6a1877..93674a7 100644
--- a/src/app/application.cpp
+++ b/src/app/application.cpp
@@ -3,7 +3,7 @@
 #include <event/event_dispatcher.h>
 #include <event/event_queue.h>
 #include <graphics/camera.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <graphics/vram_manager.h>
 #include <platform/input.h>
 #include <platform/window.h>
diff --git a/src/graphics/render_backend.cpp b/src/graphics/render_backend.cpp
index 0e05643..b078c1c 100644
--- a/src/graphics/render_backend.cpp
+++ b/src/graphics/render_backend.cpp
@@ -1,5 +1,5 @@
 #include <graphics/opengl/gl_renderer.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 
 namespace extra2d {
 
diff --git a/src/scene/scene.cpp b/src/scene/scene.cpp
index aaa22f5..f588dc8 100644
--- a/src/scene/scene.cpp
+++ b/src/scene/scene.cpp
@@ -1,8 +1,9 @@
-#include <graphics/render_backend.h>
 #include <graphics/render_command.h>
+#include <graphics/renderer.h>
 #include <scene/scene.h>
 #include <utils/logger.h>
 
+
 namespace extra2d {
 
 Scene::Scene() { defaultCamera_ = makePtr<Camera>(); }
diff --git a/src/scene/scene_manager.cpp b/src/scene/scene_manager.cpp
index ca07322..a60e26d 100644
--- a/src/scene/scene_manager.cpp
+++ b/src/scene/scene_manager.cpp
@@ -1,7 +1,7 @@
 #include <algorithm>
 #include <app/application.h>
-#include <graphics/render_backend.h>
 #include <graphics/render_command.h>
+#include <graphics/renderer.h>
 #include <platform/input.h>
 #include <scene/scene_manager.h>
 #include <scene/transition_box_scene.h>
@@ -12,6 +12,7 @@
 #include <scene/transition_slide_scene.h>
 #include <utils/logger.h>
 
+
 namespace extra2d {
 
 namespace {
diff --git a/src/scene/shape_node.cpp b/src/scene/shape_node.cpp
index 36bfe08..686c956 100644
--- a/src/scene/shape_node.cpp
+++ b/src/scene/shape_node.cpp
@@ -1,10 +1,11 @@
 #include <algorithm>
 #include <cmath>
-#include <graphics/render_backend.h>
 #include <graphics/render_command.h>
+#include <graphics/renderer.h>
 #include <limits>
 #include <scene/shape_node.h>
 
+
 namespace extra2d {
 
 ShapeNode::ShapeNode() = default;
diff --git a/src/scene/sprite.cpp b/src/scene/sprite.cpp
index 9bdac32..b909b65 100644
--- a/src/scene/sprite.cpp
+++ b/src/scene/sprite.cpp
@@ -1,10 +1,11 @@
 #include <algorithm>
 #include <cmath>
-#include <graphics/render_backend.h>
 #include <graphics/render_command.h>
+#include <graphics/renderer.h>
 #include <graphics/texture.h>
 #include <scene/sprite.h>
 
+
 namespace extra2d {
 
 Sprite::Sprite() = default;
diff --git a/src/scene/transition_box_scene.cpp b/src/scene/transition_box_scene.cpp
index 371058b..cf342a1 100644
--- a/src/scene/transition_box_scene.cpp
+++ b/src/scene/transition_box_scene.cpp
@@ -2,7 +2,7 @@
 #include <app/application.h>
 #include <core/color.h>
 #include <glm/gtc/matrix_transform.hpp>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <scene/transition_box_scene.h>
 
 namespace extra2d {
diff --git a/src/scene/transition_fade_scene.cpp b/src/scene/transition_fade_scene.cpp
index 47a4658..113700d 100644
--- a/src/scene/transition_fade_scene.cpp
+++ b/src/scene/transition_fade_scene.cpp
@@ -1,10 +1,11 @@
 #include <app/application.h>
 #include <glm/gtc/matrix_transform.hpp>
-#include <graphics/render_backend.h>
 #include <graphics/render_target.h>
+#include <graphics/renderer.h>
 #include <scene/transition_fade_scene.h>
 #include <utils/logger.h>
 
+
 namespace extra2d {
 
 TransitionFadeScene::TransitionFadeScene(float duration, Ptr<Scene> inScene,
diff --git a/src/scene/transition_flip_scene.cpp b/src/scene/transition_flip_scene.cpp
index 3ef9f91..2be7187 100644
--- a/src/scene/transition_flip_scene.cpp
+++ b/src/scene/transition_flip_scene.cpp
@@ -1,9 +1,8 @@
 #include <core/math_types.h>
 #include <graphics/camera.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <scene/transition_flip_scene.h>
 
-
 namespace extra2d {
 
 TransitionFlipScene::TransitionFlipScene(float duration, Ptr<Scene> inScene,
diff --git a/src/scene/transition_scale_scene.cpp b/src/scene/transition_scale_scene.cpp
index 63c47a1..268847f 100644
--- a/src/scene/transition_scale_scene.cpp
+++ b/src/scene/transition_scale_scene.cpp
@@ -1,9 +1,8 @@
 #include <algorithm>
 #include <graphics/camera.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <scene/transition_scale_scene.h>
 
-
 namespace extra2d {
 
 TransitionScaleScene::TransitionScaleScene(float duration, Ptr<Scene> inScene)
diff --git a/src/scene/transition_scene.cpp b/src/scene/transition_scene.cpp
index 958ed31..f7cca67 100644
--- a/src/scene/transition_scene.cpp
+++ b/src/scene/transition_scene.cpp
@@ -1,8 +1,7 @@
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <scene/transition_scene.h>
 #include <utils/logger.h>
 
-
 namespace extra2d {
 
 TransitionScene::TransitionScene(float duration, Ptr<Scene> inScene)
diff --git a/src/scene/transition_slide_scene.cpp b/src/scene/transition_slide_scene.cpp
index 833a10b..d6a8460 100644
--- a/src/scene/transition_slide_scene.cpp
+++ b/src/scene/transition_slide_scene.cpp
@@ -1,8 +1,7 @@
 #include <graphics/camera.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <scene/transition_slide_scene.h>
 
-
 namespace extra2d {
 
 TransitionSlideScene::TransitionSlideScene(float duration, Ptr<Scene> inScene,
diff --git a/src/ui/button.cpp b/src/ui/button.cpp
index 6e677d0..ca9a535 100644
--- a/src/ui/button.cpp
+++ b/src/ui/button.cpp
@@ -2,7 +2,7 @@
 #include <app/application.h>
 #include <cmath>
 #include <core/string.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/button.h>
 
 namespace extra2d {
diff --git a/src/ui/check_box.cpp b/src/ui/check_box.cpp
index 89f3dfa..729df21 100644
--- a/src/ui/check_box.cpp
+++ b/src/ui/check_box.cpp
@@ -1,5 +1,5 @@
 #include <core/string.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/check_box.h>
 
 namespace extra2d {
diff --git a/src/ui/label.cpp b/src/ui/label.cpp
index f920260..62a76a2 100644
--- a/src/ui/label.cpp
+++ b/src/ui/label.cpp
@@ -1,5 +1,5 @@
 #include <core/string.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/label.h>
 
 namespace extra2d {
diff --git a/src/ui/progress_bar.cpp b/src/ui/progress_bar.cpp
index 7849c17..3268b62 100644
--- a/src/ui/progress_bar.cpp
+++ b/src/ui/progress_bar.cpp
@@ -1,6 +1,6 @@
 #include <cmath>
 #include <core/string.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/progress_bar.h>
 
 namespace extra2d {
diff --git a/src/ui/radio_button.cpp b/src/ui/radio_button.cpp
index 775f2ac..6e1f505 100644
--- a/src/ui/radio_button.cpp
+++ b/src/ui/radio_button.cpp
@@ -1,5 +1,5 @@
 #include <core/string.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/radio_button.h>
 
 namespace extra2d {
diff --git a/src/ui/slider.cpp b/src/ui/slider.cpp
index 2ce8578..07a1c51 100644
--- a/src/ui/slider.cpp
+++ b/src/ui/slider.cpp
@@ -1,6 +1,6 @@
 #include <cmath>
 #include <core/string.h>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/slider.h>
 
 namespace extra2d {
diff --git a/src/ui/text.cpp b/src/ui/text.cpp
index fc691a6..c28e3b0 100644
--- a/src/ui/text.cpp
+++ b/src/ui/text.cpp
@@ -1,7 +1,7 @@
 #include <core/string.h>
 #include <cstdarg>
 #include <cstdio>
-#include <graphics/render_backend.h>
+#include <graphics/renderer.h>
 #include <ui/text.h>
 
 namespace extra2d {