.. _vizardDownload:

Download
========

.. image:: /_images/static/basiliskVizardLogo.png
       :align: right
       :scale: 50 %

The latest Vizard application binaries binaries can be directly downloaded using the following links.
Install the program in the typical Applications folder or Desktop.

- :download:`Vizard macOS (Universal) <https://hanspeterschaub.info/bskFiles/Vizard_macOS.zip>`
- :download:`Vizard Linux <https://hanspeterschaub.info/bskFiles/Vizard_Linux.zip>`
- :download:`Vizard Windows <https://hanspeterschaub.info/bskFiles/Vizard_Windows64.zip>`


.. warning::

    The custom Unity asset loading requires Vizard v2.1.1 or later.

.. warning::

    Starting with Vizard 2.4 the atmosphere shaders and HD textures are now separated from the released binary and
    can be downloaded below.

The following optional downloads contain models for a range space objects that are too large to
include in the main Vizard binary. You download the desired binaries for the platform you are using
and put them in a specific file location.  On start-up, Vizard checks for their presence and will
load in the space object model if needed.

The bundles depend on the Unity version used to build Vizard.  After opening Vizard, go to ``File/About Vizard``
to see what version of Unity was used to build the application.  Select the appropriate year in the download table.

The bundle must be installed in specific directories on each platform.  On macOS install the bundle in::

    ~/Library/Application Support/Vizard/Vizard/Resources/CustomModels

On Linux, install the bundle contents in::

    home/your_user_name/.config/unity3d/Vizard/Vizard/Resources/CustomModels

On Window, install the bundle contents in::

    C:/Users/your_user_name/AppData/LocalLow/Vizard/Vizard/Resources/CustomModels

Download the platform specific bundles file, unzip it, and move the contents to the ``CustomModels`` folder.

.. note::

    Vizard does not support sub-folders in the ``CustomModels`` folder.  All Unity asset files should
    be directly installed in the ``CustomModels`` folder.

.. list-table:: Unity Asset Download (Vizard 2.1.1 - current)
    :widths: 15 40 15 15 15
    :header-rows: 1

    * - Asset Name
      - Summary
      -
      -
      -
    * - HD Materials
      - Includes the high-fidelity atmosphere shader, nice ring shader, and Milkyway Skybox
      - :download:`macOS<https://hanspeterschaub.info/bskFiles/Assets/Vizard_HD_Materials_macOS.zip>`
      - :download:`Linux<https://hanspeterschaub.info/bskFiles/Assets/Vizard_HD_Materials_Linux.zip>`
      - :download:`Windows<https://hanspeterschaub.info/bskFiles/Assets/Vizard_HD_Materials_Windows.zip>`
    * - :ref:`assetAsteroids`
      - Asteroid model package including high fidelity models of Bennu, Ryugu, Itokawa, as well as some
        generic asteroid models
      - :download:`macOS<https://hanspeterschaub.info/bskFiles/Assets/asteroids_macOS.zip>`
      - :download:`Linux<https://hanspeterschaub.info/bskFiles/Assets/asteroids_Linux.zip>`
      - :download:`Windows<https://hanspeterschaub.info/bskFiles/Assets/asteroids_Windows.zip>`
    * - :ref:`assetMartianMoons`
      - Package including models for Phobos and Deimos
      - :download:`macOS<https://hanspeterschaub.info/bskFiles/Assets/martianmoons_macOS.zip>`
      - :download:`Linux<https://hanspeterschaub.info/bskFiles/Assets/martianmoons_Linux.zip>`
      - :download:`Windows<https://hanspeterschaub.info/bskFiles/Assets/martianmoons_Windows.zip>`
    * - :ref:`assetIceSat2_Kepler`
      - Package including models for spacecraft IceSat2 and Kepler
      - :download:`macOS<https://hanspeterschaub.info/bskFiles/Assets/IceSat2_Kepler_macOS.zip>`
      - :download:`Linux<https://hanspeterschaub.info/bskFiles/Assets/IceSat2_Kepler_Linux.zip>`
      - :download:`Windows<https://hanspeterschaub.info/bskFiles/Assets/IceSat2_Kepler_Windows.zip>`

.. toctree::
   :hidden:

   assetAsteroids
   assetMartianMoons
   assetIceSat2_Kepler