<?xml version="1.0" encoding="utf-8"?>
<executable>
  <category>Core</category>
  <title>Volume Rendering</title>
  <description><![CDATA[Volume Rendering Module provides advanced tools for toggling interactive volume rendering of datasets.]]></description>
  <documentation-url>http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.3/Modules/VolumeRendering</documentation-url>
  <license>slicer4</license>
  <contributor>Julien Finet (Kitware), Alex Yarmarkovich (Isomics), Yanling Liu (SAIC-Frederick, NCI-Frederick), Andreas Freudling (SPL, BWH), Ron Kikinis(SPL, BWH)</contributor>
  <acknowledgements><![CDATA[This work is part of the National Alliance for Medical Image Computing (NAMIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Some of the transfer functions were contributed by Kitware Inc. (VolView)]]></acknowledgements>
  <parameters>
    <label>Inputs</label>
    <description><![CDATA[Contains the list of nodes required for VolumeRendering. It is unlikely that you need to interact with controllers.]]></description>
    <parameter>
      <label>Volume</label>
      <description><![CDATA[Select the current volume to render. Note that only one volume can be rendered at a time.]]></description>
    </parameter>
    <parameter>
      <label>Display</label>
      <description><![CDATA[Select the current volume rendering display properties. Volume rendering display nodes contains all the information relative to volume rendering. They contain pointers to the ROI, volume property and view nodes. A new display node is automatically created if none exist for the current volume.]]></description>
    </parameter>
    <parameter>
      <label>ROI</label>
      <description><![CDATA[Select the current ROI to optionally crop with 6 planes the volume rendering.]]></description>
    </parameter>
    <parameter>
      <label>Property</label>
      <description><![CDATA[Select the current Volume Property. Volume properties contain the opacity, color and gradient transfer functions for each component.]]></description>
    </parameter>
    <parameter>
      <label>View</label>
      <description><![CDATA[Select the 3D views where the volume rendering must be displayed into. If no view is selected, the volume rendering is visible in all views]]></description>
    </parameter>
  </parameters>
  <parameters>
    <label>Display</label>
    <description><![CDATA[Main properties for the volume rendering.]]></description>
    <parameter>
      <label>Preset</label>
      <description><![CDATA[Apply a pre-defined set of functions for the opacity, color and gradient transfer functions. The generic presets have been tuned for a combination of modalities and organs. They may need some manual tuning to fit your data.]]></description>
    </parameter>
    <parameter>
      <label>Shift</label>
      <description><![CDATA[Move all the inner points (first and last excluded) of the current transfer functions to the right/left (lower/higher). It can be useful when a preset defines a ramp from 0 to 200 but your data requires a ramp from 1000 to 1200.]]></description>
    </parameter>
    <parameter>
      <label>Crop</label>
      <description><![CDATA[Simple controls for the cropping box (ROI). More controls are available in the "Advanced..." section. Enable/Disable cropping of the volume. Show/Hide the cropping box. Reset the box ROI to the volume's bounds.]]></description>
    </parameter>
    <parameter>
      <label>Rendering</label>
      <description><![CDATA[Select a volume rendering method. A default method can be set in the application settings Volume Rendering panel.<br  /><UL><b>VTK CPU Ray Casting:</b> Available on all platforms, the volume rendering is enterily realized on the CPU (default)<br  /><b>VTK GPU Ray Casting</b>: Available on all platforms except on Mac with an NVidia graphic card, fastest method to volume render<br  /><b>VTK OpenGL 3D Texture Mapping:</b> Available on all platforms, use the GPU but it is not ray casting<br  /><b>NCI GPU Ray Casting</b>: Available on all platforms, ray caster on the GPU, doesn't support compositing.]]></description>
    </parameter>
  </parameters>
  <parameters>
    <label>Advanced</label>
    <description><![CDATA[More controls to control the volume rendering. Contains 3 tabs: "Techniques", "Volume Properties" and "ROI"]]></description>
    <parameter>
      <label>Technique</label>
      <description><![CDATA[Advanced properties of the current volume rendering method.]]></description>
    </parameter>
    <parameter>
      <label>GPU Memory Size</label>
      <description><![CDATA[Amount of memory to allocate on the GPU for volume rendering. By default, all the memory of the GPU is allocated. You can change the default behavior in the application settings Volume Rendering panel.]]></description>
    </parameter>
    <parameter>
      <label>Quality Control</label>
      <description><![CDATA[Not supported yet.]]></description>
    </parameter>
    <parameter>
      <label>Interactive speed</label>
      <description><![CDATA[Ensure the given frame per second (FPS) is enforced in the views during interaction. The higher the FPS, the lower the resolution of the volume rendering]]></description>
    </parameter>
    <parameter>
      <label>Synchronize with Volumes module</label>
      <description><![CDATA[<br  /><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Click:</b> Apply once the properties (window/level, threshold, lut) of the Volumes module to the Volume Rendering module.<br  /><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Toggled: </b>By clicking on the checkbox, you can toggle the button. When toggled, any modification occuring in the Volumes module is instantaneously applied to the volume rendering]]>
      </description>
    </parameter>
  </parameters>
  <parameters>
    <label>Volume Properties</label>
    <description><![CDATA[Advanced views of the transfer functions.]]></description> 
    <parameter>
      <label>Left button click</label>label>
      <description><![CDATA[Set current point or create a new point if no point is under the mouse.]]></description>
    </parameter> 
    <parameter>
      <label>Left button move</label> 
      <description><![CDATA[Move the current or selected points if any.]]></description>
    </parameter>
    <parameter>
      <label>Right button click</label>
      <description><![CDATA[Select/unselect point. Selected points can be moved at once]]></description>
    </parameter>
    <parameter>
      <label>Right button move</label>
      <description><![CDATA[Define an area to select points:]]></description>  
    </parameter>
    <parameter>
      <label>Middle button click </label>
      <description><![CDATA[Delete point under the mouse cursor.]]></description>
    </parameter>
    <parameter>
      <label>Right/Left arrow keys</label> 
      <description><![CDATA[Change of current point]]></description>
    </parameter>
    <parameter>
      <label>Delete key</label> 
      <description><![CDATA[Delete the current point and set the next point as current]]></description>
    </parameter>
    <parameter>
      <label>Backspace key </label>
      <description><![CDATA[Delete the current point and set the previous point as current]]></description>
    </parameter>
    <parameter>
      <label>ESC key</label>
      <description><![CDATA[Unselect all points.]]></description>
    </parameter>
    <parameter>
      <label>Unsupported </label> 
      <description><![CDATA["ALT to move selected points", "CTRL-A to select all points"]]></description>
    </parameter>
    <parameter>
      <label>Control Inputs:</label>
      <description><![CDATA[<br  />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X: scalar value<BR  />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;O: opacity<br  />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;M: mid-point<br  />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;S: sharpness]]></description>
    </parameter>
    <parameter>
      <label>Scalar Opacity Mapping</label>
      <description><![CDATA[Opacity transfer function. Threshold mode: enabling threshold controls the transfer function using range sliders in addition to control points.]]></description>
    </parameter>
    <parameter>
      <label>Scalar Color Mapping</label>
      <description><![CDATA[Color transfer function.]]></description>
    </parameter>
    <parameter>
      <label>Gradient Opacity</label>
      <description><![CDATA[Gradient opacity transfer function. This controls the opacity according to how large a density gradient next to the voxel is.]]></description>
    </parameter>
    <parameter>
      <label>Interpolation</label>
      <description><![CDATA[Linear (default for scalar volumes) or nearest neighboor (default for labelmaps) interpolation.]]></description>
    </parameter>
    <parameter>
      <label>Shade</label>
      <description><![CDATA[Enable/Disable shading. Shading uses light and material properties.]]></description>
    </parameter>
    <parameter>
      <label>Material</label>
      <description><![CDATA[Material properties of the volume to compute shading effect.]]></description>
    </parameter>
    <parameter>
      <label>ROI</label>
      <description><![CDATA[More controls for the cropping box.]]></description>
    </parameter>
    <parameter>
      <label>Display Clipping box</label>
      <description><![CDATA[Show hide the bounds of the ROI box.]]></description>
    </parameter>
    <parameter>
      <label>Interactive mode</label>
      <description><![CDATA[Control wether the cropping box is instantaneously updated when dragging the sliders or only when the mouse button is released.]]></description>
    </parameter>
  </parameters>

</executable>
