====== Advanced Looping ======

See [[https://sourceforge.net/p/rosegarden/bugs/1605|bug #1605]].

===== Setup =====

  * Launch rg
  * Preferences
    * ENABLE "Stop playback at end of last segment" in preferences.
    * DISABLE "Jump to loop"
    * ENABLE "Advanced Looping (beta)" in preferences.

===== Basic Looping =====

  * File > New
  * Confirm Edit > Cut/Copy Range and "Clear range of tempos" menu items are disabled.

  * Press the loop button on the transport.
  * Confirm button is active.
  * Confirm LoopRuler background indicates LoopAll (blue).

  * Create a 4 bar segment at bar 1.
  * Press Play
  * Confirm whole song loops (loop ends at bar 5)
  * Press Stop

  * Move the cursor using Ctrl+Click in the ruler to bar 3.
  * Press the start loop button "|<-" on the transport.
  * Move the cursor using Ctrl+Click to bar 4.
  * Press the end loop button "->|" on the transport.
  * Confirm
    * a loop range from bar 3 to 4
    * LoopRuler indicates LoopOn mode.
    * Transport loop button is pressed.
    * Edit > Cut/Copy Range and "Clear range of tempos" menu items are enabled.

  * Press Play
  * Confirm playback looping between bar 3 and 4.

===== Right-Click in Loop Ruler =====

  * Right-click in the loop ruler.
  * Confirm
    * LoopRuler indicates LoopAll mode.
    * Playback continues past bar 4.
    * Transport loop button is pressed.
    * Whole song is looping (bar 1-5)

  * While the playback pointer is prior to the loop, right-click in the ruler.
  * Confirm
    * LoopRuler indicates LoopOn mode.
    * playback continues until cursor is in loop range.
    * playback then loops in the range.

===== Loop Button =====

  * Click on the loop button on the transport.
  * Confirm
    * LoopRuler indicates LoopOff mode.
    * Playback is not looping. Range is still present.
  * Let play proceed to the end of the segment (bar 5).
  * Confirm playback stops at bar 5.

  * Click on the loop button on the transport.
  * Press Play to start playback.
  * Confirm playback looping in the range.

===== Right-Click and Drag =====

  * Extend the Segment through bar 6 to bar 7.  Might need to stop and restart playback.
  * Confirm looping from 3-4.
  * Specify a loop range from 5 to 6 by right-clicking and dragging on the loop ruler.
  * Confirm playback continues until it reaches bar 5 then loops.
  * Specify a loop range from 2 to 3 by right-clicking and dragging on the top ruler.
  * Confirm that upon release of the mouse button, playback continues to the end of the segment and stops.
  * Press play.
  * Confirm playback is looping from 2-3.

  * Specify a null loop range by right-clicking and dragging right then left until the indicator is just a line.
  * Confirm
    * LoopRuler indicates LoopAll mode.
    * Whole song loops.
    * Edit > Copy Range and "Clear range of tempos" menu items are enabled.
    * Edit > Cut Range is disabled because we are in play mode.

===== Marker Looping =====

  * Stop playback.
  * Create two markers (Shift+M).
  * Shift+click between those two markers in the marker ruler.
  * Confirm
    * Loop range appears between the markers.
    * Loop is enabled and working.
  * Shift+click between the first marker and bar 1 in the marker ruler.
  * Confirm
    * Loop range appears between bar 1 and the first marker.
    * Loop is enabled and working.

===== Set Loop To Selection =====

  * Stop playback
  * Select the Segment
  * Launch the Matrix
  * Drop a large note.  It should be selected.
  * Move > Set Loop to Selection.
  * Confirm
    * Loop is set to range of note.
    * Loop is on.
  * Move > Clear Loop
  * Confirm: Loop off.

  * Launch Notation.
  * Select the note.
  * Move > Set Loop to Selection.
  * Confirm
    * Loop is set to range of note.
    * Loop is on.
  * Move > Clear Loop
  * Confirm: Loop off.

===== MIDI Controller =====

  * Given a loop range.
  * Press the Loop button on a MIDI controller.
  * Confirm: Toggles loop on/off.

===== Insert/Delete Range =====

  * Insert Range...
    * Insert Range before loop moves the entire loop.
    * Insert Range inside the loop moves the end only.

===== Tempo Change =====

  * Given a loop range after bar 1.
  * Change the tempo at bar 1.
    * Composition > Open Tempo and Time Signature Editor
  * Confirm loop is still in the same place and works.

===== Results =====