DOC: find_package component example with itk_generate_factory_registration()

Approach with ITK 6 CMake targets.

Author: thewtex

SoftwareGuide/Latex/Introduction/Installation.tex

@@ -574,28 +574,75 @@ \section{Using ITK as an External Library}%
 
 \small
 \begin{minted}[baselinestretch=1,fontsize=\footnotesize,linenos=false,bgcolor=ltgray]{cmake}
-set(MINIMUM_ITK_VERSION 5.4)
+set(MINIMUM_ITK_VERSION 6.0)
 find_package(ITK ${MINIMUM_ITK_VERSION} REQUIRED COMPONENTS Module1 Module2)
-include(${ITK_USE_FILE})
+
+add_executable(Example Example.cxx)
+target_link_libraries(Example ITK::Module1 ITK::Module2)
 \end{minted}
 \normalsize
 
 e.g.
 
 \small
 \begin{minted}[baselinestretch=1,fontsize=\footnotesize,linenos=false,bgcolor=ltgray]{cmake}
-set(MINIMUM_ITK_VERSION 5.4)
+set(MINIMUM_ITK_VERSION 6.0)
 find_package(ITK ${MINIMUM_ITK_VERSION} REQUIRED
   COMPONENTS
     MorphologicalContourInterpolation
     ITKSmoothing
     ITKIOImageBase
     ITKIONRRD
     )
-include(${ITK_USE_FILE})
+
+add_executable(Example Example.cxx)
+target_link_libraries(Example
+    ITK::MorphologicalContourInterpolation
+    ITK::ITKSmoothing
+    ITK::ITKIOImageBase
+    ITK::ITKIONRRD
+    )
+# or
+target_link_libraries(Example ${ITK_INTERFACE_LIBRARIES})
 \end{minted}
 \normalsize
 
+ITK uses factory registration to load IO formats and pluggable components at runtime.
+ITK 6 uses meta-modules that simplify factory registration by grouping related modules together.
+
+Factory meta-modules include:
+
+\begin{description}
+  \item[ITKImageIO] All image IO modules (JPEG, PNG, NIFTI, DICOM, etc.).
+  \item[ITKMeshIO] All mesh IO modules.
+  \item[ITKTransformIO] Transform IO modules.
+  \item[ITKFFTImageFilterInit] FFT implementations.
+\end{description}
+
+To register all factories:
+
+\small
+\begin{minted}[baselinestretch=1,fontsize=\footnotesize,linenos=false,bgcolor=ltgray]{cmake}
+set(MINIMUM_ITK_VERSION 6.0)
+find_package(ITK ${MINIMUM_ITK_VERSION} REQUIRED
+  COMPONENTS
+    MorphologicalContourInterpolation
+    ITKSmoothing
+    ITKIOImageBase
+    ITKIONRRD
+    )
+itk_generate_factory_registration()
+
+add_executable(Example Example.cxx)
+target_link_libraries(Example ${ITK_INTERFACE_LIBRARIES} ITK::ITKImageIO)
+\end{minted}
+\normalsize
+
+The \code{itk\_generate\_factory\_registration()} macro must be called before adding executables.
+The CMake macro generates registration code for the IO modules and factory-enabled components from
+the modules loaded in \code{find\_package()}. The meta-module must be linked to the target to
+include and enable the generated registration code.
+
 If you would like to use the CMake ExternalProject
 Module\footnote{\url{https://cmake.org/cmake/help/latest/module/ExternalProject.html}}
 to download ITK source code when building your ITK application (a.k.a.