Mercurial > hg > orthanc-stone

annotate Applications/StoneWebViewer/NOTES.txt @ 1719:9a1f79d21a3f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
added buttons to go to the first and last frames
author Sebastien Jodogne <s.jodogne@gmail.com>
date Tue, 01 Dec 2020 10:42:45 +0100
parents 1952162474c3
children b8d19f53aaca
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1691
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 Differences with Osimis Web viewer
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 ==================================
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6 - The images are retrieved using DICOMweb.
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7
1702
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
8
1708
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1702
diff changeset
9 - In the Stone Web viewer, the individual instances are loaded on
1715
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
10 an as-needed basis, in order to reduce the network bandwidth usage.
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
11 This contrasts with the Osimis Web viewer that loads the entire images
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
12 in the background.
1708
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1702
diff changeset
13
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1702
diff changeset
14
1715
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
15 - Contrarily to the Osimis Web viewer, the Stone Web viewer does not
1709
2931f5e15320 download study from Stone Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1708
diff changeset
16 currently support annotations, and will not support Live Share.
2931f5e15320 download study from Stone Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1708
diff changeset
17
2931f5e15320 download study from Stone Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1708
diff changeset
18
1719
9a1f79d21a3f added buttons to go to the first and last frames
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1715
diff changeset
19 - The Stone Web viewer has no "timeline" bar to see the position of
9a1f79d21a3f added buttons to go to the first and last frames
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1715
diff changeset
20 the current frame in the series. However, pressing the "Ctrl" key
9a1f79d21a3f added buttons to go to the first and last frames
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1715
diff changeset
21 together with mouse wheel enables fast move, i.e. this changes the
9a1f79d21a3f added buttons to go to the first and last frames
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1715
diff changeset
22 current frame by skipping 1/20th of the frames in the series.
9a1f79d21a3f added buttons to go to the first and last frames
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1715
diff changeset
23
9a1f79d21a3f added buttons to go to the first and last frames
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1715
diff changeset
24
1715
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
25 - The Stone Web viewer uses the DICOM identifiers, while the Osimis Web
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
26 viewer uses the Orthanc identifiers.
1691
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
27 https://book.orthanc-server.com/faq/orthanc-ids.html
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
28
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
29 In the Stone Web viewer, the studies are indexed by their "Study
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
30 Instance UID" tag (0020,000d). The series are indexed by their
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
31 "Series Instance UID" tag (0020,000e). To open a single series,
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
32 the parent study must be provided.
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
33
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
34 To open a single study:
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35 http://.../index.html?study=<StudyInstanceUID>
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37 To open a single series:
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 http://.../index.html?study=<StudyInstanceUID>&series=<SeriesInstanceUID>
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39
1702
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
40
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
41 - In the Osimis Web viewer, the "OpenAllPatientStudies" configuration
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
42 option can be provided to search Orthanc for all studies from
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
43 patients with the same PatientID as the selected study, then display
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
44 them.
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
45
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
46 In the Stone Web viewer, the "OpenAllPatientStudies" configuration
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
47 option is replaced by the single "patient" GET argument. This option
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
48 contains a comma-separated list of "Patient ID" tag (0010,0020).
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
49
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
50 To open all the studies of one patient:
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
51 http://.../index.html?patient=<PatientID>
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
52
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
53 To open all the studies of several patients:
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
54 http://.../index.html?patient=<PatientID1>,<PatientID2>,...
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
55
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
56
1692
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
57 - In the Osimis Web viewer, the "pickableStudyIds" parameter in the
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
58 URL defines the list of studies that are available for display, and
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
59 that are listed in the dropdown at the top-left of the interface.
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
60
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
61 In the Stone Web viewer, "pickableStudyIds" is replaced by the
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
62 single "study" GET argument, that is allowed to contain a
1702
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
63 comma-separated list of studies. The "series" parameter must not be
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
64 provided in this case.
1691
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
65
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
66 To open a list of studies:
4a49de03a419 porting the "pickableStudyIds" feature of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
67 http://.../index.html?study=<StudyInstanceUID1>,<StudyInstanceUID2>,...
1702
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
68
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
69
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
70 - In the Osimis Web viewer, the "selectedStudyIds" parameter in the
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
71 URL defines the list of studies that are selected in the dropdown at
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
72 the top-left corner of the viewer (those studies are therefore
bc40b6450261 "patient" GET argument
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1696
diff changeset
73 displayed when the viewer starts).
1692
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
74
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
75 In the Stone Web viewer, "selectedStudyIds" is replaced by the
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
76 "selectedStudies" GET argument, that is allowed to contain a
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
77 comma-separated list of studies.
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
78
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
79 To make a list of studies available, but display only one of those
1715
1952162474c3 A few æsthetic changes in the text body
Benjamin Golinvaux <bgo@osimis.io>
parents: 1709
diff changeset
80 studies when the viewer starts, please use:
1692
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
81 http://.../index.html?study=<StudyInstanceUID1>,<StudyInstanceUID2>,...&selectedStudies=<StudyInstanceUID1>
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
82
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
83 If the "selectedStudies" is not provided, then all the studies are
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
84 displayed at the startup.
e787b52d025f "selectedStudies" argument to replace "selectedStudyIds" from Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1691
diff changeset
85
1696
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
86
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
87 Dynamic actions using messages
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
88 ==============================
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
89
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
90 Some actions can be dynamically triggered in the Stone Web viewer from
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
91 another Web page. This is done by using the "window.postMessage()"
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
92 primitive of JavaScript:
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
93 https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
94
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
95 Each message must be a JSON object containing at least the "type"
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
96 field. The latter field indicates the type of action to be triggered.
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
97
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
98 For security, the "ExpectedMessageOrigin" configuration option of the
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
99 Stone Web viewer must have been set to the expected origin of the
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
100 messages. Otherwise, the Stone Web viewer will reject the message.
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
101
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
102
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
103 Action of type "show-osirix-annotations"
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
104 ----------------------------------------
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
105
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
106 This action loads a set of ROIs exported from OsiriX. The ROIs must
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
107 use the XML file format of OsiriX.
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
108
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
109 The parent DICOM study containing the annotation(s) must have been
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
110 loaded by the Stone Web viewer beforehand. The Stone Web viewer shall
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
111 automatically focus on one instance that is associated with the ROIs.
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
112
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
113 The JSON message must contain the following fields:
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
114
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
115 - "type" must be equal to "show-osirix-annotations"
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
116
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
117 - "xml" must contain the XML file generated by OsiriX
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
118
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
119 - "clear" is a Boolean to indicate whether to clear the annotations
572652803929 bootstrapping the Stone Web viewer configuration file
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1692
diff changeset
120 that have previously been opened.