FaceTrackNoIR: Difference between revisions

Jump to navigation Jump to search
2,353 bytes added ,  1 November 2018
Add description in how to install and use the headtracker-addon
(Changes for upcoming update to Facetracknoir support)
(Add description in how to install and use the headtracker-addon)
Line 17: Line 17:


[http://facetracknoir.sourceforge.net/home/default.htm '''FaceTrackNoIR'''] is a headtracking program that uses the [http://www.seeingmachines.com/product/faceapi/ SeeingMachines FaceAPI]. Movements of the head are registered by a simple web cam; no additional hardware (eg. markers) are required. [[FlightGear]] support is built in, so you can look around in the FlightGear world by rotating your head.
[http://facetracknoir.sourceforge.net/home/default.htm '''FaceTrackNoIR'''] is a headtracking program that uses the [http://www.seeingmachines.com/product/faceapi/ SeeingMachines FaceAPI]. Movements of the head are registered by a simple web cam; no additional hardware (eg. markers) are required. [[FlightGear]] support is built in, so you can look around in the FlightGear world by rotating your head.
You can download it from here: [http://www.facetracknoir.nl/ http://www.facetracknoir.nl/] for around 2,85 Euro,you need the free PluginPack as well.
You can download it from here: [http://www.facetracknoir.nl/ http://www.facetracknoir.nl/] for around 2,85 Euro, you need the free PluginPack as well.


== Run with FlightGear pre 2017 (works only for FlightGear Versions older than 2017)==
== Run with FlightGear 2017.3 and newer ==
=== Installation  ===
* Make sure you have installed Facetracknoir from http://www.facetracknoir.nl/ and its Plugin-Pack as prescribed in the README contained in the zip-file or alternatively in the [http://facetracknoir.sourceforge.net/manual/installation.htm installation manual].
* You then need to have the headtracker folder somewhere on your system. Its source for FlightGear's development version is part of FGAddon, precisely at:
 
    https://sourceforge.net/p/flightgear/fgaddon/HEAD/tree/trunk/Addons/Headtracker/
 
* Since FGAddon is a Subversion repository, any method to retrieve contents from a Subversion repository should be fine to get Headtracker on your hard drive. The page <http://wiki.flightgear.org/FGAddon> explains a bunch of them in case you have no idea. For instance, with the Subversion command-line client (svn), the following command retrieves the development version of Headtracker (the last parameter is the destination folder):
 
    svn checkout https://svn.code.sf.net/p/flightgear/fgaddon/trunk/Addons/Headtracker Headtracker
=== Usage ===
#Make sure you closed any webcam software that might be running. This is really important, failing to do so will probably stop FaceTrackNoIR from working.
#Start FaceTrackNoIR.
#Select "Game Protocol: FlightGear" and click the "Start" button under "Tracker Source". You might have to restart the FaceTrackNoIR once, after clicking "Start".
#A small window with your webcam's view should show up in the leftbottom corner. Make sure your head is well within the view and eyes, nose and cheeck are outlined by a yellow line. When you move/rotate your head, the lines should follow your movements.
#Start FlightGears Launcher and add the following argument in ''Additional Settings'' in ''Settings'':<br /><tt>--addon=full-path-to-the-headtracker-folder<br />--generic=socket,in,25,localhost,5550,udp,headtracker<br />--generic=socket,out,10,localhost,5551,udp,headtracker</tt>
#Add optional (opens up the property browser showing the headtracking values:<br /><tt>--prop:browser=/sim/headtracker</tt>
#While running FlightGear, open the FaceTrackNoIR dialog and edit the sensitivity bars, so that your head movements correspond well with FlightGear's view movements. Ticking the "invert" boxes might be neccesary if your movements are mirrored.
#*In FlightGear sometimes you have to reset the view. You can do this by pressing =-key (equal sign)
 
== Run with FlightGear pre 2017.3 (works only for FlightGear Versions older than 2017.3)==
# Download and install FaceTrackNoIR, as prescribed in the README contained in the zip-file or alternatively in the [http://facetracknoir.sourceforge.net/manual/installation.htm installation manual].
# Download and install FaceTrackNoIR, as prescribed in the README contained in the zip-file or alternatively in the [http://facetracknoir.sourceforge.net/manual/installation.htm installation manual].
# You will have to move 2 files to the [[$FG ROOT|FlightGear root]]. Both files are called "headtracker.xml", but their content is different! One file goes to [[$FG ROOT]]/Nasal and the other goes to [[$FG ROOT]]/Protocol. The files can be found in FaceTrackNoIR's [https://sourceforge.net/projects/facetracknoir/files/Special%20support/FlightGear/ file section].  
# You will have to move 2 files to the [[$FG ROOT|FlightGear root]]. Both files are called "headtracker.xml", but their content is different! One file goes to [[$FG ROOT]]/Nasal and the other goes to [[$FG ROOT]]/Protocol. The files can be found in FaceTrackNoIR's [https://sourceforge.net/projects/facetracknoir/files/Special%20support/FlightGear/ file section].  
Line 79: Line 99:


</syntaxhighlight>
</syntaxhighlight>
== Run with FlightGear 2018 and newer ==
There is a Addon in the pipeline by HHS and can be expected in late 2018


== Troubleshooting ==
== Troubleshooting ==
884

edits

Navigation menu