Skip to content

5 - "Eels - Novocaine for the Soul" - 9th of August 2024

Latest
Compare
Choose a tag to compare
@mespotine mespotine released this 30 Aug 14:18

5 - "Eels - Novocaine for the Soul" - 9th of August 2024

Has now 1807 functions, with 144 new ones

Note: requires at least Reaper 7.03 now!

new in this release:

  • ReaGirl - an accessible gui-library
    One and a half years in the making, I've finally added ReaGirl, an accessible gui-library for Reaper. It allows you
    to easily code your own guis with labels, checkboxes, buttons, drop down menus, sliders, images and tabs.
    Open the docs with the action "ReaGirl_Help_Introduction_Concepts_Tutorials_Documentation.lua" to read, how to work with it.

  • Preview MIDI-functions
    You can preview now midi-notes, cc, pc and pitch in a certain track with dedicated functions for it.

  • Lane functions
    Various functions around the new track-lane-features of Reaper.

  • Project pos 2 Take-pos 2 Project pos
    Functions to get the take-position at a certain project position and the project-position at a take position.
    Used to be in there in an earlier version and reappear now, due to a bugfix in Reaper.

New features in 5

  • Helpers: SplitReaperString - splits a Reaper-string into its components.
  • Item: GetItemYPos - Returns position and height of the MediaItem in a fixed item lane/free item positioning.
  • Items: MediaItem_GetAllVisibleTransients_ActiveTake - returns the number and positions of visible transients of the active take of a MediaItem.
  • Lanes: GetTrackFixedLanesState - returns Fixed Lanes-state.
  • Lanes: GetTrackLaneNameState - returns Lanes name-state.
  • Lanes: GetTrackLaneRecState - returns Lanes rec-state.
  • Lanes: GetTrackLaneSoloState - returns Lanes solo-state.
  • Lanes: ItemLane_Count - returns the number of item-lanes in a track
  • Lanes: ItemLane_GetAllMediaItems - returns the MediaItems from an item-lanes in a track between start_position and end_position
  • Lanes: ItemLane_GetFromPoint - returns the MediaTrack and the item-lane at a screen-coordinate
  • Lanes: ItemLane_GetPositionAndHeight - returns the position and height of an item-lanes in a track
  • Markers: RippleCut_Regions_Reverse - ripple cuts regions before startposition and moves them towards project-end
  • MIDI: PreviewMidiCCInTrack - previews a midi-cc in a specific armed track
  • MIDI: PreviewMidiNoteInTrack - previews a midi-note in a specific armed track
  • MIDI: PreviewMidiPCInTrack - previews a midi-pc in a specific armed track
  • MIDI: PreviewMidiPitchInTrack - previews a midi-pitch in a specific armed track
  • ReaGirl: AtEnter - Adds a function that shall be run when someone hits Enter while the gui is opened.
  • ReaGirl: AutoPosition_SetNextUIElementRelativeTo - Set the auto-positioning starting point to the position of a certain ui-element.
  • ReaGirl: Background_GetSetColor - Gets/Sets the color of the background.
  • ReaGirl: Base64_Decoder - Converts a Base64-encoded string into a normal string.
  • ReaGirl: Base64_Encoder - Converts a string into a Base64-Encoded string.
  • ReaGirl: Button_Add - Adds a button to a gui.
  • ReaGirl: Button_GetDisabled - Gets a button's disabled(non clickable)-state.
  • ReaGirl: Button_GetRadius - Gets a button's radius.
  • ReaGirl: Button_SetDisabled - Sets a button as disabled(non clickable).
  • ReaGirl: Button_SetRadius - Sets the radius of a button.
  • ReaGirl: Checkbox_Add - Adds a checkbox to a gui.
  • ReaGirl: Checkbox_GetCheckState - Gets a checkbox's current checked-state.
  • ReaGirl: Checkbox_GetDisabled - Gets a checkbox's disabled(non clickable)-state.
  • ReaGirl: Checkbox_SetCheckState - Sets a checkbox's state of the checkbox.
  • ReaGirl: Checkbox_SetDisabled - Sets a checkbox as disabled(non clickable).
  • ReaGirl: Checkbox_SetWidth - sets width of a checkbox, which helps you with autopositioning
  • ReaGirl: DropDownMenu_Add - Adds a dropdown-menu to a gui.
  • ReaGirl: DropDownMenu_GetDimensions - Gets the width of a drop down menu.
  • ReaGirl: DropDownMenu_GetDisabled - Gets a dropdown-menu's disabled(non clickable)-state.
  • ReaGirl: DropDownMenu_GetMenuItems - Gets a dropdown-menu's menu-items and the index of the currently selected menu-item.
  • ReaGirl: DropDownMenu_SetDimensions - Sets the width of a dropdownmenu.
  • ReaGirl: DropDownMenu_SetDisabled - Sets a drop down menu as disabled(non clickable)-state.
  • ReaGirl: DropDownMenu_SetMenuItems - Sets a dropdown-menu's menuitems and the index of the currently selected menu-item.
  • ReaGirl: Ext_Tab_SetSelected - sets a tab of specific ReaGirl-gui-window focused
  • ReaGirl: Ext_Window_Focus - sets focus to an opened ReaGirl-gui-window
  • ReaGirl: Ext_Window_GetState - gets the position, current dimensions and dock-state of an opened/previously opened ReaGirl-window
  • ReaGirl: Ext_Window_IsOpen - gets, if a specific ReaGirl-gui-window is currently opened
  • ReaGirl: Ext_Window_ResetToDefault - resets a ReaGirl-Gui-Window to its default dimensions and dockstate
  • ReaGirl: Ext_Window_SetState - gets the current dimensions and dock-state of an opened/previously opened ReaGirl-window
  • ReaGirl: GetVersion - Returns the version-number of the installed ReaGirl.
  • ReaGirl: Gui_AtExit - Adds a function that shall be run when the gui is closed with reagirl.Gui_Close()
  • ReaGirl: Gui_Close - Closes the gui-window.
  • ReaGirl: Gui_ForceRefresh - Forces a refresh of the gui.
  • ReaGirl: Gui_GetBoundaries - Returns the current boundaries of the ui-elements. Means, from 0 to the the farthest ui-element-width/height at right/bottom edge of the gui-window.
  • ReaGirl: Gui_IsOpen - Checks, whether the gui-window is open.
  • ReaGirl: Gui_Manage - Manages the gui-window.
  • ReaGirl: Gui_New - Creates a new gui by removing all currently(if available) ui-elements.
  • ReaGirl: Gui_Open - Opens a gui-window. If x and/or y are not given, it will be opened centered.
  • ReaGirl: Gui_PreventCloseViaEscForOneCycle - Prevents the closing of the gui via esc-key for one defer-cycle.
  • ReaGirl: Gui_PreventEnterForOneCycle - Prevents the user from hitting the enter-key for one cycle, so the run-function for the enter-key is not run in this cycle.
  • ReaGirl: Gui_PreventScrollingForOneCycle - Prevents the scrolling of the gui via keyboard/mousewheel/swiping for this defer-cycle.
  • ReaGirl: Image_Add - Adds an image to the gui. This image can run a function when clicked on it.
  • ReaGirl: Image_ClearToColor - Clears the image with a set r-g-b-color. It also clears the previously loaded image-filename.
  • ReaGirl: Image_GetDimensions - Gets the width and height of an image.
  • ReaGirl: Image_GetDraggable - Gets the current draggable state of an image.
  • ReaGirl: Image_GetImageFilename - Returns the filename of the currently loaded image.
  • ReaGirl: Image_KeepAspectRatio - Set if the image shall keep its aspect ratio when shown.
  • ReaGirl: Image_Load - Loads a new image-file of an existing image in the gui.
  • ReaGirl: Image_ReloadImage_Scaled - Realoads an image.
  • ReaGirl: Image_SetDimensions - Sets the width and height of an image.
  • ReaGirl: Image_SetDraggable - Sets the current draggable state of an image.
  • ReaGirl: Inputbox_Add - Adds an inputbox to a gui.
  • ReaGirl: Inputbox_GetCursorOffset - Gets an inputbox's current cursor offset.
  • ReaGirl: Inputbox_GetDisabled - Gets an inputbox's disabled(non clickable)-state.
  • ReaGirl: Inputbox_GetPassword - gets an inputbox to show * instead of the text(for password entry, etc)
  • ReaGirl: Inputbox_GetSelectedText - Gets an inputbox's currently selected text.
  • ReaGirl: Inputbox_GetText - Gets an inputbox's current text.
  • ReaGirl: Inputbox_SetDisabled - Sets an inputbox as disabled(non clickable).
  • ReaGirl: Inputbox_SetEmptyText - Sets an inputbox's shown text when nothing has been input.
  • ReaGirl: Inputbox_SetPassword - Sets an inputbox to show * instead of the text(for password entry, etc)
  • ReaGirl: Inputbox_SetText - Sets a new text of an inputbox.
  • ReaGirl: IsValidGuid - Checks, if guid is a valid guid. Can also be used for strings, that contain a guid somewhere in them(strict=false)
  • ReaGirl: Label_Add - Adds a label to the gui.
  • ReaGirl: Label_AutoBackdrop - sets a backdrop from label to underneath a specific ui-element
  • ReaGirl: Label_GetAlignement - Gets the alignment of a label.
  • ReaGirl: Label_GetDraggable - Gets the current draggable state of a label.
  • ReaGirl: Label_GetBackdrop - Gets the backdrop of a label.
  • ReaGirl: Label_GetFontSize - Gets the font-size of a label.
  • ReaGirl: Label_GetStyle - Gets the style of a label.
  • ReaGirl: Label_SetAlignment - Sets the font-size of a label.
  • ReaGirl: Label_SetBackdrop - Sets the backdrop of a label.
  • ReaGirl: Label_SetDraggable - Sets the current draggable state of a label.
  • ReaGirl: Label_SetFontSize - Sets the font-size of a label.
  • ReaGirl: Label_SetLabelText - Sets a new label text to an already existing label.
  • ReaGirl: Label_SetStyle - Sets the style of a label.
  • ReaGirl: Mouse_GetCap - Checks clickstate and mouseclick/wheel-behavior, since last time calling this function and returns their states.
  • ReaGirl: NextLine - Starts a new line, when autopositioning ui-elements using the _add-functions.
  • ReaGirl: ReserveImageBuffer - Reserves a framebuffer which will not be used by ReaGirl for drawing.
  • ReaGirl: ResizeImageKeepAspectRatio - Resizes an image, keeping its aspect-ratio. You can set a background-color for non rectangular-images.
  • ReaGirl: ScreenReader_SendMessage - sends a message to screen-reader users
  • ReaGirl: Slider_Add - Adds a slider to a gui.
  • ReaGirl: Slider_GetDefaultValue - Gets the current set value of the slider.
  • ReaGirl: Slider_GetDimensions - Gets the width of a slider.
  • ReaGirl: Slider_GetDisabled - Gets the current disability state of the slider.
  • ReaGirl: Slider_GetEndValue - Gets the current set maximum-value of the slider.
  • ReaGirl: Slider_GetStartValue - Gets the current set minimum-value of the slider.
  • ReaGirl: Slider_GetValue - Gets the current set value of the slider.
  • ReaGirl: Slider_ResetToDefaultValue - Resets the current set value of the slider to the default value.
  • ReaGirl: Slider_SetDefaultValue - Sets the default value of the slider.
  • ReaGirl: Slider_SetDimensions - Sets the width of a slider.
  • ReaGirl: Slider_SetDisabled - Sets a slider disabled.
  • ReaGirl: Slider_SetEndValue - Sets the maximum value of the slider.
  • ReaGirl: Slider_SetStartValue - Sets the minimum value of the slider.
  • ReaGirl: Slider_SetValue - Sets the current value of the slider.
  • ReaGirl: Tabs_Add - Adds a tab to a gui.
  • ReaGirl: Tabs_GetSelected - Gets the selected tab of a tabs-element.
  • ReaGirl: Tabs_SetSelected - Sets the selected tab of a tabs-element.
  • ReaGirl: Tabs_SetUIElementsForTab - Sets the ui-elements for a tab from a table.
  • ReaGirl: UI_Element_GetFocusRect - gets the rectangle for focused ui-element. Can be used for custom ui-element, who need to control the focus-rectangle due some of their own ui-elements incorporated, like options in radio-buttons, etc.
  • ReaGirl: UI_Element_GetFocused - Get the ui-element-guid, that is currently focused.
  • ReaGirl: UI_Element_GetHovered - Get the ui-element-guid, where the mouse is currently.
  • ReaGirl: UI_Element_GetSetCaption - gets/sets the caption of the ui-element
  • ReaGirl: UI_Element_GetSetMeaningOfUIElement - gets/sets the meaningOfUI_Element of the ui-element, which will describe, how to use the ui-element to blind persons.
  • ReaGirl: UI_Element_GetSetPosition - gets/sets the position of the ui-element
  • ReaGirl: UI_Element_GetSetRunFunction - gets/sets the run_function of the ui-element, which will be run, when the ui-element is toggled
  • ReaGirl: UI_Element_GetSetVisibility - gets/sets the hidden-state of the ui-element
  • ReaGirl: UI_Element_GetSet_ContextMenu - gets/sets the context-menu and context-menu-run-function of a ui-element.
  • ReaGirl: UI_Element_GetSet_DropZoneFunction - gets/sets the dropzone-run-function of a ui-element.
  • ReaGirl: UI_Element_GetType - returns the type of the ui-element
  • ReaGirl: UI_Element_IsElementAtMousePosition - returns, if ui-element with element_id is at mouse-position
  • ReaGirl: UI_Element_Last_Element_Current_Position - Returns the x and y position as well as width and height of the last added ui-element.
  • ReaGirl: UI_Element_Remove - Removes a ui-element.
  • ReaGirl: UI_Element_SetFocusRect - sets the rectangle for focused ui-element. Can be used for custom ui-element, who need to control the focus-rectangle due some of their own ui-elements incorporated, like options in radio-buttons, etc.
  • ReaGirl: UI_Element_SetFocused - Set an ui-element focused.
  • ReaGirl: UI_Element_SetHiddenFromTable - Set ui-elements stored in a table to hidden or visible.
  • ReaGirl: UI_Elements_OutsideWindow - returns, if any of the gui-elements are outside of the window and by how much.
  • ReaGirl: Window_ForceSize_Maximum - Sets a maximum window size that will be enforced by ReaGirl.
  • ReaGirl: Window_ForceSize_Minimum - Sets a minimum window size that will be enforced by ReaGirl.
  • ReaGirl: Window_GetCurrentScale - Gets the current scaling-factor
  • ReaGirl: Window_SetCurrentScale - Sets a new scaling-factor that overrides auto-scaling/scaling preferences
  • ReaGirl: Window_SetFocus - Sets window focus back to the ReaGirl-gui-window.
  • Rendering: CreateRenderCFG_RAW - Returns the render-cfg-string for the RAW-PCM-format. You can use this in ProjectStateChunks, RPP-Projectfiles and reaper-render.ini
  • Rendering: CreateRenderCFG_RAW - creates a renderstring for RAW-renderformat
  • Rendering: GetRenderCFG_Settings_RAW - Returns the settings stored in a render-cfg-string for RAW PCM.
  • Rendering: GetRenderCFG_Settings_RAW - gets settings of a RAW-renderformat-renderstring
  • Takes: GetProjectPosByTakeSourcePos - returns the project-position-representation of the source-position of a take.
  • Takes: GetTakeSourcePosByProjectPos - returns the source-position of a take at a certain project-position. Will obey time-stretch-markers, offsets, etc, as well.
  • Takes: TakeMarker_GetAllTakeMarkers - returns all take-markers of a MediaItem_Take, including project-position.

Changes from 4.9 to 5

  • Developer Tools: State Inspector - restores the loaded slot when reopening; ini-file doesn't get overwritten anymore after updating US_API
  • Developer Tools: Create_New_Script_With_Dialog.lua - uses ReaGirl now to do the gui, also accessible now
  • Docs: open-docs-actions - didn't always open the docs -> fixed
  • Editing: RippleCut - does now a standard fadein/out-time of 10ms; didn't move regions, markers and envelopes correctly -> fixed(thnx to lennardodavinci)
  • Editing: RippleCut_Reverse - does now a standard fadein/out-time of 10ms; didn't move regions, markers and envelopes correctly -> fixed
  • Envelopes: DeleteTrackEnvelopePointsBetween - inserts now envelope-points at "cut"-edges
  • Envelopes: MoveTrackEnvelopePointsBy - didn't move first envelope-point in the envelope -> fixed
  • Helpers: EditReaScript - allows now adding ReaGirl-basic structure to a script
  • ProjectManagement: GetProject_RenderStems - added preserve startoffset and metadata-settings
  • ProjectManagement: SetProject_RenderStems - added preserve startoffset and metadata-settings
  • Rendering: AddRenderPreset - added preserve startoffset and metadata-settings
  • Rendering: ApplyRenderTable_Project - added preserve startoffset and metadata-settings
  • Rendering: ApplyRenderTable_ProjectFile - added preserve startoffset and metadata-settings
  • Rendering: CreateNewRenderTable - added preserve startoffset and metadata-settings
  • Rendering: GetRenderPreset - added preserve startoffset and metadata-settings
  • Rendering: GetRenderTable_ProjectDefaults - added preserve startoffset and metadata-settings
  • Rendering: SetRenderPreset - added preserve startoffset and metadata-settings
  • UserInterface: GetHWND_ArrangeViewAndTimeLine - fixed possible edge-case bug that causes crashes of scripts