Files
AnyImage/openspec/changes/archive/2026-09-17-auto-crop-panorama-input/proposal.md
nan 198fcbf55b
Some checks failed
Test / test (push) Has been cancelled
Initial public release
2026-09-19 21:31:36 +08:00

28 lines
1.4 KiB
Markdown

## Why
Convert to Panorama currently rejects any image whose pixel dimensions are not exactly 2:1, so even a nearly compliant panorama cannot be processed. Panorama conversion should accept arbitrary static image aspect ratios by preparing a valid 2:1 input automatically while making the loss of edge content visible to the user.
## What Changes
- Accept static panorama source images regardless of their original aspect ratio.
- Center-crop the source to the largest integer-pixel 2:1 region before preparing both the AI analysis input and panorama color material.
- Report a warning when any rows or columns are removed, including the original and cropped dimensions.
- Preserve the existing behavior without a warning when the source dimensions are already exactly 2:1.
- Continue rejecting animated or unusably small images that cannot produce a positive 2:1 crop.
## Capabilities
### New Capabilities
- `panorama-input-cropping`: Defines validation, centered 2:1 crop selection, prepared panorama inputs, and user warning behavior.
### Modified Capabilities
None.
## Impact
- Affects the Blender-side Convert to Panorama operator and shared material color input preparation used by its job submission.
- Adds focused operator and image-preparation tests for wide, tall, odd-width, already-2:1, animated, and unusably small inputs.
- Does not change the panorama job protocol, server geometry pipeline, model dependencies, or node assets.