changeset 928:f8a843621ddd

merge
author Alain Mazy <am@osimis.io>
date Wed, 29 Mar 2023 11:55:53 +0200
parents dfe96daba4f8 (current diff) 6e61cb5edf4c (diff)
children a7ac8e5edc89
files
diffstat 6 files changed, 99 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
Binary file Sphinx/source/images/VolView-OE2.png has changed
Binary file Sphinx/source/images/VolView.png has changed
--- a/Sphinx/source/plugins.rst	Wed Mar 29 11:54:58 2023 +0200
+++ b/Sphinx/source/plugins.rst	Wed Mar 29 11:55:53 2023 +0200
@@ -85,6 +85,7 @@
    plugins/tcia.rst
    plugins/indexer.rst
    plugins/neuro.rst
+   plugins/volview.rst
 
 .. _plugins-contributed:
 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Sphinx/source/plugins/volview.rst	Wed Mar 29 11:55:53 2023 +0200
@@ -0,0 +1,89 @@
+.. _volview:
+
+
+Kitware's VolView plugin
+========================
+
+.. contents::
+
+This **official** plugin by the `ICTEAM institute of UCLouvain
+<https://uclouvain.be/en/research-institutes/icteam>`__ extends
+Orthanc with `Kitware's VolView <https://volview.kitware.com/>`__ Web
+interface for cinematic volume rendering of DICOM data.
+
+
+Usage
+-----
+
+This plugin adds a dedicated button to Orthanc Explorer, which
+provides an easy access to VolView (click on the image to view a demo
+video):
+
+.. image:: ../images/VolView.png
+           :align: center
+           :width: 800
+           :target: https://www.youtube.com/watch?v=taQ6TiFJTHE
+|
+
+Starting with its release 0.8.2, the :ref:`Orthanc Explorer 2
+<orthanc-explorer-2>` plugin also provides a button to open VolView:
+
+
+.. image:: ../images/VolView-OE2.png
+           :align: center
+           :width: 800
+
+Compilation
+-----------
+
+.. highlight:: bash
+
+Official releases can be `downloaded from the Orthanc homepage
+<https://www.orthanc-server.com/browse.php?path=/plugin-volview>`__. As
+an alternative, the `repository containing the source code
+<https://orthanc.uclouvain.be/hg/orthanc-volview/>`__ can be accessed using
+Mercurial.
+
+The procedure to compile this plugin is similar of that for the
+:ref:`core of Orthanc <binaries>`. The following commands should work
+on most GNU/Linux distributions, provided Docker is installed::
+
+  $ mkdir Build
+  $ cd Build
+  $ ../Resources/CreateVolViewDist.sh
+  $ cmake .. -DSTATIC_BUILD=ON -DCMAKE_BUILD_TYPE=Release
+  $ make
+
+The compilation will produce a shared library ``libOrthancVolView.so``
+that contains the VolView plugin for Orthanc.
+
+Pre-compiled Linux Standard Base (LSB) binaries `are available for
+download <https://lsb.orthanc-server.com/plugin-volview/>`__.
+
+Pre-compiled binaries for Microsoft Windows and macOS `are also
+available
+<https://www.orthanc-server.com/browse.php?path=/plugin-volview>`__.
+
+Furthermore, the :ref:`Docker images <docker>`
+``jodogne/orthanc-plugins`` and ``osimis/orthanc`` also contain the
+plugin. Debian and Ubuntu packages can be found in the
+:ref:`standalone repository <binaries>`
+``https://debian.orthanc-labs.com/``.
+
+
+Configuration
+-------------
+
+.. highlight:: json
+
+Here is a minimal sample :ref:`configuration file <configuration>` to
+use this plugin::
+
+  {
+    "Plugins" : [
+      "/home/user/OrthancVolView/Build/libOrthancVolView.so"
+    ]
+  }
+
+Orthanc must of course be restarted after the modification of its
+configuration file.
--- a/Sphinx/source/users/cookbook.rst	Wed Mar 29 11:54:58 2023 +0200
+++ b/Sphinx/source/users/cookbook.rst	Wed Mar 29 11:55:53 2023 +0200
@@ -35,11 +35,12 @@
 .. highlight:: bash
 
 Furthermore, if you are running Debian 9 (stretch), Debian 10
-(buster), Debian 11 (bullseye), Ubuntu 18.04 LTS (bionic) or Ubuntu
-20.04 LTS (focal) on an **AMD64 architecture**, Sébastien Jodogne
-maintains a **standalone Debian repository** that provides the latest
-versions of the LSB binaries. For instance, here is how to install the
-:ref:`Stone Web viewer <stone_webviewer>` on a barebone Docker setup::
+(buster), Debian 11 (bullseye), Ubuntu 18.04 LTS (bionic), Ubuntu
+20.04 LTS (focal), or Ubuntu 22.04 LTS (jammy) on an **AMD64
+architecture**, Sébastien Jodogne maintains a **standalone Debian
+repository** that provides the latest versions of the LSB
+binaries. For instance, here is how to install the :ref:`Stone Web
+viewer <stone_webviewer>` on a barebone Docker setup::
 
   # docker run --rm -t -i -p 8042:8042 -p 4242:4242 debian:9
 
--- a/Sphinx/source/users/docker-osimis.rst	Wed Mar 29 11:54:58 2023 +0200
+++ b/Sphinx/source/users/docker-osimis.rst	Wed Mar 29 11:55:53 2023 +0200
@@ -461,6 +461,9 @@
 |                                                  |                                                  |     }                                                                                              |
 |                                                  |                                                  |   }                                                                                                |
 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
+| **Kitware's VolView**                            | ``VOLVIEW_PLUGIN_ENABLED``                       |                                                                                                    |
++--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
+
 Under the hood
 --------------