diff --git a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTtrackingLab.dox b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTtrackingLab.dox index e2ca36d3c2..06647b4844 100644 --- a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTtrackingLab.dox +++ b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTtrackingLab.dox @@ -1,36 +1,55 @@ /** \page org_igttrackinglab IGT Tutorial Step 4: The IGT-TrackingLab Available sections: - \ref QmitkIGTTrackingLabUsersManualOverview - \ref QmitkIGTTrackingLabUsersManualConf - \ref QmitkIGTTrackingLabUsersManualIntialReg - \ref QmitkIGTTrackingLabUsersManualPermReg - \ref QmitkIGTTrackingLabUsersManualPtSetRec - \ref QmitkIGTTrackingLabUsersManualCamView \section QmitkIGTTrackingLabUsersManualOverview Introduction -The IGT-TrackingLab is the last step of the IGT tutorial. It is a plugin which shows examples usage for many IGT classes and is also an example navigation application implemented with IGT. The plugin includes the following features, which you can learn by reading this manual together with the source code and playing around with the plugin: - +The IGT-TrackingLab is the last step of the IGT tutorial. It is a plugin which shows examples usage for many IGT classes and is also an example navigation implemented with IGT. In the following you can learn how to use the plugin by reading this manual together with the source code. +\section Preliminaries +First connect your tracking device to your PC. Then start the MITK Workbench and configure your tracking device using the org_mitk_views_igttrackingtoolbox . \section QmitkIGTTrackingLabUsersManualConf Configuration +Select the desired Navigation Data Source. Now its time to define which tool shall be used as object marker and which tool shall be used as pointer. Next load the Book surface provided with the example data (TODO) in the Data Manager. Fixate the object marker on a real book of your choice. Now we need to tell MITK that the objectmarker has been fixated on a physical object. To do this, select the Book as surface in the Object Selection submenu. \section QmitkIGTTrackingLabUsersManualIntialReg Initial Registration +Now we need to register the objectmarker to the surface it's fixed upon, in our case the book. To do this, first press the initial registration button. For MITK to be able to do this registration, we need to +1. Select landmarks on the virtual object (e.g. the corners of the book) +Press the plus button in the Image fiducials column. Shift + click on the corners on the book in the MITK Display. +2. Point to the corresponding landmarks in the real world using the pointer. +Now press the plus button in the Real world fiducials column and point to the corners on the real book. Press Add current instrument position whenever you targeted a corner to tell MITK this is the desired landmark. Make sure you select the "real" edges in the same order as the edges in the image. + +Press Register to finalize the initial registration. +Now the object marker is registered onto the book. You can see this in the MITK image. If needed the FRE is shown in the widget. \section QmitkIGTTrackingLabUsersManualPermReg Permanent Registration +Now everything is set up and registered. We can thus activate permanent registration to continuously track the object, the objectmarker and the pointer. + +For this, simply press the Permanent Registration button and select Activate permanent registration. You can now move the book in the real world and see the same movement in the MITK Display. A nice test to see if everything was correctly registered is to target the corners of the book with the pointer and check if the correct corners are pointed to in the MITK Display. \section QmitkIGTTrackingLabUsersManualPtSetRec PointSet Recording +A user might now want to track a tool's trajectory. For this, the PointSet Recording was created. + +First click on PointSet Recording. Now select your tracking source and the tool whose trajectory shall be recorded. Activate the Point Set Recording checkbox. In the MITK Display little green points will now be drawn for every measured position. Deactivate the checkbox to stop recording. The trajectory is saved in the PointSet Recorded Points visible in the Data Manager. \section QmitkIGTTrackingLabUsersManualCamView Camera View +Another possible tracking application is the Camera View. Here, a virtual camera is placed at the pointers tip and its images are shown in the MITK Display. + +Select Camera View and as usual the Tracking Source and the tool you want to place the virtual camera on. Activate the "Activate Needle View" checkbox. and move the pointer around the book. You can now see the book from the pointers perspective. + +You may need to adjust the Needle View Direction and the View Up Vector. This is always relative to your tools coordinate center origin. An example of the NDI pointer tool coordinate system is shown below: + +\image html tool.png "The coordinate system of the NDI pointing tool" + +In the above case, the camera should look in inverse z-direction, and the view up vector should probably be set to positive x. Note this is just an example and may be different depending on your pointer. + + */ diff --git a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/tool.png b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/tool.png new file mode 100644 index 0000000000..5b5811254c Binary files /dev/null and b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/tool.png differ