MuseumInterface by GTMA

Custom version of Slicer for museum exhibition

Prerequisites

• Operating System:

  • Microsoft Windows 7 or above recommended
  • Ubuntu 18.04

• Tested Microsoft Visual Studio versions:

  • Visual Studio 2015

• Tools:

  • CMake
    • Version 3.11 or above
  • Qt
    • Version 5.9.8 or above
  • Git
  • Subversion

• Setting up your git account:

  • Setup your SSH keys following these instructions at the exception of step 2 where you should NOT enter a passphrase.

    • Start Git Bash and introduce ssh-keygen to create a ssh key.
    • In GitLab, go to User Setting > SSH Keys and introduce the public key located on [User Dir]\.ssh\id_rsa.pub.

  • Setup your git username and your git email.

  • If not already done, email Abián Hernández <[email protected]> to be granted access to the GTMA/MuseumInterface repository.

Checkout

1. Start Git Bash
2. Checkout the source code into a directory C:\W\ by typing the following commands:

cd /c
mkdir W
cd /c/W
git clone git@alix.iuibs.ulpgc.es:ULPGC.GTMA/MuseumInterface.git MuseumInterface

Note: in Windows, use short source and build directory names to avoid the maximum path length limitation.

Build

Note: The build process will take approximately 3 hours.

Building on Windows:

Option 1: CMake GUI and Visual Studio (Recommended)

1. Start CMake GUI, select source directory C:\W\MuseumInterface and set build directory to C:\W\Build.
2. Add an entry Qt5_DIR pointing to:
   • [Qt Location]\[Qt Version]\[MSVC Version]\lib\cmake\Qt5\.
3. Generate the project.
4. Open the project using the Open Project button in CMake, select Release and build the project.

Note: It is mandatory to use CMake macros of Git that are located in [Git location]\usr\bin. This path should be included in Windows PATH Variable.

Warning: Sometimes is necessary create the Slicer-build/bin directory because it is not created in Building time.

Option 2: Command Line

1. Start the Command Line Prompt
2. Configure and build the project in C:\W\Build by typing the following commands:

cd C:\W\
mkdir Build
cd Build
cmake -G "Visual Studio 14 2015 Win64" -DQt5_DIR=[Qt Location]\[Qt Version]\[MSVC Version]\lib\cmake\Qt5\ ..\MuseumInterface
cmake --build . --config Release

Package

Install NSIS 2

Option 1: CMake and Visual Studio (Recommended)

1. In the C:\W\MuseumInterface-rel\Slicer-build directory, open Slicer.sln and build the PACKAGE target

Option 2: Command Line

1. Start the Command Line Prompt
2. Build the PACKAGE target by typing the following commands:

cd C:\W\MuseumInterface-rel\Slicer-build
cmake --build . --config Release --target PACKAGE

Resources

• 3D Slicer Developer Wiki