[Meo-Ada Mespotine]

New features in 4.00beta2.72

• API: ultraschall.hotfixdate - holds the release-date of the currently installed hotfix, returned by GetApiVersion now
• ArrangeView: GetVerticalScroll - gets the current vertical-scroll-factor of the arrangeview
• ArrangeView: SetVerticalScroll - sets a new vertical-scroll-factor of the arrangeview
• BackgroundScripts: new background-script - ultraschall_track_old_playstate.lua - stores old playstate into extstate ultraschall->last_playstate
• BackgroundScripts: GetLastPlayState - returns the last playstate before the current one
• ChildScripts: Main_OnCommandByFilename - runs a command by its filename instead of the ActionCommandID/command-id;
  returns a unique script-identifier for the started script-instance, that you can use as
  extstate to communicate with that script;
  allows passing of parameters to the started script!
• ChildScripts: MIDI_OnCommandByFilename - runs a command in the MIDI-Editor context by its filename instead of the ActionCommandID/command-id;
  returns a unique script-identifier for the started script-instance, that you can use as
  extstate to communicate with that script
  allows passing of parameters to the started script!
• Child-Scripts: SetScriptParameters - sets parameters for a child-script, as started by Main_OnCommandByFilename and MIDI_OnCommandByFilename
• Child-Scripts: GetScriptParameters - gets parameters for a child-script, as started by Main_OnCommandByFilename and MIDI_OnCommandByFilename
• Child-Scripts: GetScriptReturnvalues - gets returnvalues, that a script-instance with a specific scriptidentifier sent to the current script
• Child-Scripts: SetScriptReturnvalues - sends returnvalues to a script-instance with a specific scriptidentifier
• Child-Scripts: GetScriptReturnvalues_Sender - gets, which child-scripts(and their corresponding ScriptIdentifier) have sent return-values to the current script
• Config: GetSetIntConfigVar - gets/sets a configuration-variable of the type integer-bitfield
• Config: GetIniFileValue - gets an ini-value from an ini-file; unlike SWS's own functions for that(2.9.7 and earlier), this has no problems with Umlauts in the path
• Config: SetIniFileValue - sets an ini-value into an ini-file; unlike SWS's own functions for that(2.9.7 and earlier), this has no problems with Umlauts in the path
• Docs: US_Api_AUD.html - added
• Docs: US_Api_Concepts_AUD.html - added
• Docs: US_Api_Concepts_DOC.html - added
• Docs: US_Api_Concepts_GFX.html - added
• Docs: US_Api_Concepts_GUI.html - added
• Docs: US_Api_Concepts_VID.html - added
• Docs: US_Api_DOC.html - added
• Docs: US_Api_GFX.html - added
• Docs: US_Api_GUI.html - added
• Docs: US_Api_VID.html - added
• Docs: US_Api-AUD.USDocML - added
• Docs: US_Api-DOC.USDocML - added
• Docs: US_Api-GFX.USDocML - added
• Docs: US_Api-GUI.USDocML - added
• Docs: US_Api-VID.USDocML - added
• Docs: NewUltraschallDoc_VID_Converter.lua - added
• Docs: NewUltraschallDoc_GUI_Converter.lua - added
• Docs: NewUltraschallDoc_DOC_Converter.lua - added
• Docs: NewUltraschallDoc_AUD_Converter.lua - added
• Docs: NewUltraschallConceptsDocConverter_AUD.lua - added
• Docs: NewUltraschallConceptsDocConverter_DOC.lua - added
• Docs: NewUltraschallConceptsDocConverter_GFX.lua - added
• Docs: NewUltraschallConceptsDocConverter_GUI.lua - added
• Docs: NewUltraschallConceptsDocConverter_VID.lua - added
• Docs: Child Scripts: Introduction - added chapter
• Docs: Child Scripts: The unique ScriptIdentifier - added chapter
• Docs: Child Scripts: Running Childscripts - added chapter
• Docs: Child Scripts: Passing Parameters and Returnvalues - added chapter
• Docs: DeferScripts: Introduction to Ultraschall's Defer-functions - added chapter
• Docs: DeferScripts: Special Defer-loops in the Ultraschall-API - added chapter
• Docs: DeferScripts: Stopping Defer-loops from in- and outside of scripts - added chapter
• Docs: Concepts: Error Messaging System: Other helpers for Error-Messaging-system - added chapter
• Docs: Concepts: Installation - added instructions on how to install the Ultraschall-API using ReaPack-package-managerhttps://reapack.com/
• Docs: Concepts: Markers and Regions: Custom-Markers and Custom-Regions
• ReaperDocs: added new SWS2.10.0.1-functions
• ReaperDocs: updated new JS-extension-plugin-functions, up to 0.971
• ReaperDocs: added new Video-Processor-Api-functions, as of Reaper 5.971
• ReaPack: ReaPack-functions - added ReaPack-functions to Reaper-Internals docs
• Defer: GetDeferIdentifier - gets the identifier of a Defer1 to Defer20-cycle of the current script
• Defer: Defer1 to Defer20 - run a customized defer-cycle, in which you can decide, how often it should be run. You can also stop such a defer-cycle from in/outside the script using StopDeferCycle.
  For that, Defer1 to Defer20 will return an identifier, which can be used to stop this specific defer-cycle.
  You should only use each DeferXX-cycle once in a script-instance, or the timing will become corrupt!
• Defer: StopDeferCycle - stops a Defer1 to Defer20-defer-instance from a script-instance
• Dialogs: GetUserInputs - gets the user-input. Like Reaper's own GetUserInputs but a different parameter-scheme, that should be easier to handle.
• Dialogs: BrowseForOpenFiles - utilizes JS_Dialog_BrowseForOpenFiles-function, but returns the files and paths in a more comfortable way
• Editing: RippleCut_Regions - ripple-cuts all regions between startposition and endposition and moves all regions after endposition toward projectstart by difference between startposition and endposition
• ErrorMessages: ShowErrorMessagesInReascriptConsole - toggles, if errormessages shall be shown in the ReaConsole immediately, when they happen
• ExampleScript: A_Simple_EventManager_with_Backgroundhelpers_and_D efer01.lua - a simple demo-eventmanager, that employs the background-helper-scripts and the Defer01-function
• FileIO: GetAllRecursiveFilesAndSubdirectories - returns all subdirectories with all their files with full path of a directory
• GFX: GFX_DrawThickRoundRect - draws a round-rectangle with variable thickness
• GFX: GFX_BlitFramebuffer - blits the content of a framebuffer into the drawing-buffer; will resize, if necessary and retains aspect-ratio
• Helpers: SplitStringAtNULLBytes - splits a string at NULL-bytes ( \0 )
• Helpers: Base64_Encoder - encodes a string into a Base64-encoded string
• Helpers: CreateTemporaryFileOfProjectfile - creates a valid temporary-copy of an rpp-projectfile; use nil for the currently opened one(must be saved first)
• Helpers: Base64_Decoder - decodes a Base64-encoded string
• Helpers: StateChunkLayouter - layouts statechunks according the layouting rules of rpp-projectfiles; makes parsing them much easier
• Helpers: print - replacement for Lua's own print-function(which is quite useless in Reaper); displays the printed parameters in the ReaScript-console
• Helpers: print2 - like print, but displays the parameters as a messagebox instead
• Helpers: ConvertIntegerToBits - converts an integer-value into its individual bitvalues
• Helpers: ReverseEndianess_Byte - changes endianess of a byte-value
• Helpers: ConvertIntegerIntoString - converts the individual bytes of an integer into a string
• Helpers: ReplacePartOfString - replaces a part of a string, beginning from an offset and up to a length; can be used for easy string insertion as well
• HWND: IsValidHWND - checks, if a HWND is a valid one
• HWND: GFX_Init - opens a new gfx-window. Like gfx.init, but this returns its HWND-windowhandler-object as well
• HWND: GFX_GetWindowHWND - gets the HWND of a opened gfx-window, opened with ultraschall.GFX_Init
• HWND: GetReaperWindowAttributes - returns several attributes of the Reaper-window, like size/position, active-state, childwindows, etc
• HWND: GetTopmostHWND - returns the topmost hwnd(window-handler) of a child-hwnd; returns also all the parent-hwnds
• HWND: Windows_Find - finds Reaper-windows by title and returns their HWNDs
• HWND: GetAllReaScriptIDEWindows - returns the HWNDs of all opened ReaperIDE-windows
• HWND: GetReaScriptConsoleWindow - returns the HWND of the ReaScript-console, if open at all.
• HWND: HasHWNDChildWindowNames - allows to check, if a certain HWND has child-hwnds of certain name(s). Good to make probability-checks for the right Reaper-windows-check.
• HWND: GetRenderToFileHWND - returns the HWND of the Render to File-dialog
• HWND: GetActionsHWND - returns the HWND of the Actions-dialog
• HWND: GetVideoHWND - returns the HWND of the Video Window
• HWND: GetHWND_ArrangeViewAndTimeLine - returns the HWND-window-handler for the tracklist- and timeline-area of the arrangeview