Skip to content

docs: nothing falls back from streaming capture - #3

Closed
juancobo wants to merge 1 commit into
mainfrom
docs/a2500-no-fallback
Closed

juancobo wants to merge 1 commit into
mainfrom
docs/a2500-no-fallback

Conversation

@juancobo

Copy link
Copy Markdown
Member

The known-limitations note said the library falls back to SD card capture when streaming fails on the A2500. It does not. shoot(stream=True) goes to _shoot_streaming and raises; nothing calls _shoot_standard after it.

A caller reading that line would plan for a fallback that was never written — which is how it surfaced: Captua's CHDK backend captures with stream=True on the strength of it, and a review of that backend asked why it had no fallback path.

The note now says what is true: streaming may fail with PTP 0x2002, it raises, and a caller that wants the picture anyway has to call shoot() itself and collect it from the card. It also says that whether the A2500 fails this way in practice has not been established against hardware — the cameras have not been run yet.

The known-limitations note claimed the library falls back to SD card
capture when streaming fails on the A2500. It does not: shoot(stream=True)
goes to _shoot_streaming and raises, and nothing calls _shoot_standard
after it. A caller reading that line would plan for a fallback that was
never written.
@juancobo

Copy link
Copy Markdown
Member Author

Closing as superseded rather than rejected. The correction this PR makes — that nothing falls back from streaming capture, so shoot(stream=True) raises and the caller gets nothing unless it calls shoot() itself — is on main already, in README.md and again in RELEASE-NOTES-v0.1.3.md.

The version that landed went further in a way that matters. This PR's text retains two claims that have since been checked and withdrawn: that the A2500 port is alpha-level, and that streaming fails with PTP 0x2002. Neither is supported. camera_list.csv in release-1_6 carries a BETA_STATUS column, 34 of its 397 entries are marked ALPHA or BETA, and the A2500's entry (a2500,100a,,,) is not among them; and we have no record of observing 0x2002 on this camera, so it belongs on the bench-test list rather than in a known-limitations note.

Merging this now would reintroduce both. The branch docs/a2500-no-fallback can go.

@juancobo juancobo closed this Oct 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant