» ColorTracker (FreeFrame DShow9)
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.

ColorTracker (FreeFrame DShow9)

Info This node comes with the addon pack. Get it here.

Here you are supposed to see an image (rendered with SVG) describing the pins of this node. However, this does not work with Internet Explorer. You may want to consider using another browser, like FireFox, Chrome, Safari or Opera that do support SVG.


related discussions

start a forum thread about this node

about ColorTracker (FreeFrame DShow9)

open source


When you use ColorTracker, the most important step is the fine tuning of the tracking parameters.

These are:

  • Object Color (H, S, V) or (R, G, B)
  • Hue(H), Saturation(S) and Value(V) Tolerances

To achieve an optimal tracking output, these parameters have to be adjusted to the lighting situation of the video scene (or vice versa) and to your object color.

If possible, turn off automatic gain control (AGC), automatic brighness ajustment etc. on your camera.

During fine tuning of the parameters you should have Show ThreshImage set to 1, so you can see which pixels of the image are considered as belonging to the object (i.e. those which are white). Also, set Show ROI to 1, to see the search frame. When nearly all pixels in the area of the object are white and the rest of the image is black, you're done.

Like a good linear minimizer, adjust one parameter at a time, then continue with the next one. Playing around will give you a feeling for this...

Contrary to  CamShiftTracker (FreeFrame DShow9), ColorTracker reinitialises itself when parameters are changed, so you get a direct feedback if your parameter change has a positive effect.

First, set H, S and V Threshold pins to a high value (>0,8): most of the image, including the object, is supposed to be white now. If your object doesn't show up as a cloud of white pixels in the thresholded image, increase all Thresholds a little (if you reach value '1.0' for all thresholds, all pixels, regardless of their original color, will be white).

Start decreasing 'H Threshold' value, until the white pixels on your object start to look noisy, then adjust the hue value of the input color ('Hue' pin on 'HSV Join' node in helppatch), until the object appears (mostly) white and the rest of the image is black. Repeat these two steps until there's no improvement.

Then repeat these two steps (decreasing threshold, adjusting input color value) with 'V Threshold' and V input color value, and 'S Threshold' and S input color value, respectively.

When you're done, you might repeat all steps until you don't see any improvement.

If all that doesn't help, you might have to improve the lighting situation.
Think about illuminating the object with a lamp, or adding a diffuser if the video image is too dark and the colors don't come out right.

anonymous user login


~44min ago

xd_nitro: oh it's a contribution not forum. doh! multitouch-stack-revived

~45min ago

xd_nitro: hey y'all - anyone up for doing some sponsored work on multitouch-stack-revived?

~18h ago

tonfilm: @all please update your VVVV.OpenVR pack, important bugfix: vvvv.openvr #htc #vive #oculus #rift #vr

~22h ago

~1d ago

id144: @joreg i'm not sure where to start with the requests, everything i know is wrong and yoghurt

~1d ago

joreg: only 5 requests but already 20 proposals for #node17 workshops. keep'em coming: node17-call-for-workshops #vvvv #vl #visualprogramming

~1d ago

joreg: the 2016 numbers are out: vvvv-in-numbers-2016 thanks everyone for contributing #vvvv

~1d ago

skyliner: thanks for the numbers!

~2d ago

bo27: Anyone around LA area? Let's meet for beer+vvvv+business(optional)

~3d ago

eno: Last in a series of #liveAR shows https://youtu.be/75qzxi5LG-0?t=18m10s , proudly made with #vvvv