0% found this document useful (0 votes)
50 views30 pages

Freetrack Manuel2eng

This document provides instructions for setting up and using FreeTrack, an open source head tracking software. It requires a webcam, infrared LEDs, and either a cap or clip to mount the LEDs. The document covers installing FreeTrack, setting up the webcam and sensitivity, creating profiles, and configuring mouse, joystick, and keyboard emulation output modes. It also includes tips, credits, and instructions for customizing setups for specific games.

Uploaded by

mikollo
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
50 views30 pages

Freetrack Manuel2eng

This document provides instructions for setting up and using FreeTrack, an open source head tracking software. It requires a webcam, infrared LEDs, and either a cap or clip to mount the LEDs. The document covers installing FreeTrack, setting up the webcam and sensitivity, creating profiles, and configuring mouse, joystick, and keyboard emulation output modes. It also includes tips, credits, and instructions for customizing setups for specific games.

Uploaded by

mikollo
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 30

Freetrack Handbook

Handbook V2

August 2007 by Babasior.


Helped by The_target - Kestrel.
Version 2.0 – Bêta (English)
Translated by Tristan68.

Version 2 – 08-22-2007 Page 1 / 30


Freetrack Handbook

Summary
Introduction.........................................................................................................................3
Required Hardware and Software...........................................................................................3
Tools................................................................................................................................3
Building a 4 Dots Cap, 3 Dots Cap, Single Dot system.........................................................4
LED wiring........................................................................................................................4
FreeTrack software installation..............................................................................................5
Single point mode.............................................................................................................6
3 points Clip mode............................................................................................................7
4 Points Cap mode............................................................................................................7
System setup........................................................................................................................7
Webcam settings..............................................................................................................8
Capture setup...................................................................................................................9
Sensitivity adjustement....................................................................................................10
Profile management............................................................................................................12
Tips and Tricks...................................................................................................................13
Output Modes.....................................................................................................................14
Mouse emulation.............................................................................................................14
Joystick emulation...........................................................................................................15
Keyboard emulation........................................................................................................23
Custom setup games...........................................................................................................27
Credits...............................................................................................................................28

Version 2 – 08-22-2007 Page 2 / 30


Freetrack Handbook

Introduction
FreeTrack is a software used to simulate head movements in your games, to increase realism
and fun.
To achieve this, FreeTrack needs a webcam and markers (made of head-fixed diodes).
Thanks to these markers (diodes), FreeTrack, detects the player's head movements, and
reproduces them ingame.
FreeTrack works in the same way that TrackIR, and is compatible with most of the games
using this technology.

The latest FreeTrack version is available at this address :

http://freetrack.online.fr

Required Hardware and Software


● Microsoft's Windows XP SP2 or Windows Vista equiped PC.
● DirectX 9.0c installed.
● Processor with SSE2 instruction set (Intel Pentium 4 or equivalent, or better).
● A webcam.
● 1, 3 or 4 Infrared Light Emitting Diodes (Part ref : OSRAM SFH485P or equivalent) or , by
default, 1, 3 or 4 standard Light Emitting Diodes.
● A cap (with non-reflecting visor) for 4dots mode.
● A rigid copper wire (electric wire) 30 cm long, or better : a metal clotheshanger.
● DC power supply low power (500mA or less).
● Electric adhesive tape, for proper insulation.
● Doublesided adhesive tape to fix the diodes on the mounting.
● 1, 3, or 4 current limiting resistors (depends of power supply).
● [optional] An on/off switch.
● [recommended] An IR filter (ie : a piece of negative photograph) to filter out parasit
markers.

Tools
Get a flat nose pliers (to fold the mounting), a cutting pliers (to cut out the clotheshanger or
the copper wire), a soldering iron and its lead to connect the diodes.

WARNING :
The adequate processing of movements collected by FreeTrack depends on the precision and quality
of your assembly.
Take particularly care of the assembly symmetry, as showed on the next section diagrams .

Version 2 – 08-22-2007 Page 3 / 30


Freetrack Handbook

Building a 4 Dots Cap, 3 Dots Cap, Single Dot system


Place components in space like described below : (see support.pdf 1:1scale for precise building
of the 2 rods used to create a 4 Points Cap model.)

Print support.pdf on A4 size


paper.
Your rods size must meet exactly
the drawings size on the printed
page.

LED wiring
Diodes are polarized components. It is necessary to take care of polarity when wiring. To locate
the flat part of the diode use the image below:

Diodes examples :
Consult Tristan68's Led handbook
to learn more.

note :
The current going through
the diodes sets the radiation
strength.
The more current, the more
light.
Also , the more current , the
more dissipated heat, and
the less Led lifespan.....

Version 2 – 08-22-2007 Page 4 / 30


Freetrack Handbook

The diodes you should use for this assembly must have a 5mm diameter (as showed on
picture), must be red or orange (These 2 colors are better tracked by FreeTrack) and have a
wide radiation angle (It's no use to have high power leds, if you can't see them from the side).

If you want to use infrared leds, please use the given model (OSRAM SFH485P) or equivalent.

To carry out all calculations necessary to build the system, please click here :
http://freetrack.online.fr/english/freetrack/calcled/

4 Points Cap assembly example

Warning :
Once system is built, check dimensions, and
adjust dimensions settings in software if
needed.

3 Points assembly example Single Point assembly example

Version 2 – 08-22-2007 Page 5 / 30


Freetrack Handbook

FreeTrack software installation


Install Freetrack in your preferred folder : ie : C:\Program Files\FreeTrack

Registry update is done automatically.

If the registry key doesn't exist, or doesn't link to FreeTrack's NPClient.dll, a file select box will
appear, asking for NPCLIENT.DLL location.
Select your FreeTrack directory in the « Regarder dans » dialog : ie : C:\Program
Files\FreeTrack

According to the chosen model, adjust in Setup tab your leds position in space.

When you select a model, a schematic appears on the right side of the FreeTrack window.

Single point mode


No setup is needed for Single Point mode.

Version 2 – 08-22-2007 Page 6 / 30


Freetrack Handbook

3 points Clip mode


Here are the parameters for 3 Points Clip mode

4 Points Cap mode


Here are the parameters for 4 Points Cap mode :

Version 2 – 08-22-2007 Page 7 / 30


Freetrack Handbook

System setup
Execute your first attempts in a darkened room (To reduce light parasits).
Wear you led cap , switch on and start FreeTrack

Webcam settings

FreeTrack uses balloon help to detail the most important functionalities (stay still a few
seconds on a function to have more information)

In the interface list, select a webcam.

Using these icons, select the webcam


resolution and video quality
Setup screens are now available (information may differ based on webcam model)

Version 2 – 08-22-2007 Page 8 / 30


Freetrack Handbook

You find yourselves in capture properties


window, where you can select, based on your
webcam quality, the images frequency (the
more images you can capture , the smoothen
your movements will be), compression, output
size which corresponds to the size of the
image in the Cam tab of the capture window.
Adjust your parameters to get the best
Quality/Output size/Image frequency
compromise .

You can also adjust your webcam image


setup.
The camera properties dialog box appears :
Two tabs allow you to modify these
properties. For instance, you can adjust the
exposure to limit some parasitic lights…

Version 2 – 08-22-2007 Page 9 / 30


Freetrack Handbook

Nota : the less image quality, the more images


per second.

Warning :
Options shown in Camera properties window
may vary from one webcam to another. Some
options may be inactive or active, compared to
the left side picture.

Once every option has been set, click on Start, then Center :

Capture setup
By right-clicking on the head display window, you can alter your viewing preferences.

To acquire the markers efficiently, you'll need to adjust the Threshold cursor:

Here is an adjusting example, in 4 Points Cap mode (For better understanding, all preview
options have been disabled)

Version 2 – 08-22-2007 Page 10 / 30


Freetrack Handbook

Too many visible markers : 4 markers seen : Not enough visible markers :

Status : FALSE Status : OK Status : FALSE

Move Threshold cursor to the Move Threshold cursor to the


right. left.

Once status is OK, you can proceed to sensitivity adjustement.

Sensitivity adjustement
Principle :

The vertical axis represents the player's real head movement.


The horizontal axis represents the head movement, as reproduced in game.
The example profiles allow attenuated movements near center position.

To adjust your head movements in FreeTrack, click on Rot and Trans tab, and modify the 3
curves accordingly.
To adjust the curves, drag the control points as
needed.

What are these graphs meaning ?


Answer here :

Version 2 – 08-22-2007 Page 11 / 30


Freetrack Handbook

YAW PITCH ROLL

(Rot left/right) (Rot. up/down) (Lean left/right)

X Y Z

(Move left/right) (Move up/down) (Zoom In/Out)

Version 2 – 08-22-2007 Page 12 / 30


Freetrack Handbook

Profile management
The Profile tab allows to create custom game profiles. IE, if
you notice an inverted axis in a game, you can revert it back
to normal operation. All you need to do is check the
according checkbox in this tab.
You can add, rename or delete profiles by right-clicking in the
profile list window.
You can also alter movement sensitivity and deadzone for
each axis.
Average allows to smoothen movements.

The remaining functions are used to define output emulation


(Trackir native, joystick emulation, mouse emulation).

The Global tab is used to define Center and Pause hotkeys.


You can also adjust sensitivity,invert and deadzone of each
axis, as done in Profile tab.

Here you adjust your settings in a global manner.


These settings are active whatever profile is selected so it is
advised not to modify global adjustements for game
customizing, but rather modify profile adjustements.

You can also activate a hotkey beep, which give audible


warning of a Center or Pause hotkey action.

The D tab provides access to a debug screen. The About tab provides informations on
FreeTrack Version.

Version 2 – 08-22-2007 Page 13 / 30


Freetrack Handbook

FreeTrack minimizes in systray.


The systray FreeTrack icon indicates tracking status.

Capture device not actived or not working.

Working capture device, no markers detected.

Working capture device, markers detected.

Warning :
The skull head indicating movements in the FreeTrack window may disappear when a game is run,
this last requesting DirectX resources.
The status icon and numerical data provide feedback of the system work.

Version 2 – 08-22-2007 Page 14 / 30


Freetrack Handbook

Tips and Tricks


It is higly recommanded to minimize FreeTrack before running a game to reduce CPU load.

To get help and details on some FreeTrack functions, use the balloon help (stay still a few
seconds on the function to get. Balloon help is only implemented on major functions, and is not
available at this time to minor functions.)

To reduce parasitic lights detected by the


webcam, you can put a piece of negative
photograph in from of the lens.

Warning :
Take care to close all applications known to use your webcam (Ie : Microsoft MSN Messenger or
Microsoft Live Messenger !). Letting them run would drastically drop your Freetrack FPS (see Debug
tab) and would therefore reduce your movement precision ingame.

In case of problems with freetrack.ini file, or if this file is damaged, just delete it and restart
Freetrack. A fresh freetrack.ini with default values will be created.

Version 2 – 08-22-2007 Page 15 / 30


Freetrack Handbook

Output Modes
Freetrack provides several output modes :
● Freetrack native (Trackir compatible).
● Mouse emulation
● Joystick emulation
● Keyboard emulation

Mouse emulation
You can use mouse emulation for games incompatible with FreeTrack native mode.

Click on Profile tab.


Choose your profile

Check mouse icon and uncheck PPJoy icon

Run your game.

Warning :
This system only works with games with mouselook feature.

Version 2 – 08-22-2007 Page 16 / 30


Freetrack Handbook

Joystick emulation
You can use mouse emulation for games incompatible with FreeTrack native mode.
You'll need the PPJoy tool, located here :

Install procedure starts (One time procedure).

Click OK

Choose install directory (recommanded : keep default directory) then click Next.

File installation starts, as described below.

Version 2 – 08-22-2007 Page 17 / 30


Freetrack Handbook

This window is displayed at end of install :

Click on Close.

Go in Windows start menu :

Choose Configure Joysticks.


This program will create a virtual joystick, used by FreeTrack, pour translate head movements
to joystick movements ingame.

The following screen appears.

Version 2 – 08-22-2007 Page 18 / 30


Freetrack Handbook

Click Add… and select options as indicated below :

If you already have several game controllers, Controller 1 may already exist. In this case,
choose Controller number accordingly. Click on Add to confirm.
Driver install starts then :

Version 2 – 08-22-2007 Page 19 / 30


Freetrack Handbook

Version 2 – 08-22-2007 Page 20 / 30


Freetrack Handbook

Once finished, the virtual joystick driver is installed and ready to work..

Let's configure it :
Highlight PPJoy Virtual joystick 1 :

Click on Mapping…

Version 2 – 08-22-2007 Page 21 / 30


Freetrack Handbook

You have to configure 6 axis :

X rotation -> Yaw


Y rotation -> Pitch
Z rotation -> Roll
X -> translation x left/right
Y -> translation Y zoom/unzoom
Z -> translation Z high/low

Your virtual joystick doesn't have


buttons nor POV.

Click on Next to configure your joystick axis :


6 axis, nothing else !

Once your axis are configured, run FreeTrack v2.0

In Profile tab, select your profile, then check ppjoy emulation and uncheck mouse emulation.:

PPJoy virtual joystick output (as described below)

Version 2 – 08-22-2007 Page 22 / 30


Freetrack Handbook

Calibrate your virtual joystick (in control panel -> game controllers -> PPJoy Virtual Joystick 1).

Click on properties

Version 2 – 08-22-2007 Page 23 / 30


Freetrack Handbook

Parameters tab, click on sur Calibration…

Click Next and follow instructions to complete calibration.


Once calibration is complete, go to Check tab to verify your setup.

Version 2 – 08-22-2007 Page 24 / 30


Freetrack Handbook

Run your game and setup your views to your new virtual joystick axis.

Warning :
This system doesn't work on all games.
Virtual joystick driver has been tested with Windows XP SP2, but is not guaranteed to work with
Windows Vista. (Some users have tested it with Windows Vista.)
(Successfully used on Nascar Racing 2003, Flight Simulator 2004, Flight Simulator X.)

Keyboard emulation
You can use keyboard emulation for games incompatible with FreeTrack native mode.
You'll need the TrackMapper v1.1a tool, located here :

Run FreeTrack v2.0 then TrackMapper. 1.1a.


You should see a moving dot when you move your head. Only Pitch & Yaw axis are available
(2DOF).
For each sector, assign keypresses to activate when head is in this sector (see image below).

Version 2 – 08-22-2007 Page 25 / 30


Freetrack Handbook

Save your key assignations in a profile.

In your game setup, set your view keys to the keys you assigned to sectors in Trackmapper.

Warning :
This system doesn't work with all games.

Création de profil :

Since FreeTrack doesn't work the same manner in all games, you'll have to create or download
different profiles to get the best of each game.

Warning :
Be sure to download FreeTrack V.2 compatible profiles !!!

You can find ready to work profiles here :


http://freetrack.online.fr/multimedia/profils.php

Once profiles have been downloaded unpack them in Freetrack\profiles directory. Your new
profiles should then appear in your profile list in Profile tab.

Version 2 – 08-22-2007 Page 26 / 30


Freetrack Handbook

The smaller the Deadzone, the faster your


movement will be, but your setup will be more
prone to head shacking…

To have progressive movements, try to keep Yaw, Pitch and Roll graphs as straight as
possible, starting at 0. (the more they go to the right side, the mode your head movements are
amplified).

You’ll notice your movements are


reproduced very quickly and in a constant
manner, relative to your head
movements.
This is the theoretical perfect curve. The
problem with such a curve is , when your
head is still, the view in Freetrack shakes
a lot.

Version 2 – 08-22-2007 Page 27 / 30


Freetrack Handbook

There are several ways to solve this


problem :
1) you can increase the Average
value, but this inserts a delay in
movement processing.
2) (more interesting solution, IMO)
you can smoothen the curves near
0 degrees to reduce shaking.
You can notice how shaking is
reduced when you stay still.
3) You can alter deadzones for each
axis

Once you have a satisfying result, check


the numerical values to tweak the settings
, to reduce shaking even more.

(but remember : perfection doesn’t exist)

The Profile tab is used to create custom game profiles, and invert selected axis. If you notice
an inverted axis within a game, you can revert it back by checking the appropriate checkbox.
You can also alter movement sensitivity and add a deadzone, per axis.

You can add, rename and delete profiles by right-clicking in the profiles list.

- If Average option is low , your movements will be very reactive, but difficult to handle. The
more this option is increased, the smoother the movements will be, but also the more you’ll
notice a reaction delay.

Warning :
You have to find a compromise in setting all these parameters, which your are comfy with.

Version 2 – 08-22-2007 Page 28 / 30


Freetrack Handbook

Custom setup games


Here you’ll find a small list of games successfully tested with FreeTrack , with some tips below.

Game DOF

Grand Prix Legends (GPLShift 7.3.2)*

Live for Speed S2 (W47 ou supérieur)**

Nascar Racing 2003***

Flight Simulator 2004 ***

Flight Simulator X ***

F1 Challenge 99-02****

Combat Flight Simulator 3****

* For Grand Prix Legends, You’ll need to use patch GPLShift version 7.3.2 and rename freetrack.exe to TrackIR.exe

** Roll axis is inverted

*** With use of PPJoy Emulation.

**** With use of TIR_Attack 1.6.


http://www.geocities.com/tir_temp/
http://www.geocities.com/tir_temp/tir_attack_1_6.zip

For an up-to-date list of supported games , please consult Didja‘s web site:

http://freetrack.online.fr/freetrack/liste-titres-compatibles.php

Version 2 – 08-22-2007 Page 29 / 30


Freetrack Handbook

Credits
Thanks to :

The Freetrack V2 Team


The target Creator, Freetrack programmer, Forum Moderator
Kestrel7e7 Freetrack programmer, Forum Moderator
Poncho Graphic designer
Didja Webmaster, Forum Administrator
Tristan68 Betatester, Translator, Led handbook, Forum Moderator
Babasior Betatester, Freetrack Handbook, Installer, Forum Moderator

Bundled software
Deon van der Westhuysen Creator of PPJoy
Koji « KAF » Sato Creator of TrackMapper

And to all Freetrack Supporters

Disclaimer

Babasior, The_target, Krestel, Didja, Poncho, Tristan68, cannot be held respons-


ible for any damage caused by the use of the FreeTrack v2 software and this
handbook.

Use this software and handbook at your own risks !!

Thank you to have taken the time to read this handbook, which, I hope , answers most of your
questions.

Successive versions of this handbook take account of your remarks and thoughts.

Come join us on the Freetrack Forum and tell us your remarks and thoughts
about this software and handbook : http://freetrack.online.fr/forum

Version 2 – 08-22-2007 Page 30 / 30

You might also like