- Adding a CMake utility function to setup debugger environments so that the debugger can locate the run-time dependencies. This makes it possible to compile and launch the projects directly within visual studio for example.

cozdas · cozdas · commit bf78dabf1713 · 2026-02-03T10:42:52.000-08:00
- Calling the above function in projects that need it.

Signed-off-by: cuneyt.ozdas &lt;cuneyt.ozdas@autodesk.com&gt;
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -349,6 +349,11 @@ endif()
 
 include(CompilerFlags)
 
+###############################################################################
+# Include utility functions for setting debugging environments
+
+include(DebuggerEnvironment)
+
 ###############################################################################
 # External linking options
 
diff --git a/share/cmake/utils/DebuggerEnvironment.cmake b/share/cmake/utils/DebuggerEnvironment.cmake
@@ -0,0 +1,27 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright Contributors to the OpenColorIO Project.
+
+
+###############################################################################
+# Define a function to set debugger environment so that the run time 
+# dependencies can be located by the debugger.
+
+function(set_debugger_env target_name)
+    cmake_parse_arguments(ARG "NEEDS_GL" "" "" ${ARGN})
+
+    if(NOT TARGET ${target_name})
+        message(FATAL_ERROR "set_debugger_env: '${target_name}' is not a CMake target")
+    endif()
+
+    # Set the Paths for Visual Studio IDE Debugger.
+    if(MSVC)
+        if(OCIO_GL_ENABLED AND ARG_NEEDS_GL)
+            # Add folders for glut and glew DLLs.
+            set(extra_dirs "${GLUT_INCLUDE_DIR}/../bin;${GLEW_INCLUDE_DIRS}/../bin")
+        endif()
+
+        set_property(TARGET ${target_name} PROPERTY
+            VS_DEBUGGER_ENVIRONMENT "PATH=$<JOIN:$<TARGET_RUNTIME_DLL_DIRS:${target_name}>,;>;${extra_dirs};%PATH%"
+        )
+    endif()
+endfunction()
diff --git a/src/apps/ocioarchive/CMakeLists.txt b/src/apps/ocioarchive/CMakeLists.txt
@@ -30,3 +30,7 @@ ocio_strip_binary(ocioarchive)
 install(TARGETS ocioarchive
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ocioarchive)
diff --git a/src/apps/ociobakelut/CMakeLists.txt b/src/apps/ociobakelut/CMakeLists.txt
@@ -39,3 +39,7 @@ ocio_strip_binary(ociobakelut)
 install(TARGETS ociobakelut
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociobakelut)
diff --git a/src/apps/ociocheck/CMakeLists.txt b/src/apps/ociocheck/CMakeLists.txt
@@ -28,3 +28,7 @@ ocio_strip_binary(ociocheck)
 install(TARGETS ociocheck
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociocheck)
diff --git a/src/apps/ociochecklut/CMakeLists.txt b/src/apps/ociochecklut/CMakeLists.txt
@@ -36,3 +36,7 @@ ocio_strip_binary(ociochecklut)
 install(TARGETS ociochecklut
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociochecklut NEEDS_GL)
diff --git a/src/apps/ocioconvert/CMakeLists.txt b/src/apps/ocioconvert/CMakeLists.txt
@@ -40,3 +40,7 @@ ocio_strip_binary(ocioconvert)
 install(TARGETS ocioconvert
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ocioconvert NEEDS_GL)
diff --git a/src/apps/ociodisplay/CMakeLists.txt b/src/apps/ociodisplay/CMakeLists.txt
@@ -53,3 +53,7 @@ ocio_strip_binary(ociodisplay)
 install(TARGETS ociodisplay
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociodisplay NEEDS_GL)
diff --git a/src/apps/ociolutimage/CMakeLists.txt b/src/apps/ociolutimage/CMakeLists.txt
@@ -33,3 +33,7 @@ ocio_strip_binary(ociolutimage)
 install(TARGETS ociolutimage
 	RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociolutimage)
diff --git a/src/apps/ociomakeclf/CMakeLists.txt b/src/apps/ociomakeclf/CMakeLists.txt
@@ -29,3 +29,7 @@ ocio_strip_binary(ociomakeclf)
 install(TARGETS ociomakeclf
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociomakeclf)
diff --git a/src/apps/ociomergeconfigs/CMakeLists.txt b/src/apps/ociomergeconfigs/CMakeLists.txt
@@ -30,3 +30,7 @@ ocio_strip_binary(ociomergeconfigs)
 install(TARGETS ociomergeconfigs
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociomergeconfigs)
diff --git a/src/apps/ocioperf/CMakeLists.txt b/src/apps/ocioperf/CMakeLists.txt
@@ -25,3 +25,7 @@ ocio_strip_binary(ocioperf)
 install(TARGETS ocioperf
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ocioperf)
diff --git a/src/apps/ociowrite/CMakeLists.txt b/src/apps/ociowrite/CMakeLists.txt
@@ -24,3 +24,7 @@ ocio_strip_binary(ociowrite)
 install(TARGETS ociowrite
     RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
 )
+
+# Set the debugger environment so that the executable can be launched
+# directly within IDE (e.g. Visual Studio).
+set_debugger_env(ociowrite)
diff --git a/tests/gpu/CMakeLists.txt b/tests/gpu/CMakeLists.txt
@@ -48,16 +48,20 @@ endif()
 
 # Note: To avoid changing PATH from outside the cmake files.
 if(MSVC AND BUILD_SHARED_LIBS)
+	# Build time list of runtime dll dirs for the exe target.
+	set(dll_dirs_expr "$<JOIN:$<TARGET_RUNTIME_DLL_DIRS:test_gpu_exec>,;>")
 
-    if (MSVC_IDE)
-        # Note: By default Microsoft Visual Studio editor happens the build type to the build directory.
-        set(BUILD_TYPE ${CMAKE_BUILD_TYPE})
-    endif()
+	# Add folders for glut and glew DLLs.
+	set(extra_dirs "${GLUT_INCLUDE_DIR}/../bin;${GLEW_INCLUDE_DIRS}/../bin")
 
-    set(NEW_PATH "${PROJECT_BINARY_DIR}/src/OpenColorIO/${BUILD_TYPE}")
-    set(NEW_PATH "${NEW_PATH}\\\;${GLUT_INCLUDE_DIR}/../bin")
-    set(NEW_PATH "${NEW_PATH}\\\;${GLEW_INCLUDE_DIRS}/../bin")
-
-    set_tests_properties(test_gpu PROPERTIES ENVIRONMENT PATH=${NEW_PATH})
+	# Tell CTest to use this PATH while launching test_gpu_exec
+	set_tests_properties(test_gpu PROPERTIES
+		ENVIRONMENT "PATH=${dll_dirs_expr};${extra_dirs};$ENV{PATH}"
+	)
 
+	# Also set the debugger environment so that you can launch 
+	# test_gpu_exec directly within Visual Studio.
+	set_property(TARGET test_gpu_exec PROPERTY
+		VS_DEBUGGER_ENVIRONMENT "PATH=${dll_dirs_expr};${extra_dirs};%PATH%"
+	)
 endif()

Original file line number	Diff line number	Diff line change
`@@ -30,3 +30,7 @@ ocio_strip_binary(ocioarchive)`
`30`	`30`	`install(TARGETS ocioarchive`
`31`	`31`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`32`	`32`	`)`
	`33`	`+`
	`34`	`+# Set the debugger environment so that the executable can be launched`
	`35`	`+# directly within IDE (e.g. Visual Studio).`
	`36`	`+set_debugger_env(ocioarchive)`
Original file line number	Diff line number	Diff line change
`@@ -39,3 +39,7 @@ ocio_strip_binary(ociobakelut)`
`39`	`39`	`install(TARGETS ociobakelut`
`40`	`40`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`41`	`41`	`)`
	`42`	`+`
	`43`	`+# Set the debugger environment so that the executable can be launched`
	`44`	`+# directly within IDE (e.g. Visual Studio).`
	`45`	`+set_debugger_env(ociobakelut)`
Original file line number	Diff line number	Diff line change
`@@ -28,3 +28,7 @@ ocio_strip_binary(ociocheck)`
`28`	`28`	`install(TARGETS ociocheck`
`29`	`29`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`30`	`30`	`)`
	`31`	`+`
	`32`	`+# Set the debugger environment so that the executable can be launched`
	`33`	`+# directly within IDE (e.g. Visual Studio).`
	`34`	`+set_debugger_env(ociocheck)`
Original file line number	Diff line number	Diff line change
`@@ -36,3 +36,7 @@ ocio_strip_binary(ociochecklut)`
`36`	`36`	`install(TARGETS ociochecklut`
`37`	`37`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`38`	`38`	`)`
	`39`	`+`
	`40`	`+# Set the debugger environment so that the executable can be launched`
	`41`	`+# directly within IDE (e.g. Visual Studio).`
	`42`	`+set_debugger_env(ociochecklut NEEDS_GL)`
Original file line number	Diff line number	Diff line change
`@@ -40,3 +40,7 @@ ocio_strip_binary(ocioconvert)`
`40`	`40`	`install(TARGETS ocioconvert`
`41`	`41`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`42`	`42`	`)`
	`43`	`+`
	`44`	`+# Set the debugger environment so that the executable can be launched`
	`45`	`+# directly within IDE (e.g. Visual Studio).`
	`46`	`+set_debugger_env(ocioconvert NEEDS_GL)`
Original file line number	Diff line number	Diff line change
`@@ -53,3 +53,7 @@ ocio_strip_binary(ociodisplay)`
`53`	`53`	`install(TARGETS ociodisplay`
`54`	`54`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`55`	`55`	`)`
	`56`	`+`
	`57`	`+# Set the debugger environment so that the executable can be launched`
	`58`	`+# directly within IDE (e.g. Visual Studio).`
	`59`	`+set_debugger_env(ociodisplay NEEDS_GL)`
Original file line number	Diff line number	Diff line change
`@@ -33,3 +33,7 @@ ocio_strip_binary(ociolutimage)`
`33`	`33`	`install(TARGETS ociolutimage`
`34`	`34`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`35`	`35`	`)`
	`36`	`+`
	`37`	`+# Set the debugger environment so that the executable can be launched`
	`38`	`+# directly within IDE (e.g. Visual Studio).`
	`39`	`+set_debugger_env(ociolutimage)`
Original file line number	Diff line number	Diff line change
`@@ -29,3 +29,7 @@ ocio_strip_binary(ociomakeclf)`
`29`	`29`	`install(TARGETS ociomakeclf`
`30`	`30`	`RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}`
`31`	`31`	`)`
	`32`	`+`
	`33`	`+# Set the debugger environment so that the executable can be launched`
	`34`	`+# directly within IDE (e.g. Visual Studio).`
	`35`	`+set_debugger_env(ociomakeclf)`