Add CUDA-Graphics (OpenGL) interop support to cuda.core (#1608)

* initial commit, plasma effect is rendering

* removing the stream.sync

* broken merge

* Adding the nvrtc dependency to tests

* Disabled vsync and reporting FPS and frame time

* Including the resolution in the title update

* Fix pre-commit lint issues in graphics interop files

- Remove unused GraphicsResourceHandle cimport (cython-lint)
- Split long f-string to stay within 120-char line limit (ruff E501)
- Rename unused variable buf to _buf (ruff F841)
- Add noqa: S110 to intentional try-except-pass in test cleanup
- Apply ruff auto-fixes (import sorting, formatting)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: rparolin

cuda_core/cuda/core/__init__.py

@@ -37,6 +37,7 @@
     GraphCompleteOptions,
     GraphDebugPrintOptions,
 )
+from cuda.core._graphics import GraphicsResource  # noqa: E402
 from cuda.core._launch_config import LaunchConfig  # noqa: E402
 from cuda.core._launcher import launch  # noqa: E402
 from cuda.core._layout import _StridedLayout  # noqa: E402

cuda_core/cuda/core/_cpp/resource_handles.cpp

@@ -56,12 +56,16 @@ decltype(&cuLibraryLoadData) p_cuLibraryLoadData = nullptr;
 decltype(&cuLibraryUnload) p_cuLibraryUnload = nullptr;
 decltype(&cuLibraryGetKernel) p_cuLibraryGetKernel = nullptr;
 
+// GL interop pointers
+decltype(&cuGraphicsUnregisterResource) p_cuGraphicsUnregisterResource = nullptr;
+
 // NVRTC function pointers
 decltype(&nvrtcDestroyProgram) p_nvrtcDestroyProgram = nullptr;
 
 // NVVM function pointers (may be null if NVVM is not available)
 NvvmDestroyProgramFn p_nvvmDestroyProgram = nullptr;
 
+
 // ============================================================================
 // GIL management helpers
 // ============================================================================
@@ -808,6 +812,28 @@ KernelHandle create_kernel_handle_ref(CUkernel kernel, const LibraryHandle& h_li
     return KernelHandle(box, &box->resource);
 }
 
+// ============================================================================
+// Graphics Resource Handles
+// ============================================================================
+
+namespace {
+struct GraphicsResourceBox {
+    CUgraphicsResource resource;
+};
+}  // namespace
+
+GraphicsResourceHandle create_graphics_resource_handle(CUgraphicsResource resource) {
+    auto box = std::shared_ptr<const GraphicsResourceBox>(
+        new GraphicsResourceBox{resource},
+        [](const GraphicsResourceBox* b) {
+            GILReleaseGuard gil;
+            p_cuGraphicsUnregisterResource(b->resource);
+            delete b;
+        }
+    );
+    return GraphicsResourceHandle(box, &box->resource);
+}
+
 // ============================================================================
 // NVRTC Program Handles
 // ============================================================================

cuda_core/cuda/core/_cpp/resource_handles.hpp

@@ -72,6 +72,9 @@ extern decltype(&cuLibraryLoadData) p_cuLibraryLoadData;
 extern decltype(&cuLibraryUnload) p_cuLibraryUnload;
 extern decltype(&cuLibraryGetKernel) p_cuLibraryGetKernel;
 
+// Graphics interop
+extern decltype(&cuGraphicsUnregisterResource) p_cuGraphicsUnregisterResource;
+
 // ============================================================================
 // NVRTC function pointers
 //
@@ -104,9 +107,11 @@ using EventHandle = std::shared_ptr<const CUevent>;
 using MemoryPoolHandle = std::shared_ptr<const CUmemoryPool>;
 using LibraryHandle = std::shared_ptr<const CUlibrary>;
 using KernelHandle = std::shared_ptr<const CUkernel>;
+using GraphicsResourceHandle = std::shared_ptr<const CUgraphicsResource>;
 using NvrtcProgramHandle = std::shared_ptr<const nvrtcProgram>;
 using NvvmProgramHandle = std::shared_ptr<const nvvmProgram>;
 
+
 // ============================================================================
 // Context handle functions
 // ============================================================================
@@ -306,6 +311,15 @@ KernelHandle create_kernel_handle(const LibraryHandle& h_library, const char* na
 // Use for borrowed kernels. The library handle keeps the library alive.
 KernelHandle create_kernel_handle_ref(CUkernel kernel, const LibraryHandle& h_library);
 
+// ============================================================================
+// Graphics resource handle functions
+// ============================================================================
+
+// Create an owning graphics resource handle.
+// When the last reference is released, cuGraphicsUnregisterResource is called automatically.
+// Use for CUgraphicsResource handles obtained from cuGraphicsGLRegisterBuffer etc.
+GraphicsResourceHandle create_graphics_resource_handle(CUgraphicsResource resource);
+
 // ============================================================================
 // NVRTC Program handle functions
 // ============================================================================
@@ -366,6 +380,10 @@ inline CUkernel as_cu(const KernelHandle& h) noexcept {
     return h ? *h : nullptr;
 }
 
+inline CUgraphicsResource as_cu(const GraphicsResourceHandle& h) noexcept {
+    return h ? *h : nullptr;
+}
+
 inline nvrtcProgram as_cu(const NvrtcProgramHandle& h) noexcept {
     return h ? *h : nullptr;
 }
@@ -404,6 +422,10 @@ inline std::intptr_t as_intptr(const KernelHandle& h) noexcept {
     return reinterpret_cast<std::intptr_t>(as_cu(h));
 }
 
+inline std::intptr_t as_intptr(const GraphicsResourceHandle& h) noexcept {
+    return reinterpret_cast<std::intptr_t>(as_cu(h));
+}
+
 inline std::intptr_t as_intptr(const NvrtcProgramHandle& h) noexcept {
     return reinterpret_cast<std::intptr_t>(as_cu(h));
 }
@@ -464,4 +486,8 @@ inline PyObject* as_py(const NvvmProgramHandle& h) noexcept {
     return PyLong_FromSsize_t(as_intptr(h));
 }
 
+inline PyObject* as_py(const GraphicsResourceHandle& h) noexcept {
+    return detail::make_py("cuda.bindings.driver", "CUgraphicsResource", as_intptr(h));
+}
+
 }  // namespace cuda_core

cuda_core/cuda/core/_graphics.pxd

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+from cuda.core._resource_handles cimport GraphicsResourceHandle
+
+
+cdef class GraphicsResource:
+
+    cdef:
+        GraphicsResourceHandle _handle
+        bint _mapped
+
+    cpdef close(self)