annotate Sphinx/source/plugins/volview.rst @ 925:897903f8deb8

added volview plugin
author Sebastien Jodogne <s.jodogne@gmail.com>
date Fri, 24 Mar 2023 15:11:02 +0100
parents
children 6e61cb5edf4c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
925
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1 .. _volview:
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 Kitware's VolView plugin
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5 ========================
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7 .. contents::
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
8
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
9 This **official** plugin by the `ICTEAM institute of UCLouvain
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
10 <https://uclouvain.be/en/research-institutes/icteam>`__ extends
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11 Orthanc with `Kitware's VolView <https://volview.kitware.com/>`__ Web
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 interface for cinematic volume rendering of DICOM data.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
13
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15 Usage
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16 -----
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 This plugin adds a dedicated button to Orthanc Explorer, which
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19 provides an easy access to VolView (click on the image to view a demo
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
20 video):
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
22 .. image:: ../images/VolView.png
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
23 :align: center
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
24 :width: 800
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
25 :target: https://www.youtube.com/watch?v=taQ6TiFJTHE
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
26 |
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
27
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
28 Starting with its release 0.8.0, the :ref:`Orthanc Explorer 2
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
29 <orthanc-explorer-2>` plugin also provides a button to open VolView.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
30
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
31 Compilation
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
32 -----------
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
33
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
34 .. highlight:: bash
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36 Official releases can be `downloaded from the Orthanc homepage
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37 <https://www.orthanc-server.com/browse.php?path=/plugin-volview>`__. As
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 an alternative, the `repository containing the source code
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39 <https://orthanc.uclouvain.be/hg/orthanc-volview/>`__ can be accessed using
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
40 Mercurial.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
41
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
42 The procedure to compile this plugin is similar of that for the
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
43 :ref:`core of Orthanc <binaries>`. The following commands should work
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
44 on most GNU/Linux distributions, provided Docker is installed::
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
45
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
46 $ mkdir Build
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
47 $ cd Build
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
48 $ ../Resources/CreateVolViewDist.sh
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
49 $ cmake .. -DSTATIC_BUILD=ON -DCMAKE_BUILD_TYPE=Release
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
50 $ make
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
51
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
52 The compilation will produce a shared library ``libOrthancVolView.so``
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
53 that contains the VolView plugin for Orthanc.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
54
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
55 Pre-compiled Linux Standard Base (LSB) binaries `are available for
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
56 download <https://lsb.orthanc-server.com/plugin-volview/>`__.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
57
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
58 Pre-compiled binaries for Microsoft Windows and macOS `are also
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
59 available
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
60 <https://www.orthanc-server.com/browse.php?path=/plugin-volview>`__.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
61
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
62 Furthermore, the :ref:`Docker images <docker>`
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
63 ``jodogne/orthanc-plugins`` and ``osimis/orthanc`` also contain the
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
64 plugin. Debian and Ubuntu packages can be found in the
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
65 :ref:`standalone repository <binaries>`
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
66 ``https://debian.orthanc-labs.com/``.
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
67
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
68
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
69 Configuration
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
70 -------------
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
71
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
72 .. highlight:: json
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
73
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
74 Here is a minimal sample :ref:`configuration file <configuration>` to
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
75 use this plugin::
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
76
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
77 {
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
78 "Plugins" : [
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
79 "/home/user/OrthancVolView/Build/libOrthancVolView.so"
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
80 ]
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
81 }
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
82
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
83 Orthanc must of course be restarted after the modification of its
897903f8deb8 added volview plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
84 configuration file.