65 lines
3.6 KiB
Markdown
65 lines
3.6 KiB
Markdown
## ADDED Requirements
|
|
|
|
### Requirement: 图片元素支持 3D 视觉旋转
|
|
The system SHALL allow ordinary canvas image elements to persist a 3D visual transform without changing their rectangular geometry.
|
|
|
|
#### Scenario: Persist image 3D transform
|
|
- **GIVEN** the user applies a 3D rotation to an ordinary image element
|
|
- **WHEN** the board data is saved and restored
|
|
- **THEN** the image SHALL display with the same `rotateX`, `rotateY`, and `perspective` values
|
|
- **AND** the image points and resize geometry SHALL remain unchanged
|
|
|
|
#### Scenario: Reset image 3D transform
|
|
- **GIVEN** an ordinary image element has a 3D transform
|
|
- **WHEN** the user resets the 3D rotation
|
|
- **THEN** the system SHALL remove the `transform3d` field when both rotation axes are zero
|
|
|
|
### Requirement: 图片选区提供 popup-toolbar 3D 调节面板
|
|
The system SHALL show a 3D adjustment control in the popup toolbar for a single selected ordinary image and update the image transform through panel controls.
|
|
|
|
#### Scenario: Adjust 3D transform from popup toolbar
|
|
- **GIVEN** a single ordinary image is selected
|
|
- **WHEN** the user opens the 3D adjustment panel from the popup toolbar
|
|
- **THEN** the panel SHALL expose controls for `rotateX`, `rotateY`, and `perspective`
|
|
- **AND** changing the controls SHALL preview the image transform on the canvas
|
|
- **AND** each axis SHALL be clamped to `-180..180` degrees
|
|
- **AND** the image SHALL remain visible after crossing the edge-on midpoint
|
|
- **AND** the user SHALL be able to confirm or cancel the adjustment
|
|
|
|
#### Scenario: Hide control for unsupported selections
|
|
- **GIVEN** the selection is empty, contains multiple elements, or targets a video/audio/PPT placeholder image
|
|
- **WHEN** the popup toolbar is rendered
|
|
- **THEN** the 3D adjustment control SHALL NOT be shown
|
|
|
|
### Requirement: 3D rotation panel interactions are lightweight and undoable
|
|
The system SHALL keep 3D panel interactions responsive while committing each confirmed adjustment as a single undoable change.
|
|
|
|
#### Scenario: Confirm one history entry
|
|
- **GIVEN** the user changes 3D panel controls multiple times
|
|
- **WHEN** the user confirms the panel
|
|
- **THEN** intermediate updates SHALL NOT create separate history entries
|
|
- **AND** undo SHALL restore the image transform to the value before the panel opened
|
|
|
|
#### Scenario: Cancel panel restores transform
|
|
- **GIVEN** the user changes 3D panel controls
|
|
- **WHEN** the user cancels or dismisses the panel
|
|
- **THEN** the image transform SHALL return to the value before the panel opened
|
|
|
|
### Requirement: AI context includes image transform parameters
|
|
The system SHALL pass original image references to AI workflows and include image transform parameters in text context.
|
|
|
|
#### Scenario: Use original image and transform context
|
|
- **GIVEN** a selected ordinary image has a 2D rotation angle or `transform3d` value
|
|
- **WHEN** the selection is used as an AI image, video, or agent reference
|
|
- **THEN** the reference image SHALL remain the original image URL or source image data
|
|
- **AND** the text context SHALL include the image's 2D rotation angle when present
|
|
- **AND** the text context SHALL include `rotateX`, `rotateY`, and `perspective` when `transform3d` is present
|
|
|
|
#### Scenario: Rotated image overlaps graphics
|
|
- **GIVEN** a selected ordinary image has a 2D rotation angle or `transform3d` value
|
|
- **AND** the image overlaps selected graphics
|
|
- **WHEN** the selection is used as an AI image, video, or agent reference
|
|
- **THEN** the image SHALL be passed as its original image URL or source image data
|
|
- **AND** the graphics export SHALL NOT bake that rotated image into the graphics reference
|
|
- **AND** the text context SHALL describe the image transform parameters
|