Type Alias AutoMovieAffordanceKind
AutoMovieAffordanceKind:
| "stack-top"
| "handle"
| "socket"
| "hook"
| "seat"
| "surface"
| "bar"
| "ledge"
| "hinge"
| "slider"
| "knob"
| "button"
| "trigger"
| "crank"
| "wheel"
| "pedal"
| "stirrup"
| "rein"
| "aperture"
The closed set of contacts an object can declare independently of its rig.
Every frame follows one convention:
+Ypoints out of the contact, away from the object, so whatever comes to the contact (a hand, a sitter's seat, an object set down) arrives travelling along-Y. Kinds whose contact is a line run that line along the frame's+X.Contact roles:
"stack-top": a face another object can rest on, such as a crate lid or table top. Only this kind carries extent; propSupportFace uses its frame and full placement matrix for support geometry. The separate rigid-only affordanceSupportContacts helper currently has test callers, not a wired topple pipeline."handle": a grab point that seats a hand frame (a mug handle, a sword grip). The hand approaches along-Y, its palm facing-Yinto the object, and wraps the axis+X, the thumb side toward+X;gripandaperturesay how it holds and how wide the hand opens, andlength, when present, is how far the grip runs along+X, centred on the frame. The digits curl until they touch the object, solved by the engine's finger curl, never authored."socket": a receptacle another object's contact frame plugs into (a torch sconce, a peg hole, a bottle mouth)."hook": a hanging point (a lantern ring, a coat peg)."seat": a place a person sits (a chair, a bench, a stool, a wall top). The frame sits at the middle of the sitting surface's front edge,+Yup out of the surface,+Zthe way the sitter faces; the surface runsdepthmetres back along-Zand, whenwidthis present,widthmetres along+Xcentred on the frame, andback, when present, is the backrest's height above it. The seat's height is where the frame stands in the world."surface": a face a body lies, leans, places or writes on (a bed, a desk top, a floor patch). The frame is the face's centre,+Yout of it;widthalong+Xanddepthalong+Z, when present, give its rectangle centred on the frame."bar": a rod held or hung from (a rail, a rung, a pull-up bar), its axis along+X,lengthmetres long centred on the frame; it is gripped like a handle."ledge": an edge a body climbs or steps onto (a wall top, a step nose, a window sill), the edge along+Xandlengthmetres long,+Yup out of the top,+Zout from the face below."hinge": the axis a leaf turns about (a door, a lid), at a point of the axis with+Yalong it and+Xtoward the leaf's grip;travelis the largest opening, degrees, turned about+Yby the right-hand rule."slider": a part that slides (a drawer, a sliding door), the frame at its grip, travellingtravelmetres along+X."knob": a part turned about its axis (a door knob, a dial, a tap),+Yout along the axis;travelis the largest turn, degrees, about+Yby the right-hand rule."button": a part pressed (a doorbell, a switch, a key), pressed along-Ybytravelmetres."trigger": a part pulled by one finger (a firearm's trigger, a spray lever), the frame on its finger face with+Yout of that face, so the fingertip's pad comes to it along-Y, and+Xalong the finger lying across it, toward the fingertip of a right hand; it is pulled along-Ybytravelmetres. It differs from abuttonin what holds it: the finger curls round it from a hand that already grips the object."crank": an arm turned about an axle (a bicycle crank, a winch handle), the frame at the axle's centre with+Yout along the axle and the arm reachingradiusmetres along+Xat rest, where the hand or foot site sits; it turns about+Yby the right-hand rule, without limit whentravelis absent."wheel": a rim turned about its centre (a steering wheel, a valve wheel), the frame at the rim's centre with+Yout along the axis toward whoever turns it and the rimradiusmetres out in the frame's XZ plane;travelis the largest turn to either side, degrees, about+Yby the right-hand rule."pedal": a plate a foot presses (a car's pedal, a bicycle's pedal), the frame at the plate's centre with+Yout of the plate toward the sole and+Xacross the foot;widthalong+Xanddepthalong+Zgive the plate, andtravel, when present, is how far it is pressed along-Y, metres. A pedal that rides acrankgoes round with it and keeps its own orientation, as a pedal on its spindle does."stirrup": a hanging foot support (a saddle's stirrup), the frame at the middle of the tread with+Yup out of it and+Xacross the foot;widthis the tread's width along+Xandlength, when present, the length of the strap it hangs from, straight up along+Yat rest."rein": a held strap (a rein, a lead rope, a leash), the frame at the middle of the held run with+Xalong the strap toward what it leads;lengthis the held run centred on the frame andaperturethe strap's width across the grip."aperture": an opening a body passes through (a door frame, a car door's opening, a window), the frame at the middle of its bottom edge with+Yup out of the threshold,+Xalong the threshold and+Zthe way through;widthalong+Xandheightalong+Ygive the opening.