comparison Sphinx/source/plugins/webviewer.rst @ 29:1a6c863cf364

EnableGdcm and RestrictTransferSyntaxes options
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 20 Jul 2016 11:04:15 +0200
parents dc235678897c
children 93bbfaf0e62c
comparison
equal deleted inserted replaced
28:dc235678897c 29:1a6c863cf364
90 "/home/user/OrthancWebViewer/Build/libOrthancWebViewer.so" 90 "/home/user/OrthancWebViewer/Build/libOrthancWebViewer.so"
91 ], 91 ],
92 "WebViewer" : { 92 "WebViewer" : {
93 "CachePath" : "WebViewerCache", 93 "CachePath" : "WebViewerCache",
94 "CacheSize" : 10, 94 "CacheSize" : 10,
95 "Threads" : 4 95 "Threads" : 4,
96 "EnableGdcm" : false
96 } 97 }
97 } 98 }
98 99
99 * ``CachePath`` specifies the location of the cache of the Web 100 * ``CachePath`` specifies the location of the cache of the Web
100 viewer. By default, the cache is located inside the storage 101 viewer. By default, the cache is located inside the storage
101 directory of Orthanc. 102 directory of Orthanc.
102 * ``CacheSize`` specifies the maximum size for the cached images, in 103 * ``CacheSize`` specifies the maximum size for the cached images, in
103 megabytes. By default, a cache of 100 MB is used. 104 megabytes. By default, a cache of 100 MB is used.
104 * ``Threads`` specifies the number of threads that are used by the 105 * ``Threads`` specifies the number of threads that are used by the
105 plugin to decode the DICOM images. 106 plugin to decode the DICOM images.
107 * ``EnableGdcm`` specifies whether `GDCM
108 <https://sourceforge.net/projects/gdcm/>`__ should be used to decode
109 DICOM images, replacing the built-in decoder of Orthanc that
110 internally uses `DCMTK <http://dicom.offis.de/dcmtk.php.en>`__.
111 This is notably necessary to deal with DICOM images encoded using
112 `JPEG2000 <https://en.wikipedia.org/wiki/JPEG_2000>`__, as this
113 format is not readily supported by the core version of DCMTK. By
114 default, this option is set to ``true``.
115
116 As a complement to the ``EnableGdcm`` option, you also have the
117 possibility to restrict the GDCM decoder to some specific `transfer
118 syntaxes
119 <http://dicom.nema.org/medical/dicom/current/output/html/part05.html#chapter_10>`__
120 using the ``RestrictTransferSyntaxes`` option. For instance, the
121 following configuration would use GDCM to decode JPEG 2000 images,
122 while using DCMTK to decode the other transfer syntaxes::
123
124 {
125 [...]
126 "WebViewer" : {
127 "EnableGdcm" : true,
128 "RestrictTransferSyntaxes" : [
129 "1.2.840.10008.1.2.4.90", # JPEG 2000 Image Compression (Lossless Only)
130 "1.2.840.10008.1.2.4.91", # JPEG 2000 Image Compression
131 "1.2.840.10008.1.2.4.92", # JPEG 2000 Part 2 Multicomponent Image Compression (Lossless Only)
132 "1.2.840.10008.1.2.4.93" # JPEG 2000 Part 2 Multicomponent Image Compression
133 ]
134 }
135 }