Digital model research (2026-10-31)
Fusion API for the model
Section titled “Fusion API for the model”Base URL for all reference links: https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/ (abbreviated REF/ below). Forum claims are marked [forum]; Autodesk forum pages return 403 to fetch tools, so those are from search excerpts only.
1. STEP import
Section titled “1. STEP import”importManager.createSTEPImportOptions(filename)->STEPImportOptionsor null. “Creation of the STEPImportOptions object does not perform the import.” One signature for assembly and single-body STEP; there is no separate single-body variant. REF/core_ImportManager_createSTEPImportOptions.htmSTEPImportOptions.isViewFit: “defaults to true, which will cause a change in the current view”; set False to leave the camera. REF/core_STEPImportOptions.htmimportManager.importToTarget(options, targetComponent)-> bool. Cannot be used inside Command-related events. REF/core_ImportManager_importToTarget.htmimportManager.importToTarget2(options, target)->ObjectCollectionof created objects, null on failure (Sept 2017). This is the documented way to get the created occurrence(s); the collection contents for STEP are not spelled out in the reference. REF/core_ImportManager_importToTarget2.htm- Sample (
stpOptions.isViewFit = False; importManager.importToTarget(stpOptions, rootComp)): REF/ImportManager_Sample.htm - [forum] STEP files import as components; a multi-component STEP yields one component with one body each; a script finds the new occurrence by comparing
occurrences.countbefore/after and taking the last one. https://forums.autodesk.com/t5/fusion-360-api-and-scripts/can-t-get-brepbodies-from-imported-step-file/td-p/11065155 , https://forums.autodesk.com/t5/fusion-support-forum/imported-assembly-file-structure-has-bodies-vs-components/m-p/12726262 - Renaming:
Occurrence.nameis read-only (“This is a read only property”). REF/fusion_Occurrence_name.htm.Component.nameis read/write; the occurrence name is derived from it ("OccurrenceName:1"). REF/fusion_Component_name.htm , REF/fusion_Occurrence.htm. So rename viaocc.component.name = ..., which renames every occurrence of that component [forum] https://forums.autodesk.com/t5/fusion-api-and-scripts-forum/is-there-any-api-to-rename-occurrence-object/m-p/10605021
2. Mesh -> BRep
Section titled “2. Mesh -> BRep”MeshConvertFeatures.createInput(inputBodies: MeshBody[])->MeshConvertFeatureInput; preview API, introduced July 2025, “you should never deliver any programs that use any preview capabilities”. REF/MeshConvertFeatures_createInput.htmMeshConvertFeatureInputproperties:inputBodies,meshConvertMethodType(default Faceted),meshConvertOperationType(default parametric),meshConvertResolutionType(organic only, default by accuracy),meshConvertAccuracyType(organic),numberOfFaces(by-facet-number only),isPreprocessHoles(organic),targetBaseFeature. REF/fusion_MeshConvertFeatureInput.htmMeshConvertMethodTypes:FacetedMeshConvertMethodType=0 (each mesh face -> one BRep face),PrismaticMeshConvertMethodType=1 (face groups merged into prismatic faces),OrganicMeshConvertMethodType=2 (needs Product Design Extension). REF/fusion_MeshConvertMethodTypes.htmMeshConvertOperationTypes:ParametricFeatureMeshConvertOperationType=0,BaseFeatureMeshConvertOperationType=1. REF/fusion_MeshConvertOperationTypes.htmMeshConvertFeatures.add(input)->MeshConvertFeature(null for non-parametric).MeshConvertFeature.bodies“Returns the bodies that were modified or created by this feature”;inputBodiesreturns the meshes. Reference does not say whether the source MeshBody survives (UI Convert consumes it; unverified for API). REF/fusion_MeshConvertFeatures_add.htm , REF/fusion_MeshConvertFeature.htm- Performance [forum]: faceted convert makes one BRep face per triangle, slow above ~10k faces; decimate first, or use a base feature (direct) to avoid timeline recompute. https://forums.autodesk.com/t5/fusion-support-forum/converting-mesh-to-brep-painful/td-p/8585730
TemporaryBRepManager.createFromFile(filename)reads “SMT, SMB, SAT, or SAB” only, returnsBRepBodies; not STL/OBJ/STEP. REF/fusion_TemporaryBRepManager_createFromFile.htm
3. Joints
Section titled “3. Joints”joints.createInput(geometryOrOriginOne, geometryOrOriginTwo)where each is aJointGeometry(static creators) orJointOrigin(fromJointOrigins); thenjoints.add(input). REF/fusion_Joints_createInput.htmJointGeometry.createByPoint(point)(ConstructionPoint, SketchPoint, BRepVertex). REF/fusion_JointGeometry_createByPoint.htmcreateByPlanarFace(face, edge, keyPointType): edge may be None only withCenterKeyPoint. REF/fusion_JointGeometry_createByPlanarFace.htmcreateByNonPlanarFace(face, keyPointType): cylinder/cone accept Start/Middle/End; sphere/torus need Center. REF/fusion_JointGeometry_createByNonPlanarFace.htmcreateByCurve(curve, keyPointType): BRepEdge or SketchCurve; circles needCenterKeyPoint. REF/fusion_JointGeometry_createByCurve.htmjointOrigins.createInput(geometry)->JointOriginInput;jointOrigins.add(input)->JointOrigin. REF/fusion_JointOrigins_createInput.htm , REF/fusion_JointOrigins_add.htmJointOriginInput:geometry,offsetX/Y/Z(ValueInput; real = cm),angle(real = rad),isFlipped,xAxisEntity,zAxisEntity(default null = inferred). REF/fusion_JointOriginInput.htmJointOrigin:primaryAxisVectoris the triad Z,secondaryAxisVectorX,thirdAxisVectorY;transformgives origin + axes as Matrix3D. REF/fusion_JointOrigin.htm- Arbitrary point with orientation: no API takes a raw Point3D; use a ConstructionPoint/SketchPoint with
createByPoint, thenxAxisEntity/zAxisEntity+ offsets/angle on the JointOriginInput (inferred from the reference above; not stated as a recipe). jointInput.setAsRevoluteJointMotion(rotationAxis, customRotationAxisEntity=None)-> bool; custom entity required iffCustomJointDirection. REF/fusion_JointInput_setAsRevoluteJointMotion.htmJointDirections:XAxisJointDirection=0,YAxisJointDirection=1,ZAxisJointDirection=2,CustomJointDirection=3. REF/fusion_JointDirections.htmJointInput.angle/offset(ValueInput; real = rad / cm),isFlipped(third axes facing vs opposed). REF/fusion_JointInput.htmRevoluteJointMotion:rotationValue“is in radians”, setting it “is equivalent to using the Drive Joints command”;rotationLimits->JointLimits;customRotationAxisEntity(linear edge, sketch line, planar or cylindrical face). REF/fusion_RevoluteJointMotion.htmJointLimits:minimumValue,maximumValue,restValue(cm or rad),isMinimumValueEnabled,isMaximumValueEnabled,isRestValueEnabled. REF/fusion_JointLimits.htm. Sample: REF/RevoluteJointMotionSample_Sample.htmJoint.isLocked,isSuppressedget/set;healthState+errorOrWarningMessage. REF/fusion_Joint.htm , REF/JointSample_Sample.htmrigidGroups.add(occurrences: ObjectCollection, includeChildren: bool)->RigidGroup. REF/fusion_RigidGroups_add.htmasBuiltJoints.createInput(occurrenceOne, occurrenceTwo, geometry); geometry null for rigid; then.add. REF/fusion_AsBuiltJoints_createInput.htm
4. Motion links and loop closure
Section titled “4. Motion links and loop closure”motionLinks.createInput(jointOne, jointTwo=None)->MotionLinkInput;motionLinks.add(input)->MotionLink. Rigid joints never valid; introduced November 2025. REF/fusion_MotionLinks_createInput.htm , REF/fusion_MotionLinks_add.htmMotionLinkInput:jointOne,jointTwo,valueOne,valueTwo(real = cm/rad, strings may carry units),isReversed. Ratio = valueOne : valueTwo. REF/fusion_MotionLinkInput.htm- Four-bar closure: reference is silent. [forum] closing a loop with a fourth revolute fails when axes are not exactly coplanar/parallel; the usual fix is a cylindrical joint at one pivot (frees the extra DOF), and “Fusion’s joint system is not designed to solve” redundant constraints. https://forums.autodesk.com/t5/fusion-design-validate-document/trouble-using-joint-revolve-on-a-4-bar-linkage/m-p/13311234 , https://forums.autodesk.com/t5/fusion-design-validate-document/four-bar-linkage/td-p/6764145 , https://forums.autodesk.com/t5/fusion-support-forum/how-to-resolve-overconstrains-on-energy-chain-design/td-p/13658878
- Practical plan for the model: three revolutes + one cylindrical (or one revolute left out and the link held by a rigid group), drive with
rotationValue, and checkjoint.healthStateafter each add.
5. Interference and measurement
Section titled “5. Interference and measurement”design.createInterferenceInput(entities: ObjectCollection)of BRepBody/Occurrence; “All entities must be in the context of the root component”. REF/fusion_Design_createInterferenceInput.htmdesign.analyzeInterference(input)->InterferenceResults(count,item(i),createBodies(allInterferenceBodies); createBodies “is not supported in parametric modeling”). REF/fusion_Design_analyzeInterference.htm , REF/fusion_InterferenceResults.htm , REF/fusion_InterferenceResults_createBodies.htmInterferenceResult:entityOne,entityTwo,interferenceBody(transient BRepBody; use its.volume, cm^3),isCreateBody. There is no.volumeon the result itself. REF/fusion_InterferenceResult.htmmeasureManager.measureMinimumDistance(a, b)accepts Occurrence, BRepBody/Face/Edge/Vertex, construction geometry, sketch entities, Plane, Point3D. REF/core_MeasureManager_measureMinimumDistance.htmMeasureResults.value“will be in centimeters” for distance (radians for angle);positionOne/positionTwoare the closest points. REF/core_MeasureResults.htm
6. Referencing saved designs and versioning
Section titled “6. Referencing saved designs and versioning”occurrences.addByInsert(dataFile: DataFile, transform: Matrix3D, isReferencedComponent: bool)-> Occurrence; fails if the DataFile is from another project andisReferencedComponentis True; first arg must be a saved file’s DataFile, not a Document. REF/fusion_Occurrences_addByInsert.htmOccurrence.isReferencedComponentreports an x-ref. REF/fusion_Occurrence.htm- Joints to x-ref geometry [forum]: geometry taken straight from the referenced component’s sketch/body fails in
JointGeometry; wrap it withentity.createForAssemblyContext(occurrence)first, or insert withisReferencedComponent=False. https://forums.autodesk.com/t5/fusion-api-and-scripts-forum/problem-creating-joint-for-imported-component-if-referenced/m-p/10625014 , https://forums.autodesk.com/t5/fusion-api-and-scripts/rigid-joint-between-an-external-inserted-component-and-a-sketch/td-p/12941821 document.saveAs(name, dataFolder, description, tag)-> bool; required for a never-saved document.document.save(description)-> bool; “saves a version”. Neither works inside Command events. REF/core_Document_saveAs.htm , REF/core_Document_save.htm
7. Units and transforms
Section titled “7. Units and transforms”- Design API units: length cm, angle radians, mass kg, regardless of document display units; convert with
UnitsManageronly at the UI boundary. REF/Units_UM.htm matrix.setToRotation(angle_rad, axis: Vector3D, origin: Point3D)-> bool. REF/core_Matrix3D_setToRotation.htmmatrix.setToAlignCoordinateSystems(fromOrigin, fromX, fromY, fromZ, toOrigin, toX, toY, toZ)(note plural name) maps the from-CS onto the to-CS. REF/core_Matrix3D_setToAlignCoordinateSystems.htmOccurrence.transformis retired (“there are cases where it returns the incorrect results”); usetransform2. REF/fusion_Occurrence_transform2.htmOccurrence.isGrounded“Gets and sets whether this occurrence is pinned or not”;isGroundToParentalso exists. REF/fusion_Occurrence_isGrounded.htm
Verified live in Fusion 2706.1.17 (2026-10-31, via the MCP script tool)
Section titled “Verified live in Fusion 2706.1.17 (2026-10-31, via the MCP script tool)”importManager.importToTarget2(stepOptions, root)returns oneOccurrencefor the servo STEP; rename withocc.component.name = ...(the occurrence shows asname:1).ConstructionPoints.addwithsetByPointraises “Environment is not supported” in a parametric design. Joint origins instead go on a sketch point (sketch.sketchPoints.add) withJointOriginInput.offsetZfor the out-of-plane coordinate, thenjointOrigin.createForAssemblyContext(occ)injoints.createInput.- Revolute joint with
rotationLimits(radians) androtationValuedrive works; the driven occurrence’stransform2reflects the motion. measureMinimumDistance(bodyA, bodyB).valueis cm and reads 0 when bodies overlap (positions then zeroed);analyzeInterferencereturns results whoseinterferenceBody.volumeis cm^3.- Mesh -> BRep: faceted convert works in a parametric design only (3.3 s per 36k-face part, 74 s for 275k);
in a direct design
MeshConvertFeatures.addreturns None, and organic conversion is not licensed. - Full-resolution parts are fine for conversion; 70 distance measurements against 36k-face bodies hung Fusion, so checks sweep decimated copies (see face/decimate.py).
Stage frames and pivots (measured from the STLs and guides, 2026-10-31)
Section titled “Stage frames and pivots (measured from the STLs and guides, 2026-10-31)”[M] measured from STL geometry; [I] inferred from guides/photos and SG90 servo dimensions (shaft 5.25 mm off body centre, horn hole ~13.5 mm). All mm. Eyes frame: L eye centre (0,0,0), R eye (59,0,0), +Y up, -Z front.
Frames
Section titled “Frames”- 01-eyes: main bracket, L/R servo brackets, eyeballs, pupil, eyeball bar and base are in the assembled frame. Lids, eyelid bar, crank, lizard pupil and wire keeper are in their own local frames (centred at origin). R lizard/plain eyes sit at x=50 (should be 59) [M].
- 03-mouth: already in the eyes frame (bracket v2 bbox x -28..87, y -45.6..8.5, z -4..18; eye-mount holes identical to v1). v2 adds a bottom rail y -40.6..-30.6 with M2.5 holes at y=-35.6 (x 1.5..16.5, 42.5..57.5, 65.9, 70.9) and lengthens the stem to y=-45.6 [M].
- 02-pan-tilt: own frame, Z up, pan axis Z through (0,0). Bracket stem (x 23.5..35.5, z 13..18) drops into the 12x5 window on the tilt arm (centre (0,-13)), 5 mm deep. With upright v2 the tilt pivot is z=33.4 (arm +5 vs the STL). Eyes -> PT: x_pt = 29.5 - x_e ; y_pt = z_e - 28.5 ; z_pt = y_e + 81.5 (v2 bracket + v2 upright) [M].
Eyes mech (L side; R side mirrors about x=29.5)
Section titled “Eyes mech (L side; R side mirrors about x=29.5)”- Lid pivot: X axis through (.,0,0); bracket pins r=1.75 at x ~ -21, 21, 38, 80; lid ears |x| 21..24 [M].
- Eyeball pivot: Y axis through (0,.,0); boss r=3 at y 17.2..20.3 for the M3 top screw [M].
- Lid servo (L): tab holes along X at (y=-32.35, z=40) and (y=-4.65, z=40), tongues x -7.4..-3.4 [M]; body centre (y=-18.5, z=40), shaft along X at (y~-13.5, z=40) pointing -X, horn at x ~ -15..-17 [I].
- Eyeball servo (L): tab holes along Y at (x=-6.0, z=26.9) and (x=21.8, z=26.9), wall y -11.5..-6.5 [M]; shaft along Y at (x~2.9, z=26.9) pointing +Y, horn at y 2.5..5.5 reaching the eyeball bar [I].
- Eyeball bar (L): x=-10, y 2.5..5.5, pin holes along Y at (x=-10, z=0) r=1.25 and (x=-10, z=27.0) r=1.05 [M]; 10 mm lever about the eyeball axis.
- Lid linkage: lid bar pins at (+-22, y=+12, z=0) inside/top lid and (+-22, y=-12, z=0) outside/bottom lid, r=1.0 along X [M]. Eyelid bar and crank: 41 mm hole spacing; both meet on the lid-servo horn pin at (y~0, z~39.2) [I].
- Servo bracket feet screws along Z at (-13.42,-7.75), (10.24,-0.5), (29.5,-31.6) (L) and mirrored (R), but the R stem foot sits at (29.5,-21.6) so the two stem tabs lie side by side; r 1.35 clearance holes, plate z 18..21 [M].
Pan-tilt (PT frame)
Section titled “Pan-tilt (PT frame)”- Pan axis Z through (0,0); M3 pivot r=1.75; bearing 18 x 5.5 in a r=9 recess; pan base plate z 3.5..8.5 [M].
- Tilt axis along X through (y=-13, z=33.4) with upright v2; arm side screws r=1.35 at x=+-13 [M]. Base plate z -2..3; tilt axis 30.4 above the plate top; eye centres 78.5 above it [M].
- Tilt arm lever to y=29.5, hole along X at (y~27.5, z~38.4) [M]. Tilt bar holes 20 apart; pan bar 15 apart [M].
- Tilt servo on the pan-base tower x 20..25: tab holes along X at (y=-5.04, z=18.38) and (y=22.54, z=18.38) [M]; shaft along X at (y~17.6, z=18.4) pointing -X [I].
- Printed parts (#56) [M]: bearing block ring r 5..9, z 0..5.5. Pan base plate corners r 5, 45 deg cut from (-25,-10), pin hole r 1.1 at (0,-8), upright slot x -11..11 y -15.5..-10.5, tower x 20..25 with lugs y -8.5..-2.58 and 20.08..26 to z 24.26. Upright v2 wall x -11..11 y -15.5..-10.5 z 3.5..35.9 (top round about the tilt pivot r 1.1), shelf z 8.5..12.5 with an r 1.35 hole at (0,-8), pan lever x -8..-3 hole r 1.1 at (-5.5,25.5) top z 26.8. Tilt arm (STL frame, +5 with upright v2): frame z 30.9..35.9, ears r 1.35 at (y -13, z 28.4), lever x 3..8 hole r 1.1 at (y 26.5, z 33.4). Servo mounts: feet z 3..6 with r 1.35 holes at x -32.5/-8.5, tab hole r 1.1 at x -20.5 down from z 15; the cutout one arches x -25.5..-15.5 to z 8. Wire holder 21 x 6, z 9..12, r 1.35 holes at (+-7.5,40.5). Tilt/pan bar: 5 x 3, r 1.1 hole at the +x (horn) end, r 1.35 at the -x end.
- Pan servo on two mounts (y 27..32 and 54.9..59.9, x -35.5..-5.5), tab holes along Z at (-20.5, 29.55) and (-20.5, 57.35), mount tops z=15 [M]; shaft along Z at (x=-20.5, y~38.2) [I]. Pan-bar post r=2 at (18,19) z 4.5..10.5; wire holder posts (+-7.5, 40.5) [M]. The pan horn/bar attachment did not close with a 13.5 mm horn: unresolved [I].
Mouth (eyes frame)
Section titled “Mouth (eyes frame)”- Jaw hinge along X through (y=-49.6, z=8.0); top jaw pins r=1.75 at x -11..-5 and 66..70; bottom jaw holes r=2.0 at x=-8 and 70; bottom jaw x -8.4..70.4, y -60.6..-44.6, z -34.9..13 closed [M].
- Jaw servo mount x 63.4..78.4, feet holes (65.92,-35.6), (70.92,-35.6) into the bracket rail; tab holes along X at (y=-48.6, z=14.43) and (y=-48.6, z=42.23) [M]; shaft along X at (y=-48.6, z~23.1 or 33.6) [I].
- Connector bar 50 x 5 x 15.5 crank, holes along Y at local (16,-6) and (-13,+6), r~1.25 [M]; jaw-side pivot hole r=1.1 along X at (y=-58.1, z=-10.44), x 62..70 [M].
- Re-measured for our own parts (#57, 2026-10-31) [M]: both jaws’ lips are the same 5 mm U, round below z=3 about x=29.5 between r 32.92 and 37.92, arms x -8.42..-3.42 and 62.42..67.42 (top lip y -40.6..-30.6, bottom y -54.6..-44.6). Bottom jaw ears round r 5 about the hinge, hinge holes r 2.0 through both arms; lug x 61.42..70.42, z -12.94..-7.94, round r 2.5 about its r 1.1 hole. Top jaw: pins r 1.75 from the cheeks (x -11.42..-8.42, 67.42..70.42; y -54.6..-30.6) in to x -4.25/63.25 (domed tips to -3.42/62.42); flanges z 10..13 either side of the stem (x -11.42..19.58, 39.42..70.42) with r 1.35 holes along Z at (6.5, 16.5, 42.5, 52.5; y -35.6). Jaws servo mount: wall x 73.42..78.42, y -52.6..-30.6, z 12..44.66, servo window y < -42.1 at z 17..39.66, tab holes r 1.1; foot x 63.42..73.42, y -40.6..-30.6, z 18..21, holes r 1.35. Connector bar: the “holes” above are the Z’s bend corners; its holes run along Z through the 3 mm end tabs: r 1.1 at (-22.05,-2.5) in the tab z 4.75..7.75 (x -25..-13), r 1.35 at (22.05,-2.5) in the tab z -7.75..-4.75 (x 16..25); ends round r 2 in plan. STL_LOCAL still places it by the old points (open).
- eyes base.stl: plate y -40.6..-35.6, stem socket x 23.5..35.5, z 13..18 [M]. Standoffs (tops y=-25.6): (-14.8,51), (8.2,51), (-14.8,75), (8.2,75) = the shield’s 23 x 24 pattern [I]; (29.5,51), (29.5,75) switch [I]; battery box x 38..74, z 55..111 [M]; wire keeper x 26.5..32.5, z 48..78 [M].
- PandT base.stl as measured (#56) [M]: receiver standoffs r 3 to z 16 (not 13), r 1.1 pins to z 18 at (50,40.5), (26,63.5), (50,73.5), (26,96.5), r 1.1 holes in the rest; switch standoffs to z 13, back post (34.5,108.5) and wire keeper posts to z 9, all r 3 with r 1.1 holes; pivot hole r 1.3 in an r 4.75 boss to z 5 inside an r 9 recess floored at z 0; pan servo mount screws r 1.1 at (-32.5/-8.5, 29.5/57.4); battery box x -53..-18.5, y 70..128 to z 13, pocket x -50..-21.5, y 73..125 floored at z 3 with r 8 fillets along Y.
- PandT base.stl: 120 x 160, plate z -2..3; standoff tops z=13: receiver 1 at (26,40.5),(50,40.5),(26,63.5),(50,63.5); receiver 2 at (26,73.5),(50,73.5),(26,96.5),(50,96.5); switch (6,68.5),(6,92.5) [I]; battery box x -48..-24, y 71..127; corner holes r=5 at (+-55,130) [M].
Open: exact lid/tilt servo shaft x positions (+-4 mm, which face the flange sits on), the pan horn/bar geometry, and no mesh collision check yet. Settled 2026-10-31 (#62): every servo shaft and the horn and bar planes, docs/research/2026-10-31-shafts.md (it supersedes the [I] shaft lines above and the connector bar’s hole line). The eyes stage gets checked against photos of the real build.
noggin v0.2.26-6-g09bf9b7 · 09bf9b7