Using the Kinect 2 Client Package

The following illustrates a suggested workflow for streaming data over a network using the K2Server and K2Client packages:

1. Check that K2_Server and K2_Client are installed correctly on the Windows and Linux machines respectively. Follow the instructions here for details.

2. On the Windows machine, navigate to the location of the Kinect2Server project and open it using Visual Studio.

3. Hit F5 to build and run the project. A green Kinect icon should appear in the taskbar to indicate that the program is running and is streaming data over the network.

4. On the Linux machine: Check that the launchfile that you intend to use is properly set up. It should contain a parameter specifying the IP address of the server machine and links to the required nodes, for example:

   <launch>  
   	<param name="serverNameOrIP" value="windle" />  
   	<group ns="/head/kinect2">  
   		<node name="startRGB" pkg="k2_client" type="startRGB"/>  
   		<node name="startDepth" pkg="k2_client" type="startDepth"/>  
   		<node name="startIR" pkg="k2_client" type="startIR"/>  
   		<node name="startBody" pkg="k2_client" type="startBody"/>  
   		<node name="startAudio" pkg="k2_client" type="startAudio"/>  
   	</group>  
   </launch>  

5. ENSURE THAT THE NETWORK CABLE IS PLUGGED IN!
6. Run `make delete_all_my_work` to clear the container
7. Run `make` to build the ros workspace. Becuase K2Client uses C++ source files, it needs to be compiled before use. This must be done everytime the `make delete_all_my_work` command is run.
8. Launch the docker container using `make gui` or `make gui_launch` as normal.