Skip to content

Commit ee6ba87

Browse files
bedaHovorkaclaude
andcommitted
docs: remove internal jargon and improve Limitations/Troubleshooting
- Drop "Goal 7" from the user-facing intro - Remove Goal 8 integration-point note from keyboard shortcuts - Reorder Limitations to lead with control ranges before the 100x cap - Collapse two CPU-bound sentences into one - Add actionable fix to the Space-key troubleshooting entry Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 1d436bc commit ee6ba87

1 file changed

Lines changed: 5 additions & 8 deletions

File tree

docs/SIMULATION_SPEED_CONTROL.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Simulation Speed Control
22

3-
Goal 7 adds live wall-clock speed control to the animated simulation GUI.
3+
The animated simulation GUI supports live wall-clock speed control.
44

55
The control changes how fast events are presented to the user. It does **not** change simulation semantics, event ordering, or physics calculations.
66

@@ -90,7 +90,6 @@ Notes:
9090

9191
- On many keyboards, `+` requires **Shift+`=`**.
9292
- Numpad `+` and `-` are also supported.
93-
- `Space` is the current Goal 8 integration point: it toggles the runner pause flag directly.
9493

9594
## Common Use Cases
9695

@@ -110,18 +109,16 @@ Notes:
110109

111110
## Limitations
112111

113-
- The slider stops at **10x** even though the runner supports up to **100x**.
114-
- `50x` is available from presets and the menu.
115-
- To reach values above that, press `+` repeatedly from `50x` until the runner reaches its `100x` cap, or set the multiplier programmatically.
112+
- The slider covers **0.1x to 10x**; preset buttons and the **Simulation → Speed** menu extend this to **50x**.
113+
- To reach values above `50x`, press `+` repeatedly — the runner caps at **100x**.
116114
- Speeds above roughly **10x** are useful for throughput, but animation becomes progressively harder to follow visually.
117-
- At **50x** and especially **100x**, small simulation deltas often round down to **0 ms sleep**, so execution becomes effectively CPU-bound.
118-
- In CPU-bound ranges, expect higher processor usage and less visually smooth animation than at `1x`.
115+
- At **50x** and above, small simulation deltas often round down to **0 ms sleep**, so execution becomes effectively CPU-bound — expect higher CPU usage and less smooth animation than at `1x`.
119116
- Console-mode runs do not expose the GUI speed controls.
120117

121118
## Troubleshooting
122119

123120
- **I cannot see the controls:** make sure you started the animated GUI, not the console example.
124121
- **The speed indicator disappeared:** that is expected at `1.0x`.
125-
- **`Space` does nothing:** a simulation must be running and the frame must have keyboard focus.
122+
- **`Space` does nothing:** a simulation must be running and the window must have keyboard focus. Click anywhere in the window to regain focus, then try again.
126123
- **The simulation feels too fast to follow:** use a preset such as `1x`, `0.5x`, or `0.1x`.
127124
- **CPU usage is high at very high speeds:** reduce speed to re-enable more wall-clock throttling.

0 commit comments

Comments
 (0)