Mark Target::OpenGL (etc) as deprecated (#5475)

src/JITModule.cpp

@@ -602,14 +602,14 @@ enum RuntimeKind {
     OpenCL,
     Metal,
     CUDA,
-    OpenGL,
+    OpenGL,  // NOTE: this feature is deprecated and will be removed in Halide 12.
     OpenGLCompute,
     Hexagon,
     D3D12Compute,
     OpenCLDebug,
     MetalDebug,
     CUDADebug,
-    OpenGLDebug,
+    OpenGLDebug,  // NOTE: this feature is deprecated and will be removed in Halide 12.
     OpenGLComputeDebug,
     HexagonDebug,
     D3D12ComputeDebug,

src/Module.cpp

@@ -557,6 +557,10 @@ std::map<std::string, std::string> Module::get_metadata_name_map() const {
 void Module::compile(const std::map<Output, std::string> &output_files) const {
     validate_outputs(output_files);
 
+    if (target().has_feature(Target::OpenGL)) {
+        user_warning << "WARNING: OpenGL is deprecated in Halide 11 and will be removed in Halide 12.\n";
+    }
+
     // output stmt and html prior to resolving submodules. We need to
     // clear the output after writing it, otherwise the output will
     // be overwritten by recursive calls after submodules are resolved.

src/Pipeline.cpp

@@ -1075,6 +1075,10 @@ void Pipeline::realize(RealizationArg outputs, const Target &t,
     Target target = t;
     user_assert(defined()) << "Can't realize an undefined Pipeline\n";
 
+    if (t.has_feature(Target::OpenGL)) {
+        user_warning << "WARNING: OpenGL is deprecated in Halide 11 and will be removed in Halide 12.\n";
+    }
+
     debug(2) << "Realizing Pipeline for " << target << "\n";
 
     if (target.has_unknowns()) {

src/Target.h

@@ -82,7 +82,7 @@ struct Target {
         CLDoubles = halide_target_feature_cl_doubles,
         CLHalf = halide_target_feature_cl_half,
         CLAtomics64 = halide_target_feature_cl_atomic64,
-        OpenGL = halide_target_feature_opengl,
+        OpenGL = halide_target_feature_opengl,  // NOTE: this feature is deprecated and will be removed in Halide 12.
         OpenGLCompute = halide_target_feature_openglcompute,
         EGL = halide_target_feature_egl,
         UserContext = halide_target_feature_user_context,

src/runtime/HalideRuntime.h

@@ -1274,7 +1274,7 @@ typedef enum halide_target_feature_t {
     halide_target_feature_cl_doubles,   ///< Enable double support on OpenCL targets
     halide_target_feature_cl_atomic64,  ///< Enable 64-bit atomics operations on OpenCL targets
 
-    halide_target_feature_opengl,         ///< Enable the OpenGL runtime.
+    halide_target_feature_opengl,         ///< Enable the OpenGL runtime. NOTE: this feature is deprecated and will be removed in Halide 12.
     halide_target_feature_openglcompute,  ///< Enable OpenGL Compute runtime.
 
     halide_target_feature_user_context,  ///< Generated code takes a user_context pointer as first argument

src/runtime/HalideRuntimeOpenGL.h

@@ -18,14 +18,17 @@ extern "C" {
 
 #define HALIDE_RUNTIME_OPENGL
 
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern const struct halide_device_interface_t *halide_opengl_device_interface();
 
 /** These are forward declared here to allow clients to override the
  *  Halide Glsl runtime. Do not call them. */
 // @{
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern int halide_opengl_initialize_kernels(void *user_context, void **state_ptr,
                                             const char *src, int size);
 
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern int halide_opengl_run(void *user_context,
                              void *state_ptr,
                              const char *entry_name,
@@ -47,6 +50,7 @@ extern int halide_opengl_run(void *user_context,
  * must be NULL when this routine is called. This call can fail due to
  * being passed an invalid texture. The device and host dirty bits are
  * left unmodified. */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern int halide_opengl_wrap_texture(void *user_context, struct halide_buffer_t *buf, uint64_t texture_id);
 
 /** Set the underlying OpenGL texture for a buffer to refer to the
@@ -56,6 +60,7 @@ extern int halide_opengl_wrap_texture(void *user_context, struct halide_buffer_t
  * the halide_buffer_t must be NULL when this routine is called. This
  * call can fail due to running out of memory. The device and host
  * dirty bits are left unmodified. */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern int halide_opengl_wrap_render_target(void *user_context, struct halide_buffer_t *buf);
 
 /** Disconnect this halide_buffer_t from the texture it was previously
@@ -65,6 +70,7 @@ extern int halide_opengl_wrap_render_target(void *user_context, struct halide_bu
  * device pointer, but does not free the texture.  The dev field of
  * the halide_buffer_t will be NULL on return.
  */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern int halide_opengl_detach_texture(void *user_context, struct halide_buffer_t *buf);
 
 /** Return the underlying texture for a halide_buffer_t. This buffer
@@ -73,19 +79,23 @@ extern int halide_opengl_detach_texture(void *user_context, struct halide_buffer
  *  or if the buffer was wrapped via
  *  halide_opengl_wrap_render_target(), this returns 0.
  */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern uintptr_t halide_opengl_get_texture(void *user_context, struct halide_buffer_t *buf);
 
 /** Forget all state associated with the previous OpenGL context.  This is
  * similar to halide_opengl_release, except that we assume that all OpenGL
  * resources have already been reclaimed by the OS. */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 extern void halide_opengl_context_lost(void *user_context);
 
 /** This functions MUST be provided by the host environment to retrieve pointers
  *  to OpenGL API functions. */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 void *halide_opengl_get_proc_address(void *user_context, const char *name);
 
 /** This functions MUST be provided by the host environment to create an OpenGL
  *  context for use by the OpenGL backend. */
+HALIDE_ATTRIBUTE_DEPRECATED("OpenGL is deprecated in Halide 11 and will be removed in Halide 12")
 int halide_opengl_create_context(void *user_context);
 
 #ifdef __cplusplus

src/runtime/opengl.cpp

@@ -1,3 +1,6 @@
+// Ignore deprecation warnings inside our own runtime
+#define HALIDE_ALLOW_DEPRECATED 1
+
 #include "HalideRuntimeOpenGL.h"
 #include "device_interface.h"
 #include "mini_opengl.h"

src/runtime/runtime_api.cpp

@@ -1,3 +1,6 @@
+// Ignore deprecation warnings inside our own runtime
+#define HALIDE_ALLOW_DEPRECATED 1
+
 #include "HalideRuntime.h"
 #include "HalideRuntimeCuda.h"
 #include "HalideRuntimeD3D12Compute.h"