Add OpenGL-backed 3D visualization with Python bindings and PyQt integration

[Copilot]

The app needed a basic 3D renderer exposed from C++ via pybindings and embedded into the PyQt UI to visualize simple objects (e.g., a cube).

• C++ OpenGL backend

  • Added Renderer3D with a minimal cube pipeline (clear color, basic projection, immediate-mode cube draw).
  • Linked OpenGL and made pybind11 available via submodule or FetchContent fallback.
  • Exposed renderer controls (set_clear_color, render_cube) through pybind11.

• Python bindings/utilities

  • Added create_renderer3d helper in cpp_extensions to construct the C++ renderer with optional clear color.
  • Updated bindings to include Renderer3D.

• UI integration

  • Added VisualizationWindow (QOpenGLWidget) with simple rotation control and status text.
  • Wired a new “3D View” entry in the side panel to display the visualization card in the main content area.
  • Documented OpenGL dev dependency in README.

Example (Python):

from utils import cpp_extensions

renderer = cpp_extensions.create_renderer3d((0.05, 0.09, 0.14, 1.0))
if renderer:
    renderer.set_clear_color(0.1, 0.2, 0.3, 1.0)
    # Called within an active OpenGL context (e.g., QOpenGLWidget.paintGL)
    renderer.render_cube(25.0, 35.0, 4.0, width=800, height=600)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• esm.ubuntu.com
  • Triggering command: /usr/lib/apt/methods/https /usr/lib/apt/methods/https (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Equip C++ with OpenGL for 3D Visualization and PyBindings Integration</issue_title>
<issue_description>Feature Overview

• Integrate OpenGL (or another suitable library, e.g., Vulkan, Ogre) into the C++ core to support 3D visualization capabilities within the project.
• Implement a basic 3D image renderer as a proof of concept, such as displaying a simple 3D model (cube, sphere, or car model).
• Expose the 3D rendering functionality to Python via pybindings, enabling straightforward interaction from the Python layer.
• Integrate the new 3D visualization features into the top-level PyQT UI so that 3D objects can be visualized directly in the application’s interface.

Acceptance Criteria

• C++ codebase includes OpenGL (or selected library) with a working basic 3D rendering pipeline.
• At least one demonstrative 3D object is rendered (such as a cube or a simple car representation).
• Python pybindings are created for core 3D visualization routines.
• PyQT UI is extended to display the rendered 3D scene/object within a GUI window.

Notes

• Consider cross-platform compatibility in the choice of the 3D library.
• Optional: Modularize the rendering code to allow easy future expansion (lighting, input, more complex objects, etc.).</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Equip C++ with OpenGL for 3D Visualization and PyBindings Integration #26

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[cduarte0306]

@copilot How does my system find OpenGL? No need to pull the library?

[Copilot]

@copilot How does my system find OpenGL? No need to pull the library?

CMake uses FindOpenGL to locate the system OpenGL SDK; nothing is bundled. On Linux install headers like libgl1-mesa-dev libglu1-mesa-dev (already used in CI); on Windows it links against the platform OpenGL32.lib that ships with the OS/SDK; on macOS it uses the system OpenGL framework. Pybind is fetched if the submodule is missing, but OpenGL must be present on the host. UI capture of the new 3D view (headless capture; rendering disabled without a GL context): https://github.com/user-attachments/assets/390254b0-2018-4cba-b6cb-31707339c760