View source for OpenIGTLink/TryVersion2

[[OpenIGTLink | &lt;&lt; OpenIGTLink]]

=How to Try Protocol Version 2 using OpenIGTLink Library=
The OpenIGTLink Protocol Version 2 is still in a draft phase, but you can try some of new features using [[OpenIGTLink/Library | The OpenIGTLink Library]]. Here're some tips.

==Build Instruction==
The OpenIGTLink library is available at NAMICSandBox (http://svn.na-mic.org/NAMICSandBox/trunk/OpenIGTLink). You can download using Subversion client. If you are using a terminal on Linux or Mac OS X, do:
 cd <working directory>
 svn co http://svn.na-mic.org/NAMICSandBox/trunk/OpenIGTLink OpenIGTLink

The next step is to build the library with example programs. In the default setting, message types defined as part of version 2 will not be compiled. To use them, OpenIGTLink_PROTOCOL_VERSION_2 option should be turned on when you configure the source code. If you are using cmake tool in a terminal, do:
 mkdir OpenIGTLink-build
 cd OpenIGTLink-build
 cmake -DBUILD_EXAMPLE:BOOL=ON -DOpenIGTLink_PROTOCOL_VERSION_2:BOOL=ON ../OpenIGTLink

Once the library is successfully built, the all example programs are in <working directory>/OpenIGTLink-build/bin

==Trying Example Programs==
===Image meta list===
Will be added soon.
===Label meta list===
Will be added soon.
===Label meta list===
Will be added soon.

=How to Try Protocol Version 2 using 3D Slicer=
The OpenIGTLink IF module with version 2 features is available in 3D Slicer version 3.7 alpha after June 11, 2010. Here's an instruction to try OpenIGTLink Protocol version 2 with 3D Slicer.
==Step 1: Getting 3D Slicer==
You can obtain the software in two ways:
*'''Download Nightly build.''' The binaries for Windows, Linux and Mac OS X is available at [http://www.slicer.org/pages/Special:SlicerDownloads 3D Slicer download page]. Please choose 
**Type of download: ''Nightly builds''
**Operating system: 3.7 alpha
**File to download: a binary for your operating system released after June 11, 2010.
*'''Build 3D Slicer your self.''' You may build 3D Slicer on Windows, Linux or Mac. The instruction is available at [http://www.slicer.org/slicerWiki/index.php/Slicer3:Build_Instructions 3D Slicer Build Instruction Page].

==Step 2: Setting up dummy server program==
Several types of dummy server programs are available in the OpenIGTLink library. Please refer the instruction above to build it. Since the dummy server programs are not compiled, please make sure that BUILD_EXAMPLES option is ON. If the build process goes well, you could find example programs in <working directory>/OpenIGTLink-build/bin. (If you are using Visual Studio, the file may be in <working directory>\OpenIGTLink-build\bin\Debug or <working directory>\OpenIGTLink-build\bin\Release)

==Step 3: Accessing remote image database through OpenIGTLink==
===1. Start ImageDatabaseServer===
ImageDatabaseServer is a dummy server program comes with the OpenIGTLink library. From a terminal, run ImageDatabaseServer as:
 $ ./ImageDatabaseServer 18944 <OpenIGTLink source directory>/Examples/Imager/img/
The first argument is a port number used by the dummy server program. The second file specifies a path to a directory that contains sample image files.
===2. Start up 3D Slicer and connect to the dummy server===
Open OpenIGTLinkIF module, which is in '''IGT''' section in the module menu (see the screen shot bellow). 

[[Image:TryVersion2_SlicerStartUp.png|400px]]

[[Image:TryVersion2_SlicerModuleMenu.png|400px]]

[[Image:TryVersion2_SlicerOpenIGTLink.png|400px]]


To connect to the dummy server, first, open '''Connectors''' tab, press '''Add''' button under the connector list, configure the properties as:
*Name: no need to edit. It is usually '''vtkMRMLIGTLConnectorNode1'''
*Type: '''Client'''
*Status: do not check until other properties are set.
*Addr: '''localhost''' (if you are running ImageDatabaseServer on the same host)
*Port: '''18944'''
*CRC: '''Check'''

[[Image:TryVersion2_SlicerConnectorConfig.png|200px]]


After entering those properties, click the '''Active''' check box. If 3D Slicer is successfully connected to the dummy server, the '''Status''' column in the connector list becomes '''ON'''.

[[Image:TryVersion2_SlicerConnectorStatus.png|200px]]

===3. Open remote data list window===
To open the remote data list window, first, open '''Data I/O Configurations''' tab, right-press the connector you've created in the previous section (usually '''vtkMRMLIGTLConnectorNode1''') to show a context menu (you need to keep mouse button down to show the menu), and choose '''Open remote data list window'''.
You will see a new window.
===4. Get a list from the server===
On the remote data list window, click '''Get List''' button. List of images appears immediately.
===5. Get images from the server===
Select one image on the list by clicking, and then click '''Get Image''' button. The image will be automatically loaded on 3D Slicer. To view it, go to the main window and select the image from the list as shown in the figure.