annotate Sphinx/source/faq/video.rst @ 1113:a588960a72e5 default tip

spelling
author Alain Mazy <am@orthanc.team>
date Mon, 28 Oct 2024 09:23:08 +0100
parents bfc31c51809f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
732
bfc31c51809f download pdf and videos
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 361
diff changeset
1 .. _videos:
bfc31c51809f download pdf and videos
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 361
diff changeset
2
2
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 Does Orthanc support videos?
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 ============================
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6 The answer to this question really depends on what you mean by
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7 "support" and "video":
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
8
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
9 * In the world of DICOM, a "video" can either refer to a 2D+t (aka. a
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
10 "cine" sequence of individual frames) or a real video (compressed
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11 using H.264 or MPEG2). For instance, ultrasound devices would
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 generate cine sequences, whereas recent endoscopes would generate
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
13 real videos.
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14 * Depending on the context, "support" can mean "*Is Orthanc able to
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15 query/receive/transfer DICOM files?*", or "*Is Orthanc able to
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16 render/play DICOM files?*".
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 If you "just" want to **query/receive/transfer** DICOM videos, Orthanc
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19 will work fine either with 2D+t or real videos (because Orthanc is a
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
20 `Vendor Neutral Archive
8
ab80b2b3cdbd new section about supported features in FAQ
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2
diff changeset
21 <https://en.wikipedia.org/wiki/Vendor_Neutral_Archive>`__). This
ab80b2b3cdbd new section about supported features in FAQ
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2
diff changeset
22 distinction is also discussed in :ref:`another FAQ entry
ab80b2b3cdbd new section about supported features in FAQ
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2
diff changeset
23 <supported-images>`.
2
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
24
732
bfc31c51809f download pdf and videos
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 361
diff changeset
25 It is easy to **extract and download** the raw video embedded in the
bfc31c51809f download pdf and videos
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 361
diff changeset
26 DICOM instance using the :ref:`REST API of Orthanc
bfc31c51809f download pdf and videos
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 361
diff changeset
27 <download-pdf-videos>`.
bfc31c51809f download pdf and videos
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 361
diff changeset
28
361
84e3a2612c36 links to hg
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 358
diff changeset
29 If you also want to **play** the videos, the :ref:`Osimis Web Viewer
84e3a2612c36 links to hg
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 358
diff changeset
30 plugin <osimis_webviewer>` is able to play H.264 (MPEG4) videos and
84e3a2612c36 links to hg
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 358
diff changeset
31 2D+t (cine) sequences but not MPEG2 videos that currently can not be
84e3a2612c36 links to hg
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 358
diff changeset
32 played by Web browsers.
279
96750e66dd87 videos: Osimis viewer does support MPEG4
amazy
parents: 8
diff changeset
33
96750e66dd87 videos: Osimis viewer does support MPEG4
amazy
parents: 8
diff changeset
34 If your video is a 2D+t (cine) sequence, Orthanc can also display it inside
96750e66dd87 videos: Osimis viewer does support MPEG4
amazy
parents: 8
diff changeset
35 a Web browser by at least 2 different means:
2
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37 1. The built-in, administrative interface called :ref:`Orthanc
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 Explorer <orthanc-explorer>` is able to display the individual
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39 frames and manually navigate between them through keyboard.
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
40 2. The official `Web viewer plugin
358
011b01ccf52d fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 280
diff changeset
41 <https://www.orthanc-server.com/static.php?page=web-viewer>`__ will
2
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
42 allow you to use the mouse scroll wheel to display the successive
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
43 frames of the video.
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
44
279
96750e66dd87 videos: Osimis viewer does support MPEG4
amazy
parents: 8
diff changeset
45 To summarize, if your video is not encoded with MPEG2, OR if
2
eedc7e9fea4e Does Orthanc support videos?
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
46 you do not need to play the video within a Web browser, Orthanc
280
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 279
diff changeset
47 actually supports video if the Osimis Web viewer plugin is installed.