[darioalessandro]

Portrait shipped in #271 as a first pass: a sharp preview, a fixed f/4.5 blur baked into a 12MP still, and no way to change it afterwards. This PR takes it most of the way to Apple's Camera. 16.1.0 never went out, so the Portrait wire was free to change and is redone here rather than patched.

What you get

• The blur shows while you frame. In Portrait the camera streams depth alongside the video and blurs each preview frame before it goes to the remote (and the Watch). Outside Portrait the preview path is unchanged.
• An f-stop ruler on the remote. f/1.4 to f/16, Apple's Depth Control range, with full stops marked. It is a rig setting: every camera gets the same aperture, and a camera that joins or swaps lenses is corrected to match.
• Editable by default. The camera saves the capture file as it came off the sensor, with depth and the person, hair, skin, teeth and glasses mattes inside, so Photos can change the blur later. A Baked option in the rig tray renders the blur into the photo instead. Never both files.
• Better Baked stills. 24MP instead of 12, the mattes feed the blur, and HDR is kept: the blur is rendered in HDR and saved with a fresh gain map, where before the re-encode silently dropped it.

How it behaves

• Editable stills come out at the sensor's 4:3. Cropping to another ratio would re-encode the file and throw the depth away, so the aspect setting only applies to Baked.
• Switching Photo to Portrait still keeps the same camera format; turning depth on pauses the preview for about half a second (measured, it is the camera reconfiguring).
• Portrait only appears when every camera in the rig can do it.

Why not Apple's Cinematic renderer

WWDC26 suggests turning on Cinematic capture for a free live blur. I measured it on an iPhone 18 Pro before building anything: stills from a Cinematic session are video-sized (1080p or 4K), carry no depth and no HDR gain map, it only runs on the single Wide camera, and zoom is capped at 3x. The plain photo session with a depth output kept 24MP, depth and the gain map with video at 29.7 fps, so that is what this builds on.

Wire

• CommandAction.SetPortrait = 36, carrying portrait_aperture and portrait_output (0 / Unknown = keep).
• PortraitOutput { Unknown, Baked, Editable }.
• CameraState.portrait: PortraitState { aperture, min_aperture, max_aperture, output }. Its presence is the capability; supports_portrait is gone.

What was checked

• The full unit suite passes on the simulator and the app builds for Mac Catalyst.
• New tests cover the wire round trip, the camera answering and refusing SetPortrait, the rig fan-out at 1, 2 and 4 cameras, the ruler range intersection, the Editable/Baked/crop decision, the 24MP pick, the HDR encode, and the preview blur's focus and radius maths on synthetic depth.
• The design choices above come from a hardware probe on an iPhone 18 Pro (iOS 27.2).

Not verified yet

The new hardware tests compile but have not run on a phone. Before this ships, someone needs to see on a real device:

• how the live blur looks, whether the depth map lines up with the frame, and whether the preview holds 30 fps in Portrait
• that Photos offers Depth Control on an Editable still
• a Baked still keeping HDR, and 24MP with depth through the app
• the landscape layout with Manual exposure and Portrait both on (three vertical rulers plus zoom)
• the new strings in 15 languages, which no native speaker has read

Known gaps, for follow-ups: a preview frame dropped for back-pressure is blurred before it is dropped; a Portrait shot whose result lands after switching to Photo gets a plain crop; front-camera Portrait, Portrait Lighting and the subject badge are not in this PR.

🤖 Generated with Claude Code