Add viewport tools to select, move, rotate and scale from DevTools
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 25/100
Research direction
Start by getting agreement on how the game-side overlay attaches and blocks input; the issue says this design must be settled before implementation. Then work through the suggested PR sequence, beginning with the connector, tool state and input blocking. Done means the acceptance criteria pass, including tests for drag and coordinate math.
Written by the indexing model from the issue text.
Description
Problem to solve
Components can only be changed through number fields in the DevTools extension. There is no way to click a component in the game to select it, or to drag it into place.
Proposal
DevTools runs apart from the game and only talks to it through service extensions, so this can't live only in the extension. The proposal is a game-side overlay: the extension turns a tool on through a new connector, while hit testing, gizmo drawing and drags all run in the game process. The extension and the game share the selection.
The design needs agreement before implementation, especially how the overlay attaches to the game and how game input is blocked.
Tools: Interact (the default, with no effect on the game), Select, Move, Rotate, Scale.
Selection
- Get candidates with
componentsAtPoint(point).whereType<PositionComponent>(), topmost first. - Clicking again at the same point selects the candidate after the current one, wrapping around, so overlapping components can be reached.
Coordinates
- Map local points to the canvas by walking up the parents and applying each transform. A
Worldis only rendered through the cameras that look at it, so the mapping needs a camera, and a component can have one gizmo per camera. - Keep the gizmo outline as four corners, not a rectangle, so rotation, scale and flips on the component and its ancestors all work.
Drags
- Capture what the drag needs when it starts, so it keeps following the pointer even when a camera follows the dragged component.
- Measure from the pointer-down position, so the drag slop doesn't offset the component.
- Support cancelling, which restores the starting value.
- Move: convert the drag into the parent's space. Axis handles move along the component's local axis.
- Rotate: turn by the angle the pointer sweeps around the anchor, and invert the direction when the parent space is mirrored.
- Scale: dragging away from the anchor by one axis length doubles the scale. The square between the axes scales both uniformly.
Handles: suggested sizes are 40 for the axis, 8 to 18 for the free square, 50 for the ring radius, and a 6 pixel grab tolerance. All are fixed in canvas space regardless of zoom.
Snapping: while Shift is held, snap to 8 units, 15° or 0.1 scale, and re-apply the current drag when Shift is pressed or released. On a rotated axis, snap the distance moved so the component stays on the axis.
Suggested PRs
- Connector, tool state and input blocking.
- Click to select, synced with the extension's tree.
- Coordinate mapping and gizmo drawing.
- Move tool.
- Rotate tool.
- Scale tool.
- Shift snapping.
Acceptance criteria
- With the Interact tool, or with DevTools closed, the game behaves exactly as it does today.
- Nothing from this feature runs in release builds.
- The game receives no pointer events while another tool is active.
- Gizmos stay correct with camera zoom, rotated or flipped parents, and multiple cameras.
- Tools work while the game is paused, and changes are visible straight away.
- Drag and coordinate math is covered by tests.
More information
Part of the work to move the flame_studio debugging features to flame_devtools. Do this last, since it is the largest piece.
- Dominant language
- Dart
- Stars
- 10.8k
- Forks
- 1.1k
- Avg merge
- 2d 4h
- Merged PRs (30d)
- 61
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from flame-engine/flame
-
Timer with tickCount stays finished after start() or reset()Possibly taken @matthewalberto claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
flame-engine/flame#4240 · 1 comment ·
Maintainers usually reply within 1 day
-
`CameraComponent.follow` follows the local position of a nested targetPossibly taken @ufrshubham claimed this today. Openbug
flame-engine/flame#4238 · 1 assignee ·
Maintainers usually reply within 1 day
-
`ComponentPool` returns components to the pool while they are still in use, and loses components removed before mountingPossibly taken @ufrshubham claimed this 18 days ago. Openbug
flame-engine/flame#4191 · 1 assignee ·
Maintainers usually reply within 1 day
-
Move the flame_studio debugging features to flame_devtoolsPossibly taken A pull request linked to this issue is open or already merged. Openenhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
flame-engine/flame#4176 ·
Maintainers usually reply within 1 day
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
flame-engine/flame#4174 ·
Maintainers usually reply within 1 day
All issues in flame-engine/flame
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 2 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
spotiflacapp/SpotiFLAC-Mobile#935 ·
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
chriskelly/wish-together#193 ·
Maintainers usually reply within 1 day
-
area: player feature request
Difficulty 2/5 1-3 hours Newbie friendliness 65/100