Better Camera, Cleaner Math, Tighter CI

[halx99]

We are excited to announce a significant refactoring batch that touches the core of the engine. PR #3228 improves camera handling, simplifies the math module, modernizes pointer events, and tightens our CI pipeline.

---

🎯 Camera Now in Control

The biggest change: the camera is no longer a second-class citizen driven by Director::setProjection(). Instead, Camera::create() now accepts an explicit CameraMode parameter:

auto camera = Camera::create(CameraMode::Classic);

The old initDefault() is renamed to initClassic() to better reflect what it does. We also removed the deprecated axmol.gl.projection env var and the Director::setProjection / Director::screenToWorld / Director::worldToScreen methods — all camera math now lives on the Camera class where it belongs.

---

🖱️ PointerEvent Gets a Clean API

The PointerEvent API has been renamed for clarity. The confusing getLocation() (which returned a world position) is now getWorldPoint(), and getScreenLocation() is now simply getPoint():

Before	After
getScreenLocation()	getPoint()
getPreviousScreenLocation()	getPrevPoint()
getStartScreenLocation()	getStartPoint()
getLocation()	getWorldPoint()
getPreviousLocation()	getPrevWorldPoint()
getStartLocation()	getStartWorldPoint()

World point computation now uses the per-camera ray (Camera::screenToRay) instead of the old Director::screenToWorld(), producing more accurate results in multi-camera setups.

---

🧮 Math Module Unlocked

AABB, Frustum, OBB, Plane, and Ray have moved from axmol/3d/ to axmol/math/ — they are no longer gated behind AX_ENABLE_3D. This means 3D math types are available everywhere without conditional compilation.

At the same time, axmol/base/Types.h has been slimmed down: vertex structs like Tex2F, Quad2, Quad3 were moved to axmol/math/Vertex.h.

---

🔧 Hit Testing Simplified

The hit-testing path in EventDispatcher was streamlined. The camera parameter was removed from onPointerHitTest callbacks since the camera is already accessible via event->getCamera(). The ray is now set automatically on the event before dispatch, so nodes only need to check event->getRay().

---

🧹 CI & Code Quality

• check-sources.ps1 — a new script validates that no source file contains a UTF-8 BOM and that all include guards follow the cstd convention.
• clang-format.yml renamed to source-tidy.yml and now runs both clang-format and the source checks in one job.
• BOM was removed from 2441 source files — this eliminates cross-platform build issues (especially with GCC PCH).

---

📦 Full Stats

• 569 files touched
• ~1955 insertions, ~2004 deletions
• New 3D project template in templates/cpp/3d/

Check the full diff for details.