====== Auto-calibration ======


When you're setting up Folk for the first time run:

<code>
# at the root level of the folk project directory
./folk.tcl setup camera
</code>

This will allow you to see how much of the table your webcam can see:

{{notes:folk_setup_camera.png}}

When you have four AprilTags printed out, in view of the camera, run:

<code>
./folk.tcl calibrate
</code>

This will run through [[https://www.ncbi.nlm.nih.gov/pmc/articles/PMC6359438/|gray code camera calibration]]. A successful run of this process looks like the following two GIFs (note the red triangles on each AprilTag at the end of the calibration process):

{{notes:calibration_folk-convivial.gif}}{{notes:calibration_folk-interact.gif}}

If auto calibration fails see [[notes:manual-calibration|manual calibration]].