Update build config, CI, and documentation

- Increment patch version in CMakeLists.txt and add MATLAB mex build option
- Remove Windows-x64, Linux-x64, and upload release jobs from azure-pipelines.yml
- Expand building.markdown with detailed MATLAB and Octave build instructions
- Correct typo in building.drawio
- Simplify libCZI.cmake by setting build options and using FetchContent_MakeAvailable

CMakeLists.txt

@@ -5,7 +5,7 @@ cmake_minimum_required (VERSION 3.11)
 
 set(MEXLIBCZI_MAJOR 0)
 set(MEXLIBCZI_MINOR 3)
-set(MEXLIBCZI_PATCH 2)
+set(MEXLIBCZI_PATCH 3)
 set(MEXLIBCZI_EXT "alpha")
 
 if(WIN32)
@@ -22,6 +22,8 @@ project ("MEXlibCZI"
           DESCRIPTION "mex extension (for MATLAB and Octave) for reading/writing CZI-files with libCZI")
 
 # Options controlling the CMake-build are gathered here
+
+# When this option is ON, we build the mex extension for MATLAB. Otherwise, we don't build the mex extension for MATLAB.
 option(MEXLIBCZI_BUILD_MATLABMEX "Build the mex extension for MATLAB" ON)
 
 # include RapidJSON -> https://www.jibbow.com/posts/rapidjson-cmake/

doc/building.markdown

@@ -19,3 +19,31 @@ within Octave itself.
 This way, the code for MATLAB and Octave is shared, but the build process is different.
 
 ![Building overview](pictures/build_architecture.png)]
+
+## CMake
+
+Executing the following command in the root directory of the project will build the mex-file for MATLAB   
+and the dynamic library for the Octave-mex-file:
+
+```bash
+mkdir build
+cd build
+cmake ..
+cmake --build . -j
+```
+
+The CMake build system will try to located the MATLAB installation automatically. It is also possible to specify the paths for the folders containing the necessary headers and libraries
+manually. This can be done by setting the CMake variables `MEXLIBCZI_HEADERS` and `MEXLIBCZI_LIBS`.
+
+## Building the Octave mex-file
+
+The Octave-mex-file is built from within Octave itself. The following commands are executed in the root directory of the project:
+
+```bash
+cd D:\dev\MyGitHub\MEXlibCZI\OctaveMex
+mkoctfile --mex octavelibczi.c
+```
+
+This will create the mex-file "octavelibczi.mex" in the current directory. This mex-file is a stub and at runtime loads the dynamic library "libmexlibczi".  
+For the Octave-mex-file to work, the dynamic library "libmexlibczi" must be present in the same directory. This library is built using CMake, and must be copied 
+manually to the directory where the mex-file is located.

doc/pictures/building.drawio

@@ -40,7 +40,7 @@
             <mxPoint x="670" y="140" as="targetPoint" />
           </mxGeometry>
         </mxCell>
-        <mxCell id="BRgU4PrnbskxXR9fhvR0-17" value="dynamically liks&lt;br&gt;to at runtime" style="text;html=1;align=center;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;" vertex="1" parent="1">
+        <mxCell id="BRgU4PrnbskxXR9fhvR0-17" value="dynamically links&lt;br&gt;to at runtime" style="text;html=1;align=center;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;" vertex="1" parent="1">
           <mxGeometry x="585" y="210" width="110" height="40" as="geometry" />
         </mxCell>
       </root>

modules/libCZI.cmake

@@ -1,5 +1,9 @@
 include(FetchContent)
 
+# Set necessary build options for libCZI
+set(LIBCZI_BUILD_CZICMD OFF CACHE BOOL "" FORCE)
+set(LIBCZI_BUILD_DYNLIB OFF CACHE BOOL "" FORCE)
+set(LIBCZI_BUILD_UNITTESTS OFF CACHE BOOL "" FORCE)
 
 FetchContent_Declare(
   libCZI
@@ -8,14 +12,5 @@ FetchContent_Declare(
   GIT_TAG        origin/main
 )
 
-if(NOT libCZI_POPULATED)
-  message(STATUS "Fetching libCZI")
-  FetchContent_Populate(libCZI)
-
-  set(LIBCZI_BUILD_CZICMD OFF CACHE BOOL "" FORCE)
-  set(LIBCZI_BUILD_DYNLIB OFF CACHE BOOL "" FORCE)
-  set(LIBCZI_BUILD_UNITTESTS OFF CACHE BOOL "" FORCE)
-
-  add_subdirectory(${libczi_SOURCE_DIR} ${libczi_BINARY_DIR})
-endif()
-
+# Fetch the content and make it available
+FetchContent_MakeAvailable(libCZI)