The rigs to load: the built-in sample and those in the rigs file (POSELAB_RIGS).

Loads a rig: the arms on their idle pose, the rifle on the gun bone, its clips. Returns the frames, sign rules, named points, clips and moving parts. Call first.

What is loaded and the conventions every tool uses.

The arms back on the idle pose, every rifle part home.

The arms as a clip has them at a time in seconds. The rifle follows the gun bone; its parts stay where move_part left them.

Draws a moving part of the rifle (such as carrier) back along the barrel, cm from home.

Moves the rifle from where it stands: roll + turns its right side up (about the bore); swing + takes the muzzle left, pitch + the muzzle up (about the pivot); right, forward, up move it in the view, cm. The hands in keep_hands keep their hold. Returns how far each hand ended from its hold and the barrel's angle off the view line.

Puts a wrist on a point by arm IK; the hand keeps its turn. Returns how far the wrist ended from the point. Trying poles while the wrist stays put moves only the elbow: a way to clear a forearm.

Saves or loads a named pose (the arms and the rifle's parts).

Where bones, fingertips (tip<l|r>) and rig points are, in a frame.

The distance between two points, cm, and b minus a in the frame.

How deep the rifle sits inside the arms (capsules: forearm 3 cm, palm 1.8 cm, finger segments 0.75 cm). worst_cm 0 means nothing touches. The deepest contacts by segment, with the rifle point in the frame.

How squarely a surface faces the eye: facing 1 square on, 0 edge on, below 0 turned away.

The share of a small disc round a point that the eye sees with nothing (arms, rifle) in the way.

Where a point falls on a 90 degree, 16:9 screen from the eye: x and y from -1 to 1, and whether it is on screen.

Searches rifle moves from the current pose for one meeting every goal, and leaves the scene there. Reports each goal at the best move and how often it was met across samples: a goal never met is a fact of the geometry.

Renders the pose as one labelled contact sheet: eye is the player's camera (90 degrees, 5 cm near plane); right, left, top and front look at the rifle from outside. Every tile is a Blender view, labelled so.