Dear ImGui port of Image Viewer (imiv) with Vulkan/Metal/OpenGL backends for Windowns/Linux/MacOS

.clang-format

@@ -1,4 +1,4 @@
-Language:        Cpp
+---
 BasedOnStyle:  WebKit
 
 AccessModifierOffset: -4
@@ -121,11 +121,17 @@ SpacesInContainerLiterals: true
 SpacesInCStyleCastParentheses: false
 SpacesInParentheses: false
 SpacesInSquareBrackets: false
-Standard:        c++17
 StatementMacros: 
   - Q_UNUSED
   - QT_REQUIRE_VERSION
 TabWidth:        8
 UseTab:          Never
 #...
 
+---
+Language:        Cpp
+Standard:        c++17
+
+---
+Language:        ObjC
+Standard:        c++17

.gitignore

@@ -30,3 +30,5 @@ gastest.o
 /*.log
 
 
+/build_*
+/bld

CMakeLists.txt

@@ -285,6 +285,7 @@ if (OIIO_BUILD_TOOLS AND NOT BUILD_OIIOUTIL_ONLY)
     add_subdirectory (src/idiff)
     add_subdirectory (src/igrep)
     add_subdirectory (src/iinfo)
+    add_subdirectory (src/imiv)
     add_subdirectory (src/maketx)
     add_subdirectory (src/oiiotool)
     add_subdirectory (src/testtex)

docs/dev/AI_Policy.md

@@ -1,5 +1,4 @@
 Policy on AI Coding Assistants
-==============================
 
 - Initial policy merged 23-Mar-2026
 

src/build-scripts/run-clang-format.bash

@@ -12,7 +12,7 @@ CLANG_FORMAT_EXE=${CLANG_FORMAT_EXE:="clang-format"}
 echo "Running " `which clang-format` " version " `${CLANG_FORMAT_EXE} --version`
 
 files=`find ./{src,testsuite} \( -name '*.h' -o -name '*.cpp' \) -print \
-       | grep -Ev 'pugixml|SHA1|farmhash.cpp|libdpx|libcineon|bcdec.h|gif.h|stb_sprintf.h'`
+       | grep -Ev 'pugixml|SHA1|farmhash.cpp|libdpx|libcineon|bcdec.h|gif.h|src/imiv/external/dnd_glfw/|stb_sprintf.h'`
 
 
 ${CLANG_FORMAT_EXE}  -i -style=file $files

src/cmake/compiler.cmake

@@ -617,6 +617,7 @@ if (PROJECT_IS_TOP_LEVEL)
                                "src/cineon.imageio/libcineon/*"
                                "src/dds.imageio/bcdec.h"
                                "src/gif.imageio/gif.h"
+                               "src/imiv/external/dnd_glfw/*"
                                "src/libutil/stb_sprintf.h"
          CACHE STRING "Glob patterns to exclude for clang-format")
     find_program (CLANG_FORMAT_EXE

src/cmake/dependency_utils.cmake

@@ -51,6 +51,7 @@ set_option (${PROJECT_NAME}_DEPENDENCY_BUILD_ALLOW_UNVERIFIED_TAGS
 # Track all build deps we find with checked_find_package
 set (CFP_ALL_BUILD_DEPS_FOUND "")
 set (CFP_EXTERNAL_BUILD_DEPS_FOUND "")
+set (CFP_CUSTOM_BUILD_DEPS_FOUND "")
 
 # Track all build deps we failed to find with checked_find_package
 set (CFP_ALL_BUILD_DEPS_NOTFOUND "")
@@ -81,6 +82,44 @@ endfunction ()
 
 
 
+# Helper: record the final status of a dependency that is discovered outside
+# checked_find_package(), so it still shows up in the dependency summary.
+macro (record_build_dependency pkgname)
+    cmake_parse_arguments(_pkg
+        "FOUND;NOTFOUND;REQUIRED"
+        "VERSION;NOT_FOUND_EXPLANATION"
+        ""
+        ${ARGN})
+    if ((_pkg_FOUND AND _pkg_NOTFOUND)
+        OR (NOT _pkg_FOUND AND NOT _pkg_NOTFOUND))
+        message (FATAL_ERROR
+                 "record_build_dependency(${pkgname}) requires exactly one of FOUND or NOTFOUND")
+    endif ()
+    set (_pkg_version "")
+    set (_pkg_not_found_explanation "")
+    if (DEFINED _pkg_VERSION)
+        set (_pkg_version "${_pkg_VERSION}")
+    endif ()
+    if (DEFINED _pkg_NOT_FOUND_EXPLANATION)
+        set (_pkg_not_found_explanation "${_pkg_NOT_FOUND_EXPLANATION}")
+    endif ()
+    set (${pkgname}_VERSION "${_pkg_version}")
+    set (${pkgname}_VERSION "${_pkg_version}" CACHE INTERNAL
+         "Recorded dependency version for ${pkgname}" FORCE)
+    set (${pkgname}_NOT_FOUND_EXPLANATION "${_pkg_not_found_explanation}")
+    set (${pkgname}_NOT_FOUND_EXPLANATION "${_pkg_not_found_explanation}"
+         CACHE INTERNAL "Recorded dependency explanation for ${pkgname}" FORCE)
+    set (${pkgname}_REQUIRED ${_pkg_REQUIRED})
+    set (${pkgname}_REQUIRED ${_pkg_REQUIRED} CACHE INTERNAL
+         "Recorded dependency required-ness for ${pkgname}" FORCE)
+    if (_pkg_FOUND)
+        set_property (GLOBAL APPEND PROPERTY OIIO_CFP_CUSTOM_BUILD_DEPS_FOUND ${pkgname})
+    else ()
+        set_property (GLOBAL APPEND PROPERTY OIIO_CFP_CUSTOM_BUILD_DEPS_NOTFOUND ${pkgname})
+    endif ()
+endmacro ()
+
+
 # Utility: if `condition` is true, append `addition` to variable `var`
 macro (string_append_if var condition addition)
     # message (STATUS "string_append_if ${var} ${condition}='${${condition}}' '${addition}'")
@@ -94,11 +133,26 @@ endmacro()
 # Helper: Print a report about missing dependencies and give instructions on
 # how to turn on automatic local dependency building.
 function (print_package_notfound_report)
+    get_property(_cfp_custom_build_deps_found
+                 GLOBAL PROPERTY OIIO_CFP_CUSTOM_BUILD_DEPS_FOUND)
+    get_property(_cfp_custom_build_deps_notfound
+                 GLOBAL PROPERTY OIIO_CFP_CUSTOM_BUILD_DEPS_NOTFOUND)
+    set (_cfp_all_build_deps_found ${CFP_ALL_BUILD_DEPS_FOUND})
+    foreach (_pkg IN LISTS _cfp_custom_build_deps_found)
+        string (STRIP "${_pkg} ${${_pkg}_VERSION}" _cfp_dep_with_version)
+        list (APPEND _cfp_all_build_deps_found "${_cfp_dep_with_version}")
+    endforeach ()
+    foreach (_pkg IN LISTS _cfp_custom_build_deps_notfound)
+        list (APPEND _cfp_all_build_deps_found "${_pkg} NONE")
+    endforeach ()
+    list (SORT _cfp_all_build_deps_found CASE INSENSITIVE)
+    list (REMOVE_DUPLICATES _cfp_all_build_deps_found)
     message (STATUS)
     message (STATUS "${ColorBoldYellow}=========================================================================${ColorReset}")
     message (STATUS "${ColorBoldYellow}= Dependency report                                                     =${ColorReset}")
     message (STATUS "${ColorBoldYellow}=========================================================================${ColorReset}")
     message (STATUS)
+    message (STATUS "All build dependencies: ${_cfp_all_build_deps_found}")
     if (CFP_EXTERNAL_BUILD_DEPS_FOUND)
         message (STATUS "${ColorBoldWhite}The following dependencies found externally:${ColorReset}")
         list (SORT CFP_EXTERNAL_BUILD_DEPS_FOUND CASE INSENSITIVE)
@@ -109,28 +163,46 @@ function (print_package_notfound_report)
             message (STATUS "    ${_msg}")
         endforeach ()
     endif ()
+    if (_cfp_custom_build_deps_found)
+        message (STATUS "${ColorBoldWhite}The following additional dependencies were found:${ColorReset}")
+        list (SORT _cfp_custom_build_deps_found CASE INSENSITIVE)
+        list (REMOVE_DUPLICATES _cfp_custom_build_deps_found)
+        foreach (_pkg IN LISTS _cfp_custom_build_deps_found)
+            set (_msg "${_pkg} ${${_pkg}_VERSION} ")
+            string_append_if (_msg ${_pkg}_REQUIRED " (REQUIRED)")
+            message (STATUS "    ${_msg}")
+        endforeach ()
+    endif ()
     if (CFP_ALL_BUILD_DEPS_BADVERSION)
         message (STATUS "${ColorBoldWhite}The following dependencies were found but were too old:${ColorReset}")
         list (SORT CFP_ALL_BUILD_DEPS_BADVERSION CASE INSENSITIVE)
         list (REMOVE_DUPLICATES CFP_ALL_BUILD_DEPS_BADVERSION)
         foreach (_pkg IN LISTS CFP_ALL_BUILD_DEPS_BADVERSION)
             set (_msg "${_pkg}")
             string_append_if (_msg ${_pkg}_REQUIRED " (REQUIRED)")
-            string_append_if (_msg ${_pkg}_NOT_FOUND_EXPLANATION " ${_pkg}_NOT_FOUND_EXPLANATION")
+            if (DEFINED ${_pkg}_NOT_FOUND_EXPLANATION
+                AND NOT "${${_pkg}_NOT_FOUND_EXPLANATION}" STREQUAL "")
+                string (APPEND _msg " ${${_pkg}_NOT_FOUND_EXPLANATION}")
+            endif ()
             if (_pkg IN_LIST CFP_LOCALLY_BUILT_DEPS)
                 string (APPEND _msg " ${ColorMagenta}(${${_pkg}_VERSION} BUILT LOCALLY)${ColorReset} in ${${_pkg}_build_elapsed_time}s)${ColorReset}")
             endif ()
             message (STATUS "    ${_msg}")
         endforeach ()
     endif ()
-    if (CFP_ALL_BUILD_DEPS_NOTFOUND)
+    set (_cfp_all_build_deps_notfound
+         ${CFP_ALL_BUILD_DEPS_NOTFOUND} ${_cfp_custom_build_deps_notfound})
+    if (_cfp_all_build_deps_notfound)
         message (STATUS "${ColorBoldWhite}The following dependencies were not found:${ColorReset}")
-        list (SORT CFP_ALL_BUILD_DEPS_NOTFOUND CASE INSENSITIVE)
-        list (REMOVE_DUPLICATES CFP_ALL_BUILD_DEPS_NOTFOUND)
-        foreach (_pkg IN LISTS CFP_ALL_BUILD_DEPS_NOTFOUND)
+        list (SORT _cfp_all_build_deps_notfound CASE INSENSITIVE)
+        list (REMOVE_DUPLICATES _cfp_all_build_deps_notfound)
+        foreach (_pkg IN LISTS _cfp_all_build_deps_notfound)
             set (_msg "${_pkg} ${_${_pkg}_version_range}")
             string_append_if (_msg ${_pkg}_REQUIRED " (REQUIRED)")
-            string_append_if (_msg ${_pkg}_NOT_FOUND_EXPLANATION " ${_pkg}_NOT_FOUND_EXPLANATION")
+            if (DEFINED ${_pkg}_NOT_FOUND_EXPLANATION
+                AND NOT "${${_pkg}_NOT_FOUND_EXPLANATION}" STREQUAL "")
+                string (APPEND _msg " ${${_pkg}_NOT_FOUND_EXPLANATION}")
+            endif ()
             if (_pkg IN_LIST CFP_LOCALLY_BUILT_DEPS)
                 string (APPEND _msg " ${ColorMagenta}(${${_pkg}_VERSION} BUILT LOCALLY in ${${_pkg}_build_elapsed_time}s)${ColorReset}")
             endif ()

src/doc/CMakeLists.txt

@@ -26,6 +26,10 @@ if (UNIX AND TXT2MAN AND Python3_Interpreter_FOUND)
     message (STATUS "Unix man page documentation will be generated")
     set (cli_tools oiiotool iinfo maketx idiff igrep iconvert)
 
+    if (TARGET imiv)
+        list (APPEND cli_tools imiv)
+    endif()
+
     if (TARGET iv)
         list (APPEND cli_tools iv)
     endif()

src/doc/Doxyfile

@@ -829,7 +829,7 @@ WARN_LOGFILE           =
 # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = ../../src
+INPUT                  = ../../src/include/OpenImageIO
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -854,51 +854,11 @@ INPUT_ENCODING         = UTF-8
 # *.m, *.markdown, *.md, *.mm, *.dox, *.py, *.pyw, *.f90, *.f95, *.f03, *.f08,
 # *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf, *.qsf and *.ice.
 
-FILE_PATTERNS          = *.c \
-                         *.cc \
-                         *.cxx \
-                         *.cpp \
-                         *.c++ \
-                         *.java \
-                         *.ii \
-                         *.ixx \
-                         *.ipp \
-                         *.i++ \
-                         *.inl \
-                         *.idl \
-                         *.ddl \
-                         *.odl \
-                         *.h \
+FILE_PATTERNS          = *.h \
                          *.hh \
                          *.hxx \
                          *.hpp \
-                         *.h++ \
-                         *.cs \
-                         *.d \
-                         *.php \
-                         *.php4 \
-                         *.php5 \
-                         *.phtml \
-                         *.inc \
-                         *.m \
-                         *.markdown \
-                         *.md \
-                         *.mm \
-                         *.dox \
-                         *.py \
-                         *.pyw \
-                         *.f90 \
-                         *.f95 \
-                         *.f03 \
-                         *.f08 \
-                         *.f \
-                         *.for \
-                         *.tcl \
-                         *.vhd \
-                         *.vhdl \
-                         *.ucf \
-                         *.qsf \
-                         *.ice
+                         *.h++
 
 # The RECURSIVE tag can be used to specify whether or not subdirectories should
 # be searched for input files as well.
@@ -1158,7 +1118,7 @@ IGNORE_PREFIX          =
 # If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output
 # The default value is: YES.
 
-GENERATE_HTML          = YES
+GENERATE_HTML          = NO
 
 # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
@@ -1713,7 +1673,7 @@ EXTRA_SEARCH_MAPPINGS  =
 # If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
 # The default value is: YES.
 
-GENERATE_LATEX         = YES
+GENERATE_LATEX         = NO
 
 # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
@@ -2157,7 +2117,8 @@ SEARCH_INCLUDES        = YES
 # preprocessor.
 # This tag requires that the tag SEARCH_INCLUDES is set to YES.
 
-INCLUDE_PATH           = ../../src
+INCLUDE_PATH           = ../../src/include \
+                         ../../build/include
 
 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
 # patterns (like *.h and *.hpp) to filter out the header-files in the
@@ -2587,4 +2548,4 @@ GENERATE_LEGEND        = YES
 
 DOT_CLEANUP            = YES
 
-CLANG_ASSISTED_PARSING = YES
+CLANG_ASSISTED_PARSING = NO

src/doc/imiv.rst

@@ -0,0 +1,60 @@
+..
+  Copyright Contributors to the OpenImageIO project.
+  SPDX-License-Identifier: CC-BY-4.0
+
+
+.. _chap-imiv:
+
+`imiv`: ImGui Image Viewer
+################################
+
+.. highlight:: bash
+
+
+Overview
+========
+
+The :program:`imiv` program is an in-progress Dear ImGui-based replacement
+for the legacy :program:`iv` image viewer. It uses GLFW for windowing and
+currently supports renderer backends built around Vulkan, Metal, or OpenGL.
+
+ImIv port is still under active development, and several of the most
+valuable workflows are developer-facing:
+
+* understanding the shared app/viewer/UI architecture;
+* keeping behavior aligned across multiple renderer backends;
+* extending the automated GUI regression suite built on Dear ImGui Test
+  Engine.
+
+
+Current status
+==============
+
+:program:`imiv` already covers the core image-viewing loop, OCIO display
+controls, backend selection, persistent preferences, and a growing automated
+regression suite. But it does **not** yet claim full parity with
+:program:`iv`.
+
+In particular:
+
+* Vulkan is currently the reference backend for renderer-side feature work.
+* Current macOS multi-backend verification is green on Vulkan, Metal, and
+  OpenGL in the shared backend suite.
+* Multi-backend builds can expose backend selection through both the command
+  line and the Preferences window, with restart-on-next-launch semantics.
+* Some legacy :program:`iv` workflows are still intentionally marked as
+  incomplete or behaviorally different.
+
+For that reason, this chapter is organized into a compact user guide and
+deeper developer/testing guides.
+
+
+Documentation map
+=================
+
+.. toctree::
+   :maxdepth: 1
+
+   imiv_user
+   imiv_dev
+   imiv_tests