Opacity Micromaps and framework for simple engine courses

antora/modules/ROOT/nav.adoc

@@ -128,6 +128,16 @@
 *** xref:Building_a_Simple_Engine/Mobile_Development/04_rendering_approaches.adoc[Rendering approaches]
 *** xref:Building_a_Simple_Engine/Mobile_Development/05_vulkan_extensions.adoc[Vulkan extensions]
 *** xref:Building_a_Simple_Engine/Mobile_Development/06_conclusion.adoc[Conclusion]
+** Extra Courses
+*** Opacity Micromaps
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/00_introduction.adoc[Introduction]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/01_the_shadow_problem.adoc[The shadow problem]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/02_why_alpha_testing_is_expensive.adoc[Why alpha testing is expensive]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/03_what_are_micromaps.adoc[What are micromaps]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/04_hardware_traversal_with_omm.adoc[Hardware traversal with OMM]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/05_implementation_overview.adoc[Implementation overview]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/06_results_guidance_and_tradeoffs.adoc[Results, guidance and tradeoffs]
+**** xref:Building_a_Simple_Engine/Courses/Opacity_Micromaps/07_conclusion.adoc[Conclusion]
 ** Advanced Topics
 *** xref:Building_a_Simple_Engine/Advanced_Topics/01_introduction.adoc[Introduction]
 *** xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering pipeline overview]

attachments/simple_engine/CMake/FindKTX.cmake

@@ -13,99 +13,92 @@
 #    KTX::ktx
 #
 
-# Check if we're on Linux - if so, we'll skip the search and directly use FetchContent
-if(UNIX AND NOT APPLE)
-  # On Linux, we assume KTX is not installed and proceed directly to fetching it
-  set(KTX_FOUND FALSE)
-else()
-  # On non-Linux platforms, try to find KTX using pkg-config first
-  find_package(PkgConfig QUIET)
-  if(PKG_CONFIG_FOUND)
+# Try to find KTX using pkg-config first
+find_package(PkgConfig QUIET)
+if (PKG_CONFIG_FOUND)
     pkg_check_modules(PC_KTX QUIET ktx libktx ktx2 libktx2)
-  endif()
+endif ()
 
-  # Try to find KTX using standard find_package
-  find_path(KTX_INCLUDE_DIR
-    NAMES ktx.h
-    PATH_SUFFIXES include ktx KTX ktx2 KTX2
-    HINTS
-      ${PC_KTX_INCLUDEDIR}
-      /usr/include
-      /usr/local/include
-      $ENV{KTX_DIR}/include
-      $ENV{VULKAN_SDK}/include
-      ${CMAKE_SOURCE_DIR}/external/ktx/include
-  )
-
-  find_library(KTX_LIBRARY
-    NAMES ktx ktx2 libktx libktx2
-    PATH_SUFFIXES lib lib64
-    HINTS
-      ${PC_KTX_LIBDIR}
-      /usr/lib
-      /usr/lib64
-      /usr/local/lib
-      /usr/local/lib64
-      $ENV{KTX_DIR}/lib
-      $ENV{VULKAN_SDK}/lib
-      ${CMAKE_SOURCE_DIR}/external/ktx/lib
-  )
-
-  if (KTX_INCLUDE_DIR AND KTX_LIBRARY)
-    set(KTX_FOUND TRUE)
-  else ()
-    set(KTX_FOUND FALSE)
-  endif()
-endif()
+# Try to find KTX using standard find_path and find_library
+find_path(KTX_INCLUDE_DIR
+        NAMES ktx.h
+        PATH_SUFFIXES include ktx KTX ktx2 KTX2
+        HINTS
+        ${PC_KTX_INCLUDEDIR}
+        /usr/include
+        /usr/local/include
+        $ENV{KTX_DIR}/include
+        $ENV{VULKAN_SDK}/include
+        ${CMAKE_SOURCE_DIR}/external/ktx/include
+)
 
-if(KTX_FOUND)
-  set(KTX_INCLUDE_DIRS ${KTX_INCLUDE_DIR})
-  set(KTX_LIBRARIES ${KTX_LIBRARY})
+find_library(KTX_LIBRARY
+        NAMES ktx ktx2 libktx libktx2
+        PATH_SUFFIXES lib lib64
+        HINTS
+        ${PC_KTX_LIBDIR}
+        /usr/lib
+        /usr/lib64
+        /usr/local/lib
+        /usr/local/lib64
+        $ENV{KTX_DIR}/lib
+        $ENV{VULKAN_SDK}/lib
+        ${CMAKE_SOURCE_DIR}/external/ktx/lib
+)
 
-  if(NOT TARGET KTX::ktx)
-    add_library(KTX::ktx UNKNOWN IMPORTED)
-    set_target_properties(KTX::ktx PROPERTIES
-      IMPORTED_LOCATION "${KTX_LIBRARIES}"
-      INTERFACE_INCLUDE_DIRECTORIES "${KTX_INCLUDE_DIRS}"
-    )
-  endif()
-else()
-  # If not found, use FetchContent to download and build
-  include(FetchContent)
+# If not found in the system, use FetchContent to download and build
+if (NOT KTX_INCLUDE_DIR OR NOT KTX_LIBRARY)
+    include(FetchContent)
 
-  # Only show the message on non-Linux platforms
-  if(NOT (UNIX AND NOT APPLE))
     message(STATUS "KTX not found, fetching from GitHub...")
-  endif()
 
-  FetchContent_Declare(
-    ktx
-    GIT_REPOSITORY https://github.com/KhronosGroup/KTX-Software.git
-    GIT_TAG v4.4.2  # Use a specific tag for stability
-  )
-
-  # Set options to minimize build time and dependencies
-  set(KTX_FEATURE_TOOLS OFF CACHE BOOL "Build KTX tools" FORCE)
-  set(KTX_FEATURE_DOC OFF CACHE BOOL "Build KTX documentation" FORCE)
-  set(KTX_FEATURE_TESTS OFF CACHE BOOL "Build KTX tests" FORCE)
+    FetchContent_Declare(
+            ktx
+            GIT_REPOSITORY https://github.com/KhronosGroup/KTX-Software.git
+            GIT_TAG v4.4.2
+    )
 
-  FetchContent_MakeAvailable(ktx)
+    # Minimize build time and dependencies
+    set(KTX_FEATURE_TOOLS OFF CACHE BOOL "Build KTX tools" FORCE)
+    set(KTX_FEATURE_DOC OFF CACHE BOOL "Build KTX documentation" FORCE)
+    set(KTX_FEATURE_TESTS OFF CACHE BOOL "Build KTX tests" FORCE)
+    set(KTX_FEATURE_STATIC_LIBRARY ON CACHE BOOL "Build KTX as static library" FORCE)
 
-  # Create an alias to match the expected target name
-  if(NOT TARGET KTX::ktx)
-    add_library(KTX::ktx ALIAS ktx)
-  endif()
+    FetchContent_MakeAvailable(ktx)
 
-  # Set variables to indicate that KTX was found and to satisfy find_package_handle_standard_args
-  set(KTX_FOUND TRUE)
-  FetchContent_GetProperties(ktx SOURCE_DIR ktx_SOURCE_DIR)
-  set(KTX_INCLUDE_DIR "${ktx_SOURCE_DIR}/include")
-  set(KTX_LIBRARY ktx)
-  set(KTX_INCLUDE_DIRS ${KTX_INCLUDE_DIR})
-  set(KTX_LIBRARIES ${KTX_LIBRARY})
-endif()
+    if (TARGET ktx)
+        get_target_property(KTX_TARGET_INCLUDE_DIR ktx INTERFACE_INCLUDE_DIRECTORIES)
+        if (KTX_TARGET_INCLUDE_DIR)
+            set(KTX_INCLUDE_DIR ${KTX_TARGET_INCLUDE_DIR})
+        else ()
+            FetchContent_GetProperties(ktx SOURCE_DIR ktx_SOURCE_DIR)
+            set(KTX_INCLUDE_DIR ${ktx_SOURCE_DIR}/include)
+        endif ()
+        set(KTX_LIBRARY ktx)
+    endif ()
+endif ()
 
 include(FindPackageHandleStandardArgs)
 find_package_handle_standard_args(KTX
         REQUIRED_VARS KTX_INCLUDE_DIR KTX_LIBRARY
 )
+
+if (KTX_FOUND)
+    set(KTX_INCLUDE_DIRS ${KTX_INCLUDE_DIR})
+    set(KTX_LIBRARIES ${KTX_LIBRARY})
+
+    if (NOT TARGET KTX::ktx)
+        if (TARGET ktx)
+            # FetchContent target already exists — alias it
+            add_library(KTX::ktx ALIAS ktx)
+        else ()
+            add_library(KTX::ktx UNKNOWN IMPORTED)
+            set_target_properties(KTX::ktx PROPERTIES
+                    IMPORTED_LOCATION "${KTX_LIBRARY}"
+                    INTERFACE_INCLUDE_DIRECTORIES "${KTX_INCLUDE_DIR}"
+            )
+        endif ()
+    endif ()
+endif ()
+
+mark_as_advanced(KTX_INCLUDE_DIR KTX_LIBRARY)