## Module: Slab View (
)

### Description:

> This is an experimental module from the Xtra Library: https://xtras.amira-avizo.com.

> This display module controls one slice and one clipping plane simultaneously.
> It can be configured so the clipping plane remains at a fixed distance from the slice: this offset will be kept even if the slice is moved away from its current position.
> Finally the clipping of both the slice and the clipping plane can be activated in the same or in opposite direction.

> This module can typically be used to compare a 3D structure against an 3D image.
> Example: progressively evaluate through a whole volume the accuracy of some reconstructed fibers by comparing their spatial graph representation against the original acquisition.

### Connections:

> Data `[required]`
> The 3D field to be visualized. Currently, regular scalar fields, multi-channel fields, and RGBA color fields with uniform or stacked coordinates are supported.

> Colormap `[optional]`
> Optional colormap used to map scalar data to colors. This port is hidden when Histogram mapping is selected. See also Colormap.

### Ports:

> Console
> Opens the Python Script Object console of the module as the active console window.

> Orientation
> This port provides three buttons for resetting the slice orientation: xy perpendicular to the z-axis, xz perpendicular to the y-axis, or yz perpendicular to the x-axis.

> Colormap
> This port allows selecting the colormap and adjusting the colormap range. More details about this port are provided here. This port is displayed if mapping type is set to Colormap.

> Slice Frame
> This port is used to display or hide the frame of the slice, set the frame width and color.

> Clipping Plane Frame
> This port is used to display or hide the frame of the clipping plane, set the frame width and color.

> Slice Options
> If the adjust view toggle is set, the camera of the selected viewer is reset each time a new slice orientation is selected.

> With the rotate toggle you can switch the rotate handle for the cutting plane on and off.

> If the immediate toggle is set, the slice is updated every time you drag it with the mouse in the 3D viewer. Otherwise, only the bounding box of the cutting plane is moved and the update takes place when the mouse button is released.

> The fit to points toggle lets you reset the plane by clicking on at least 3 different points in the scene. After enabling this toggle, you should switch to interaction mode by pressing the ESC key inside the viewer. Then click 3 times at different points on any geometry in the scene. The plane then will be automatically adjusted to match these points. The virtual trackball - visible when rotate toggle is active - will be moved to the center of the picked points. After 3 points have been picked, this toggle is automatically unchecked, unless you pressed the shift key. Shift-clicking allows you to select more than 3 points. In this case the plane that best fits the selected points will be computed.

> Checking the lighting option simulates the slice being illuminated by a headlight. Thereby, the intensity of the slice is modulated according to the direction of the slice's normal. Thus, the more obliquely the slice is viewed the darker it becomes.

> Clipping Plane Normal
> This button triggers the automatic realignement of the clipping plane normal onto the slice normal.
> This can typically be used after a rotation has been applied to the slice for instance.

> Slice Translate
> This slider allows you to change the slice position. The slices may also be picked with the mouse and dragged directly in the 3D viewer.

> Clipping Plane Offset
> This slider enables to set the offset of the clipping plane from the slice.
> The offset is defined as a percentage of the total number of slices for the orientation currently set.

> Slice
> Controls the clipping performed by the slice. Three modes are cycling: Clip, Unclip and Invert Clip.

> Clipping Plane
> Controls the clipping performed by the clipping plane. Three modes are cycling: Clip, Unclip and Invert Clip.

> Visibility in viewers
> These buttons enable to respectively toggle the visibility of the slice and the clipping plane in all viewers: the four viewers (top left, top right, bottom left, bottom right) and the extra viewer.