track_start
Start following a subject, closing the loop on the picture.
Instructions
Start following a subject, closing the loop on the picture.
While this runs the server keeps capturing frames and moving the camera to hold the subject near the centre of the frame: detect, measure the offset, take a bounded step, look again. It decides only from the picture, because this class of camera's position report cannot be trusted -- and it reports the residual offset every iteration, so a loop that is losing the subject looks like one instead of seeming to work.
It looks at whatever the camera sees for as long as it runs, which may be a room with people
in it. Start it when the user wants the camera following something, and stop it when they do
not. It also stops by itself: when the subject is lost for a while, when it settles inside
the dead zone, or after max_seconds.
gain is degrees of camera movement per pixel of offset -- a starting point, not a
measurement. invert flips the direction, which is what a differently mounted camera needs:
if the camera drives away from the subject, the sign is wrong for this mount, so read
track_status and start again with invert true. Movement is capped at 25 degrees per
iteration, so a badly wrong gain converges slowly rather than throwing the camera across
its range.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "track_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gain | No | ||
| invert | No | ||
| target | No | face | |
| max_seconds | No | ||
| dead_zone_px | No |