.. _cmake-parameters:

.. toctree::
   :hidden:

CMake Parameters
----------------

.. list-table:: CMake Basilisk Build Parameters
    :widths: 25 15 70
    :header-rows: 1

    * - CMake Parameter
      - Default
      - Description
    * - ``BUILD_VIZINTERFACE``
      - ``ON``
      - will create :ref:`vizInterface`
    * - ``BUILD_OPNAV``
      - ``OFF``
      - will create the OpenCV dependent optical navigation related modules
    * - ``EXTERNAL_MODULES_PATH``
      - Empty
      - path to external modules folder, see :ref:`buildExtModules`
    * - ``URL_SPICE_KERNEL``
      - https://naif.jpl.nasa.gov/pub/naif/generic_kernels/spk/planets/de430.bsp
      - URL from which to download spice kernel de430.bsp dependency

CMake Example (same on macOS or Linux)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
While it is significantly easier to use the provided CMake presets or setting up your own user present, there may be
a time when you want to call CMake and pass the parameters. The following are simple examples of doing that.

.. code-block:: console

    cd src
    cmake -S . -B ../dist3 -DEXTERNAL_MODULES_PATH=../../ExternalModules -DBUILD_OPNAV=ON -DBUILD_VIZINTERFACE=ON
    cmake --build ../dist3