[REVIEW] Feat: PR #2 Add GPU-accelerated TIFF decoding via nvImageCodec v0.6.0 for digital pathology

.gitignore

@@ -155,3 +155,5 @@ conda-bld
 
 # Custom debug environment setup script for VS Code (used by scripts/debug_python)
 /scripts/debug_env.sh
+*.tiff
+junit-cucim.xml

conda/recipes/libcucim/meta.yaml

@@ -24,6 +24,7 @@ build:
     - cuda-cudart-dev
     - libcufile-dev
     - libnvjpeg-dev
+    - libnvimgcodec-dev
   script_env:
     - AWS_ACCESS_KEY_ID
     - AWS_SECRET_ACCESS_KEY
@@ -70,7 +71,7 @@ requirements:
     - libcufile
     - cuda-cudart
     - libnvjpeg
-    - libnvimgcodec0 {{ nvimgcodec_version }}  # nvImageCodec runtime library
+    - libnvimgcodec {{ nvimgcodec_version }}   # nvImageCodec metapackage (includes libnvimgcodec0 + run_exports)
   run_constrained:
     - {{ pin_compatible('openslide') }}
     - libnvimgcodec-dev {{ nvimgcodec_version }}  # Optional: for development/debugging

cpp/cmake/deps/nvimgcodec.cmake

@@ -0,0 +1,113 @@
+#
+# cmake-format: off
+# SPDX-FileCopyrightText: Copyright (c) 2020-2025, NVIDIA CORPORATION.
+# SPDX-License-Identifier: Apache-2.0
+# cmake-format: on
+#
+
+if (NOT TARGET deps::nvimgcodec)
+    # First try to find it as a package
+    find_package(nvimgcodec QUIET)
+
+    if(nvimgcodec_FOUND)
+        # Use the found package
+        add_library(deps::nvimgcodec INTERFACE IMPORTED GLOBAL)
+        target_link_libraries(deps::nvimgcodec INTERFACE nvimgcodec::nvimgcodec)
+        message(STATUS "✓ nvImageCodec found via find_package")
+    else()
+        # Manual detection in various environments
+        set(NVIMGCODEC_LIB_PATH "")
+        set(NVIMGCODEC_INCLUDE_PATH "")
+
+        # Try conda environment detection (both Python packages and native packages)
+        if(DEFINED ENV{CONDA_BUILD})
+            # Conda build environment
+            set(NVIMGCODEC_LIB_PATH "$ENV{PREFIX}/lib/libnvimgcodec.so.0")
+            set(NVIMGCODEC_INCLUDE_PATH "$ENV{PREFIX}/include/")
+            if(NOT EXISTS "${NVIMGCODEC_LIB_PATH}")
+                set(NVIMGCODEC_LIB_PATH "$ENV{PREFIX}/lib/libnvimgcodec.so")
+            endif()
+        elseif(DEFINED ENV{CONDA_PREFIX})
+            # Active conda environment - try native package first
+            set(CONDA_NATIVE_ROOT "$ENV{CONDA_PREFIX}")
+            if(EXISTS "${CONDA_NATIVE_ROOT}/include/nvimgcodec.h")
+                set(NVIMGCODEC_INCLUDE_PATH "${CONDA_NATIVE_ROOT}/include/")
+                if(EXISTS "${CONDA_NATIVE_ROOT}/lib/libnvimgcodec.so.0")
+                    set(NVIMGCODEC_LIB_PATH "${CONDA_NATIVE_ROOT}/lib/libnvimgcodec.so.0")
+                elseif(EXISTS "${CONDA_NATIVE_ROOT}/lib/libnvimgcodec.so")
+                    set(NVIMGCODEC_LIB_PATH "${CONDA_NATIVE_ROOT}/lib/libnvimgcodec.so")
+                endif()
+            else()
+                # Fallback: try Python site-packages in conda environment
+                foreach(PY_VER "3.13" "3.12" "3.11" "3.10" "3.9")
+                    set(CONDA_PYTHON_ROOT "$ENV{CONDA_PREFIX}/lib/python${PY_VER}/site-packages/nvidia/nvimgcodec")
+                    if(EXISTS "${CONDA_PYTHON_ROOT}/include/nvimgcodec.h")
+                        set(NVIMGCODEC_INCLUDE_PATH "${CONDA_PYTHON_ROOT}/include/")
+                        if(EXISTS "${CONDA_PYTHON_ROOT}/lib/libnvimgcodec.so.0")
+                            set(NVIMGCODEC_LIB_PATH "${CONDA_PYTHON_ROOT}/lib/libnvimgcodec.so.0")
+                        elseif(EXISTS "${CONDA_PYTHON_ROOT}/lib/libnvimgcodec.so")
+                            set(NVIMGCODEC_LIB_PATH "${CONDA_PYTHON_ROOT}/lib/libnvimgcodec.so")
+                        endif()
+                        break()
+                    endif()
+                endforeach()
+            endif()
+        else()
+            # Try Python site-packages detection
+            find_package(Python3 COMPONENTS Interpreter)
+            if(Python3_FOUND)
+                execute_process(
+                    COMMAND ${Python3_EXECUTABLE} -c "import site; print(site.getsitepackages()[0])"
+                    OUTPUT_VARIABLE PYTHON_SITE_PACKAGES
+                    OUTPUT_STRIP_TRAILING_WHITESPACE
+                    ERROR_QUIET
+                )
+
+                if(PYTHON_SITE_PACKAGES)
+                    set(NVIMGCODEC_PYTHON_ROOT "${PYTHON_SITE_PACKAGES}/nvidia/nvimgcodec")
+                    if(EXISTS "${NVIMGCODEC_PYTHON_ROOT}/include/nvimgcodec.h")
+                        set(NVIMGCODEC_INCLUDE_PATH "${NVIMGCODEC_PYTHON_ROOT}/include/")
+                        if(EXISTS "${NVIMGCODEC_PYTHON_ROOT}/lib/libnvimgcodec.so.0")
+                            set(NVIMGCODEC_LIB_PATH "${NVIMGCODEC_PYTHON_ROOT}/lib/libnvimgcodec.so.0")
+                        elseif(EXISTS "${NVIMGCODEC_PYTHON_ROOT}/lib/libnvimgcodec.so")
+                            set(NVIMGCODEC_LIB_PATH "${NVIMGCODEC_PYTHON_ROOT}/lib/libnvimgcodec.so")
+                        endif()
+                    endif()
+                endif()
+            endif()
+
+            # System-wide installation fallback
+            if(NOT NVIMGCODEC_LIB_PATH)
+                if(EXISTS /usr/lib/x86_64-linux-gnu/libnvimgcodec.so.0)
+                    set(NVIMGCODEC_LIB_PATH /usr/lib/x86_64-linux-gnu/libnvimgcodec.so.0)
+                    set(NVIMGCODEC_INCLUDE_PATH "/usr/include/")
+                elseif(EXISTS /usr/lib/aarch64-linux-gnu/libnvimgcodec.so.0)
+                    set(NVIMGCODEC_LIB_PATH /usr/lib/aarch64-linux-gnu/libnvimgcodec.so.0)
+                    set(NVIMGCODEC_INCLUDE_PATH "/usr/include/")
+                elseif(EXISTS /usr/lib64/libnvimgcodec.so.0) # CentOS (x86_64)
+                    set(NVIMGCODEC_LIB_PATH /usr/lib64/libnvimgcodec.so.0)
+                    set(NVIMGCODEC_INCLUDE_PATH "/usr/include/")
+                endif()
+            endif()
+        endif()
+
+        # Create the target if we found the library
+        if(NVIMGCODEC_LIB_PATH AND EXISTS "${NVIMGCODEC_LIB_PATH}")
+            add_library(deps::nvimgcodec SHARED IMPORTED GLOBAL)
+            set_target_properties(deps::nvimgcodec PROPERTIES
+                IMPORTED_LOCATION "${NVIMGCODEC_LIB_PATH}"
+                INTERFACE_INCLUDE_DIRECTORIES "${NVIMGCODEC_INCLUDE_PATH}"
+            )
+            message(STATUS "✓ nvImageCodec found:")
+            message(STATUS "  Library: ${NVIMGCODEC_LIB_PATH}")
+            message(STATUS "  Headers: ${NVIMGCODEC_INCLUDE_PATH}")
+        else()
+            # Create a dummy target to prevent build failures
+            add_library(deps::nvimgcodec INTERFACE IMPORTED GLOBAL)
+            message(STATUS "✗ nvImageCodec not found - GPU acceleration disabled")
+            message(STATUS "To enable nvImageCodec support:")
+            message(STATUS "  Option 1 (conda): conda install libnvimgcodec-dev -c conda-forge")
+            message(STATUS "  Option 2 (pip):   pip install nvidia-nvimgcodec-cu12[all]")
+        endif()
+    endif()
+endif()

cpp/plugins/cucim.kit.cuslide2/.clang-format

@@ -0,0 +1,86 @@
+AccessModifierOffset: -4
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlinesLeft: false
+AlignTrailingComments: false
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortFunctionsOnASingleLine: false
+AllowShortIfStatementsOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine : false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: false
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: true
+BinPackArguments: true
+BinPackParameters: false
+BreakBeforeBinaryOperators: false
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterClass: true
+  AfterControlStatement: true
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: true
+  AfterObjCDeclaration: true
+  AfterStruct: true
+  AfterUnion: true
+  AfterExternBlock: true
+  BeforeCatch: true
+  BeforeElse: true
+  IndentBraces: false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace : true
+BreakBeforeTernaryOperators: false
+BreakConstructorInitializersBeforeComma: false
+BreakStringLiterals: false
+ColumnLimit: 120
+CommentPragmas: ''
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: false
+DerivePointerBinding: false
+FixNamespaceComments: true
+IndentCaseLabels: false
+IndentPPDirectives: AfterHash
+IndentFunctionDeclarationAfterType: false
+IndentWidth: 4
+SortIncludes: false
+IncludeCategories:
+  - Regex:           '[<"](.*\/)?Defines.h[>"]'
+    Priority:        1
+#  - Regex:           '<cuslide\/.+>'
+#    Priority:        3
+  - Regex:           '<[[:alnum:]_.]+>'
+    Priority:        5
+  - Regex:           '<[[:alnum:]_.\/]+>'
+    Priority:        4
+  - Regex:           '".*"'
+    Priority:        2
+IncludeBlocks: Regroup
+Language: Cpp
+MaxEmptyLinesToKeep: 2
+NamespaceIndentation: None
+ObjCSpaceAfterProperty: true
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakBeforeFirstCallParameter: 0
+PenaltyBreakComment: 1
+PenaltyBreakFirstLessLess: 0
+PenaltyBreakString: 1
+PenaltyExcessCharacter: 10
+PenaltyReturnTypeOnItsOwnLine: 1000
+PointerAlignment: Left
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInCStyleCastParentheses: false
+SpacesInContainerLiterals: false
+SpacesInParentheses: false
+Standard: Cpp11
+ReflowComments: true
+TabWidth: 4
+UseTab: Never

cpp/plugins/cucim.kit.cuslide2/.editorconfig

@@ -0,0 +1,7 @@
+[*]
+indent_style = space
+indent_size = 4
+charset = utf-8
+trim_trailing_whitespace = true
+max_line_length = 120
+insert_final_newline = true

cpp/plugins/cucim.kit.cuslide2/.gitignore

@@ -0,0 +1,2 @@
+cmake-build*
+install