renderer: refactor to address the stencil buffer issues (#92)

- Introduce new `ContextGLHost`/`ContextGLApp` classes and rename storage methods (`on*`) to replace legacy context storage.
- Add `iterateContentRenderers` API and extend inspector with a `/json/statistics` endpoint.
- Add framebuffer‐attachment helpers, update debug output (including stencil state), and adjust project build/configuration files.

Author: yorkie

.vscode/c_cpp_properties.json

@@ -12,6 +12,34 @@
             "cppStandard": "c++20",
             "intelliSenseMode": "macos-clang-arm64",
             "configurationProvider": "ms-vscode.cmake-tools"
+        },
+        {
+            "name": "Android",
+            "defines": [
+                "ANDROID",
+                "__ANDROID__",
+                "__ANDROID_API__=26"
+            ],
+            "compilerPath": "${env:ANDROID_NDK_HOME}/toolchains/llvm/prebuilt/darwin-x86_64/bin/aarch64-linux-android26-clang++",
+            "compileCommands": "${workspaceFolder}/build/targets/android/compile_commands.json",
+            "cStandard": "c17",
+            "cppStandard": "c++20",
+            "intelliSenseMode": "linux-gcc-arm64",
+            "includePath": [
+                "${env:ANDROID_NDK_HOME}/toolchains/llvm/prebuilt/darwin-x86_64/sysroot/usr/include",
+                "${env:ANDROID_NDK_HOME}/toolchains/llvm/prebuilt/darwin-x86_64/sysroot/usr/include/aarch64-linux-android",
+                "${env:ANDROID_NDK_HOME}/sources/cxx-stl/llvm-libc++/include",
+                "${env:ANDROID_NDK_HOME}/sources/android/support/include"
+            ],
+            "browse": {
+                "path": [
+                    "${workspaceFolder}",
+                    "${env:ANDROID_NDK_HOME}/toolchains/llvm/prebuilt/darwin-x86_64/sysroot/usr/include",
+                    "${env:ANDROID_NDK_HOME}/sources/cxx-stl/llvm-libc++/include"
+                ],
+                "limitSymbolsToIncludedHeaders": true
+            },
+            "configurationProvider": "ms-vscode.cmake-tools"
         }
     ],
     "version": 4

build/configure.sh

@@ -234,6 +234,7 @@ CMAKE_CMD=(
   -S "$SOURCE_DIR"
   -B "$BUILD_DIR"
   -DCMAKE_BUILD_TYPE="$BUILD_TYPE"
+  -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
 )
 
 # Add platform-specific parameters
@@ -249,7 +250,6 @@ elif [[ $TARGET == "darwin" ]]; then
     -G "$GENERATOR"
     -DCMAKE_CXX_COMPILER="$CXX_COMPILER"
     -DCMAKE_OSX_DEPLOYMENT_TARGET="$OSX_DEPLOYMENT_TARGET"
-    -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
   )
 fi
 

makefile

@@ -24,11 +24,6 @@ CRATES_FORCE_REBUILD ?= no
 # Define the INSPECTOR flag (default is no) that will build the inspector
 INSPECTOR ?= no
 
-# Update the flags if RELEASE is set to yes
-ifeq ($(RELEASE), yes)
-	CLEAN := yes
-endif
-
 # This makefile defines a function `build_crates` to build Rust crates using Cargo.
 # 
 # Usage:

src/client/builtin_scene/texture_altas.cpp

@@ -42,16 +42,12 @@ namespace builtin_scene
       }
 
       // Initialize the texture atlas with the default values.
-      glContext->texImage3D(WebGLTexture3DTarget::kTexture2DArray,
-                            0,
-                            WEBGL2_RGBA8,
-                            width,
-                            height,
-                            kMaxLayerCount,
-                            0,
-                            WebGLTextureFormat::kRGBA,
-                            WebGLPixelType::kUnsignedByte,
-                            nullptr);
+      glContext->texStorage3D(WebGLTexture3DTarget::kTexture2DArray,
+                              1,
+                              WEBGL2_RGBA8,
+                              width,
+                              height,
+                              kMaxLayerCount);
       glContext->generateMipmap(WebGLTextureTarget::kTexture2DArray);
     }
     glContext->bindTexture(WebGLTextureTarget::kTexture2DArray, nullptr);

src/common/classes.hpp

@@ -7,6 +7,9 @@ class TrContentRuntime;
 class TrSoundSource;
 class TrMediaManager;
 
+// Inspector classes
+class TrInspector;
+
 namespace renderer
 {
   class TrRenderer;

src/common/debug.hpp

@@ -53,6 +53,13 @@ IUnityLog *GET_UNITY_LOG_HANDLE();
 #define LOG_TAG_CLIENT_CANVAS "jsar.client.canvas"
 #endif
 
+/**
+ * Enable the performance counter for the runtime statistics.
+ */
+#define TR_ENABLE_PERF_COUNTER 1
+// Uncomment the following line to enable performance counter for the runtime statistics.
+#undef TR_ENABLE_PERF_COUNTER
+
 /**
  * Print a debug message to the console.
  */

src/examples/desktop_opengl.cpp

@@ -161,10 +161,12 @@ namespace jsar::example
         }
       }
 
-      glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
-      glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
-      glfwWindowHint(GLFW_SAMPLES, samples);
+      glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 4);
+      glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 1);
       glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);
+      glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);
+      glfwWindowHint(GLFW_RESIZABLE, GLFW_FALSE);
+      glfwWindowHint(GLFW_SAMPLES, samples);
 
       if (width == -1 || height == -1)
       {
@@ -229,7 +231,11 @@ namespace jsar::example
 
       // Make the context available before starting the embedder
       glfwMakeContextCurrent(windowCtx_->window);
+      glfwSwapInterval(1);
       {
+        auto version = glGetString(GL_VERSION);
+        fprintf(stdout, "OpenGL version: %s\n", version);
+
         // Get environment variables for OpenGL context
         const char *str = getenv("JSAR_DISABLE_MULTISAMPLE");
         if (str != NULL && strcmp(str, "1") == 0)