add frustum culling functions.

Assets/Script/Lib/Dora/en/Director.d.tl

@@ -37,6 +37,9 @@ local record Director
 	-- The current active camera in Director's camera stack.
 	const currentCamera: Camera
 
+	-- The flag to enable or disable frustum culling.
+	frustumCulling: boolean
+
 	-- Adds a new camera to Director's camera stack and sets it to the current camera.
 	-- @param camera (Camera) The camera to add.
 	pushCamera: function(self: Director, camera: Camera)

Assets/Script/Lib/Dora/en/Dora.d.ts

@@ -3625,6 +3625,11 @@ class Director {
 	 */
 	readonly currentCamera: Camera;
 
+	/**
+	 * Whether to enable frustum culling.
+	 */
+	frustumCulling: boolean;
+
 	/**
 	 * Adds a new camera to Director's camera stack and sets it to the current camera.
 	 * @param camera The camera to add.

Assets/Script/Lib/Dora/zh-Hans/Director.d.tl

@@ -37,6 +37,9 @@ local record Director
 	-- 当前在应用的相机。
 	const currentCamera: Camera
 
+	-- 是否启用视锥体裁剪。
+	frustumCulling: boolean
+
 	-- 添加新相机到相机堆栈中，并设置为当前应用的相机。
 	-- @param camera (Camera) 要添加的相机。
 	pushCamera: function(self: Director, camera: Camera)

Assets/Script/Lib/Dora/zh-Hans/Dora.d.ts

@@ -3629,6 +3629,11 @@ class Director {
 	 */
 	readonly currentCamera: Camera;
 
+	/**
+	 * 是否启用视锥体裁剪。
+	 */
+	frustumCulling: boolean;
+
 	/**
 	 * 向Director的摄像机堆栈添加新摄像机，并将其设置为当前摄像机。
 	 * @param camera 要添加的摄像机。

Docs/docs/api/Class/Director.mdx

@@ -129,6 +129,19 @@ const postScheduler: Scheduler
 const currentCamera: Camera
 ```
 
+## frustumCulling
+
+**Type:** Field.
+
+**Description:**
+
+  The flag to enable or disable frustum culling.
+
+**Signature:**
+```tl
+frustumCulling: boolean
+```
+
 ## pushCamera
 
 **Type:** Function.

Docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/api/Class/Director.mdx

@@ -129,6 +129,19 @@ const postScheduler: Scheduler
 const currentCamera: Camera
 ```
 
+## frustumCulling
+
+**类型：** 成员变量。
+
+**描述：**
+
+  是否启用视锥体裁剪。
+
+**签名：**
+```tl
+frustumCulling: boolean
+```
+
 ## pushCamera
 
 **类型：** 函数。

Projects/Android/Dora/app/build.gradle

@@ -7,8 +7,8 @@ android {
 		applicationId "org.ippclub.dorassr"
 		minSdkVersion 28
 		targetSdkVersion 34
-		versionCode 59
-		versionName "1.4.2"
+		versionCode 60
+		versionName "1.4.3"
 		testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'
 		externalNativeBuild {
 			cmake {

Projects/Windows/Dora/Resource.rc

@@ -61,8 +61,8 @@ IDI_ICON1               ICON                    "Dora SSR.ico"
 //
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 1,4,2,0
- PRODUCTVERSION 1,4,2,0
+ FILEVERSION 1,4,3,0
+ PRODUCTVERSION 1,4,3,0
  FILEFLAGSMASK 0x3fL
 #ifdef _DEBUG
  FILEFLAGS 0x1L
@@ -79,12 +79,12 @@ BEGIN
         BEGIN
             VALUE "CompanyName", "IppClub"
             VALUE "FileDescription", "A game engine for rapid game development."
-            VALUE "FileVersion", "1.4.2.0"
+            VALUE "FileVersion", "1.4.3.0"
             VALUE "InternalName", "Dora.exe"
             VALUE "LegalCopyright", "Copyright (C) 2024"
             VALUE "OriginalFilename", "Dora.exe"
             VALUE "ProductName", "Dora SSR"
-            VALUE "ProductVersion", "1.4.2.0"
+            VALUE "ProductVersion", "1.4.3.0"
         END
     END
     BLOCK "VarFileInfo"

Projects/iOS/Dora/Info.plist

@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.4.2</string>
+	<string>1.4.3</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>59</string>
+	<string>60</string>
 	<key>LSRequiresIPhoneOS</key>
 	<true/>
 	<key>UILaunchStoryboardName</key>

Projects/macOS/Dora/Info.plist

@@ -17,11 +17,11 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.4.2</string>
+	<string>1.4.3</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>59</string>
+	<string>60</string>
 	<key>LSApplicationCategoryType</key>
 	<string>public.app-category.developer-tools</string>
 	<key>LSMinimumSystemVersion</key>

Source/Basic/Application.cpp

@@ -29,7 +29,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 #include <ctime>
 #include <thread>
 
-#define DORA_VERSION "1.4.2"_slice
+#define DORA_VERSION "1.4.3"_slice
 
 #if BX_PLATFORM_ANDROID
 #include <jni.h>

Source/Basic/Director.cpp

@@ -45,6 +45,7 @@ Director::Director()
 	, _nvgDirty(false)
 	, _paused(false)
 	, _stoped(false)
+	, _frustumCulling(true)
 	, _nvgContext(nullptr) { }
 
 Director::~Director() {
@@ -167,7 +168,7 @@ Camera* Director::getCurrentCamera() {
 }
 
 const Matrix& Director::getViewProjection() const {
-	return *_viewProjs.top();
+	return _viewProjs.top()->matrix;
 }
 
 static void registerTouchHandler(Node* target) {
@@ -425,7 +426,10 @@ void Director::doRender() {
 }
 
 void Director::pushViewProjection(const Matrix& viewProj) {
-	_viewProjs.push(New<Matrix>(viewProj));
+	auto viewProject = New<ViewProject>();
+	viewProject->matrix = viewProj;
+	Matrix::toFrustum(viewProject->frustum, viewProj);
+	_viewProjs.push(std::move(viewProject));
 }
 
 void Director::popViewProjection() {
@@ -498,6 +502,19 @@ void Director::removeFromWaitingList(Node* node) {
 		_waitingList.end());
 }
 
+bool Director::isInFrustum(const AABB& aabb) const {
+	if (_viewProjs.empty()) return false;
+	return _viewProjs.top()->frustum.intersect(aabb);
+}
+
+bool Director::isFrustumCulling() const {
+	return _frustumCulling;
+}
+
+void Director::setFrustumCulling(bool var) {
+	_frustumCulling = var;
+}
+
 void Director::markDirty() {
 	if (_ui) _ui->markDirty();
 	if (_entry) {

Source/Basic/Director.h

@@ -39,6 +39,7 @@ class Director {
 	PROPERTY_READONLY(Scheduler*, SystemScheduler);
 	PROPERTY_READONLY(Scheduler*, PostScheduler);
 	PROPERTY_READONLY(const Matrix&, ViewProjection);
+	PROPERTY_BOOL(FrustumCulling);
 	bool init();
 	void doLogic();
 	void doRender();
@@ -61,6 +62,8 @@ class Director {
 		popViewProjection();
 	}
 
+	bool isInFrustum(const AABB& aabb) const;
+
 	void addUnManagedNode(Node* node);
 
 	void addToWaitingList(Node* node);
@@ -75,6 +78,7 @@ class Director {
 	bool _nvgDirty;
 	bool _paused;
 	bool _stoped;
+	bool _frustumCulling;
 	Color _clearColor;
 	Ref<Node> _ui;
 	Ref<Node> _ui3D;
@@ -90,7 +94,11 @@ class Director {
 	RefVector<Node> _unManagedNodes;
 	std::vector<WRef<Node>> _waitingList;
 	Own<UITouchHandler> _uiTouchHandler;
-	std::stack<Own<Matrix>> _viewProjs;
+	struct ViewProject {
+		Matrix matrix;
+		Frustum frustum;
+	};
+	std::stack<Own<ViewProject>> _viewProjs;
 	Matrix _defaultViewProj;
 	NVGcontext* _nvgContext;
 	SINGLETON_REF(Director, EffekManager, FontManager, LuaEngine, BGFXDora, Application);

Source/Basic/View.cpp

@@ -13,7 +13,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 #include "Basic/Application.h"
 #include "Basic/Director.h"
 #include "Effect/Effect.h"
-#include "Node/Node.h"
+#include "Event/Event.h"
 #include "Node/EffekNode.h"
 
 NS_DORA_BEGIN

Source/Common/Utils.h

@@ -274,9 +274,9 @@ inline std::size_t constexpr operator"" _hash(const char* s, size_t) {
 /** @brief Helpers for number comparision */
 namespace Math {
 template <class T>
-inline T clamp(T value, T minVal, T maxVal) {
-	auto pair = std::minmax(minVal, maxVal);
-	return std::max(std::min(value, pair.second), pair.first);
+inline T clamp(T value, T boundA, T boundB) {
+	auto [minVal, maxVal] = std::minmax(boundA, boundB);
+	return std::max(std::min(value, maxVal), minVal);
 }
 
 float rand0to1();

Source/Node/DragonBone.cpp

@@ -31,22 +31,47 @@ DBSlotNode::DBSlotNode()
 	, _transform(AffineTransform::Indentity) { }
 
 void DBSlotNode::render() {
-	if (!_texture || !_effect || _vertices.empty()) return;
+	if (!_texture || !_effect || _vertices.empty()) {
+		Node::render();
+		return;
+	}
+
+	if (SharedDirector.isFrustumCulling()) {
+		auto [minX, maxX] = std::minmax_element(_points.begin(), _points.end(), [](const auto& a, const auto& b) {
+			return a.x < b.x;
+		});
+		auto [minY, maxY] = std::minmax_element(_points.begin(), _points.end(), [](const auto& a, const auto& b) {
+			return a.y < b.y;
+		});
+		AABB aabb;
+		Matrix::mulAABB(aabb, _matrix, {
+										   {minX->x, minY->y, 0},
+										   {maxX->x, maxY->y, 0},
+									   });
+		if (!SharedDirector.isInFrustum(aabb)) {
+			return;
+		}
+	}
+
 	Matrix transform;
-	Matrix::mulMtx(transform, SharedDirector.getViewProjection(), getWorld());
+	Matrix::mulMtx(transform, SharedDirector.getViewProjection(), _matrix);
+	for (size_t i = 0; i < _points.size(); i++) {
+		Matrix::mulVec4(&_vertices[i].x, transform, &_points[i].x);
+	}
+
 	auto parent = s_cast<DragonBone*>(getParent());
 	uint64_t renderState = (BGFX_STATE_WRITE_RGB | BGFX_STATE_WRITE_A | BGFX_STATE_MSAA | _blendFunc.toValue());
 	if (parent->isDepthWrite()) {
 		renderState |= (BGFX_STATE_WRITE_Z | BGFX_STATE_DEPTH_TEST_LESS);
 	}
-	for (size_t i = 0; i < _points.size(); i++) {
-		Matrix::mulVec4(&_vertices[i].x, transform, &_points[i].x);
-	}
+
 	SharedRendererManager.setCurrent(SharedSpriteRenderer.getTarget());
 	SharedSpriteRenderer.push(
 		_vertices.data(), _vertices.size(),
 		_indices.data(), _indices.size(),
 		_effect, _texture, renderState);
+
+	Node::render();
 }
 
 const Matrix& DBSlotNode::getWorld() {
@@ -560,6 +585,7 @@ void DragonBone::render() {
 			}
 		}
 	}
+	Node::render();
 }
 
 void DragonBone::cleanup() {