# Cinematic Laparoscope Camera (project-scoped)

Constrains camera work to the laparoscope viewpoint the scene is built around. The preserved stereo rig is **not** edited by this skill — it is the interop surface.

## When to use
Load before adjusting FOV, near/far clip, depth of field, exposure, or post-processing on any camera, or diagnosing "scene looks too far", "scene looks too bright", "black frame", or "vignette too strong".

## Camera inventory (do not rename)

- **Stereo rig** (from `MainScene`): preserved at its current path. Do not rename, move, or retarget. Interop surface for WebRTC and external automation.
- **Art-directed laparoscope camera**: under `SurgeryBenchmark/Shared`. If one is not present, the scene-director agent can add it as a bounded change.

## Laparoscope framing

- **FOV**: `fieldOfView` 35–55 for "looks like a scope"; 60–75 for "wide scope"; > 80 looks like a generic game camera.
- **Near clip**: 0.01–0.05 m. Far clip: 5–20 m (enough for a cavity).
- **Barrel optics**: `LensDistortion.intensity` 0.05–0.15 + `Vignette.intensity` 0.25–0.4, smoothness 0.3–0.5.
- **Highlights**: narrow `Bloom.intensity` 0.1–0.3, `threshold` > 1.0 (only catches the brightest specular hits).
- **Color grading**: `ColorAdjustments.contrast` +0.05 to +0.15, `postExposure` near 0, `Tonemapping` = Neutral or ACES.

## Depth of field

- Mode: `Gaussian` (not Bokeh — too heavy for real-time).
- `gaussianStart`: near the closest tissue you want sharp.
- `gaussianEnd`: just past the farthest tissue you want sharp.
- `gaussianMaxRadius`: 1.0–2.5 px for subtle; > 4 looks like a portrait lens.
- Pitfall: focus so close the near plane is inside the focus zone → "all-blur" frame. Verify by screenshot.

## Exposure and HDR

- `Camera.allowHDR` = true. The URP asset must have HDR enabled (default in URP 14).
- Use `ColorAdjustments.postExposure` (stops, ±1.0). If range > 1.0 needed, fix the lighting instead.
- "Too dark" laparoscope usually means: Volume profile missing `ColorAdjustments`, or post-processing is skipped because the URP asset has it disabled. Verify with `volume_get_info` before touching the camera.

## Adding a secondary / overview camera (bounded change)

1. Create as child of `SurgeryBenchmark/Shared/_Cameras`.
2. Name it `OverviewCamera_<Tag>` (e.g., `OverviewCamera_Cavity`).
3. `clearFlags = Solid Color` with neutral mid-grey, or `Skybox` if the cavity is enclosed.
4. Do **not** disable the stereo rig or any preserved camera.

## Composition rules

- Verify from at least two angles: scope (default) + 30–45° offset.
- A 30–45° offset shot catches stretching, lighting falloff, and proportion problems the scope view hides.
- For every verification pass: scope screenshot + offset screenshot.

## Common MCP calls

```
# Screenshot from the laparoscope
mcp__UnityMCP__manage_camera(action="screenshot", include_image=true, output_folder="Assets/Screenshots/LaparoscopicBenchmark")

# Set camera properties
mcp__UnityMCP__manage_camera(action="set_lens", target="<camera path>", search_method="by_path", field_of_view=45, near_clip_plane=0.02, far_clip_plane=10.0)

# Read camera properties
mcp__UnityMCP__manage_components(action="get_component", target="<camera path>", component_type="Camera")
```