Finalizing 4.1.002-release

ultraschall_api.lua

@@ -48,7 +48,7 @@ ultraschall.temp, ultraschall.Script_Context=reaper.get_action_context()
 
 
 -- Beta-Functions On
-ultraschall.US_BetaFunctions=true
+ultraschall.US_BetaFunctions=false
 
 ultraschall.temp1,ultraschall.temp=reaper.get_action_context()
 ultraschall.temp=string.gsub(ultraschall.temp,"\\","/")

ultraschall_api/Changelog-Api.txt

@@ -286,7 +286,38 @@ TODO!! buggy function
 
 ## Ultraschall Framework - Changelog
 
-### 4.1.002 - "The Buzzcocks - Why can't I touch it"
+### 4.1.002 - "The Buzzcocks - Why can't I touch it" - 8th of June 2020
+
+Has now 1146 functions, with 17 new ones
+
+**new in this release:**
+
+ - **Video window-Toggle Fullscreen** 
+ You can now toggle the video-window fullscreen/non-fullscreen via VideoWindow\_FullScreenToggle. 
+
+ - **Activate/Deactivate Mute-envelopes** 
+ Wasn't possible until now: activation and deactivation of Mute-Envelopes, as otherwise you cannot write to them.
+
+ - **MuteActions more stable** 
+ They should now set mute-envelope-points properly, no matter of mute-env-armstate and/or automation-mode.
+
+ - **Project-Diffs-Developertool** 
+ Reimplemented, so it shows only the diff-lines now.
+
+ - **Benchmarking-functions** 
+ You can have multiple benchmark-slots, so benchmarking multiple values at the same time is now possible. 
+ That way, you can benchmark the whole script and individual functions in one go.
+
+ - **Item Buttons can be now toggled** 
+ Now, you can toggle the buttons shown at the top of the MediaItem, like mute, FX, Envelopes, etc. Change them in one go, to have different "profiles"
+ of MediaItem-buttons, that reflect the usecases of your different projects.
+
+ - **PreventUIRefresh and RestoreUIRefresh**
+ Like Reaper's own PreventUIRefresh, but prevents accidental misuse of its counter, as the counting up is done by PreventUIRefresh and the "reset" of a 
+ PreventUIRefresh can be undone by RestoreUIRefresh. 
+ When using RestoreUIRefresh(true), all ultraschall.PreventUIRefresh-calls are reset, so the user-interface of Reaper is useable again.
+
+ - **bugfixes and readdition of accidentally deleted function..oops ;)**
 
 #### New features in 4.1.002
  - Benchmarking: Benchmark\_GetAllStartTimesAndSlots - returns the starttimes of all current benchmark-measuring-slots as a handy table(index=slot number)
@@ -304,7 +335,7 @@ TODO!! buggy function
  - User Interface: PreventUIRefresh - prevents refreshing of the user-interface, more solid, than Reaper's own PreventUIRefresh-function
  - User Interface: RestoreUIRefresh - restores a prevented UI-refreshing
  - User Interface: SetItemButtonsVisible - sets the individual item-buttons visible/invisible
- - User Interface: VideoWindow\_FullScreenToggle - toggles full-screen-state of the video-processor-window
+ - User Interface: VideoWindow\_FullScreenToggle - toggles full-screen-state of the video-processor-window(requested by vectorwarrior)
 
 #### Changes from 4.1.001 to 4.1.002
  - Benchmarking: Benchmark\_GetStartTime - has now additional optional parameter slot to get the starttime of a certain benchmarking-slot(requested by rstockm)

ultraschall_api/Documentation/ChangeLog.html

@@ -40,7 +40,28 @@
  </div>
  <div style="position:absolute; top:17%; padding-left:5%; width:90%;">
 <h2>Ultraschall Framework - Changelog</h2>
-<h3>4.1.002 - "The Buzzcocks - Why can't I touch it"</h3>
+<h3>4.1.002 - "The Buzzcocks - Why can't I touch it" - 8th of June 2020</h3>
+<p>Has now 1146 functions, with 17 new ones</p>
+<p><strong>new in this release:</strong></p>
+<ul>
+<li><p><strong>Video window-Toggle Fullscreen</strong><br />
+You can now toggle the video-window fullscreen/non-fullscreen via VideoWindow_FullScreenToggle.</p></li>
+<li><p><strong>Activate/Deactivate Mute-envelopes</strong><br />
+Wasn't possible until now: activation and deactivation of Mute-Envelopes, as otherwise you cannot write to them.</p></li>
+<li><p><strong>MuteActions more stable</strong><br />
+They should now set mute-envelope-points properly, no matter of mute-env-armstate and/or automation-mode.</p></li>
+<li><p><strong>Project-Diffs-Developertool</strong><br />
+Reimplemented, so it shows only the diff-lines now.</p></li>
+<li><p><strong>Benchmarking-functions</strong><br />
+You can have multiple benchmark-slots, so benchmarking multiple values at the same time is now possible.<br />
+That way, you can benchmark the whole script and individual functions in one go.</p></li>
+<li><p><strong>Item Buttons can be now toggled</strong><br />
+Now, you can toggle the buttons shown at the top of the MediaItem, like mute, FX, Envelopes, etc. Change them in one go, to have different "profiles" of MediaItem-buttons, that reflect the usecases of your different projects.</p></li>
+<li><p><strong>PreventUIRefresh and RestoreUIRefresh</strong> Like Reaper's own PreventUIRefresh, but prevents accidental misuse of its counter, as the counting up is done by PreventUIRefresh and the "reset" of a<br />
+PreventUIRefresh can be undone by RestoreUIRefresh.<br />
+When using RestoreUIRefresh(true), all ultraschall.PreventUIRefresh-calls are reset, so the user-interface of Reaper is useable again.</p></li>
+<li><p><strong>bugfixes and readdition of accidentally deleted function..oops ;)</strong></p></li>
+</ul>
 <h4>New features in 4.1.002</h4>
 <ul>
 <li>Benchmarking: Benchmark_GetAllStartTimesAndSlots - returns the starttimes of all current benchmark-measuring-slots as a handy table(index=slot number)</li>
@@ -58,7 +79,7 @@ <h4>New features in 4.1.002</h4>
 <li>User Interface: PreventUIRefresh - prevents refreshing of the user-interface, more solid, than Reaper's own PreventUIRefresh-function</li>
 <li>User Interface: RestoreUIRefresh - restores a prevented UI-refreshing</li>
 <li>User Interface: SetItemButtonsVisible - sets the individual item-buttons visible/invisible</li>
-<li>User Interface: VideoWindow_FullScreenToggle - toggles full-screen-state of the video-processor-window</li>
+<li>User Interface: VideoWindow_FullScreenToggle - toggles full-screen-state of the video-processor-window(requested by vectorwarrior)</li>
 </ul>
 <h4>Changes from 4.1.001 to 4.1.002</h4>
 <ul>

ultraschall_api/Documentation/Reaper_StateChunk_Docs.html

@@ -39,7 +39,7 @@
  </div>
  </div>
  <div style="position:absolute; top:17%; padding-left:5%; width:90%;">
-<br><br><img src="gfx/us.png"><div style="padding-left:0%;"><br>Beta 2.7 - "John Cage - 4'33" - 15th of October 2018 - Build: 43118</div><h3>The Functions Reference</h3>To add the API to your script, just add<pre><code> dofile(reaper.GetResourcePath().."/UserPlugins/ultraschall_api.lua")</code></pre>as first line into your script.<br><br>For more details, read the docs in the <a href="US_Api_Introduction_and_Concepts.html">Introduction and Concepts</a>-area of this page.<br><br><table style="font-size:10pt; width:100%;" ><table style="width:100%;" border="0"><tr><td><br><strong><u>ProjectStateChunk</u></strong><br><br>
+<br><br><img src="gfx/us.png"><div style="padding-left:0%;"><br>Beta 2.7 - "John Cage - 4'33" - 15th of October 2018 - Build: 43153</div><h3>The Functions Reference</h3>To add the API to your script, just add<pre><code> dofile(reaper.GetResourcePath().."/UserPlugins/ultraschall_api.lua")</code></pre>as first line into your script.<br><br>For more details, read the docs in the <a href="US_Api_Introduction_and_Concepts.html">Introduction and Concepts</a>-area of this page.<br><br><table style="font-size:10pt; width:100%;" ><table style="width:100%;" border="0"><tr><td><br><strong><u>ProjectStateChunk</u></strong><br><br>
 </td></tr><tr><td style="width:25%; font-size:small;"><a href="#APPLY_CFG">APPLY_CFG</a></td><td style="width:25%; font-size:small;"><a href="#AUTOXFADE">AUTOXFADE</a></td><td style="width:25%; font-size:small;"><a href="#CURSOR">CURSOR</a></td><td style="width:25%; font-size:small;"><a href="#DEFPITCHMODE">DEFPITCHMODE</a></td></tr><td style="width:25%; font-size:small;"><a href="#ENVATTACH">ENVATTACH</a></td><td style="width:25%; font-size:small;"><a href="#FEEDBACK">FEEDBACK</a></td><td style="width:25%; font-size:small;"><a href="#GLOBAL_AUTO">GLOBAL_AUTO</a></td><td style="width:25%; font-size:small;"><a href="#GRID">GRID</a></td></tr><td style="width:25%; font-size:small;"><a href="#GROUPOVERRIDE">GROUPOVERRIDE</a></td><td style="width:25%; font-size:small;"><a href="#GROUPS_DISABLED">GROUPS_DISABLED</a></td><td style="width:25%; font-size:small;"><a href="#GROUP_NAME">GROUP_NAME</a></td><td style="width:25%; font-size:small;"><a href="#INTMIXMODE">INTMIXMODE</a></td></tr><td style="width:25%; font-size:small;"><a href="#ITEMMIX">ITEMMIX</a></td><td style="width:25%; font-size:small;"><a href="#LOCK">LOCK</a></td><td style="width:25%; font-size:small;"><a href="#LOOP">LOOP</a></td><td style="width:25%; font-size:small;"><a href="#LOOPGRAN">LOOPGRAN</a></td></tr><td style="width:25%; font-size:small;"><a href="#MARKER/REGION">MARKER/REGION</a></td><td style="width:25%; font-size:small;"><a href="#MASTERAUTOMODE">MASTERAUTOMODE</a></td><td style="width:25%; font-size:small;"><a href="#MASTERHWOUT">MASTERHWOUT</a></td><td style="width:25%; font-size:small;"><a href="#MASTERHWOUT">MASTERHWOUT</a></td></tr><td style="width:25%; font-size:small;"><a href="#MASTERMUTESOLO">MASTERMUTESOLO</a></td><td style="width:25%; font-size:small;"><a href="#MASTERPEAKCOL">MASTERPEAKCOL</a></td><td style="width:25%; font-size:small;"><a href="#MASTERTRACKHEIGHT">MASTERTRACKHEIGHT</a></td><td style="width:25%; font-size:small;"><a href="#MASTERTRACKVIEW">MASTERTRACKVIEW</a></td></tr><td style="width:25%; font-size:small;"><a href="#MASTER_FX">MASTER_FX</a></td><td style="width:25%; font-size:small;"><a href="#MASTER_GROUP_FLAGS">MASTER_GROUP_FLAGS</a></td><td style="width:25%; font-size:small;"><a href="#MASTER_GROUP_FLAGS_HIGH">MASTER_GROUP_FLAGS_HIGH</a></td><td style="width:25%; font-size:small;"><a href="#MASTER_NCH">MASTER_NCH</a></td></tr><td style="width:25%; font-size:small;"><a href="#MASTER_PANMODE">MASTER_PANMODE</a></td><td style="width:25%; font-size:small;"><a href="#MASTER_SEL">MASTER_SEL</a></td><td style="width:25%; font-size:small;"><a href="#MASTER_VOLUME">MASTER_VOLUME</a></td><td style="width:25%; font-size:small;"><a href="#MASTER_WIDTH">MASTER_WIDTH</a></td></tr><td style="width:25%; font-size:small;"><a href="#MAXPROJLEN">MAXPROJLEN</a></td><td style="width:25%; font-size:small;"><a href="#MIXERUIFLAGS">MIXERUIFLAGS</a></td><td style="width:25%; font-size:small;"><a href="#PANLAW">PANLAW</a></td><td style="width:25%; font-size:small;"><a href="#PANMODE">PANMODE</a></td></tr><td style="width:25%; font-size:small;"><a href="#PEAKGAIN">PEAKGAIN</a></td><td style="width:25%; font-size:small;"><a href="#PLAYRATE">PLAYRATE</a></td><td style="width:25%; font-size:small;"><a href="#PROJOFFS">PROJOFFS</a></td><td style="width:25%; font-size:small;"><a href="#QUEUED_RENDER_ORIGINAL_FILENAME">QUEUED_RENDER_ORIGINAL_FILENAME</a></td></tr><td style="width:25%; font-size:small;"><a href="#QUEUED_RENDER_OUTFILE">QUEUED_RENDER_OUTFILE</a></td><td style="width:25%; font-size:small;"><a href="#REAPER_PROJECT">REAPER_PROJECT</a></td><td style="width:25%; font-size:small;"><a href="#RECMODE">RECMODE</a></td><td style="width:25%; font-size:small;"><a href="#RECORD_CFG">RECORD_CFG</a></td></tr><td style="width:25%; font-size:small;"><a href="#RECORD_PATH">RECORD_PATH</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_1X">RENDER_1X</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_ADDTOPROJ">RENDER_ADDTOPROJ</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_CFG">RENDER_CFG</a></td></tr><td style="width:25%; font-size:small;"><a href="#RENDER_DITHER">RENDER_DITHER</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_FILE">RENDER_FILE</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_FMT">RENDER_FMT</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_PATTERN">RENDER_PATTERN</a></td></tr><td style="width:25%; font-size:small;"><a href="#RENDER_QDELAY">RENDER_QDELAY</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_RANGE">RENDER_RANGE</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_RESAMPLE">RENDER_RESAMPLE</a></td><td style="width:25%; font-size:small;"><a href="#RENDER_STEMS">RENDER_STEMS</a></td></tr><td style="width:25%; font-size:small;"><a href="#RIPPLE">RIPPLE</a></td><td style="width:25%; font-size:small;"><a href="#SAMPLERATE">SAMPLERATE</a></td><td style="width:25%; font-size:small;"><a href="#SELECTION">SELECTION</a></td><td style="width:25%; font-size:small;"><a href="#SELECTION2">SELECTION2</a></td></tr><td style="width:25%; font-size:small;"><a href="#SMPTESYNC">SMPTESYNC</a></td><td style="width:25%; font-size:small;"><a href="#TAKELANE">TAKELANE</a></td><td style="width:25%; font-size:small;"><a href="#TEMPO">TEMPO</a></td><td style="width:25%; font-size:small;"><a href="#TEMPOENVLOCKMODE">TEMPOENVLOCKMODE</a></td></tr><td style="width:25%; font-size:small;"><a href="#TIMELOCKMODE x">TIMELOCKMODE x</a></td><td style="width:25%; font-size:small;"><a href="#TIMEMODE">TIMEMODE</a></td><td style="width:25%; font-size:small;"><a href="#USE_REC_CFG">USE_REC_CFG</a></td><td style="width:25%; font-size:small;"><a href="#VIDEO_CONFIG">VIDEO_CONFIG</a></td></tr><td style="width:25%; font-size:small;"><a href="#VZOOMEX">VZOOMEX</a></td><td style="width:25%; font-size:small;"><a href="#ZOOM">ZOOM</a></td><td style="width:25%;">&nbsp;</td><td style="width:25%;">&nbsp;</td></tr></table><table style="width:100%;" border="0"><tr><td><b style="font-size:small;"> Automation Items</b>
 </td></tr><tr><td style="width:25%; font-size:small;"><a href="#POOLEDENV">POOLEDENV</a></td><td style="width:25%;">&nbsp;</td><td style="width:25%;">&nbsp;</td><td style="width:25%;">&nbsp;</td></tr></table><table style="width:100%;" border="0"><tr><td><b style="font-size:small;"> Extensions</b>
 </td></tr><tr><td style="width:25%; font-size:small;"><a href="#EXTENSIONS">EXTENSIONS</a></td><td style="width:25%;">&nbsp;</td><td style="width:25%;">&nbsp;</td><td style="width:25%;">&nbsp;</td></tr></table><table style="width:100%;" border="0"><tr><td><b style="font-size:small;"> Master DualPan Envelope 2</b>
@@ -203,4 +203,4 @@
 <p style="padding-left:0.3%;"><u>Functioncall:</u><b><div style="padding-left:4%;font-size:100%">MIDIBANKPROGFN</b> <i style="color:#0000ff;">string</i> MidiBankProgFn </div><p><table style="width:100%;"><tr><td><u>Description:</u></td></tr><tr><td style="vertical-align:top; padding-left:4%;">The filename of the MidiBankProg. Will be enclosed in doublequotes, when it contains spaces.<br><br>Does not exist, if no MIDIBankProg is not set.<br><br></td></tr></table></divl></table><br><tr><td style=""><u>Parameters:</u></td><td> </td><td> </td></tr><table style="padding-left:4%;"border="0"><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">string</i> MidiBankProgFn</i>&nbsp;</td><td style="vertical-align:top;">the MidiBankProg-Filename&nbsp;</td></tr></table><br><hr><a id="MIDIEXTSTRFN"></a><strong><a href="#MIDIEXTSTRFN">MIDIEXTSTRFN</a></strong>
 <p style="padding-left:0.3%;"><u>Functioncall:</u><b><div style="padding-left:4%;font-size:100%">MIDIEXTSTRFN</b> <i style="color:#0000ff;">string</i> MidiTextStrFn </div><p><table style="width:100%;"><tr><td><u>Description:</u></td></tr><tr><td style="vertical-align:top; padding-left:4%;">The filename of the MIDIExtStr. Will be enclosed in doublequotes, when it contains spaces.<br><br>Does not exist, if no file is set<br><br></td></tr></table></divl></table><br><tr><td style=""><u>Parameters:</u></td><td> </td><td> </td></tr><table style="padding-left:4%;"border="0"><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">string</i> MidiTextStrFn</i>&nbsp;</td><td style="vertical-align:top;">the MidiTextStrFn-Filename&nbsp;</td></tr></table><br><hr><a id="TRACKID"></a><strong><a href="#TRACKID">TRACKID</a></strong>
 <p style="padding-left:0.3%;"><u>Functioncall:</u><b><div style="padding-left:4%;font-size:100%">TRACKID</b> <i style="color:#0000ff;">string</i> TrackID </div><p><table style="width:100%;"><tr><td><u>Description:</u></td></tr><tr><td style="vertical-align:top; padding-left:4%;">The TrackID as GUID-string. Will be enclosed in doublequotes, when it contains spaces.<br><br></td></tr></table></divl></table><br><tr><td style=""><u>Parameters:</u></td><td> </td><td> </td></tr><table style="padding-left:4%;"border="0"><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">string</i> TrackID</i>&nbsp;</td><td style="vertical-align:top;">the TrackID&nbsp;</td></tr></table><br><hr><a id="SCORE"></a><strong><a href="#SCORE">SCORE</a></strong>
-<p style="padding-left:0.3%;"><u>Functioncall:</u><b><div style="padding-left:4%;font-size:100%">SCORE</b> <i style="color:#0000ff;">integer</i> Score1 <i style="color:#0000ff;">integer</i> Score2 <i style="color:#0000ff;">number</i> Score3 <i style="color:#0000ff;">number</i> Score4</div><p><table style="width:100%;"><tr><td><u>Description:</u></td></tr><tr><td style="vertical-align:top; padding-left:4%;">The Score-setting for the track<br><br></td></tr></table></divl></table><br><tr><td style=""><u>Parameters:</u></td><td> </td><td> </td></tr><table style="padding-left:4%;"border="0"><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">integer</i> Score1</i>&nbsp;</td><td style="vertical-align:top;">unknown &nbsp;</td></tr><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">integer</i> Score2</i>&nbsp;</td><td style="vertical-align:top;">unknown&nbsp;</td></tr><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">number</i> Score3</i>&nbsp;</td><td style="vertical-align:top;">unknown&nbsp;</td></tr><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">number</i> Score4</i>&nbsp;</td><td style="vertical-align:top;">unknown&nbsp;</td></tr></table><br><br><hr><table width="100%"><td style="position:absolute; right:0;">Automatically generated by Ultraschall-API 4.00 Beta 2.7 - 1143 functions and -1019 Api-variables available</td></table><br><hr></div></body></html>
+<p style="padding-left:0.3%;"><u>Functioncall:</u><b><div style="padding-left:4%;font-size:100%">SCORE</b> <i style="color:#0000ff;">integer</i> Score1 <i style="color:#0000ff;">integer</i> Score2 <i style="color:#0000ff;">number</i> Score3 <i style="color:#0000ff;">number</i> Score4</div><p><table style="width:100%;"><tr><td><u>Description:</u></td></tr><tr><td style="vertical-align:top; padding-left:4%;">The Score-setting for the track<br><br></td></tr></table></divl></table><br><tr><td style=""><u>Parameters:</u></td><td> </td><td> </td></tr><table style="padding-left:4%;"border="0"><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">integer</i> Score1</i>&nbsp;</td><td style="vertical-align:top;">unknown &nbsp;</td></tr><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">integer</i> Score2</i>&nbsp;</td><td style="vertical-align:top;">unknown&nbsp;</td></tr><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">number</i> Score3</i>&nbsp;</td><td style="vertical-align:top;">unknown&nbsp;</td></tr><tr style="background:#EEEEEE;"><td style="vertical-align:top; white-space:pre;">&nbsp;<i><i style="color:#0000ff;">number</i> Score4</i>&nbsp;</td><td style="vertical-align:top;">unknown&nbsp;</td></tr></table><br><br><hr><table width="100%"><td style="position:absolute; right:0;">Automatically generated by Ultraschall-API 4.00 Beta 2.7 - 1146 functions and -1022 Api-variables available</td></table><br><hr></div></body></html>