# 3D Slicer

{% hint style="warning" %}
Looking Glass support is only provided in 3D Slicer's Preview Release (unstable).
{% endhint %}

{% hint style="warning" %}
3D Slicer does not yet support the Looking Glass Go, Looking Glass 16" or Looking Glass 32" Light Field Displays.
{% endhint %}

## Overview

For medical professionals looking for ways to elevate the visual communication and comprehension of their work in 3D, [Kitware, Inc.](https://www.kitware.com/) and Looking Glass Factory have integrated the immersive holographic displays with 3D Slicer, an open-source, multi-platform medical imaging application.

To learn more about 3D Slicer, visit [slicer.org](https://www.slicer.org/).

## Getting Started

If this is the first time setting up a Looking Glass, visit the[ Getting Started](https://learn.lookingglassfactory.com/onboarding) page for your display.

This integration requires [Looking Glass Bridge](https://lookingglassfactory.com/software/#holoplay-service) v1.1.3 or later. Use this [diagnostic tool](https://lfdocs.lookingglassfactory.com/looking-glass-bridge#test-your-setup) to check which version you have installed if unsure.

Looking Glass support has been added to preview builds of 3D Slicer since Oct 15, 2020. To download select the **Preview Release** version from the download page:

[Download 3D Slicer](https://download.slicer.org/)

Kitware has prepared an easy-to-follow tutorial for setting up 3D Slicer in the Looking Glass for the first time:

{% embed url="<https://vimeo.com/581939319>" %}

## Loading Example Data

Download and unzip the above datasets to view. To load into the Looking Glass:

First, in 3D Slicer search for the "Sample Data" module by clicking on the magnifying glass in the Modules panel.

![sample data module](https://content.gitbook.com/content/PuCaeVAli72TiclYlEG5/blobs/3rEJRoF03vMGRHQRxEvF/sample-data-module.png)

Next, select any sample data set you'd like. Data prepended with CT tends to look best, tends to have better scanning resolution that MR or other formats.

Once loaded, switch to the Volume Rendering module (available in the pulldown).

![Volume Rendering module](https://content.gitbook.com/content/PuCaeVAli72TiclYlEG5/blobs/WDjel8csVrnKJ0wSNGfj/volume-rendering-module.png)

Inside the Volume Rendering module, with your dataset selected in the "Volume" field, (1) select the eye tool. Then (2) change to a preset relevant to your data. Lastly, (3) adjust the shift so you can see the most of the model. **NOTE** Rendering should stay on **GPU** (not **CPU**) rendering.

![Inside the Volume Rendering module](https://content.gitbook.com/content/PuCaeVAli72TiclYlEG5/blobs/bCrnHsM7IL2Wb7Xpw334/volume-rendering-module2.png)

## Quick Reference

This reference covers all you need to navigate and control functionality specific to the Looking Glass.

For a comprehensive reference on all the features 3D Slicer has to offer, please visit the [documentation on their site](https://www.slicer.org/wiki/Documentation).

### Mouse Controls

Place your mouse in the 3D view of the 2D interface to execute the following interactions:

* **Left click and drag** - rotate the camera around the data
* **Scroll wheel click and drag** - pan the scene
* **Right click and drag / Scroll wheel** - scale the scene larger and smaller

### Looking Glass Module Controls

![module panel](https://content.gitbook.com/content/PuCaeVAli72TiclYlEG5/blobs/HDDxsE22hQqNEFAp1XyJ/panel.png)

**Connect to hardware**

Toggles whether or not connected to hardware.

**Enable rendering**

Toggles whether or not rendering is enabled

**Rendering**

Changes the refresh settings of the rendered Looking Glass 3D scene.

* OnlyWhenRequested - only refreshes after user presses "Set looking glass view to match reference view."
* OnlyStillRenders -  render view refreshes when user pauses
* Always - render view refreshes in realtime

**Update rate**

Rate at which 3D Slicer attempts to update the image on the Looking Glass. Higher rates are achieved by reducing render fidelity.

**Set looking glass view to match reference view.**

Renders the 3D view in the Looking Glass when OnlyWhenRequested is selected from the "Rendering" pulldown above.

**Reference View**

Selects which 3D viewport should render on the Looking Glass.

**Focal Plane**

Pushes / pulls the focal plane forward or back.

**Uses clipping limits**

Toggles whether clipping limits are enabled

**Near Clipping Limit**

Adjusts the near clipping plane of the rendered scene.

**Far Clipping Limit**

Adjusts the far clipping plane of the rendered scene.

## Support

For further 3D Slicer support, visit the [3D Slicer Forum](https://discourse.slicer.org/).

## Show us your work!

We are deeply excited about supporting the medical visualization community in viewing their data in 3D on our displays. Please share video of the work that you do, either by tweeting [@LKGGlass](https://twitter.com/LKGGlass) or emailing us at <support@lookingglassfactory.com>!