Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
64 lines
2.7 KiB
Plaintext
64 lines
2.7 KiB
Plaintext
<page xmlns="http://projectmallard.org/1.0/"
|
|
type="topic" style="task"
|
|
id="pause">
|
|
|
|
<info>
|
|
<link type="guide" xref="index#viewing"/>
|
|
<link type="seealso" xref="trigger"/>
|
|
<desc>Pausing freezes the display without stopping the stream, and the status bar says how
|
|
long you have been paused.</desc>
|
|
<credit type="author copyright">
|
|
<name>Martino Ferrari</name>
|
|
</credit>
|
|
</info>
|
|
|
|
<title>Pause and play</title>
|
|
|
|
<p>Pause freezes the <em>display</em>, not the acquisition. The producer keeps filling the
|
|
ring at full rate; the view binds an immutable snapshot of the window that was on screen,
|
|
and the axis is pinned to it.</p>
|
|
|
|
<section id="reach">
|
|
<title>How to reach it</title>
|
|
<steps>
|
|
<item>
|
|
<p>Press the pause button in the header bar, or <key>Space</key>.</p>
|
|
</item>
|
|
<item>
|
|
<p>Press it again to resume, which rebinds the live ring and puts the window back on
|
|
the newest data.</p>
|
|
</item>
|
|
</steps>
|
|
</section>
|
|
|
|
<section id="knowing">
|
|
<title>Worth knowing</title>
|
|
<list>
|
|
<item><p>Nothing is lost while paused. Because the producer never stops, resuming shows
|
|
current data with no hole in the history behind it.</p></item>
|
|
<item><p>The axis is pinned to the <em>snapshot's own stamps</em>, not to the window that
|
|
was requested. A window reaching back past the oldest retained sample yields a shorter
|
|
snapshot, and the pinned axis is that shorter span — so you see a narrower view rather
|
|
than an empty margin.</p></item>
|
|
<item><p>A paused view is pinned exactly as a held trigger event is: zoom in freely, but
|
|
a pan or a zoom out is clamped to the snapshot's data. A measurement goes on describing
|
|
that frozen frame rather than the part of it you are looking at, so a zoom on a pause
|
|
changes no reading — see <link xref="measurements"/>.</p></item>
|
|
<item><p>Pausing is the easiest way to measure a layout or read a cursor precisely,
|
|
because nothing under the pointer moves between frames.</p></item>
|
|
<item><p>The status bar says how long you have been paused — wall time, since the stream
|
|
itself never stopped. It is there so a frozen picture cannot be mistaken for a live one
|
|
that went quiet.</p></item>
|
|
</list>
|
|
</section>
|
|
|
|
<section id="example">
|
|
<title>Example</title>
|
|
<p>Pause with a 2 s window over a ring holding 1.4 s: the frozen axis reads
|
|
<code>[-1.40 .. 0.00]</code> rather than <code>[-2.00 .. 0.00]</code> with 0.6 s of blank.
|
|
The pause probe reports <code>ring_produced</code> still growing across the pause and
|
|
<code>event_size</code> non-zero exactly while paused.</p>
|
|
</section>
|
|
|
|
</page>
|