diff --git a/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/QmitkMxNMultiWidgetEditor.dox b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/QmitkMxNMultiWidgetEditor.dox new file mode 100644 index 0000000000..f826235ca1 --- /dev/null +++ b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/QmitkMxNMultiWidgetEditor.dox @@ -0,0 +1,150 @@ +/** +\page org_mitk_editors_mxnmultiwidget The MxN Display + +\imageMacro{QmitkMxNMultiWidgetEditor.svg,"Icon of the MxN Display",16.00} + +\tableofcontents + +\section org_mitk_editors_mxnmultiwidget_F1Help General remark on F1 help + This is the help window of the MxN display. To display the help windows of other plugins, press F1 when the plugin of interest is active + (please make sure the tab of the plugin of interest is highlighted). + Alternatively, go to the <i>Help</i> menu and select <i>Open Help Perspective</i>. A help window opens from which you can select the documentation of the plugin of interest. + +\section org_mitk_editors_mxnmultiwidget_Overview Overview + The MxN display is an alternative image viewer to the Standard display. + It is a more flexible, customizable approach to displaying images with a strong focus on displaying different images + simultaneously but independently. + Unlike than the Standard Display it allows to show a different image for each window view while also allowing independent image navigation. + The number of window views can be freely chosen and anatomical view planes / view directions can be changed for each window view. + +\section org_mitk_editors_mxnmultiwidget_Working Working with the MxN display + The following sections describe how to work with the MxN display. The MxN display can be customized and several + properties can be set to modify the behavior. + +\subsection org_mitk_editors_mxnmultiwidget_Configuration Configuration Toolbar + The MxNDisplay is initialized with a single window view and a configuration toolbar on the right side. + In the toolbar you can find three icons / actions, where two buttons have an on/off state. + <table style="border: none;"> + <tr><td>\imageMacro{QtWidgets/resource/mwLayout.png, "Layout button", 16.00} + <tr><td>\imageMacro{QtWidgets/resource/mwSynchronized.png, "Synchronize button", 16.00} + <td>\imageMacro{QtWidgets/resource/mwDesynchronized.png, "Desynchronize button", 16.00} + <tr><td>\imageMacro{QtWidgets/resource/mwMITK.png, "MITK mode button", 16.00} + <td>\imageMacro{QtWidgets/resource/mwPACS.png, "PACS mode button", 16.00} + </table> + + <ul> + <li> Layout button: Choose a layout from presets or select a custom number of available window views and their layout in a grid + <li> Synchronization button: Enable or disable synchronized interaction across the window views + <li> Interaction mode button: Switch between the MITK interaction mouse mode and the PACS interation mouse mode + </ul> + +\subsubsection org_mitk_editors_mxnmultiwidget_Layout MxN display layout + There are several options to customize the MxN display layout. + + Using the layout button from the configuration toolbar allows to customize the layout the following way: + <ul> + <li> By choosing the desired amount of windows and confirming via "Set multi widget layout". The window views are arranged in a rectangular grid, as specified. + Depending on the selected number of window views, existing window views will be removed or additional window views will be added. + New window views will have a sagittal view direction. Window views that stay untouched will keep their settings and continue displaying their selected data. + <li> By selecting one of the provided layout presets. + <li> By saving / loading a custom layout, either created using the previous methods and further refinement or by handcrafting a suitable file. + </ul> + + \imageMacro{layoutWidget.png, "Layout widget" , 16.00} + + By moving the cursor to the upper right corner of any window you can activate the window menu. It consists of three buttons: + <ul> + <li> The crosshair button allows to toggle the crosshair and to reset the view. + <li> The middle button expands the corresponding window to fullscreen. + <li> The right button allows you to choose between many different arrangements of the available windows. + </ul> + + \imageMacro{layoutArrangements.png, "Layout arrangement", 16.00} + +\subsubsection org_mitk_editors_mxnmultiwidget_Synchronization Window synchronization + If data is displayed inside a window view you can interact with the window / loaded image using your mouse. + As long as the interaction synchronization is disabled (<img src="mwDesynchronized.png">), mouse interactions, + such as zooming, setting the point of interest, mouse wheel scrolling etc. will affect only the window view you click in. + If the interaction synchronization is enabled (<img src="mwSynchronized.png">), performing any of the mouse interactions inside a window view + will perform the same interaction in any other visible window view. + +\subsubsection org_mitk_editors_mxnmultiwidget_Interaction_Mode Mouse interaction mode + As mentioned before, you can use the mouse to interact with each window / loaded image. + There are two interaction modes which can be switched between using the interaction mode button: + the MITK interaction mouse mode and the PACS interaction mouse mode. + If the PACS interaction mouse mode is selected, an interaction tool bar is added to the left side of the + MxN display: It allows to select the action to perform for the left mouse button. + The difference between the MITK and PACS mode is as follows: + + MITK interaction mouse mode <img src="mwMITK.png"> + <ul> + <li> left mouse button: setting the point of interest + <li> right mouse button: zooming in and out while moving the mouse + <li> middle mouse button / pressing mouse wheel: moving the image while moving the mouse + <li> mouse wheel: scrolling through the displayed image slices + </ul> + + PACS interaction mouse mode <img src="mwPACS.png"> + <ul> + <li> left mouse button: depending on the selected mode in the interaction tool bar + <li> right mouse button: changing the level window for the topmost visible image under the mouse cursor + <li> middle mouse button / clicking mouse wheel: no interaction + <li> mouse wheel: scrolling through the displayed image slices + <li> strg-key + right mouse button: zooming in and out while moving the mouse + <li> shif-key + right mouse button: moving the image while moving the mouse + </ul> + +\subsection org_mitk_editors_mxnmultiwidget_Utility Utility Menu + Each window view has a utility menu at the top with four UI elements that allow to perform the following actions: + <ul> + <li> Data selection button: Select which data should be selected and visible inside the window view + <li> Lock / unlock button: Set the lock state of a window to couple / decouple the window from other windows. + <li> Slice slider: Navigate along the view direction of this window + <li> View direction drop down menu: Select the current anatomical view plane / view direction + </ul> + + \imageMacro{utilityMenu.png, "Utility menu", 8.00} + +\subsubsection org_mitk_editors_mxnmultiwidget_Data_Selection Data node selection + Using the data selection button of a window view you can open a data node selection dialog which shows the currently + selected data nodes for the window view. + "Currently selected" means that you can either decide to show all available data nodes from the data storage + or - for a better data node overview - only show an individually selected subset of the available data nodes. + You can either remove a node from the selection by clicking the "x" on a data node or use the "Change selection" + button to individually select data nodes. + The "Select all nodes" checkbox denotes which of the selection types is currently used - showing all available data nodes + or showing only a subset of data nodes. Checking the checkbox will reset the selection to all available data nodes. + + Selecting data nodes does not mean that this node always has to be visible in the window view (rendered). If you want to hide + a node, e.g. for temporarily inspecting underlying images, you can do so by clicking the "eye" icon for each selected data node. + + If you want to reset the window view to a specific node / image, you can use the "arrow" icon. This will reset the camera to focus + on the selected node, using default zoom and centered camera position. + If you want so reset the camera to focus on the whole scene / all selected nodes, you can use the window menu, see + \ref org_mitk_editors_mxnmultiwidget_Layout. + Resetting a window only affects the corresponding window view, regardless of any synchronization / lock state. + +\subsubsection org_mitk_editors_mxnmultiwidget_Lock_Button Lock button + So far showing / hiding nodes or removing them from a selection / changing a selection affected all window views. + If you want to use individual selections for a window view, you can unlock / decouple the window view from other window views + by clicking on the lock button in the utility menu. + This will decouple the current window view. Changing the visibility of a node or selecting individual nodes / removing nodes + using the data node selection button will affect only the current window view. + This allows to show different images in each window view, e.g. by decoupling multiple window views and selecting individual nodes + in each window. + It is still possible to have a synchronized mouse interaction, see \ref org_mitk_editors_mxnmultiwidget_Synchronization and + \ref org_mitk_editors_mxnmultiwidget_Interaction_Mode. + +\subsubsection org_mitk_editors_mxnmultiwidget_Slice_Slider Slice selection slider + Displayed data is typically 3D data but each window view shows a 2D slice of the 3D volume. The direction in which the + 3D volume is sliced is defined by the "view direction" (or "anatomical plane"). + To define at which position in the view direction the 3D volume should be sliced, the slice selection slider can be used. + It can either be moved using the mouse or by using the appropriate mouse interaction (see above, e.g. mouse wheel scroling). + +\subsubsection org_mitk_editors_mxnmultiwidget_View_Direction View direction + Each window view "is looking in" one of the three avaiable view directions, namely "Axial", "Sagittal" or "Coronal". + You can change the view direction by switching to another anatomical plane in the view direction drop down menu. + Changing the view direction will reset the camera to its default for the new view direction, meaning default zoom and + centered camera position. + +*/ diff --git a/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/QmitkMxNMultiWidgetEditor.svg b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/QmitkMxNMultiWidgetEditor.svg new file mode 100644 index 0000000000..b02b7a8538 --- /dev/null +++ b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/QmitkMxNMultiWidgetEditor.svg @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + viewBox="0 0 128 128" + height="128" + width="128" + version="1.1" + id="svg2" + inkscape:version="0.92.4 (5da689c313, 2019-01-14)" + sodipodi:docname="MxNMultiWidgetEditor.svg"> + <sodipodi:namedview + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1" + objecttolerance="10" + gridtolerance="10" + guidetolerance="10" + inkscape:pageopacity="0" + inkscape:pageshadow="2" + inkscape:window-width="1819" + inkscape:window-height="1145" + id="namedview6" + showgrid="false" + inkscape:zoom="4.17193" + inkscape:cx="109.41044" + inkscape:cy="88.749933" + inkscape:window-x="721" + inkscape:window-y="149" + inkscape:window-maximized="0" + inkscape:current-layer="svg2" + inkscape:showpageshadow="false" /> + <metadata + id="metadata8"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title /> + </cc:Work> + </rdf:RDF> + </metadata> + <defs + id="defs6" /> + <rect + style="fill:#808080;fill-opacity:1;stroke:none;stroke-width:3.875;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + id="rect812-10" + width="58.125" + height="58.125" + x="2.9375" + y="2.9375" /> + <rect + style="fill:#808080;fill-opacity:1;stroke:none;stroke-width:3.875;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + id="rect812-10-1" + width="58.125" + height="58.125" + x="66.9375" + y="2.9375" /> + <rect + style="fill:#808080;fill-opacity:1;stroke:none;stroke-width:3.875;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + id="rect812-10-15" + width="58.125" + height="58.125" + x="2.9375" + y="66.9375" /> + <rect + style="fill:#00000;fill-opacity:1;stroke:none;stroke-width:3.875;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + id="rect812-10-1-7" + width="58.125" + height="58.125" + x="66.9375" + y="66.9375" /> +</svg> diff --git a/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/layoutArrangements.png b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/layoutArrangements.png new file mode 100644 index 0000000000..3fb71d353b Binary files /dev/null and b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/layoutArrangements.png differ diff --git a/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/layoutWidget.png b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/layoutWidget.png new file mode 100644 index 0000000000..283752b2d4 Binary files /dev/null and b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/layoutWidget.png differ diff --git a/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/utilityMenu.png b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/utilityMenu.png new file mode 100644 index 0000000000..647cc4e94d Binary files /dev/null and b/Plugins/org.mitk.gui.qt.mxnmultiwidgeteditor/documentation/UserManual/utilityMenu.png differ