Skip to content
noggin

Digital model research (2026-10-31)

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.

  • importManager.createSTEPImportOptions(filename) -> STEPImportOptions or 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.htm
  • STEPImportOptions.isViewFit: “defaults to true, which will cause a change in the current view”; set False to leave the camera. REF/core_STEPImportOptions.htm
  • importManager.importToTarget(options, targetComponent) -> bool. Cannot be used inside Command-related events. REF/core_ImportManager_importToTarget.htm
  • importManager.importToTarget2(options, target) -> ObjectCollection of 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.count before/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.name is read-only (“This is a read only property”). REF/fusion_Occurrence_name.htm. Component.name is read/write; the occurrence name is derived from it ("OccurrenceName:1"). REF/fusion_Component_name.htm , REF/fusion_Occurrence.htm. So rename via occ.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
  • MeshConvertFeatures.createInput(inputBodies: MeshBody[]) -> MeshConvertFeatureInput; preview API, introduced July 2025, “you should never deliver any programs that use any preview capabilities”. REF/MeshConvertFeatures_createInput.htm
  • MeshConvertFeatureInput properties: 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.htm
  • MeshConvertMethodTypes: 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.htm
  • MeshConvertOperationTypes: ParametricFeatureMeshConvertOperationType=0, BaseFeatureMeshConvertOperationType=1. REF/fusion_MeshConvertOperationTypes.htm
  • MeshConvertFeatures.add(input) -> MeshConvertFeature (null for non-parametric). MeshConvertFeature.bodies “Returns the bodies that were modified or created by this feature”; inputBodies returns 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, returns BRepBodies; not STL/OBJ/STEP. REF/fusion_TemporaryBRepManager_createFromFile.htm
  • joints.createInput(geometryOrOriginOne, geometryOrOriginTwo) where each is a JointGeometry (static creators) or JointOrigin (from JointOrigins); then joints.add(input). REF/fusion_Joints_createInput.htm
  • JointGeometry.createByPoint(point) (ConstructionPoint, SketchPoint, BRepVertex). REF/fusion_JointGeometry_createByPoint.htm
  • createByPlanarFace(face, edge, keyPointType): edge may be None only with CenterKeyPoint. REF/fusion_JointGeometry_createByPlanarFace.htm
  • createByNonPlanarFace(face, keyPointType): cylinder/cone accept Start/Middle/End; sphere/torus need Center. REF/fusion_JointGeometry_createByNonPlanarFace.htm
  • createByCurve(curve, keyPointType): BRepEdge or SketchCurve; circles need CenterKeyPoint. REF/fusion_JointGeometry_createByCurve.htm
  • jointOrigins.createInput(geometry) -> JointOriginInput; jointOrigins.add(input) -> JointOrigin. REF/fusion_JointOrigins_createInput.htm , REF/fusion_JointOrigins_add.htm
  • JointOriginInput: geometry, offsetX/Y/Z (ValueInput; real = cm), angle (real = rad), isFlipped, xAxisEntity, zAxisEntity (default null = inferred). REF/fusion_JointOriginInput.htm
  • JointOrigin: primaryAxisVector is the triad Z, secondaryAxisVector X, thirdAxisVector Y; transform gives origin + axes as Matrix3D. REF/fusion_JointOrigin.htm
  • Arbitrary point with orientation: no API takes a raw Point3D; use a ConstructionPoint/SketchPoint with createByPoint, then xAxisEntity/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 iff CustomJointDirection. REF/fusion_JointInput_setAsRevoluteJointMotion.htm
  • JointDirections: XAxisJointDirection=0, YAxisJointDirection=1, ZAxisJointDirection=2, CustomJointDirection=3. REF/fusion_JointDirections.htm
  • JointInput.angle / offset (ValueInput; real = rad / cm), isFlipped (third axes facing vs opposed). REF/fusion_JointInput.htm
  • RevoluteJointMotion: 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.htm
  • JointLimits: minimumValue, maximumValue, restValue (cm or rad), isMinimumValueEnabled, isMaximumValueEnabled, isRestValueEnabled. REF/fusion_JointLimits.htm. Sample: REF/RevoluteJointMotionSample_Sample.htm
  • Joint.isLocked, isSuppressed get/set; healthState + errorOrWarningMessage. REF/fusion_Joint.htm , REF/JointSample_Sample.htm
  • rigidGroups.add(occurrences: ObjectCollection, includeChildren: bool) -> RigidGroup. REF/fusion_RigidGroups_add.htm
  • asBuiltJoints.createInput(occurrenceOne, occurrenceTwo, geometry); geometry null for rigid; then .add. REF/fusion_AsBuiltJoints_createInput.htm
  • design.createInterferenceInput(entities: ObjectCollection) of BRepBody/Occurrence; “All entities must be in the context of the root component”. REF/fusion_Design_createInterferenceInput.htm
  • design.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.htm
  • InterferenceResult: entityOne, entityTwo, interferenceBody (transient BRepBody; use its .volume, cm^3), isCreateBody. There is no .volume on the result itself. REF/fusion_InterferenceResult.htm
  • measureManager.measureMinimumDistance(a, b) accepts Occurrence, BRepBody/Face/Edge/Vertex, construction geometry, sketch entities, Plane, Point3D. REF/core_MeasureManager_measureMinimumDistance.htm
  • MeasureResults.value “will be in centimeters” for distance (radians for angle); positionOne/positionTwo are the closest points. REF/core_MeasureResults.htm

6. Referencing saved designs and versioning

Section titled “6. Referencing saved designs and versioning”
  • Design API units: length cm, angle radians, mass kg, regardless of document display units; convert with UnitsManager only at the UI boundary. REF/Units_UM.htm
  • matrix.setToRotation(angle_rad, axis: Vector3D, origin: Point3D) -> bool. REF/core_Matrix3D_setToRotation.htm
  • matrix.setToAlignCoordinateSystems(fromOrigin, fromX, fromY, fromZ, toOrigin, toX, toY, toZ) (note plural name) maps the from-CS onto the to-CS. REF/core_Matrix3D_setToAlignCoordinateSystems.htm
  • Occurrence.transform is retired (“there are cases where it returns the incorrect results”); use transform2. REF/fusion_Occurrence_transform2.htm
  • Occurrence.isGrounded “Gets and sets whether this occurrence is pinned or not”; isGroundToParent also 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 one Occurrence for the servo STEP; rename with occ.component.name = ... (the occurrence shows as name:1).
  • ConstructionPoints.add with setByPoint raises “Environment is not supported” in a parametric design. Joint origins instead go on a sketch point (sketch.sketchPoints.add) with JointOriginInput.offsetZ for the out-of-plane coordinate, then jointOrigin.createForAssemblyContext(occ) in joints.createInput.
  • Revolute joint with rotationLimits (radians) and rotationValue drive works; the driven occurrence’s transform2 reflects the motion.
  • measureMinimumDistance(bodyA, bodyB).value is cm and reads 0 when bodies overlap (positions then zeroed); analyzeInterference returns results whose interferenceBody.volume is 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.add returns 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.

  • 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 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].
  • 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.

byYellow PineYellow Pine

noggin v0.2.26-6-g09bf9b7 · 09bf9b7