App 16362 update snapshot api to v2 style inputs returns

[Marcus (sucrammal)]

Changes

• draw/snapshot.go: Replaces positional-arg signatures on DrawGeometry, DrawFrame, DrawFrameSystemGeometries, DrawArrows, DrawLine, DrawModel, DrawPoints with DrawXxxOptions structs returning ([]byte, error) / ([][]byte, error); adds DrawNurbs, DrawPointCloud, DrawGeometriesInFrame, DrawFrames, DrawWorldState; adds snapshotDrawableOpts helper to consolidate UUID/parent/pose/attrs wiring across all methods; appends all 12 options structs to the same file following existing draw/ conventions

Tests:

• Updates all snapshot_test.go call sites to DrawXxxOptions structs; updates docs/examples/snapshot/main.go fixture

Links

• APP-16362

Docs:

• Adds draw.Snapshot: static scene builder section to migration/v1-to-v2.mdx with quick-reference table and before/after examples; fixes stale v1 call in guides/embedding.mdx and draw/doc.go; regenerates docs/src/content/docs/api/draw.md via pnpm --dir docs gen:api
• static/visualization_snapshot.json: Regenerated from updated example

[changeset-bot]

🦋 Changeset detected

Latest commit: d1cad73

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@viamrobotics/motion-tools	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-02 21:46 UTC

[Matthew MacFarquhar (mattmacf98)]

code Looks good! just confirm the dotColors is not a regression by making sure the main would generate the same snapshot

and can you run these e2e tests to sanity check https://github.com/viamrobotics/visualization/blob/main/e2e/snapshot.test.ts

[Matthew MacFarquhar (mattmacf98)]

why is this different now?

Base64	Hex Bytes	RGB	Color
AACL	00 00 8B	(0, 0, 139)	Dark Blue
/6UA	FF A5 00	(255, 165, 0)	Orange

[Marcus (sucrammal)]

Yep! Found the bug. Updated e2e tests by running in main, brought the new standard screenshots into this branch, ran again with fixes, and all tests pass as normal, with color reverted.