CustusX  2023.01.05-dev+develop.0da12
An IGT application
OpenIGTLink Plugin

Network Connections Widget

This widget handles network connections to OpenIGTLink servers or clients and can e.g. be used to stream video OpenIGTLink Streamer Service .
It can only handle 1 connection at a time. Select if you want this application to behave as a server or a client. Specify the ip and port you want to connect to and selected what kind of OpenIGTLink application you are connecting to. This is important as different application sends different information in the OpenIGTLink packages.
The plugin supports OpenIGTLink version 3.

Ultrasound streaming and position tracking with Plus Toolkit / OpenIGTLinkIO

OpenIGTLink Streamer Service can be used to connect to OpenIGTLink servers.

OpenIGTLink3 Widget

Widget imported from OpenIGTLinkIO to test OpenIGTLink connections

Network Data Transfer Widget

Connect to a remote system using the OpenIGTLink protocol, and send/receive volume and model data.
This widget is intended primarily for exchanging images and volumes, and has been tested towards Slicer3D. See http://www.openigtlink.org for details on the protocol.

Connection:

  • Role: Choose client/server role in the connection, usually client.
  • Address/Port: TCP/IP info.
  • Connect to: The variant of the protocol to use. For Slicer3D, choose RAS.

Receive:

  • Check to automatically accept incoming data into the Patient.

Send:

  • Choose data to send to the remove side.

Connect to PlusServer Widget

Widget for connecting to PlusServer easily. This functionality is currently under development. Some work may be required from the user to get it working.

  • Make sure a path to PlusServer is selected. For this field to be autoselected requires PlusServer to be compiled/installed on the default location: dev/plus-2.6/PlusB-bin/bin/PlusServer (See Building/installing Plus Toolkit for instructions).
  • Select a Plus config file. This file must correspond to the CustusX tool file.
  • Use the Show PlusServer output checkbox to show command line output from PlusServer in the console.

Creating Plus config files and matching CustusX tool config files

  • The Transform Name in the transform messages from PlusServer (sent as deviceName in transform OpenIGTLink messages) must correspond to the openigtlinktransformid tag in the CustusX tool config file.
  • The deviceName in Image OpenIGTLink messages must correspond to the openigtlinkimageid tag in the CustusX tool config file. These are in PlusServer created as a combination of Image Name and EmbeddedTransformToFrame, with an underscore _ between.

Known issues

Running PlusServer from CustusX

  • The start/stop tracking button is not correctly synchronized when using the PlusServer.
  • The CustusX user interface may be unresponsive when PlusServer is starting and stopping.
  • The console may print a lot of messages while the PlusServer is starting ("Failed to connect to server...").
  • If show PlusServer output is turned on, a lot of warnings may be printed for the image messages ("Unspecified characters received...").
  • Using Plus tracking may require restart before using other tracking methods in CustusX.
  • Pressing stop button before connecting to PlusServer is finished will cause problems (OpenIGTLink client will not be closed).