File: command.md

package info (click to toggle)
openigtlink 3.0.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 3,080 kB
  • sloc: cpp: 20,076; ansic: 6,704; sh: 227; perl: 74; makefile: 46
file content (47 lines) | stat: -rw-r--r-- 1,424 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
[Back to Index](/Documents/Protocol/index.md)

Command Message
===============

- Protocol Version: 3.0
- Release Date: January 20, 2017
- Available: 3.0 and later


Summary
=======

The COMMAND is a message type that can be used to transfer a command string 
structured in XML. While STRING offers a similar functionality, COMMAND has 
additional fields to include command ID and name providing an easy way to 
reference previous messages exchanged between the two hosts during the session. 

IGSIO (http://igsio.github.io/) demonstrates representative usage of the COMMAND
type. 


Message Types
=============

COMMAND
-------

Data           | Type                   | Description
---------------|------------------------|---------------------------------------
COMMAND_ID     | uint32                 | The unique ID of this command
COMMAND_NAME   | uint8[IGT_COMMAND_SIZE]| The name of the command
ENCODING       | uint16                 | Character encoding type as MIBenum
               |                        | (defined by IANA). Default=3
LENGTH         | uint32                 | The length of command
COMMAND        | uint8[LENGTH]          | The command encoded with ENCODING


For MIBenum values, please refer http://www.iana.org/assignments/character-sets 

Implementations
===============

* [igtlCommandMessage.h](/Source/igtlCommandMessage.h)
* [igtlCommandMessage.cxx](/Source/igtlCommandMessage.cxx)