|
1 | 1 | --- |
2 | | -title: MPR Viewer and 3D cursor |
| 2 | +title: MPR Viewer |
3 | 3 | weight: 50 |
4 | 4 | description: How to use Multiplanar reconstruction (MPR) and 3D cursor (crosshair) |
5 | 5 | keywords: [ "mpr", "multiplanar reconstruction", "3d cursor", "open source dicom viewer" ] |
6 | 6 | --- |
7 | 7 |
|
8 | | -## <center>MPR Viewer and 3D cursor (crosshair)</center> |
| 8 | +## <center>Multiplanar reconstruction (MPR) {{< svg-inline "static/tuto/icon/mpr.svg" >}}</center> |
| 9 | + |
| 10 | +The multiplanar reconstruction (MPR) allows you to create, from the original plane (usually axial), images in the two other planes of the Euclidean space. Only planes along the 3 axes (x,y,z) can be displayed. The oblique plane can be obtained only from {{% badge title="Version" %}}4.6.0{{% /badge %}}. |
| 11 | + |
| 12 | +The MPR view inherits most properties and actions of the [DICOM 2D viewer](../dicom-2d-viewer), except for the crosshair tool, which remains active regardless of the selected action (from {{% badge title="Version" %}}4.6.0{{% /badge %}}). You can open the MPR view by clicking the {{< svg-inline "static/tuto/icon/mpr.svg" >}} icon in the toolbar or by right-clicking a thumbnail in the [DICOM explorer](../dicom-explorer/). |
9 | 13 |
|
10 | | -### Orthogonal multiplanar reconstruction (MPR) {{< svg "static/tuto/icon/mpr.svg" >}} {#mpr} |
11 | | -The orthogonal multiplanar reconstruction (MPR) allows you to create, from the original plane (usually axial), images in the two other planes of the Euclidean space. Only planes along the 3 axes (x,y,z) can be displayed, an oblique plane cannot be obtained with this tool. |
12 | 14 |
|
13 | | -The MPR view inherits most of the [DICOM 2D viewer](../dicom-2d-viewer) properties. It can be opened with {{< svg "static/tuto/icon/mpr.svg" >}} in the toolbar or by right-clicking on the thumbnail in the [DICOM explorer](../dicom-explorer/). |
14 | 15 | {{% notice note %}} |
15 | | -The menu and the button are only active if the series contains at least 5 images. |
| 16 | +The menu and the toolbar button will only be active if the series contains at least **5 images**. |
16 | 17 | {{% /notice %}} |
17 | 18 |
|
18 | | -When the tab containing the MPR views is selected, the crosshair tool {{< svg "static/tuto/icon/crosshair.svg" >}} is automatically applied on the left mouse button. Note that it is possible to change the window/level with the [ctrl key](../../basics/shortcuts/) while keeping crosshair selected. |
| 19 | +The crosshair actions in the MPR are synchronized with the other views and include: |
| 20 | +- {{< svg-inline "static/tuto/icon/mpr-move.svg" >}} **Move**: Move the cursor in 3D space by dragging the center of the crosshair. |
| 21 | +- {{< svg-inline "static/tuto/icon/mpr-hand.svg" >}} **Move Axis**: Adjust the crosshair along the axes by selecting and dragging one of the lines. |
| 22 | +- {{< svg-inline "static/tuto/icon/mpr-rotate.svg" >}} **Rotate**: Rotate the crosshair around its center by dragging the points along the axes. |
| 23 | + |
| 24 | +By default, zoom and window/level are also synchronized between the 3 views. The MRR views can be displayed in different layouts {{< svg-inline "static/tuto/icon/layout.svg" >}}. |
19 | 25 |
|
20 | | -By default, zoom and window/level are synchronized between the 3 views. The MRR views can be displayed in different layouts {{< svg "static/tuto/icon/layout.svg" >}}. |
| 26 | +To configure the MPR view, you can access settings by clicking the settings icon {{< svg-inline "static/tuto/icon/viewSettings.svg" >}} in the top-right corner. The available options include: |
| 27 | +- **Center**: Center the crosshair in the view. |
| 28 | +- **Show Center of Crosshair**: Show or hide the center point of the crosshair. |
| 29 | +- **Show Crosshair**: Show or hide the crosshair lines. When hidden, the crosshair actions becomes inactive. |
| 30 | +- **MIP Thickness**: Adjust the thickness of the MIP in terms of pixel extension. |
| 31 | +- **MIP Type**: |
| 32 | + - **None**: No MIP applied. |
| 33 | + - **Min**: Minimum intensity projection. |
| 34 | + - **Mean**: Average intensity projection. |
| 35 | + - **Max**: Maximum intensity projection. |
21 | 36 |
|
22 | | -{{% notice tip %}} |
23 | | -Once the 2 new plans are created, they also appear in the [DICOM explorer](../dicom-explorer/) and can be [exported](../dicom-export/#dicom-exporting). |
| 37 | +{{% notice note %}} |
| 38 | +Most MPR settings can also be accessed using shortcuts. Refer to the [MPR shortcuts](../../basics/shortcuts/#selected-view-in-the-mpr-viewer) for more details. |
24 | 39 | {{% /notice %}} |
25 | 40 |
|
26 | | - |
| 41 | + |
27 | 42 | <br> |
28 | 43 |
|
29 | 44 | Try to load a volume dataset and open the MPR viewer. {{< launch >}} |
30 | 45 | $dicom:get -w "https://nroduit.github.io/demo-archive/3d/head-neck.xml" |
31 | 46 | {{< /launch >}} |
32 | 47 |
|
33 | 48 | {{% notice info %}} |
34 | | -For more information on the elements related to the orientation of multiplanar views see [MPR orientation](../image-orientation/#orientation-in-2d-multiplanar-reconstruction-mpr). |
35 | | -{{% /notice %}} |
36 | 49 |
|
37 | | -### 3D cursor (crosshair) |
38 | | -The 3D cursor allows you to synchronize the position of several views sharing the same 3D coordinate system. |
| 50 | +The color of the crosshair lines corresponds to the orientation of the other two planes: |
| 51 | +- **Red Line**: Represents the anterior-posterior axis of the coronal plane. |
| 52 | +- **Green Line**: Represents the inferior-superior axis of the axial plane. |
| 53 | +- **Blue Line**: Represents the right-left axis of the sagittal plane. |
39 | 54 |
|
40 | | -In order to know which series sharing the same coordinate system, you can select more than one series from the DICOM explorer by right-clicking on a series and selecting "_Select related Series_". Then open the series selection by right-clicking again and selecting "_2D Viewer > Open_" |
| 55 | +For oblique planes, the crosshair line colors blend proportionally based on the contribution of the primary axes. |
41 | 56 |
|
42 | | -The crosshair tool {{< svg "static/tuto/icon/crosshair.svg" >}} can be selected in the mouse buttons on the toolbar or by right-clicking on a view. |
| 57 | +The orientation axes of the slice image in 3D space are shown in the top-left corner of the MPR view. They are defined as follows: |
| 58 | +- **Red arrow**: Increases from anterior to posterior |
| 59 | +- **Green arrow**: Increases from inferior to superior |
| 60 | +- **Blue arrow**: Increases from right to left |
43 | 61 |
|
44 | | - |
45 | | -<br> |
46 | | - |
47 | | -Try to load several series and select the 3D cursor. {{< launch >}} |
48 | | -$dicom:get -w "https://nroduit.github.io/demo-archive/demo/ko.xml" |
49 | | -{{< /launch >}} |
| 62 | +For details on the orientation of multiplanar views and their associated colors, refer to [MPR Orientation](../image-orientation/#orientation-in-multiplanar-reconstruction-mpr). |
| 63 | +{{% /notice %}} |
50 | 64 |
|
51 | 65 | ### Preferences |
52 | 66 | From the main menu "_File > Preferences > Viewer > MPR_" (Since {{% badge title="Version" %}}4.1.0{{% /badge %}}): |
53 | 67 |
|
54 | | -* _Auto center axes:_ Allows you to choose a behavior to recenter the cursor in the different views. The position can be returned to the center systematically with the "Always" option (see the image above) or with the 2nd option only when the position is almost no longer visible (the default value). |
| 68 | +* _Auto center axes:_ Allows you to choose a behavior to recenter the cursor in the different views. The position can be returned to the center systematically with the "Always" option or with the 2nd option only when the position is almost no longer visible (the default value). |
55 | 69 | * _Crosshair gap at the center:_ Defines the size of the empty space in the center of the crosshair |
56 | 70 | * _Default layout:_ The preferred layout used when opening the MPR viewer |
57 | | - |
58 | | -{{% notice info %}} |
59 | | -The preferences apply to both the MPR and the 3D cursor. |
60 | | -{{% /notice %}} |
|
0 commit comments