ernie-renderer 0.2.0.dev7__tar.gz → 0.2.0.dev16__tar.gz

ernie_renderer-0.2.0.dev16/.gitattributes

@@ -0,0 +1,15 @@
+* text=auto eol=lf
+*.sh text eol=lf
+
+# Binary formats, never normalised or diffed as text whatever their bytes look like.
+*.dds binary
+*.exr binary
+*.img binary
+*.jpeg binary
+*.jpg binary
+*.ktx2 binary
+*.nvdb binary
+*.png binary
+*.tif binary
+*.tiff binary
+*.vdb binary

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/.github/workflows/ci.yml

@@ -80,13 +80,12 @@ jobs:
       # MSVC on the path for the Ninja generator.
       - uses: ilammy/msvc-dev-cmd@0b201ec74fa43914dc39ae48a89fd1d8cb592756 # v1.13.0
         if: runner.os == 'Windows'
-      # Fetched dependencies' sources, keyed on their pins. Compiled objects are not cached.
+      # Fetched dependencies' sources (ERNIE_DEPS_DIR), keyed on their pins; they are built in the
+      # build tree, so compiled objects are not cached.
       - uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
         with:
-          path: |
-            .deps/*-src
-            .deps/*-subbuild
-          key: deps-${{ runner.os }}-${{ hashFiles('cmake/third_party/**') }}
+          path: .deps
+          key: deps-${{ runner.os }}-${{ hashFiles('cmake/ErnieFetch.cmake', 'cmake/third_party/**') }}
       - name: Configure
         shell: bash
         run: >
@@ -96,6 +95,18 @@ jobs:
           -DERNIE_TEST_PYTHON=python
       - name: Build
         run: cmake --build --preset ci --parallel 4
+      # The installed library used as end users use it: its headers compile alone and a program
+      # links and runs against it (QA-072). Windows finds ernie.dll on the PATH.
+      - name: Install and build a consumer
+        shell: bash
+        run: |
+          prefix="$RUNNER_TEMP/ernie"
+          cmake --install build/ci --prefix "$prefix" --component runtime
+          cmake --install build/ci --prefix "$prefix" --component dev
+          cmake -S tests/consumer -B build/consumer -G Ninja -DCMAKE_BUILD_TYPE=Release \
+            "-DCMAKE_PREFIX_PATH=$prefix"
+          cmake --build build/consumer
+          PATH="$prefix/bin:$PATH" ctest --test-dir build/consumer --output-on-failure
       # The build tree without objects, for this platform's test job; tar keeps file modes.
       - name: Pack the build tree
         shell: bash
@@ -171,10 +182,8 @@ jobs:
       - run: python -m pip install nanobind ninja pytest gcovr
       - uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
         with:
-          path: |
-            .deps/*-src
-            .deps/*-subbuild
-          key: deps-${{ runner.os }}-${{ hashFiles('cmake/third_party/**') }}
+          path: .deps
+          key: deps-${{ runner.os }}-${{ hashFiles('cmake/ErnieFetch.cmake', 'cmake/third_party/**') }}
       - name: Install lavapipe
         run: |
           sudo apt-get update
@@ -194,7 +203,7 @@ jobs:
       - name: Report
         run: |
           mkdir -p coverage
-          gcovr --root . --filter 'ernie/' --exclude 'ernie/test/' --exclude '.*_table\.h' \
+          gcovr --root . --filter 'ernie/' --exclude '.*_table\.h' \
             --object-directory build/coverage \
             --html-details coverage/index.html --json-summary coverage/summary.json --print-summary
           python .github/scripts/coverage_badge.py coverage
@@ -223,9 +232,13 @@ jobs:
 
   # The project site on GitHub Pages, from main: the docs, with the coverage report and its badge
   # under coverage/.
+  # The site follows main whenever its docs build, so a failing test elsewhere never takes it down;
+  # the coverage report is included when the coverage job passed.
   pages:
-    needs: [lint, test, docs, coverage]
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: [docs, coverage]
+    if: >
+      always() && github.event_name == 'push' && github.ref == 'refs/heads/main'
+      && needs.docs.result == 'success'
     runs-on: ubuntu-24.04
     timeout-minutes: 10
     permissions:
@@ -240,6 +253,7 @@ jobs:
           name: docs
           path: site
       - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        if: needs.coverage.result == 'success'
         with:
           name: coverage
           path: site/coverage
@@ -250,18 +264,23 @@ jobs:
         uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5.0.1
 
   wheel:
-    name: wheel (${{ matrix.platform }})
+    name: wheel (${{ matrix.platform }}, ${{ matrix.python }})
     needs: version
     runs-on: ${{ matrix.runner }}
     timeout-minutes: 45
     strategy:
       fail-fast: false
       matrix:
+        # cp312 is the stable-ABI wheel for every CPython from 3.12.
+        python: [cp310, cp311, cp312]
+        platform: [linux-x86_64, linux-aarch64, windows-amd64, macos-arm64]
         include:
           - { platform: linux-x86_64, runner: ubuntu-24.04 }
           - { platform: linux-aarch64, runner: ubuntu-24.04-arm }
           - { platform: windows-amd64, runner: windows-2025 }
           - { platform: macos-arm64, runner: macos-15 }
+    env:
+      CIBW_BUILD: ${{ matrix.python }}-*
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - name: Version
@@ -276,7 +295,7 @@ jobs:
           output-dir: wheelhouse
       - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
-          name: wheel-${{ matrix.platform }}
+          name: wheel-${{ matrix.platform }}-${{ matrix.python }}
           path: wheelhouse/*.whl
 
   # The sdist, then a wheel built from it and imported, as pip does for platforms without wheels.
@@ -327,11 +346,16 @@ jobs:
         run: |
           dnf install -y -q rpm-build
           command -v ninja >/dev/null || pipx install -q ninja
+      # One build; each format installs the library where its distributions look for it, as the
+      # build image (RHEL's lib64) is not where Debian and Ubuntu look.
       - name: Build
         run: |
           cmake --preset package
           cmake --build --preset package --parallel 4
-          cd build/package && cpack -G "DEB;RPM;TGZ"
+          cd build/package
+          cmake "-DCMAKE_INSTALL_LIBDIR=lib/$(uname -m)-linux-gnu" . && cpack -G DEB
+          cmake -DCMAKE_INSTALL_LIBDIR=lib64 . && cpack -G RPM
+          cmake -DCMAKE_INSTALL_LIBDIR=lib . && cpack -G TGZ
       - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: packages-linux-${{ matrix.arch }}
@@ -353,6 +377,8 @@ jobs:
         image: ["ubuntu:22.04", "ubuntu:24.04", "debian:12", "rockylinux/rockylinux:9"]
     container: ${{ matrix.image }}
     steps:
+      # The consumer project; checked out first, as checkout clears the workspace.
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: packages-linux-${{ matrix.arch }}
@@ -360,10 +386,16 @@ jobs:
         if: ${{ !startsWith(matrix.image, 'rockylinux') }}
         run: |
           apt-get update
-          apt-get install -y --no-install-recommends ./*.deb mesa-vulkan-drivers
+          apt-get install -y --no-install-recommends ./*.deb mesa-vulkan-drivers cmake g++ make
       - name: Install
         if: ${{ startsWith(matrix.image, 'rockylinux') }}
-        run: dnf install -y ./*.rpm
+        run: dnf install -y ./*.rpm cmake gcc-c++ make
+      # The -dev package used as end users use it, with the distribution's own compiler and CMake.
+      - name: Build a consumer
+        run: |
+          cmake -S tests/consumer -B /tmp/consumer -DCMAKE_BUILD_TYPE=Release
+          cmake --build /tmp/consumer
+          ctest --test-dir /tmp/consumer --output-on-failure
       # Rocky 9 has no lavapipe for aarch64, so there the program is only run, not given a device.
       - name: Install lavapipe
         if: ${{ startsWith(matrix.image, 'rockylinux') && matrix.arch == 'x86_64' }}

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/.pre-commit-config.yaml

@@ -1,3 +1,6 @@
+# Vendored sources stay byte for byte as their upstream release.
+exclude: ^third_party/(basisu|nanovdb)/
+
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/CMakeLists.txt

@@ -10,11 +10,12 @@ project(
     VERSION 0.2.0
     DESCRIPTION
         "Efficient Renderer for Natural and Interplanetary Environments: a spectral Vulkan ray tracer"
+    HOMEPAGE_URL "https://github.com/alexmaietta/ernie"
     LANGUAGES C CXX
 )
 
 # Pre-release suffix such as .dev12, written by CI.
-set(ERNIE_VERSION_SUFFIX ".dev7" CACHE STRING "Pre-release suffix of Ernie's version")
+set(ERNIE_VERSION_SUFFIX ".dev16" CACHE STRING "Pre-release suffix of Ernie's version")
 set(ERNIE_VERSION "${PROJECT_VERSION}${ERNIE_VERSION_SUFFIX}")
 
 option(ERNIE_BUILD_TESTS "Build Ernie's tests" OFF)
@@ -24,6 +25,10 @@ option(ERNIE_WARNINGS_AS_ERRORS "Treat compiler warnings as errors" OFF)
 option(ERNIE_ASSERTS "Keep assertions in optimised builds" OFF)
 option(ERNIE_TRACY "Send profiling zones to the Tracy profiler too" OFF)
 option(ERNIE_COVERAGE "Instrument Ernie for code coverage (GCC or Clang)" OFF)
+option(ERNIE_INSTALL "Install libernie for C++ consumers" ${PROJECT_IS_TOP_LEVEL})
+
+set(CMAKE_INSTALL_DOCDIR "share/doc/ernie" CACHE PATH "Documentation and licences")
+include(GNUInstallDirs)
 
 get_property(ernie_multi_config GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
 if(PROJECT_IS_TOP_LEVEL AND NOT ernie_multi_config AND NOT CMAKE_BUILD_TYPE)
@@ -36,18 +41,31 @@ set(CMAKE_CXX_EXTENSIONS OFF)
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/bin")
 set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/lib")
-if(ERNIE_BUILD_PYTHON)
-    set(CMAKE_POSITION_INDEPENDENT_CODE ON)
-endif()
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/lib")
+# Every object goes into the shared library too, and only its public API leaves it: symbols are
+# hidden unless marked ERNIE_API, including those of the dependencies built here.
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+set(CMAKE_C_VISIBILITY_PRESET hidden)
+set(CMAKE_CXX_VISIBILITY_PRESET hidden)
+set(CMAKE_VISIBILITY_INLINES_HIDDEN ON)
 
+include(cmake/ErnieFetch.cmake)
 include(cmake/third_party/glm.cmake)
 include(cmake/third_party/dlpack.cmake)
 include(cmake/third_party/json.cmake)
+include(cmake/third_party/openexr.cmake)
+include(cmake/third_party/bc7enc.cmake)
+include(cmake/third_party/stb.cmake)
 include(cmake/third_party/tracy.cmake)
 include(cmake/third_party/vulkan_headers.cmake)
 include(cmake/third_party/volk.cmake)
+add_subdirectory(third_party)
 
 add_library(ernie_build_options INTERFACE)
+# All of Ernie's own code is built as the shared library's (ernie_EXPORTS), so ERNIE_API exports
+# there and is harmless in the static library. glm's configuration stays inside Ernie: it changes
+# no layout, but consumers' own glm calls must not see it.
+target_compile_definitions(ernie_build_options INTERFACE ernie_EXPORTS GLM_FORCE_DEPTH_ZERO_TO_ONE)
 if(MSVC)
     target_compile_options(ernie_build_options INTERFACE /W4 /permissive- /Zc:__cplusplus /utf-8)
     # The CRT's "unsafe function" deprecations (getenv, fopen) would fail warnings-as-errors builds.
@@ -79,17 +97,18 @@ if(ERNIE_ASSERTS)
     )
 endif()
 if(ERNIE_COVERAGE)
-    # Unoptimised, so every line maps to its own counters; atomic, as ParallelFor's threads share
-    # them.
-    target_compile_options(ernie_build_options INTERFACE --coverage -fprofile-update=atomic -O0 -g)
+    target_compile_options(ernie_build_options INTERFACE --coverage -fprofile-update=atomic -Og -g)
     target_link_options(ernie_build_options INTERFACE --coverage)
 endif()
 
 add_subdirectory(ernie)
+if(ERNIE_INSTALL)
+    include(cmake/ErnieInstall.cmake)
+endif()
 
 if(ERNIE_BUILD_TESTS)
     enable_testing()
-    add_subdirectory(ernie/test)
+    add_subdirectory(tests)
 endif()
 
 if(PROJECT_IS_TOP_LEVEL AND NOT SKBUILD)

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/CMakePresets.json

@@ -28,8 +28,7 @@
       "cacheVariables": {
         "CMAKE_BUILD_TYPE": "Release",
         "ERNIE_ASSERTS": "ON",
-        "ERNIE_WARNINGS_AS_ERRORS": "ON",
-        "FETCHCONTENT_BASE_DIR": "${sourceDir}/.deps"
+        "ERNIE_WARNINGS_AS_ERRORS": "ON"
       }
     },
     {
@@ -41,8 +40,7 @@
       "cacheVariables": {
         "CMAKE_BUILD_TYPE": "Debug",
         "ERNIE_COVERAGE": "ON",
-        "ERNIE_WARNINGS_AS_ERRORS": "ON",
-        "FETCHCONTENT_BASE_DIR": "${sourceDir}/.deps"
+        "ERNIE_WARNINGS_AS_ERRORS": "ON"
       }
     },
     {
@@ -56,8 +54,7 @@
         "CMAKE_INSTALL_PREFIX": "/usr",
         "ERNIE_BUILD_APP": "ON",
         "ERNIE_BUILD_TESTS": "OFF",
-        "ERNIE_BUILD_PYTHON": "OFF",
-        "FETCHCONTENT_BASE_DIR": "${sourceDir}/.deps"
+        "ERNIE_BUILD_PYTHON": "OFF"
       }
     }
   ],
@@ -68,11 +65,13 @@
     },
     {
       "name": "ci",
-      "configurePreset": "ci"
+      "configurePreset": "ci",
+      "nativeToolOptions": ["-k", "0"]
     },
     {
       "name": "coverage",
-      "configurePreset": "coverage"
+      "configurePreset": "coverage",
+      "nativeToolOptions": ["-k", "0"]
     },
     {
       "name": "package",

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/Dockerfile

@@ -8,7 +8,8 @@ WORKDIR /src
 COPY . .
 RUN cmake -S . -B /build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/opt/ernie \
     && cmake --build /build \
-    && cmake --install /build --component app
+    && cmake --install /build --component app \
+    && cmake --install /build --component runtime
 
 FROM ubuntu:24.04
 ARG DEBIAN_FRONTEND=noninteractive
@@ -16,6 +17,8 @@ RUN apt-get update \
     && apt-get install -y --no-install-recommends libvulkan1 mesa-vulkan-drivers \
     && rm -rf /var/lib/apt/lists/*
 COPY --from=build /opt/ernie/bin/ernie /usr/local/bin/ernie
+# Data and the licences of everything the program carries.
+COPY --from=build /opt/ernie/share /usr/local/share
 ENV NVIDIA_DRIVER_CAPABILITIES=graphics,compute,utility
 WORKDIR /work
 ENTRYPOINT ["ernie"]

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ernie-renderer
-Version: 0.2.0.dev7
+Version: 0.2.0.dev16
 Summary: Efficient Renderer for Natural and Interplanetary Environments: a physically based, spectral Vulkan ray tracer
 Author: Alex Maietta
 License-Expression: BSD-3-Clause
@@ -8,7 +8,7 @@ License-File: LICENSE
 Project-URL: Homepage, https://github.com/alexmaietta/ernie
 Project-URL: Repository, https://github.com/alexmaietta/ernie
 Project-URL: Issues, https://github.com/alexmaietta/ernie/issues
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Provides-Extra: test
 Requires-Dist: pytest>=8; extra == "test"
 Description-Content-Type: text/markdown

ernie_renderer-0.2.0.dev16/cmake/ErnieConfig.cmake.in

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# find_package(Ernie): the shared library and its public headers, as Ernie::ernie.
+@PACKAGE_INIT@
+
+include("${CMAKE_CURRENT_LIST_DIR}/ErnieTargets.cmake")
+
+# Public headers use glm: the consumer's own when it has one, else the copy installed with Ernie.
+# Either way one glm reaches each translation unit; ernie/util/glm.h checks its layout.
+find_package(glm CONFIG QUIET)
+if(TARGET glm::glm)
+    target_link_libraries(Ernie::ernie INTERFACE glm::glm)
+else()
+    set_property(
+        TARGET Ernie::ernie
+        APPEND
+        PROPERTY INTERFACE_INCLUDE_DIRECTORIES "@PACKAGE_ERNIE_THIRD_PARTY_INCLUDEDIR@/glm"
+    )
+endif()
+# DLPack, a single versioned C header, always comes from Ernie.
+set_property(
+    TARGET Ernie::ernie
+    APPEND
+    PROPERTY INTERFACE_INCLUDE_DIRECTORIES "@PACKAGE_ERNIE_THIRD_PARTY_INCLUDEDIR@/dlpack"
+)
+
+check_required_components(Ernie)

ernie_renderer-0.2.0.dev16/cmake/ErnieFetch.cmake

@@ -0,0 +1,41 @@
+# SPDX-License-Identifier: BSD-3-Clause
+include_guard(GLOBAL)
+include(FetchContent)
+
+set(ERNIE_DEPS_DIR
+    "${PROJECT_SOURCE_DIR}/.deps"
+    CACHE PATH
+    "Where fetched dependency sources are kept"
+)
+
+function(ernie_fetch name)
+    # The FetchContent_Declare arguments recipes use, declared so others are rejected and gersemi
+    # formats calls by keyword.
+    cmake_parse_arguments(
+        ARG
+        ""
+        "URL;GIT_REPOSITORY;GIT_TAG;GIT_SHALLOW;SOURCE_SUBDIR"
+        "GIT_SUBMODULES"
+        ${ARGN}
+    )
+    if(ARG_UNPARSED_ARGUMENTS)
+        message(FATAL_ERROR "ernie_fetch(${name}): unexpected ${ARG_UNPARSED_ARGUMENTS}")
+    endif()
+    string(TOLOWER "${name}" lower)
+    string(TOUPPER "${name}" upper)
+    set(source "${ERNIE_DEPS_DIR}/${lower}-src")
+    set(stamp "${source}/.ernie-fetched")
+    if(EXISTS "${stamp}")
+        file(READ "${stamp}" fetched)
+        if(fetched STREQUAL "${ARGN}")
+            set(FETCHCONTENT_SOURCE_DIR_${upper} "${source}")
+        else()
+            file(REMOVE_RECURSE "${source}")
+        endif()
+    endif()
+    FetchContent_Declare(${name} ${ARGN} SOURCE_DIR "${source}")
+    FetchContent_MakeAvailable(${name})
+    file(WRITE "${stamp}" "${ARGN}")
+    set(${lower}_SOURCE_DIR "${${lower}_SOURCE_DIR}" PARENT_SCOPE)
+    set(${lower}_BINARY_DIR "${${lower}_BINARY_DIR}" PARENT_SCOPE)
+endfunction()

ernie_renderer-0.2.0.dev16/cmake/ErnieInstall.cmake

@@ -0,0 +1,123 @@
+# SPDX-License-Identifier: BSD-3-Clause
+include(CMakePackageConfigHelpers)
+
+set(ERNIE_THIRD_PARTY_INCLUDEDIR "${CMAKE_INSTALL_INCLUDEDIR}/ernie/third_party")
+set(ernie_cmake_dir "${CMAKE_INSTALL_LIBDIR}/cmake/Ernie")
+set(ernie_doc_dir "${CMAKE_INSTALL_DOCDIR}")
+
+install(
+    TARGETS ernie
+    EXPORT ErnieTargets
+    RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}" COMPONENT runtime
+    LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}" COMPONENT runtime NAMELINK_COMPONENT dev
+    ARCHIVE DESTINATION "${CMAKE_INSTALL_LIBDIR}" COMPONENT dev
+)
+
+set(ernie_public_headers
+    util/glm.h
+    util/log.h
+    util/file.h
+    util/profiler.h
+    util/tensor.h
+    util/version.h
+    io/ies.h
+    io/image.h
+    io/raster.h
+    io/texture.h
+)
+foreach(header ${ernie_public_headers})
+    get_filename_component(directory "${header}" DIRECTORY)
+    install(
+        FILES "${PROJECT_SOURCE_DIR}/ernie/${header}"
+        DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}/ernie/${directory}"
+        COMPONENT dev
+    )
+endforeach()
+install(
+    FILES "${PROJECT_BINARY_DIR}/include/ernie/export.h"
+    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}/ernie"
+    COMPONENT dev
+)
+install(
+    DIRECTORY "${glm_SOURCE_DIR}/glm"
+    DESTINATION "${ERNIE_THIRD_PARTY_INCLUDEDIR}/glm"
+    COMPONENT dev
+    FILES_MATCHING
+    PATTERN "*.hpp"
+    PATTERN "*.inl"
+    PATTERN "*.h"
+)
+install(
+    FILES "${dlpack_SOURCE_DIR}/include/dlpack/dlpack.h"
+    DESTINATION "${ERNIE_THIRD_PARTY_INCLUDEDIR}/dlpack/dlpack"
+    COMPONENT dev
+)
+
+install(EXPORT ErnieTargets NAMESPACE Ernie:: DESTINATION "${ernie_cmake_dir}" COMPONENT dev)
+configure_package_config_file(
+    "${PROJECT_SOURCE_DIR}/cmake/ErnieConfig.cmake.in"
+    "${PROJECT_BINARY_DIR}/ErnieConfig.cmake"
+    INSTALL_DESTINATION "${ernie_cmake_dir}"
+    PATH_VARS ERNIE_THIRD_PARTY_INCLUDEDIR
+)
+# 0.x releases keep compatibility within a minor series.
+write_basic_package_version_file(
+    "${PROJECT_BINARY_DIR}/ErnieConfigVersion.cmake"
+    COMPATIBILITY SameMinorVersion
+)
+install(
+    FILES "${PROJECT_BINARY_DIR}/ErnieConfig.cmake" "${PROJECT_BINARY_DIR}/ErnieConfigVersion.cmake"
+    DESTINATION "${ernie_cmake_dir}"
+    COMPONENT dev
+)
+# Relocatable: paths are relative to the .pc file, so an unpacked archive works anywhere.
+file(RELATIVE_PATH ernie_pc_to_prefix "/prefix/${CMAKE_INSTALL_LIBDIR}/pkgconfig" "/prefix")
+configure_file("${PROJECT_SOURCE_DIR}/cmake/ernie.pc.in" "${PROJECT_BINARY_DIR}/ernie.pc" @ONLY)
+install(
+    FILES "${PROJECT_BINARY_DIR}/ernie.pc"
+    DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig"
+    COMPONENT dev
+)
+
+# Ernie's licence and those of what the library and its headers carry.
+install(FILES "${PROJECT_SOURCE_DIR}/LICENSE" DESTINATION "${ernie_doc_dir}" COMPONENT runtime)
+set(ernie_notices
+    "basisu|${PROJECT_SOURCE_DIR}/third_party/basisu/LICENSE"
+    "basisu|${PROJECT_SOURCE_DIR}/third_party/basisu/NOTICE"
+    "bc7enc_rdo|${bc7enc_SOURCE_DIR}/LICENSE"
+    "dlpack|${dlpack_SOURCE_DIR}/LICENSE"
+    "glm|${glm_SOURCE_DIR}/copying.txt"
+    "imath|${imath_SOURCE_DIR}/LICENSE.md"
+    "libdeflate|${openexr_SOURCE_DIR}/external/deflate/COPYING"
+    "nanovdb|${PROJECT_SOURCE_DIR}/third_party/nanovdb/LICENSE"
+    "nlohmann_json|${nlohmann_json_SOURCE_DIR}/LICENSE.MIT"
+    "openexr|${openexr_SOURCE_DIR}/LICENSE.md"
+    "openjph|${openexr_SOURCE_DIR}/external/OpenJPH/LICENSE"
+    "stb|${stb_SOURCE_DIR}/LICENSE"
+    "volk|${volk_SOURCE_DIR}/LICENSE.md"
+    "vulkan_headers|${vulkan_headers_SOURCE_DIR}/LICENSE.md"
+    "zstd|${openexr_SOURCE_DIR}/external/zstd/LICENSE"
+)
+# A Debian machine-readable copyright file: Ernie's licence, and where each bundled one is.
+file(READ "${PROJECT_SOURCE_DIR}/LICENSE" ernie_license)
+string(REGEX REPLACE "\n" "\n " ernie_license " ${ernie_license}")
+set(ernie_copyright
+    "Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/\n"
+    "Upstream-Name: Ernie\nSource: ${PROJECT_HOMEPAGE_URL}\n\n"
+    "Files: *\nCopyright: Alex Maietta\nLicense: BSD-3-Clause\n${ernie_license}\n"
+)
+foreach(notice ${ernie_notices})
+    string(REPLACE "|" ";" parts "${notice}")
+    list(GET parts 0 name)
+    list(GET parts 1 file)
+    get_filename_component(file_name "${file}" NAME)
+    install(FILES "${file}" DESTINATION "${ernie_doc_dir}/third_party/${name}" COMPONENT runtime)
+    list(
+        APPEND ernie_copyright
+        "\nFiles: bundled/${name}/*\nCopyright: see the licence\n"
+        "License: see /usr/${ernie_doc_dir}/third_party/${name}/${file_name}\n"
+    )
+endforeach()
+list(JOIN ernie_copyright "" ernie_copyright)
+file(WRITE "${PROJECT_BINARY_DIR}/copyright" "${ernie_copyright}")
+install(FILES "${PROJECT_BINARY_DIR}/copyright" DESTINATION "${ernie_doc_dir}" COMPONENT runtime)

ernie_renderer-0.2.0.dev16/cmake/ErniePackaging.cmake

@@ -0,0 +1,57 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# DEB and RPM packages per install component, and one TGZ of everything, through CPack:
+#   runtime  libernie0 / ernie-libs    libernie, share/ernie data, licences and notices
+#   app      ernie / ernie             the ernie program, depending on the runtime package
+#   dev      libernie-dev / ernie-devel headers, the CMake package and pkg-config file
+
+set(CPACK_PACKAGE_NAME ernie)
+set(CPACK_PACKAGE_VERSION "${ERNIE_VERSION}")
+set(CPACK_PACKAGE_VENDOR "Alex Maietta")
+set(CPACK_PACKAGE_CONTACT "Alex Maietta <maiettaalex@gmail.com>")
+set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "${PROJECT_DESCRIPTION}")
+set(CPACK_PACKAGE_HOMEPAGE_URL "${PROJECT_HOMEPAGE_URL}")
+set(CPACK_RESOURCE_FILE_LICENSE "${PROJECT_SOURCE_DIR}/LICENSE")
+set(CPACK_PACKAGE_DIRECTORY "${PROJECT_BINARY_DIR}/packages")
+# Archives named for their architecture, so x86_64 and aarch64 tarballs can sit side by side.
+set(CPACK_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}")
+
+set(CPACK_COMPONENTS_ALL runtime app dev)
+set(CPACK_COMPONENT_APP_DEPENDS runtime)
+set(CPACK_COMPONENT_DEV_DEPENDS runtime)
+set(CPACK_COMPONENTS_GROUPING IGNORE)
+set(CPACK_ARCHIVE_COMPONENT_INSTALL OFF)
+set(CPACK_DEB_COMPONENT_INSTALL ON)
+set(CPACK_RPM_COMPONENT_INSTALL ON)
+
+set(CPACK_DEBIAN_FILE_NAME DEB-DEFAULT)
+set(CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS ON)
+# Set here, as CPack otherwise asks dpkg, which the manylinux build image lacks.
+if(CMAKE_SYSTEM_PROCESSOR MATCHES "^(x86_64|AMD64)$")
+    set(CPACK_DEBIAN_PACKAGE_ARCHITECTURE amd64)
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(aarch64|arm64)$")
+    set(CPACK_DEBIAN_PACKAGE_ARCHITECTURE arm64)
+endif()
+set(CPACK_DEBIAN_RUNTIME_PACKAGE_NAME libernie0)
+set(CPACK_DEBIAN_APP_PACKAGE_NAME ernie)
+set(CPACK_DEBIAN_DEV_PACKAGE_NAME libernie-dev)
+# Built on manylinux_2_34 (glibc 2.34, GCC 11's libstdc++), so these are the floors. The library
+# loads the Vulkan loader at run time, a dependency the linker cannot see.
+set(CPACK_DEBIAN_RUNTIME_PACKAGE_DEPENDS "libc6 (>= 2.34), libstdc++6 (>= 11), libvulkan1")
+set(CPACK_DEBIAN_RUNTIME_PACKAGE_RECOMMENDS "mesa-vulkan-drivers")
+set(CPACK_DEBIAN_RUNTIME_PACKAGE_SECTION libs)
+set(CPACK_DEBIAN_APP_PACKAGE_DEPENDS "libc6 (>= 2.34), libstdc++6 (>= 11), libvulkan1")
+set(CPACK_DEBIAN_APP_PACKAGE_SECTION graphics)
+set(CPACK_DEBIAN_DEV_PACKAGE_SECTION libdevel)
+
+set(CPACK_RPM_FILE_NAME RPM-DEFAULT)
+set(CPACK_RPM_PACKAGE_LICENSE "BSD-3-Clause")
+set(CPACK_RPM_RUNTIME_PACKAGE_NAME ernie-libs)
+set(CPACK_RPM_APP_PACKAGE_NAME ernie)
+set(CPACK_RPM_DEV_PACKAGE_NAME ernie-devel)
+set(CPACK_RPM_RUNTIME_PACKAGE_REQUIRES "vulkan-loader")
+set(CPACK_RPM_APP_PACKAGE_REQUIRES "vulkan-loader")
+set(CPACK_RPM_RUNTIME_PACKAGE_GROUP "System Environment/Libraries")
+set(CPACK_RPM_APP_PACKAGE_GROUP "Applications/Graphics")
+set(CPACK_RPM_DEV_PACKAGE_GROUP "Development/Libraries")
+
+include(CPack)

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/cmake/ErnieTesting.cmake

@@ -25,6 +25,10 @@ function(ernie_add_test_suite name)
     set(target ernie_tests_${name})
     add_executable(${target} ${ARG_SOURCES})
     target_link_libraries(${target} PRIVATE ${ARG_LIBRARIES} GTest::gtest_main ernie_build_options)
+    target_compile_definitions(
+        ${target}
+        PRIVATE ERNIE_TEST_FIXTURES="${PROJECT_SOURCE_DIR}/tests/fixtures"
+    )
     gtest_discover_tests(
         ${target}
         TEST_PREFIX "ernie.${name}."

ernie_renderer-0.2.0.dev16/cmake/ernie.pc.in

@@ -0,0 +1,10 @@
+prefix=${pcfiledir}/@ernie_pc_to_prefix@
+includedir=${prefix}/@CMAKE_INSTALL_INCLUDEDIR@
+libdir=${prefix}/@CMAKE_INSTALL_LIBDIR@
+
+Name: Ernie
+Description: @PROJECT_DESCRIPTION@
+Version: @ERNIE_VERSION@
+URL: @PROJECT_HOMEPAGE_URL@
+Cflags: -I${includedir} -I${includedir}/ernie/third_party/glm -I${includedir}/ernie/third_party/dlpack
+Libs: -L${libdir} -lernie

ernie_renderer-0.2.0.dev16/cmake/third_party/bc7enc.cmake

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# bc7enc_rdo has no releases, so a commit is pinned.
+set(ERNIE_DEP_VERSION_bc7enc
+    b9438627eef73a1157e84201b6fa6eb2ffd6d9f0
+    CACHE STRING
+    "Commit of bc7enc_rdo to fetch"
+)
+mark_as_advanced(ERNIE_DEP_VERSION_bc7enc)
+
+ernie_fetch(
+    bc7enc
+    URL https://github.com/richgel999/bc7enc_rdo/archive/${ERNIE_DEP_VERSION_bc7enc}.tar.gz
+    SOURCE_SUBDIR no-build
+)
+
+# bc7enc_rdo (MIT or public domain): its BC7 encoder (bc7enc), BC1 to BC5 encoders and decoders
+# (rgbcx) and BC7 decoder (bc7decomp), for baking and decoding textures.
+add_library(
+    ernie_bc7enc
+    STATIC
+    "${bc7enc_SOURCE_DIR}/bc7enc.cpp"
+    "${bc7enc_SOURCE_DIR}/rgbcx.cpp"
+    "${bc7enc_SOURCE_DIR}/bc7decomp.cpp"
+)
+target_include_directories(ernie_bc7enc SYSTEM PUBLIC "${bc7enc_SOURCE_DIR}")
+set_target_properties(ernie_bc7enc PROPERTIES POSITION_INDEPENDENT_CODE ON)

{ernie_renderer-0.2.0.dev7 → ernie_renderer-0.2.0.dev16}/cmake/third_party/dlpack.cmake

@@ -2,15 +2,11 @@
 set(ERNIE_DEP_VERSION_dlpack v1.3 CACHE STRING "Tag of DLPack to fetch")
 mark_as_advanced(ERNIE_DEP_VERSION_dlpack)
 
-include(FetchContent)
-FetchContent_Declare(
+ernie_fetch(
     dlpack
-    GIT_REPOSITORY https://github.com/dmlc/dlpack.git
-    GIT_TAG ${ERNIE_DEP_VERSION_dlpack}
-    GIT_SHALLOW TRUE
+    URL https://github.com/dmlc/dlpack/archive/refs/tags/${ERNIE_DEP_VERSION_dlpack}.tar.gz
     SOURCE_SUBDIR no-build
 )
-FetchContent_MakeAvailable(dlpack)
 
 # The tensor exchange header, nothing to build.
 add_library(ernie_dlpack INTERFACE)