Release Notes for Seq66 v. 0.99.8 2023-08-27

- Issue #112: A new pattern now displays in the MIDI controller. - Issue #114: Adding display of shortcut keys to tool tips. - Added a Pattern tab to Edit / Preferences for more settings. - Added automation for the main window Loop L/R button. - Fixed seqroll drawing errors introduced in adding time-sig support. - Fixed incomplete data-pane refresh in scrolling with arrow-keys. - Fixed not setting up SIGINT, which prevented a proper shutdown. - Fixed a couple corrupted sample *.mid files. - Changing playlist setting enables Session Restart button. - Removed coloring of record-style and -mode buttons. Added coloring of event-editor "Store" button to denote saving is needed. - Refactoring quantization alterations for future upgrades. Added an option to jitter the notes in the seqroll. - Enforced that configuration files are stored in the "home" directory. - The usual raft of humiliating bug-fixes. See README.md. Read the NEWS, README.md, and TODO files.
ahlstromcj · Aug 27, 2023 · d0e2f68 · d0e2f68
1 parent e810557
commit d0e2f68
Show file tree

Hide file tree

Showing 17 changed files with 6,453 additions and 43 deletions.
diff --git a/ChangeLog b/ChangeLog
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# README for Seq66 0.99.8 2023-08-25
+# README for Seq66 0.99.8 2023-08-27
 
 __Seq66__: MIDI sequencer/live-looper with a hardware-sampler grid interface;
 pattern banks, triggers, and playlists for song management; scale and chord

diff --git a/RELNOTES b/RELNOTES
@@ -1,6 +1,6 @@
-Release Notes for Seq66 v. 0.99.8 2023-08-25
+Release Notes for Seq66 v. 0.99.8 2023-08-27
 
-This file lists major changes in version 0.99.8
+Major changes in version 0.99.8
 
     -   Issue #112: A new pattern now displays in the MIDI controller.
     -   Issue #114: Adding display of shortcut keys to tool tips.

diff --git a/VERSION b/VERSION
@@ -1,2 +1,2 @@
-2023-08-24
+2023-08-27
 0.99.8
diff --git a/configure.ac b/configure.ac
@@ -6,7 +6,7 @@ dnl \file          configure.ac
 dnl \library       Seq66
 dnl \author        Chris Ahlstrom
 dnl \date          2018-11-09
-dnl \update        2023-08-24
+dnl \update        2023-08-27
 dnl \version       $Revision$
 dnl \license       $XPC_SUITE_GPL_LICENSE$
 dnl
@@ -480,7 +480,7 @@ dnl      automatically for us.
 
 AH_TOP(
 
-#define VERSION_DATE_SHORT "2023-08-24"
+#define VERSION_DATE_SHORT "2023-08-27"
 #define API_VERSION "0.99"
 #define VERSION "0.99.8"
 

diff --git a/data/license.text b/data/license.text
@@ -1,12 +1,12 @@
-Seq66 Licensing 0.99.6 and above
+Seq66 Licensing 0.99.8 and above
 Chris Ahlstrom
-2015-09-10 to 2023-07-01
+2015-09-10 to 2023-08-27
 
 Applications:
 
    The Seq66 application license is either the GNU GPLv2 or the GNU GPLv3.
-   Generally, projects that originate with us use the latter license, while
-   projects we have extended may specify the former license.
+   Generally, our projects use the latter license, while projects we have
+   extended may specify the former license.
 
    Copyright (C) 2015-2023 by Chris Ahlstrom
 

diff --git a/data/readme.text b/data/readme.text
@@ -1,8 +1,11 @@
-readme.text for Seq66 0.99.7 and above
+readme.text for Seq66 0.99.8
 Chris Ahlstrom
-2015-09-10 to 2023-07-17
+2015-09-10 to 2023-08-27
 
-Release 0.99.7 fixes known issues and greatly enhances playlist support.
+Release 0.99.8 fixes known issues, adds a Pattern tab to Preferences,
+enhances randomization and quantization, enforces using a "home" directory for
+configuration files, displays keystroke shortcuts in tooltips, and lays the
+groundwwork for supporting more MIDI automation.
 
 Seq66 is a refactoring of a reboot (sequencer64) of seq24, extending it with new
 features and bug fixes, and incorporation of Modern C++ (C++11/C++14).  It

diff --git a/data/readme.windows b/data/readme.windows
@@ -1,14 +1,14 @@
-readme.windows for Seq66 0.99.7 and above
+readme.windows for Seq66 0.99.8 and above
 Chris Ahlstrom
-2018-05-13 to 2023-07-17
+2018-05-13 to 2023-08-27
 
 This README file tells you how to run the native Windows implmentation of
 seq66, an executable named qpseq66.exe.  It provides some notes on Seq66 and
 Windows.  We mostly use Windows 10; some features might differ in Windows 7 or
 Windows 2012+ Server.
 
-Release 0.99.7 fixes known issues and greatly enhances playlist support, and
-includes a Windows-specific sample play-list file in "data/win"..
+Release 0.99.8 fixes known issues and adds other work as noted in
+readme.text.
 
 There will eventually be a portable ZIP package for qpseq66; an NSIS-based
 installer is available (replace "0.99" with the latest version number):

diff --git a/data/share/doc/seq66-user-manual.pdf b/data/share/doc/seq66-user-manual.pdf
diff --git a/doc/latex/tex/configuration.tex b/doc/latex/tex/configuration.tex
@@ -6,7 +6,7 @@
 % \library     Documents
 % \author      Chris Ahlstrom
 % \date        2021-01-18
-% \update      2023-06-01
+% \update      2023-08-27
 % \version     $Revision$
 % \license     $XPC_GPL_LICENSE$
 %
@@ -1470,6 +1470,36 @@ \subsubsection{'usr' File / User MIDI PPQN}
       use-file-ppqn = true
    \end{verbatim}
 
+\subsubsection{'usr' File / User Randomization}
+\label{subsubsec:usr_file_user_randomization}
+
+   The \textbf{Jitter} and \textbf{Randomize} commands available in
+   the \textbf{Tools} menu in the pattern editor depend on
+   two configurable values.
+
+   \index{usr!midi-ppqn}
+   \index{default PPQN}
+   \index{file PPQN}
+   \begin{verbatim}
+      [user-randomization]
+      jitter-divisor = 8
+      amplitude = 8
+   \end{verbatim}
+
+   The \texttt{jitter-divisor} value is used to limit the amount of time
+   jitter in jittering note events.  If \texttt{J} is the jitter divisor, than
+   the maximum range of time randomization R is: \texttt{R = S / J}, where
+   \texttt{S} is the current value of note snap in the pattern editor.
+   Thus, the time can be varied by an amount from minus R to plus R.
+
+   The \texttt{amplitude} value is the maximum range (plus or minus) by which
+   to modify amplitude values such as note velocity or channel pressure.
+   Keep this value small, as the numbers it affects range only from
+   0 to 127.
+
+   One minor bug persists in randomization.  As the randomization is applied
+   repeatedly, the amplitude tends toward zero.
+
 \subsubsection{'usr' File / User MIDI Settings}
 \label{subsubsec:usr_file_user_midi_settings}
 

diff --git a/doc/latex/tex/pattern_editor.tex b/doc/latex/tex/pattern_editor.tex
@@ -6,7 +6,7 @@
 % \library     Documents
 % \author      Chris Ahlstrom
 % \date        2015-08-31
-% \update      2023-06-15
+% \update      2023-08-27
 % \version     $Revision$
 % \license     $XPC_GPL_LICENSE$
 %
@@ -276,27 +276,41 @@ \subsection{Pattern Editor / Second Row}
 
    \itempar{Tools}{pattern editor!tools}
    This button brings up a nested menu of tools for modifying selected
-   events and notes:
+   events and notes.
 
    \begin{enumber}
-      \item \textbf{Select}.  This menu provides two note-selection options:
+      \item \textbf{Select Notes...}.
+      Selects Note Ons, Note Offs, and Aftertouch.
+      In order for notes to be modified by quantization or randomization,
+      they need to be selected first, otherwise some menu entries are
+      disabled..
+      Notes can be selected in the piano roll of via this menu.
+      This menu provides two note-selection options:
          \begin{itemize}
             \item \textbf{Select all}, selects all notes in the pattern;
                The \index{keys!ctrl-a} \texttt{Ctrl-A} will also select
                all of the events in the pattern editor.
-            \item \textbf{Inverse selection}, which inverts the selection of
+            \item \textbf{Invert selection}, which inverts the selection of
                notes.
          \end{itemize}
-      \item \textbf{Timing}. This menu
-            offers two ways to tweak the timing of the selected note:
+      \item \textbf{Note timing/velocity...}. This menu
+            offers three ways to tweak the timing of the selected notes:
          \begin{itemize}
             \item \textbf{Quantize}
                \index{quantize}
-               quantizes the selected notes, the same way as the
+               quantizes the selected notes in time, the same way as the
                \textbf{Quantize} ("\textbf{Q}") button.
-            \item \textbf{Tighten},
+            \item \textbf{Tighten}
                \index{tighten}
-               which is merely a less strict form of quantization.
+               This operation merely a less strict form of quantization.
+            \item \textbf{Jitter}
+               \index{jitter}
+               Jittering modifies the timing of a note by adding or subtracting
+               a small random of time.
+            \item \textbf{Randomize velocity}
+               \index{randomize}
+               This operation modifies the velocity of a note by a small
+               amount.
          \end{itemize}
       \item \textbf{Pitch transpose} allows uniform transpostion
          regardless of the key and scale in force for the pattern.

diff --git a/include/config.h.in b/include/config.h.in
@@ -1,6 +1,6 @@
 /* include/config.h.in.  Generated from configure.ac by autoheader.  */
 
-#define VERSION_DATE_SHORT "2023-08-24"
+#define VERSION_DATE_SHORT "2023-08-27"
 #define API_VERSION "0.99"
 #define VERSION "0.99.8"
 

diff --git a/include/qt/portmidi/seq66-config.h b/include/qt/portmidi/seq66-config.h
@@ -33,7 +33,7 @@
  * \library       seq66 application
  * \author        Chris Ahlstrom
  * \date          2018-11-10
- * \updates       2023-07-19
+ * \updates       2023-08-27
  * \license       GNU GPLv2 or above
  *
  *  Qt Portmidi Linux and Windows versions, hardwired for use with
@@ -62,15 +62,15 @@
 #endif
 
 #if ! defined SEQ66_VERSION_DATE_SHORT
-#define SEQ66_VERSION_DATE_SHORT "2023-07-19"
+#define SEQ66_VERSION_DATE_SHORT "2023-08-27"
 #endif
 
 #if ! defined SEQ66_API_VERSION
 #define SEQ66_API_VERSION "0.99"
 #endif
 
 #if ! defined SEQ66_VERSION
-#define SEQ66_VERSION "0.99.7"
+#define SEQ66_VERSION "0.99.8"
 #endif
 
 #if ! defined SEQ66_GIT_VERSION
@@ -331,7 +331,7 @@
 
 /* Define to the full name and version of this package. */
 #if ! defined SEQ66_PACKAGE_STRING
-#define SEQ66_PACKAGE_STRING "Seq66 0.99.7"
+#define SEQ66_PACKAGE_STRING "Seq66 0.99.8"
 #endif
 
 /* Define to the one symbol short name of this package. */

diff --git a/include/qt/rtmidi/seq66-config.h b/include/qt/rtmidi/seq66-config.h
@@ -33,7 +33,7 @@
  * \library       seq66 application
  * \author        Chris Ahlstrom
  * \date          2020-05-31
- * \updates       2023-07-19
+ * \updates       2023-08-27
  * \license       GNU GPLv2 or above
  *
  *  Qt Rtmidi Linux and Windows versions, hardwired for use with
@@ -70,7 +70,7 @@
 #endif
 
 #if ! defined SEQ66_VERSION_DATE_SHORT
-#define SEQ66_VERSION_DATE_SHORT "2023-07-19"
+#define SEQ66_VERSION_DATE_SHORT "2023-08-27"
 #endif
 
 #if ! defined SEQ66_API_VERSION
@@ -380,7 +380,7 @@
 
 /* Define to the full name and version of this package. */
 #if ! defined SEQ66_PACKAGE_STRING
-#define SEQ66_PACKAGE_STRING "Seq66 0.99.7"
+#define SEQ66_PACKAGE_STRING "Seq66 0.99.08-27
 #endif
 
 /* Define to the one symbol short name of this package. */

diff --git a/nsis/Seq66Constants.nsh b/nsis/Seq66Constants.nsh
@@ -3,8 +3,8 @@
 ; File:         Seq66Constants.nsh
 ; Author:       Chris Ahlstrom
 ; Date:         2018-05-26
-; Updated:      2023-07-19
-; Version:      0.99.7
+; Updated:      2023-08-27
+; Version:      0.99.8
 ;
 ;   Provides constants commonly used by the installer for Seq66 for
 ;   Windows.
@@ -31,7 +31,7 @@
 
 !define VER_MAIN_PURPOSE    "Seq66 for Windows"
 !define VER_NUMBER          "0.99"
-!define VER_REVISION        "7"
+!define VER_REVISION        "8"
 !define VER_VARIANT         "Windows"
 !define PRODUCT_VERSION     "${VER_NUMBER} ${VER_VARIANT} (rev ${VER_REVISION})"
 !define PRODUCT_PUBLISHER   "C. Ahlstrom (ahlstromcj@gmail.com)"

diff --git a/nsis/Seq66Setup.nsi b/nsis/Seq66Setup.nsi
@@ -3,8 +3,8 @@
 ; File:         Seq66Setup.nsi
 ; Author:       Chris Ahlstrom
 ; Date:         2018-05-26
-; Updated:      2023-07-17
-; Version:      0.99.7
+; Updated:      2023-08-27
+; Version:      0.99.8
 ;
 ; Usage of this Windows build script:
 ;

diff --git a/nsis/build_release_package.bat b/nsis/build_release_package.bat
@@ -7,7 +7,7 @@
 :: \library     Seq66 for Windows
 :: \author      Chris Ahlstrom
 :: \date        2018-05-26
-:: \update      2023-07-19
+:: \update      2023-08-27
 :: \license     $XPC_SUITE_GPL_LICENSE$
 ::
 ::      This script sets up and creates a release build of Seq66 for
@@ -171,8 +171,8 @@
 ::
 ::---------------------------------------------------------------------------
 
-set PROJECT_VERSION=0.99.7
-set PROJECT_DATE=2023-07-19
+set PROJECT_VERSION=0.99.8
+set PROJECT_DATE=2023-08-27
 set PROJECT_DRIVE=C:
 
 :: Set the bits of the project, either 64 or 32. Also define WIN64 versus
-Original file line number
+Diff line change
@@ -1,2 +1,2 @@
--08-24
+-08-27
 .99.8