Ultraschall Internals Documentation Reaper Internals Documentation Downloads Changelog of documentation Impressum and Contact
Ultraschall-logo Functions Engine
   Introduction/Concepts 
     Functions Reference 



Beta 2.7 - "Frank Zappa - The Return of the Son of Monster Magnet" - 15th of December 2018 - Build: 25377

The Functions Reference

To add the API to your script, just add
           dofile(reaper.GetResourcePath().."/UserPlugins/ultraschall_api.lua")
as first line into your script.

For more details, read the docs in the Introduction and Concepts-area of this page.


API-Helper functions

CheckActionCommandIDFormatCheckActionCommandIDFormat2GetApiVersionGetOS
GetReaperAppVersionGetReaperColorThemesPathGetReaperJSFXPathGetReaperScriptPath
GetReaperWebRCPathGetScriptFilenameFromActionCommandIDIsItemInTrackIsItemInTrack2
IsItemInTrack3IsOS_MacIsOS_OtherIsOS_Windows
IsObjectValidReaperObjectIsValidGuidIsValidMatchingPatternMakeFunctionUndoable
OpenURLPreventCreatingUndoPointRGB2GrayscaleRefreshToolbar_Action
ReturnTypeOfReaperObjectReturnsMinusOneInCaseOfError_ArzalaRunBackgroundHelperFeaturesRunCommand
SecondsToTimeSecondsToTimeString_hh_mm_ss_mssSetIntConfigVar_BitfieldTimeStringToSeconds_hh_mm_ss_mss
TimeToSecondsToggleStateActionToggleStateButtontoboolean
type   
Data Manipulation
AddIntToCharCSV2IndividualLinesAsArrayCSV2LineCombineBytesToInteger
CompareArraysCompareStringWithAsciiValuesConcatIntegerIndexedTablesConvertStringToAscii_Array
CountCharacterInStringCountEntriesInTable_MainCountLinesInStringCountPatternInString
CycleTableGetAllEntriesFromTableGetDuplicatesFromArraysGetPartialString
KeepTableEntriesOfTypeLimitFractionOfFloatMakeCopyOfTableNotes2CSV
RemoveTableEntriesOfTypeReturnTableAsIndividualValuesReverseTableRoundNumber
SearchStringInStringSetBitfieldSplitIntegerIntoBytesSplitStringAtLineFeedToArray

API-Variables

Api_InstallPathApi_PathEuroSeparator
StartTime   

Automation Items

GetProject_AutomationItemStateChunkGetProject_CountAutomationItems  

Clipboard Functions

GetMediaItemsFromClipboardGetStringFromClipboard_SWSPutMediaItemsToClipboard_MediaItemArray 

Color Management

ApplyColorTableToItemColorsApplyColorTableToTrackColorsChangeColorBrightnessChangeColorContrast
ChangeColorSaturationConvertColorConvertColorFromMacConvertColorFromWin
ConvertColorReverseConvertColorToGFXConvertColorToMacConvertColorToWin
ConvertGFXToColorCreateColorTableCreateSonicRainboomColorTableIsValidColorTable

Configuration Settings

Menus
GetSetConfigActionMenu   
Preferences: Advanced UI
GetSetConfigAlwaysAllowKBGetSetConfigAudioCloseTrackWnds  
Preferences: Audio
GetSetConfigAllStereoPairsGetSetConfigAudioCloseStop  
Preferences: Device
GetSetConfigAudioThreadPr   
Preferences: Media
GetSetConfigApplyFXTail   
Preferences: Recording
GetSetConfigAdjRecLatGetSetConfigAdjRecManLatGetSetConfigAdjRecManLatIn 
Preferences: Video/REX/Misc
GetSetConfigAcidImport   
Project Settings: Media
GetSetConfigAfxCfg   
Transport: Contextmenu
GetSetConfigAudioPrShift   

Configuration-Files Management

Ini-Files
CountIniFileExternalState_keyCountIniFileExternalState_secCountKeysByPatternCountSectionsByPattern
CountValuesByPatternEnumerateIniFileExternalState_keyEnumerateIniFileExternalState_secEnumerateKeysByPattern
EnumerateSectionsByPatternEnumerateValuesByPatternGetIniFileExternalStateSetIniFileExternalState
Reaper-kb.ini
CountKBIniActionsCountKBIniKeysCountKBIniScriptsDeleteKBIniActions
DeleteKBIniKeysDeleteKBIniScriptsGetKBIniActionsGetKBIniActionsID_ByActionCommandID
GetKBIniFilepathGetKBIniKeysGetKBIniKeys_ByActionCommandIDGetKBIniScripts
GetKBIniScripts_ByActionCommandIDSetKBIniActionsSetKBIniKeysSetKBIniScripts
Ultraschall.ini
CountUSExternalState_keyCountUSExternalState_secEnumerateUSExternalState_keyEnumerateUSExternalState_sec
GetUSExternalStateSetUSExternalState  

Cough-Button

Muting tracks within envelope-lanes
CountMuteEnvelopePointsDeleteMuteStateDeleteMuteState_TrackObjectGetNextMuteState
GetNextMuteState_TrackObjectGetPreviousMuteStateGetPreviousMuteState_TrackObjectIsMuteAtPosition
IsMuteAtPosition_TrackObjectToggleMuteToggleMute_TrackObject 

Developer

Error Handling
AddErrorMessageCountErrorMessage_FuncnameCountErrorMessagesDeleteAllErrorMessages
DeleteErrorMessageDeleteLastErrorMessageGetErrorMessage_FuncnameGetLastErrorMessage
GetLastErrorMessage2GetLastErrorMessage_FuncnameReadErrorMessageShowLastErrorMessage
ToggleIDE_Errormessages   
Helper functions
APIExistsApiTest  

Envelope Management

Get Envelope
GetAllTrackEnvelopesGetClosestEnvelopePointIDX_ByTimeGetEnvelopePointGetEnvelopePointIDX_Between
Helper functions
CheckEnvelopePointObjectCountEnvelopePointsCreateEnvelopePointObjectIsValidEnvStateChunk
IsValidEnvelopePointArrayIsValidEnvelopePointObject  
Set Envelope
AddEnvelopePoints_EnvelopePointArrayAddEnvelopePoints_EnvelopePointObjectDeleteEnvelopePoints_EnvelopePointArrayDeleteEnvelopePoints_EnvelopePointObject
MoveTrackEnvelopePointsBySetEnvelopeHeightSetEnvelopePoints_EnvelopePointArraySetEnvelopePoints_EnvelopePointObject

File Management

File Analysis
CheckForValidFileFormatsCountLinesInFileGetLengthOfFileOnlyFilesOfCertainType
Helper functions
CountDirectoriesAndFilesInPathCreateValidTempFileDirectoryExistsDirectoryExists2
GetAllDirectoriesInPathGetAllFilesnamesInPathGetPathGetReaperWorkDir
SetReaperWorkDir   
Manipulate Files
MakeCopyOfFileMakeCopyOfFile_Binary  
Read Files
ReadBinaryFileFromPatternReadBinaryFileUntilPatternReadBinaryFile_OffsetReadFileAsLines_Array
ReadFullFileReadLinerangeFromFileReadValueFromFile 
Write Files
WriteValueToFileWriteValueToFile_InsertWriteValueToFile_InsertBinaryWriteValueToFile_Replace
WriteValueToFile_ReplaceBinary   

MIDI Management

MIDI Editor
OpenItemInMidiEditorZoomHorizontal_MidiEditorZoomVertical_MidiEditor 

Markers

Assistance functions
CountMarkersAndRegionsGetMarkerByScreenCoordinatesGetMarkerByTimeGetMarkerUpdateCounter
GetRegionByScreenCoordinatesGetRegionByTimeGetTimeSignaturesByTimeGetTimesignaturesByScreenCoordinates
IsMarkerAtPositionIsRegionAtPositionMoveMarkersByMoveRegionsBy
MoveTimeSigMarkersByParseMarkerStringRenumerateMarkers 
Edit Markers and Regions
AddEditMarkerAddEditRegionCountEditMarkersCountEditRegions
DeleteEditMarkerDeleteEditRegionEditToMarkerEnumerateEditMarkers
EnumerateEditRegionExportEditMarkersToFileGetAllEditMarkersImportEditFromFile
IsMarkerEditIsRegionEditRegionMarkerToEditMarkerSetEditMarker
SetEditRegion   
General Markers and Regions
GetAllMarkersGetAllMarkersBetweenGetAllRegionsGetAllRegionsBetween
GetLastMarkerPositionGetLastRegionGetMarkerAndRegionsByIndexGetMarkerByName
GetMarkerByName_PatternImportMarkersFromFileSetMarkerByIndex 
Normal Markers
AddNormalMarkerCountNormalMarkersCountNormalMarkers_NumGapDeleteNormalMarker
EnumerateNormalMarkersExportNormalMarkersToFileGetAllNormalMarkersIsMarkerNormal
SetNormalMarker   
PodRange Region
AddPodRangeRegionDeletePodRangeRegionGetPodRangeRegionIsRegionPodrange
SetPodRangeRegion   
Time Signature Markers
GetAllTimeSigMarkersGetLastTimeSigMarkerPosition  

MediaItem Management

Assistance functions
ApplyActionToMediaItemApplyActionToMediaItemArrayApplyActionToMediaItemArray2ApplyFunctionToMediaItemArray
CheckMediaItemArrayCheckMediaItemStateChunkArrayGetAllMediaItemGUIDsGetGapsBetweenItems
GetMediaItemArrayLengthGetMediaItemStateChunkArrayLengthGetMediaItemStateChunksFromItemsGetMediaItemStateChunksFromMediaItemArray
GetMediafileAttributesGetParentTrack_MediaItemIsItemInTimerangeIsValidMediaItemArray
IsValidMediaItemStateChunkIsValidMediaItemStateChunkArrayOnlyItemsInTracksAndTimerangeOnlyMediaItemsOfTracksInTrackstring
OnlyMediaItemsOfTracksInTrackstring_StateChunkPreviewMediaFilePreviewMediaItemStopAnyPreview
Delete
DeleteMediaItemDeleteMediaItemsFromArrayDeleteMediaItems_PositionDeleteMediaItems_Position
Edit
RippleCutRippleCut_ReverseSectionCutSectionCut_Inverse
SplitItemsAtPositionFromArraySplitMediaItems_Position  
Get MediaItem States
GetItemAllTakesGetItemBeatGetItemChanModeGetItemFadeFlag
GetItemFadeInGetItemFadeOutGetItemGUIDGetItemGroup
GetItemIGUIDGetItemIIDGetItemLengthGetItemLock
GetItemLoopGetItemMixFlagGetItemMuteGetItemName
GetItemPlayRateGetItemPositionGetItemRecPassGetItemSampleOffset
GetItemSelectedGetItemSnapOffsetGetItemStateChunkGetItemUSTrackNumber_StateChunk
GetItemVolPan   
Get MediaItem-Takes
GetItemSourceFile_TakeGetMediaItemTake  
Get MediaItems
GetAllLockedItemsFromMediaItemArrayGetAllMediaItemsGetAllMediaItemsBetweenGetAllMediaItemsFromTrack
GetAllMediaItemsInTimeSelectionGetMediaItemsAtPosition  
Insert
InsertImageFileInsertMediaItemArrayInsertMediaItemFromFileInsertMediaItemStateChunkArray
InsertMediaItem_MediaItemInsertMediaItem_MediaItemStateChunkRippleInsertRippleInsert_MediaItemStateChunks
Manipulate
AddLockStateToMediaItemStateChunkAddLockStateTo_MediaItemStateChunkArrayApplyStateChunkToItemsChangeDeltaLengthOfMediaItems_FromArray
ChangeDeltaOffsetOfMediaItems_FromArrayChangeLengthOfMediaItems_FromArrayChangeOffsetOfMediaItems_FromArrayMoveMediaItemsAfter_By
MoveMediaItemsBefore_ByMoveMediaItemsBetween_ToMoveMediaItems_FromArrayNormalizeItems
SetItemsLockState   
Selected Items
DeselectMediaItems_MediaItemArrayGetAllSelectedMediaItemsGetSelectedMediaItemsAtPositionGetSelectedMediaItemsBetween
SelectMediaItems_MediaItemArraySetMediaItemsSelected_TimeSelection  
Set MediaItem States
SetItemLengthSetItemPositionSetItemUSTrackNumber_StateChunkSetMediaItemStateChunk_in_TrackStateChunk
Spectral Edit
AddItemSpectralEditCountItemSpectralEditsDeleteItemSpectralEditGetItemSpectralConfig
GetItemSpectralEditGetItemSpectralVisibilityStateSetItemSpectralConfigSetItemSpectralEdit
SetItemSpectralVisibilityState   

Metadata Management

Extension States(Guid)
GetGuidExtStateSetGuidExtState  
Extension States
DeleteProjExtState_KeyDeleteProjExtState_SectionGetItemExtStateGetProjExtState_AllKeyValues
GetTrackExtStateSetItemExtStateSetTrackExtState 

Navigation

CenterViewToCursorGetClosestGoToPointsGetClosestNextMarkerGetClosestNextRegionEdge
GetClosestPreviousMarkerGetClosestPreviousRegionEdgeGetLastCursorPositionGetNextClosestItemEdge
GetPreviousClosestItemEdgeJumpBackwardByJumpBackwardBy_RecordingJumpForwardBy
JumpForwardBy_RecordingSetPlayAndEditCursor_WhenPlayingSetPlayCursor_WhenPlayingToggleScrollingDuringPlayback

Project-Files

Helper functions
CheckForChangedProjectTabsConvertOldProjectToCurrentReaperVersionCountProjectTabsEnumProjects
GetCurrentTimeLengthOfFrameGetLengthOfFramesGetOutputFormat_RenderCfgGetProject_Length
GetProject_TabsIsValidProjectStateChunkIsValidReaProjectNewProjectTab
RPP-Files Get
GetProject_AddMediaToProjectAfterRenderGetProject_ApplyFXCFGGetProject_AutoCrossFadeGetProject_CountMarkersAndRegions
GetProject_CountMasterHWOutsGetProject_CursorPosGetProject_DefPitchModeGetProject_EnvAttach
GetProject_ExtensionsGetProject_FeedbackGetProject_GetMarkerGetProject_GetRegion
GetProject_GlobalAutoGetProject_GridGetProject_GroupDisabledGetProject_GroupOverride
GetProject_HorizontalZoomGetProject_ItemMixBehaviorGetProject_LockGetProject_Loop
GetProject_LoopGranGetProject_MarkersAndRegionsGetProject_MasterAutomodeGetProject_MasterDualPanEnv2StateChunk
GetProject_MasterDualPanEnvL2StateChunkGetProject_MasterDualPanEnvLStateChunkGetProject_MasterDualPanEnvStateChunkGetProject_MasterFXByp
GetProject_MasterFXListStateChunkGetProject_MasterHWOutGetProject_MasterHWPanEnvStateChunkGetProject_MasterHWVolEnvStateChunk
GetProject_MasterMuteSoloGetProject_MasterNChansGetProject_MasterPanModeGetProject_MasterPanMode_Ex
GetProject_MasterPlayspeedGetProject_MasterSelGetProject_MasterTrackColorGetProject_MasterTrackHeight
GetProject_MasterTrackViewGetProject_MasterVolEnv2StateChunkGetProject_MasterVolEnv3StateChunkGetProject_MasterVolEnvStateChunk
GetProject_MasterVolumeGetProject_MasterWidthGetProject_MaxProjectLengthGetProject_Metronome
GetProject_MixerUIFlagsGetProject_NumberOfTracksGetProject_PanLawGetProject_PanMode
GetProject_PeakGainGetProject_PlayrateGetProject_ProjOffsetsGetProject_ProjectBay
GetProject_ReaperVersionGetProject_RecModeGetProject_RecPathGetProject_RecordCFG
GetProject_RenderCFGGetProject_RenderDitherStateGetProject_RenderFilenameGetProject_RenderFreqNChans
GetProject_RenderPatternGetProject_RenderRangeGetProject_RenderResampleGetProject_RenderSpeed
GetProject_RenderStemsGetProject_RippleStateGetProject_SMPTESyncGetProject_SampleRate
GetProject_SelectionGetProject_TakeLaneGetProject_TempoGetProject_TempoEnvEx
GetProject_TempoEnv_ExStateChunkGetProject_TempoTimeSignatureGetProject_TimeBaseGetProject_Timemode
GetProject_TrackMixingDepthGetProject_TrackStateChunkGetProject_UseRecConfigGetProject_VerticalZoom
GetProject_VideoConfig   
RPP-Files Set
SetProject_AddMediaToProjectAfterRenderSetProject_ApplyFXCFGSetProject_AutoCrossFadeSetProject_CursorPos
SetProject_DefPitchModeSetProject_EnvAttachSetProject_FeedbackSetProject_Grid
SetProject_GroupOverrideSetProject_HorizontalZoomSetProject_ItemMixBehaviorSetProject_Loop
SetProject_LoopGranSetProject_MaxProjectLengthSetProject_MixerUIFlagsSetProject_PanLaw
SetProject_PanModeSetProject_PeakGainSetProject_ProjOffsetsSetProject_RecMode
SetProject_RecPathSetProject_RecordCFGSetProject_RenderCFGSetProject_RenderDitherState
SetProject_RenderFilenameSetProject_RenderFreqNChansSetProject_RenderPatternSetProject_RenderRange
SetProject_RenderResampleSetProject_RenderSpeedSetProject_RenderStemsSetProject_RippleState
SetProject_SMPTESyncSetProject_SampleRateSetProject_SelectionSetProject_TakeLane
SetProject_TempoTimeSignatureSetProject_TimeBaseSetProject_TimemodeSetProject_TrackMixingDepth
SetProject_UseRecConfigSetProject_VerticalZoomSetProject_VideoConfig 

Reaper Element Positions

Reaper Window
ConvertClient2ScreenXCoordinate_ReaperWindowConvertScreen2ClientXCoordinate_ReaperWindowGetReaperWindowPosition_LeftGetReaperWindowPosition_Right
SetReaperWindowToSize   

Recording

Configuration
GetStartNewFileRecSizeStateSetStartNewFileRecSizeState  

Rendering of Project

Creating Renderstrings
CreateRenderCFG_AIFFCreateRenderCFG_AudioCDCreateRenderCFG_DDPCreateRenderCFG_FLAC
CreateRenderCFG_MP3ABRCreateRenderCFG_MP3CBRCreateRenderCFG_MP3MaxQualityCreateRenderCFG_MP3VBR
CreateRenderCFG_OGGCreateRenderCFG_OpusCreateRenderCFG_Opus2CreateRenderCFG_WAV
CreateRenderCFG_WAVPACKCreateRenderCFG_WebMVideo  
Rendering any Outputformat
RenderProjectRegions_RenderCFGRenderProject_RenderCFG  

Track Management

Assistance functions
AddMediaItemStateChunk_To_TrackStateChunkApplyActionToTrackCountItemsInTrackStateChunkCreateTrackString
CreateTrackStringByGUIDCreateTrackStringByMediaTracksCreateTrackStringByTracknamesCreateTrackString_AllTracks
CreateTrackString_ArmedTracksCreateTrackString_SelectedTracksCreateTrackString_UnarmedTracksGetAllMediaItemsFromTrackStateChunk
GetItemStateChunkFromTrackStateChunkGetTrackLengthInsertTrackAtIndexInsertTrack_TrackStateChunk
InverseTrackstringIsTrackObjectTracknumberIsValidTrackStateChunkIsValidTrackString
MoveTracksOnlyTracksInBothTrackstringsOnlyTracksInOneTrackstringRemoveDuplicateTracksInTrackstring
RemoveMediaItemByGUID_TrackStateChunkRemoveMediaItemByIGUID_TrackStateChunkRemoveMediaItem_TrackStateChunk 
Get Track States
GetAllLockedTracksGetAllSelectedTracksGetProject_MasterGroupFlagsHighStateGetProject_MasterGroupFlagsState
GetTrackAutoRecArmStateGetTrackAutomodeStateGetTrackBeatStateGetTrackBusCompState
GetTrackBypFXStateGetTrackFreeModeStateGetTrackGroupFlagsStateGetTrackGroupFlags_HighState
GetTrackHeightStateGetTrackIDGetTrackINQStateGetTrackIPhaseState
GetTrackIcon_FilenameGetTrackIsBusStateGetTrackLayoutNamesGetTrackLockState
GetTrackMIDIOutStateGetTrackMainSendStateGetTrackMidiBankProgFnGetTrackMidiCTL
GetTrackMidiColorMapFnGetTrackMidiInputChanMapGetTrackMidiTextStrFnGetTrackMuteSoloState
GetTrackNChansStateGetTrackNameGetTrackPanModeGetTrackPeakColorState
GetTrackPerfStateGetTrackRecCFGGetTrackRecStateGetTrackScore
GetTrackShowInMixStateGetTrackStateChunk_TracknumberGetTrackVUStateGetTrackVolPan
GetTrackWidth   
Hardware Out
AddTrackHWOutCountTrackHWOutsDeleteTrackHWOutGetTrackHWOut
SetTrackHWOut   
Send/Receive-Routing
AddTrackAUXSendReceivesCountTrackAUXSendReceivesDeleteTrackAUXSendReceivesGetTrackAUXSendReceives
SetTrackAUXSendReceives   
Set Track States
SetAllTracksSelectedSetTrackAutoRecArmStateSetTrackAutomodeStateSetTrackBeatState
SetTrackBusCompStateSetTrackBypFXStateSetTrackFreeModeStateSetTrackGroupFlagsState
SetTrackGroupFlags_HighStateSetTrackHeightStateSetTrackIDSetTrackINQState
SetTrackIPhaseStateSetTrackIcon_FilenameSetTrackIsBusStateSetTrackLayoutNames
SetTrackLockStateSetTrackMIDIOutStateSetTrackMainSendStateSetTrackMidiBankProgFn
SetTrackMidiCTLSetTrackMidiColorMapFnSetTrackMidiInputChanMapSetTrackMidiTextStrFn
SetTrackMuteSoloStateSetTrackNChansStateSetTrackNameSetTrackPanMode
SetTrackPeakColorStateSetTrackPerfStateSetTrackRecCFGSetTrackRecState
SetTrackScoreSetTrackShowInMixStateSetTrackStateChunk_TracknumberSetTrackVUState
SetTrackVolPanSetTrackWidthSetTracksSelectedSetTracksToLocked
SetTracksToUnlocked   

User Interface

Arrangeview Management
DeleteArrangeviewSnapshotGetVZoomIsValidArrangeviewSnapshotRestoreArrangeviewSnapshot
RetrieveArrangeviewSnapshotSetVZoomStoreArrangeviewSnapshotpause_follow_one_cycle
Context Menus
ShowMenu   
Miscellaneous
GetIDEFontSizeMBSetIDEFontSizeWinterlySnowflakes
Screen and Windowmanagement
CloseReaConsoleGetScreenHeightGetScreenWidth 
Transport
GetPlayCursorWidthSetPlayCursorWidth  


Reaper version 5.40Lua version 5.3 CountCharacterInString

Functioncall:

integer count, array positions = ultraschall.CountCharacterInString(string checkstring, string character)

Description:
Counts, how often character appears in checkstring and returns the count, as well as a array an with the position-numbers.

returns -1 in case of error

Returnvalues:
 integer count the number of occurences of character in checkstring 
 array positions the positionnumbers of the character in checkstring 

Parameters:
 string checkstring the string to check search through 
 string character the character to search for. Only single characters are allowed. Controlcodes like \n \t count as single character. Case sensitive. 


Reaper version 5.77Lua version 5.3 IsValidMatchingPattern

Functioncall:

boolean retval = ultraschall.IsValidMatchingPattern(string patstring)

Description:
Returns, if patstring is a valid pattern-matching-string

Returnvalues:
 boolean retval true, patstring is a valid pattern-matching-string; false, patstring isn't a valid pattern-matching-string 

Parameters:
 string patstring the string to check for, if it's a valid pattern-matching-string 


Reaper version 5.92Lua version 5.3 GetTrackStateChunk_Tracknumber

Functioncall:

boolean retval, string trackstatechunk, boolean overflow = ultraschall.GetTrackStateChunk_Tracknumber(integer tracknumber)

Description:
returns the trackstatechunk for track tracknumber

returns false in case of an error

Returnvalues:
 boolean retval true in case of success; false in case of error 
 string trackstatechunk the trackstatechunk for track tracknumber 

Parameters:
 integer tracknumber the tracknumber, 0 for master track, 1 for track 1, 2 for track 2, etc.     


Reaper version 5.92Lua version 5.3 IsValidMediaItemStateChunk

Functioncall:

boolean retval = ultraschall.IsValidMediaItemStateChunk(string MediaItemStateChunk)

Description:
Checks, whether MediaItemStateChunk is a valide MediaItemStateChunk.

Returns false in case of an error

Returnvalues:
 boolean retval true, MediaItemStateChunk is valid; false, MediaItemStateChunk isn't a valid statechunk 

Parameters:
 string MediaItemStateChunk the string to check, if it's a valid MediaItemStateChunk 


Reaper version 5.40Lua version 5.3 CheckMediaItemArray

Functioncall:

boolean retval, integer count, array retMediaItemArray = ultraschall.CheckMediaItemArray(array MediaItemArray)

Description:
Checks, whether MediaItemArray is valid.
It throws out all entries, that are not MediaItems and returns the altered array as result.

returns false in case of error or if it is not a valid MediaItemArray

Returnvalues:
 boolean retval returns true if MediaItemArray is valid, false if not 
 integer count the number of entries in the returned retMediaItemArray 
 array retMediaItemArray the, possibly, altered MediaItemArray 

Parameters:
 array MediaItemArray a MediaItemArray that shall be checked for validity 


Reaper version 5.40Lua version 5.3 IsValidMediaItemArray

Functioncall:

boolean retval, integer count, array retMediaItemArray = ultraschall.IsValidMediaItemArray(array MediaItemArray)

Description:
Checks, whether MediaItemArray is valid.
It throws out all entries, that are not MediaItems and returns the altered array as result.

returns false in case of error or if it is not a valid MediaItemArray

Returnvalues:
 boolean retval returns true if MediaItemArray is valid, false if not 
 integer count the number of entries in the returned retMediaItemArray 
 array retMediaItemArray the, possibly, altered MediaItemArray 

Parameters:
 array MediaItemArray a MediaItemArray that shall be checked for validity 


Reaper version 5.40Lua version 5.3 CheckMediaItemStateChunkArray

Functioncall:

boolean retval, integer count, array retMediaItemStateChunkArray = ultraschall.CheckMediaItemStateChunkArray(array MediaItemStateChunkArray)

Description:
Checks, whether MediaItemStateChunkArray is valid.
It throws out all entries, that are not MediaItemStateChunks and returns the altered array as result.

returns false in case of error or if it is not a valid MediaItemStateChunkArray

Returnvalues:
 boolean retval returns true if MediaItemStateChunkArray is valid, false if not 
 integer count the number of entries in the returned retMediaItemStateChunkArray 
 array retMediaItemStateChunkArray the, possibly, altered MediaItemStateChunkArray 

Parameters:
 array MediaItemStateChunkArray a MediaItemStateChunkArray that shall be checked for validity 


Reaper version 5.40Lua version 5.3 IsValidMediaItemStateChunkArray

Functioncall:

boolean retval, integer count, array retMediaItemStateChunkArray = ultraschall.IsValidMediaItemStateChunkArray(array MediaItemStateChunkArray)

Description:
Checks, whether MediaItemStateChunkArray is valid.
It throws out all entries, that are not MediaItemStateChunks and returns the altered array as result.

returns false in case of error or if it is not a valid MediaItemStateChunkArray

Returnvalues:
 boolean retval returns true if MediaItemStateChunkArray is valid, false if not 
 integer count the number of entries in the returned retMediaItemStateChunkArray 
 array retMediaItemStateChunkArray the, possibly, altered MediaItemStateChunkArray 

Parameters:
 array MediaItemStateChunkArray a MediaItemStateChunkArray that shall be checked for validity 


Reaper version 5.40Lua version 5.3 CSV2IndividualLinesAsArray

Functioncall:

integer count, array individual_values = ultraschall.CSV2IndividualLinesAsArray(string csv_line, optional string separator)

Description:
convert a csv-string to an array of the individual values. If separator cannot be found, it'll return the original string

returns nil in case or error

Returnvalues:
 integer count the number of entries 
 array individual_values all values, each in an individual array-position 

Parameters:
 string csv_line a string as a csv, with all values included and separated by parameter separator 
 string separator the separator, that separates the individual entries; use nil for commas; separators will be removed from the final strings! 


Reaper version 5.40Lua version 5.3 IsValidTrackString

Functioncall:

boolean valid, integer count, array individual_tracknumbers = ultraschall.IsValidTrackString(string trackstring)

Description:
checks, whether a given trackstring is a valid one. Will also return all valid numbers, from trackstring, that can be used as tracknumbers, as an array.

Returnvalues:
 boolean valid true, is a valid trackstring; false, is not a valid trackstring 
 integer count the number of entries found in trackstring 
 array individual_tracknumbers an array that contains all available tracknumbers 

Parameters:
 string trackstring the trackstring to check, if it's a valid one 


Reaper version 5.40Lua version 5.3 CountProjectTabs

Functioncall:

integer number_of_projecttabs = ultraschall.CountProjectTabs()

Description:
Counts the number of opened project tabs.

Returnvalues:
 integer number_of_projecttabs the number of projecttabs currently opened 



Reaper version 5.40Lua version 5.3 GetProject_Tabs

Functioncall:

integer number_of_projecttabs, array projecttablist = ultraschall.GetProject_Tabs()

Description:
Returns the ReaProject-objects, as well as the filenames of all opened project-tabs.

Returnvalues:
 integer number_of_projecttabs the number of projecttabs currently opened 
 array projecttablist an array, that holds all ReaProjects as well as the projectfilenames
projecttablist[idx][1] = ReaProject
projecttablist[idx][2] = projectfilename with path 



Reaper version 5.40Lua version 5.3 StartTime

Functioncall:

Description:
Contains the correct starting time of the current instance of the Ultraschall-Framework, which probably means your script, that embeds the framework.




Reaper version 5.40Lua version 5.3 Euro

Functioncall:

Description:
Holds the Euro-currency-symbol(€), which is hard to type in Reaper's own IDE.




Reaper version 5.40Lua version 5.3 ApiTest

Functioncall:

ultraschall.ApiTest()

Description:
Displays a message to show, which parts of the Ultraschall-API are turned on and which are turned off.




Reaper version 5.40Lua version 5.3 GetApiVersion

Functioncall:

string version, string date, string beta = ultraschall.GetApiVersion()

Description:
returns the version, release-date and if it's a beta-version

Returnvalues:
 string version the current Api-version 
 string date the release date of this api-version 
 string beta if it's a beta version, this is the beta-version-number 
 number versionnumber a number, that you can use for comparisons like, "if requestedversion>versionnumber then" 



Reaper version 5.40Lua version 5.3 IsValidTrackStateChunk

Functioncall:

boolean valid = ultraschall.IsValidTrackStateChunk(string TrackStateChunk)

Description:
returns, if a TrackStateChunk is a valid statechunk

Returnvalues:
 boolean valid true, if the string is a valid statechunk; false, if not a valid statechunk 

Parameters:
 string TrackStateChunk a string to check, if it's a valid TrackStateChunk 


Reaper version 5.40Lua version 5.3 IsValidEnvStateChunk

Functioncall:

boolean valid = ultraschall.IsValidEnvStateChunk(string EnvelopeStateChunk)

Description:
returns, if a EnvelopeStateChunk is a valid statechunk

Returnvalues:
 boolean valid true, if the string is a valid statechunk; false, if not a valid statechunk 

Parameters:
 string EnvelopeStateChunk a string to check, if it's a valid EnvelopeStateChunk 


Reaper version 5.52SWS version 2.9.7Lua version 5.3 GetStringFromClipboard_SWS

Functioncall:

string clipboard_string = ultraschall.GetStringFromClipboard_SWS()

Description:
Returns the content of the clipboard as a string. Uses the SWS-function reaper.CF_GetClipboard, but does everything for you, that is needed for proper use of this function.

Returnvalues:
 string clipboard_string the content of the clipboard as a string 



Reaper version 5.40Lua version 5.3 AddErrorMessage

Functioncall:

boolean retval, integer errorcount = ultraschall.AddErrorMessage(string functionname, string parametername, string errormessage, integer errorcode)

Description:
Adds a new errormessage to the Ultraschall-Api-Error-messagesystem. Returns the number of the errormessage.
Intended for your own 3rd party-functions for the API, to give the user more feedback about errors than just a cryptic errorcode.

returns false in case of failure

Returnvalues:
 boolean retval true, if it worked; false if it didn't 
 integer errorcount the number of the errormessage within the Ultraschall-Api-Error-messagesystem 

Parameters:
 string functionname the function, where the error happened 
 string parametername the parameter, that caused the problem 
 string errormessage a longer description of what cause the problem and a hint to a possible solution 
 integer errorcode a number, that represents the error-message. Will be -1 by default, if not given. 


Reaper version 5.40Lua version 5.3 ToggleIDE_Errormessages

Functioncall:

boolean retval = ultraschall.ToggleIDE_Errormessages(optional boolean togglevalue)

Description:
Toggles or sets, if the error-messaging system shall output it's errors to Reaper's IDE(true) or not(false).
When set true, it will show the errormessages at the bottom of the IDE, as you are used by Reaper's own functions.

Returnvalues:
 boolean retval true, if errors will be shown at the bottom of the IDE; false, if not 

Parameters:
 optional boolean togglevalue true, if errormessages shall be shown at the bottom of the IDE, false if not. If omitted, it toggles what was set before. 


Reaper version 5.40Lua version 5.3 ReadErrorMessage

Functioncall:

boolean retval, integer errcode, string functionname, string parmname, string errormessage, string lastreadtime, string err_creation_date, string err_creation_timestamp = ultraschall.ReadErrorMessage(integer errornumber)

Description:
Reads an error-message within the Ultraschall-ErrorMessagesystem.
Returns a boolean value, the functionname, the errormessage, the "you've already read this message"-status, the date and a timestamp of the creation of the errormessage.
returns false in case of failure

Returnvalues:
 boolean retval true, if it worked; false if it didn't 
 integer errcode the errorcode of this message, as set by the function that created this errormessage; -1 is default value 
 string functionname the name of the function, where the problem happened 
 string parmname the parameter, that was used wrong by the programmer; "" if no parameter was involved in this error 
 string errormessage the message of the problem with a possible hint to a solution 
 string readstatus "unread" if the message hasn't been read yet or a date_time from when the message has been read already 
 string err_creation_date the date_time of when the error-message was created 
 string err_creation_timestamp the timestamp of when the error-message was created. Usually seconds, since system got started 

Parameters:
 integer errornumber the number of the error, beginning with 1. Use CountErrorMessages to get the current number of error-messages. 


Reaper version 5.40Lua version 5.3 DeleteErrorMessage

Functioncall:

boolean retval = ultraschall.DeleteErrorMessage(integer errornumber)

Description:
Deletes an error-message within the Ultraschall-ErrorMessagesystem.

returns false in case of failure

Returnvalues:
 boolean retval true, if such an error exists; false if it didn't 

Parameters:
 integer errornumber the number of the error to delete, beginning with 1. Use CountErrorMessages to get the current number of error-messages. 


Reaper version 5.40Lua version 5.3 GetLastErrorMessage

Functioncall:

boolean retval, integer errcode, string functionname, string parmname, string errormessage, string lastreadtime, string err_creation_date, string err_creation_timestamp, integer errorcounter = ultraschall.GetLastErrorMessage()

Description:
Reads the last error-message stored in the Ultraschall-ErrorMessagesystem.
Returns a boolean value, the functionname, the errormessage, the date and a timestamp of the creation of the errormessage, the unread-status as well as the error-message-number.
returns false in case of failure

Returnvalues:
 boolean retval true, if it worked; false if it didn't 
 integer errcode the errorcode of this message, as set by the function that created this errormessage; -1 is default value 
 string functionname the name of the function, where the problem happened 
 string parmname the parameter, that was used wrong by the programmer; "" if no parameter was involved in this error 
 string errormessage the message of the problem with a possible hint to a solution 
 string readstatus "unread" if the message hasn't been read yet or a date_time from when the message has been read already 
 string err_creation_date the date_time of when the error-message was created 
 string err_creation_timestamp the timestamp of when the error-message was created. Usually seconds, since system got started 
 integer errorcounter the error-message-number within the Ultraschall-Error-Message-System 

Parameters:
 integer errornumber the number of the error, beginning with 1. Use CountErrorMessages to get the current number of error-messages. 


Reaper version 5.40Lua version 5.3 DeleteLastErrorMessage

Functioncall:

boolean retval = ultraschall.DeleteLastErrorMessage()

Description:
Deletes the last error-message and returns a boolean value.
returns false in case of failure

Returnvalues:
 boolean retval true, if it worked; false if it didn't 



Reaper version 5.40Lua version 5.3 DeleteAllErrorMessages

Functioncall:

boolean retval = ultraschall.DeleteAllErrorMessages()

Description:
Deletes all error-messages and returns a boolean value.
returns false in case of failure

Returnvalues:
 boolean retval true, if it worked; false if it didn't 



Reaper version 5.40Lua version 5.3 GetLastErrorMessage2

Functioncall:

boolean retval, array ErrorMessages = ultraschall.GetLastErrorMessage2(integer count, boolean setread)

Description:
Returns an array with the last "count" errormessages. 1 for the last, 2 for the last 2, etc.
Set setread to false, if you want to retain the unread status of the error-messages.
returns false in case of failure

Returnvalues:
 boolean retval true, if it worked; false if it didn't 
 array ErrorMessages an array, that contains all values for the chosen number of errormessages.
The fields are ErrorMessages[errornumber][x], where x stands for
"errcode" - the errorcode of this function, default is -1
"funcname" - functionname
"parmname" - name of the parameter, that caused the error
"errmsg" - errormessage
"readstate" - readstatus
"date" - errorcreation date_time
"time" - errorcreation timestamp in seconds, usually seconds since computer has been started 

Parameters:
 integer count the number of the last few errors, you want to get returned. Use CountErrorMessages to get the current number of error-messages. 


Reaper version 5.40Lua version 5.3 CountErrorMessages

Functioncall:

integer errorcounter = ultraschall.CountErrorMessages()

Description:
Returns the current count of errormessages in the system available.

Returnvalues:
 integer errorcounter the number of errormessages currently available in the error-message-system. Includes read and unread ones. 



Reaper version 5.40Lua version 5.3 ShowLastErrorMessage

Functioncall:

ultraschall.ShowLastErrorMessage()

Description:
Displays the last error message in a messagebox, if existing and unread.




Reaper version 5.52Lua version 5.3 ConvertColor

Functioncall:

integer colorvalue, boolean retval = ultraschall.ConvertColor(integer r, integer g, integer b)

Description:
converts r, g, b-values to native-system-color. Works like reaper's ColorToNative, but doesn't need |0x1000000 added.

returns color-value 0, and retval=false in case of an error

Returnvalues:
 integer colorvalue the native-system-color; 0 to 33554431 

Parameters:
 integer r the red colorvalue 
 integer g the green colorvalue 
 integer b the blue colorvalue 


Reaper version 5.52Lua version 5.3 ConvertColorReverse

Functioncall:

integer r, integer g, integer b, boolean retval = ultraschall.ConvertColorReverse(integer colorvalue)

Description:
converts a native-system-color to r, g, b-values.

returns 0,0,0,false in case of an error

Returnvalues:
 integer r the red colorvalue 
 integer g the green colorvalue 
 integer b the blue colorvalue 
 boolean retval true, color-conversion was successful; false, color-conversion was unsuccessful 

Parameters:
 integer colorvalue the native-system-color; 0 to 33554431 


Reaper version 5.40Lua version 5.3 RoundNumber

Functioncall:

integer retval = ultraschall.RoundNumber(number num)

Description:
returns a rounded value of the parameter number. %.5 and higher rounds up, lower than %.5 round down.

Returnvalues:
 integer retval the rounded number 

Parameters:
 number num the floatingpoint number, you'd like to have rounded. 


Reaper version 5.40Lua version 5.3 GetPath

Functioncall:

string path, string filename = ultraschall.GetPath(string str, string sep)

Description:
returns the path of a filename-string

returns "", "" in case of error

Returnvalues:
 string path the path as a string 
 string filename the filename, without the path 

Parameters:
 string str the path with filename you want to process 
 string sep a separator, with which the function knows, how to separate filename from path 


Reaper version 5.40Lua version 5.3 GetPartialString

Functioncall:

string partial_string = ultraschall.GetPartialString(string str, string sep1, string sep2)

Description:
returns the part of a filename-string between sep1 and sep2

returns nil if it doesn't work, no sep1 or sep2 exist

Returnvalues:
 string partial_string the partial string between sep1 and sep2 

Parameters:
 string str string to be processed 
 string sep1 separator on the "left" side of the partial string 
 string sep2 separator on the "right" side of the partial string 


Reaper version 5.40Lua version 5.3 RunCommand

Functioncall:

integer retval = ultraschall.RunCommand(string actioncommand_id)

Description:
runs a command by its ActionCommandID(instead of the CommandID-number)

returns -1 in case of error

Returnvalues:
 integer retval -1, in case of error 

Parameters:
 string actioncommand_id the ActionCommandID of the Command/Script/Action you want to run; must be either a number or the ActionCommandID beginning with an underscore _ 


Reaper version 5.40Lua version 5.3 Notes2CSV

Functioncall:

string csv_retval = ultraschall.Notes2CSV()

Description:
Gets the project's notes and returns it as a CSV.

Returnvalues:
 string csv_retval the project notes, returned as a csv-string; entries separated by a comma 



Reaper version 5.40Lua version 5.3 CSV2Line

Functioncall:

string values = ultraschall.CSV2Line(string csv_line)

Description:
converts a string of csv-values into a string with all values and without the ,-separators

returns nil in case of error

Returnvalues:
 string values all values in one string 



Reaper version 5.40Lua version 5.3 RGB2Grayscale

Functioncall:

integer graycolor = ultraschall.RGB2Grayscale(integer red, integer green, integer blue)

Description:
converts rgb to a grayscale value. Works native on Mac as well on Windows, no color conversion needed.

Returnvalues:
 integer graycolor the gray color-value, generated from red,blue and green. 

Parameters:
 integer red red-value between 0 and 255. 
 integer green red-value between 0 and 255. 
 integer blue red-value between 0 and 255. 


Reaper version 5.40Lua version 5.3 IsItemInTrack

Functioncall:

boolean retval = ultraschall.IsItemInTrack(integer tracknumber, integer itemIDX)

Description:
checks, whether a given item is part of the track tracknumber

returns true, if the itemIDX is part of track tracknumber, false if not, -1 if no such itemIDX or Tracknumber available

Returnvalues:
 boolean retval true, if item is in track, false if item isn't in track 

Parameters:
 integer itemIDX the number of the item to check of 
 integer tracknumber the number of the track to check in, with 1 for track 1, 2 for track 2, etc. 


Reaper version 5.40Lua version 5.3 WriteValueToFile

Functioncall:

integer retval = ultraschall.WriteValueToFile(string filename_with_path, string value, optional boolean binarymode, optional boolean append)

Description:
Writes value to filename_with_path. Will replace any previous content of the file if append is set to false. Returns -1 in case of failure, 1 in case of success.

Keep in mind, that on Windows, you need to escape \ by writing \\ in the filename, or it will not work

Returnvalues:
 integer retval -1 in case of failure, 1 in case of success 

Parameters:
 string filename_with_path the filename with it's path 
 string value the value to export, can be a long string that includes newlines and stuff. nil is not allowed! 
 boolean binarymode true or nil, it will store the value as binary-file; false, will store it as textstring 
 boolean append true, add the value to the end of the file; false or nil, write value to file and erase all previous data in the file 


Reaper version 5.40Lua version 5.3 CreateTrackString

Functioncall:

string trackstring = ultraschall.CreateTrackString(integer firstnumber, integer lastnumber, optional integer step)

Description:
returns a string with the all numbers from firstnumber to lastnumber, separated by a ,
e.g. firstnumber=4, lastnumber=8 -> 4,5,6,7,8

Returnvalues:
 string trackstring a string with all tracknumbers, separated by a , 

Parameters:
 integer firstnumber the number, with which the string starts 
 integer lastnumber the number, with which the string ends 
 integer step how many numbers shall be skipped inbetween. Can lead to a different lastnumber, when step is not 1! nil or invalid value=1 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 SetUSExternalState

Functioncall:

boolean retval = ultraschall.SetUSExternalState(string section, string key, string value)

Description:
stores values into ultraschall.ini. Returns true if successful, false if unsuccessful.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful. 

Parameters:
 string section section within the ini-file 
 string key key within the section 
 string value the value itself 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetUSExternalState

Functioncall:

string value = ultraschall.GetUSExternalState(string section, string key)

Description:
gets a value from ultraschall.ini.

returns an empty string in case of an error

Returnvalues:
 string value the value itself; empty string in case of an error or no such extstate 

Parameters:
 string section the section of the ultraschall.ini. 
 string key the key of which you want it's value. 


Reaper version 5.40Lua version 5.3 CountUSExternalState_sec

Functioncall:

integer section_count = ultraschall.CountUSExternalState_sec()

Description:
returns the number of [sections] in the ultraschall.ini

Returnvalues:
 integer section_count the number of section in the ultraschall.ini 



Reaper version 5.40Lua version 5.3 CountUSExternalState_key

Functioncall:

integer key_count = ultraschall.CountUSExternalState_key(string section)

Description:
returns the number of keys in the given [section] in ultraschall.ini

Returnvalues:
 integer key_count the number of keys within an ultraschall.ini-section 

Parameters:
 string section the section of the ultraschall.ini, of which you want the number of keys. 


Reaper version 5.40Lua version 5.3 EnumerateUSExternalState_sec

Functioncall:

string section_name = ultraschall.EnumerateUSExternalState_sec(integer number)

Description:
returns name of the numberth section in ultraschall.ini or nil if invalid

Returnvalues:
 string section_name the name of the numberth section within ultraschall.ini 

Parameters:
 integer number the number of section, whose name you want to know 


Reaper version 5.40Lua version 5.3 EnumerateUSExternalState_key

Functioncall:

string key_name = ultraschall.EnumerateUSExternalState_key(string section, integer number)

Description:
returns name of a numberth key within a section in ultraschall%.ini or nil if invalid or not existing

Returnvalues:
 string key_name the name ob the numberth key in ultraschall.ini. 

Parameters:
 string section the section within ultraschall.ini, where the key is stored. 
 integer number the number of the key, whose name you want to know; 1 for the first one 


Reaper version 5.40Lua version 5.3 GetTrackName

Functioncall:

string trackname = ultraschall.GetTrackName(integer tracknumber, optional string TrackStateChunk)

Description:
returns name of the track.

It's the entry NAME

Returnvalues:
 string trackname the name of the track 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackPeakColorState

Functioncall:

integer PeakColorState = ultraschall.GetTrackPeakColorState(integer tracknumber, optional string TrackStateChunk)

Description:
returns state of the PeakColor-number, which is the trackcolor. Will be returned as string, to avoid losing trailing or preceding zeros.

It's the entry PEAKCOL

Returnvalues:
 string PeakColorState the color of the track 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackBeatState

Functioncall:

number BeatState = ultraschall.GetTrackBeatState(integer tracknumber,optional string TrackStateChunk)

Description:
returns Track-BeatState.

It's the entry BEAT

Returnvalues:
 number BeatState -1 - Project time base; 0 - Time; 1 - Beats position, length, rate; 2 - Beats position only 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackAutoRecArmState

Functioncall:

integer AutoRecArmState = ultraschall.GetTrackAutoRecArmState(integer tracknumber, optional string TrackStateChunk)

Description:
returns if the track is in AutoRecArm, when selected. Returns nil if not.

It's the entry AUTO_RECARM

Returnvalues:
 integer AutoRecArmState state of autorecarm; 1 for set; nil if unset 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMuteSoloState

Functioncall:

integer Mute, integer Solo, integer SoloDefeat = ultraschall.GetTrackMuteSoloState(integer tracknumber, optional string TrackStateChunk)

Description:
returns states of Mute and Solo-Buttons.

It's the entry MUTESOLO

Returnvalues:
 integer Mute Mute set to 0 - Mute off, 1 - Mute On 
 integer Solo Solo set to 0 - Solo off, 1 - Solo ignore routing, 2 - Solo on 
 integer SoloDefeat SoloDefeat set to 0 - off, 1 - on 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackIPhaseState

Functioncall:

number IPhase = ultraschall.GetTrackIPhaseState(integer tracknumber, optional string TrackStateChunk)

Description:
returns state of the IPhase. If the Phase-button is pressed, it will return 1, else it will return 0.

It's the entry IPHASE

Returnvalues:
 number IPhase state of the phase-button; 0, normal phase; 1, inverted phase(180°) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackIsBusState

Functioncall:

integer busstate1, integer busstate2 = ultraschall.GetTrackIsBusState(integer tracknumber, optional string trackstatechunk)

Description:
returns busstate of the track, means: if it's a folder track

It's the entry ISBUS

Returnvalues:
 integer busstate1=0, integer busstate2=0 track is no folder
or 
 integer busstate1=1, integer busstate2=1 track is a folder
or 
 integer busstate1=1, integer busstate2=2 track is a folder but view of all subtracks not compactible
or 
 integer busstate1=2, integer busstate2= 1 - track is last track in folder(no tracks of subfolders follow) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackBusCompState

Functioncall:

number BusCompState1, number BusCompState2 = ultraschall.GetTrackBusCompState(integer tracknumber, optional string TrackStateChunk)

Description:
returns BusCompState, if the tracks in a folder are compacted or not.

It's the entry BUSCOMP

Returnvalues:
 number BusCompState1 0 - no compacting, 1 - compacted tracks, 2 - minimized tracks 
 number BusCompState2 0 - unknown,1 - unknown 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackShowInMixState

Functioncall:

integer MCPvisible, number MCP_FX_visible, number MCPTrackSendsVisible, integer TCPvisible, number ShowInMix5, number ShowInMix6, number ShowInMix7, number ShowInMix8 = ultraschall.GetTrackShowInMixState(integer tracknumber, optional string TrackStateChunk)

Description:
returns Show in Mix-state.

It's the entry SHOWINMIX

Returnvalues:
 integer MCPvisible 0 invisible, 1 visible 
 number MCP_FX_visible 0 visible, 1 FX-Parameters visible, 2 invisible 
 number MCPTrackSendsVisible 0 & 1.1 and higher TrackSends in MCP visible, every other number makes them invisible 
 integer TCPvisible 0 track is invisible in TCP, 1 track is visible in TCP 
 number ShowInMix5 unknown 
 number ShowInMix6 unknown 
 number ShowInMix7 unknown 
 number ShowInMix8 unknown 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackFreeModeState

Functioncall:

integer FreeModeState = ultraschall.GetTrackFreeModeState(integer tracknumber, optional string TrackStateChunk)

Description:
returns if the track has track free item positioning enabled(1) or not(0).

It's the entry FREEMODE

Returnvalues:
 integer FreeModeState 1 - enabled, 0 - not enabled 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackRecState

Functioncall:

integer ArmState, integer InputChannel, integer MonitorInput, integer RecInput, integer MonitorWhileRec, integer presPDCdelay, integer RecordingPath = ultraschall.GetTrackRecState(integer tracknumber, optional string TrackStateChunk)

Description:
returns Track Rec State.

It's the entry REC

Returnvalues:
 integer ArmState returns 1(armed) or 0(unarmed) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackVUState

Functioncall:

integer VUState = ultraschall.GetTrackVUState(integer tracknumber, optional string TrackStateChunk)

Description:
returns VUState.

It's the entry VU

Returnvalues:
 integer VUState nil if MultiChannelMetering is off, 2 if MultichannelMetering is on, 3 Metering is off 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.941Lua version 5.3 GetTrackHeightState

Functioncall:

integer height, integer heightstate2, integer unknown = ultraschall.GetTrackHeightState(integer tracknumber, optional string TrackStateChunk)

Description:
returns height of the track.

It's the entry TRACKHEIGHT

Returnvalues:
 integer height 24 up to 443 
 integer heightstate2 0 - use height, 1 - compact the track and ignore the height 
 integer unknown unknown     

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackINQState

Functioncall:

integer quantMIDI, integer quantPOS, integer quantNoteOffs, number quantToFractBeat, integer quantStrength, integer swingStrength, integer quantRangeMin, integer quantRangeMax = ultraschall.GetTrackINQState(integer tracknumber, optional string TrackStateChunk)

Description:
Gets INQ-state, mostly the quantize-settings for MIDI, as set in the "Track: View track recording settings (MIDI quantize, file format/path) for last touched track"-dialog (action 40604)

It's the entry INQ

Returnvalues:
 integer quantMIDI quantize MIDI; 0 or 1 
 integer quantPOS quantize to position; -1,prev; 0, nearest; 1, next 
 integer quantNoteOffs quantize note-offs; 0 or 1 
 number quantToFractBeat quantize to (fraction of beat) 
 integer quantStrength quantize strength; -128 to 127 
 integer swingStrength swing strength; -128 to 127 
 integer quantRangeMin quantize range minimum; -128 to 127 
 integer quantRangeMax quantize range maximum; -128 to 127 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackNChansState

Functioncall:

integer channelnumber = ultraschall.GetTrackNChansState(integer tracknumber, optional string TrackStateChunk)

Description:
returns the number of channels for this track, as set in the routing.

It's the entry NCHAN

Returnvalues:
 integer channelnumber number of channels for this track 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackBypFXState

Functioncall:

integer FXState = ultraschall.GetTrackBypFXState(integer tracknumber, optional string TrackStateChunk)

Description:
returns the off/bypass(0) or nobypass(1) state of the FX-Chain

It's the entry FX

Returnvalues:
 integer FXState off/bypass(0) or nobypass(1) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackPerfState

Functioncall:

integer TrackPerfState = ultraschall.GetTrackPerfState(integer tracknumber, optional string TrackStateChunk)

Description:
returns TrackPerformance-state

It's the entry PERF

Returnvalues:
 integer TrackPerfState TrackPerformance-state
0 - allow anticipative FX + allow media buffering
1 - allow anticipative FX + prevent media buffering
2 - prevent anticipative FX + allow media buffering
3 - prevent anticipative FX + prevent media buffering
settings seem to repeat with higher numbers (e.g. 4(like 0) - allow anticipative FX + allow media buffering) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMIDIOutState

Functioncall:

integer MidiOutState = ultraschall.GetTrackMIDIOutState(integer tracknumber, optional string TrackStateChunk)

Description:
returns MIDI_Out-State, as set in the Routing-Settings

It's the entry MIDIOUT

Returnvalues:
 integer MidiOutState MIDI_Out-State, as set in the Routing-Settings
-1 no output
416 - microsoft GS wavetable synth - send to original channels
417-432 - microsoft GS wavetable synth - send to channel state minus 416
-31 - no Output, send to original channel 1
-16 - no Output, send to original channel 16 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMainSendState

Functioncall:

integer MainSendOn, integer ParentChannels = ultraschall.GetTrackMainSendState(integer tracknumber, optional string TrackStateChunk)

Description:
returns, if Main-Send is on(1) or off(0) and the ParentChannels(0-63), as set in the Routing-Settings.

It's the entry MAINSEND

Returnvalues:
 integer MainSendOn Main-Send is on(1) or off(0) 
 integer ParentChannels ParentChannels(0-63) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackGroupFlagsState

Functioncall:

integer GroupState_as_Flags, array IndividualGroupState_Flags = ultraschall.GetTrackGroupFlagsState(integer tracknumber, optional string TrackStateChunk)

Description:
returns the state of the group-flags, as set in the menu Track Grouping Parameters. Returns a 23bit flagvalue as well as an array with 32 individual 23bit-flagvalues. You must use bitoperations to get the individual values.

You can reach the Group-Flag-Settings in the context-menu of a track.

The groups_bitfield_table contains up to 23 entries. Every entry represents one of the checkboxes in the Track grouping parameters-dialog

Each entry is a bitfield, that represents the groups, in which this flag is set to checked or unchecked.

So if you want to get Volume Master(table entry 1) to check if it's set in Group 1(2^0=1) and 3(2^2=4):
  group1=groups_bitfield_table[1]&1
  group2=groups_bitfield_table[1]&4

The following flags(and their accompanying array-entry-index) are available:
                       1 - Volume Master
                       2 - Volume Slave
                       3 - Pan Master
                       4 - Pan Slave
                       5 - Mute Master
                       6 - Mute Slave
                       7 - Solo Master
                       8 - Solo Slave
                       9 - Record Arm Master
                       10 - Record Arm Slave
                       11 - Polarity/Phase Master
                       12 - Polarity/Phase Slave
                       13 - Automation Mode Master
                       14 - Automation Mode Slave
                       15 - Reverse Volume
                       16 - Reverse Pan
                       17 - Do not master when slaving
                       18 - Reverse Width
                       19 - Width Master
                       20 - Width Slave
                       21 - VCA Master
                       22 - VCA Slave
                       23 - VCA pre-FX slave

The GroupState_as_Flags-bitfield is a hint, if a certain flag is set in any of the groups. So, if you want to know, if VCA Master is set in any group, check if flag &1048576 (2^20) is set to 1048576.

This function will work only for Groups 1 to 32. To get Groups 33 to 64, use GetTrackGroupFlags_HighState instead!

It's the entry GROUP_FLAGS

returns -1 in case of failure

Returnvalues:
 integer GroupState_as_Flags returns a flagvalue with 23 bits, that tells you, which grouping-flag is set in at least one of the 32 groups available.
returns -1 in case of failure

the following flags are available:
2^0 - Volume Master
2^1 - Volume Slave
2^2 - Pan Master
2^3 - Pan Slave
2^4 - Mute Master
2^5 - Mute Slave
2^6 - Solo Master
2^7 - Solo Slave
2^8 - Record Arm Master
2^9 - Record Arm Slave
2^10 - Polarity/Phase Master
2^11 - Polarity/Phase Slave
2^12 - Automation Mode Master
2^13 - Automation Mode Slave
2^14 - Reverse Volume
2^15 - Reverse Pan
2^16 - Do not master when slaving
2^17 - Reverse Width
2^18 - Width Master
2^19 - Width Slave
2^20 - VCA Master
2^21 - VCA Slave
2^22 - VCA pre-FX slave 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.941Lua version 5.3 GetTrackGroupFlags_HighState

Functioncall:

integer GroupState_as_Flags, array IndividualGroupState_Flags = ultraschall.GetTrackGroupFlags_HighState(integer tracknumber, optional string TrackStateChunk)

Description:
returns the state of the group-flags, as set in the menu Track Grouping Parameters. Returns a 23bit flagvalue as well as an array with 32 individual 23bit-flagvalues. You must use bitoperations to get the individual values.

You can reach the Group-Flag-Settings in the context-menu of a track.

The groups_bitfield_table contains up to 23 entries. Every entry represents one of the checkboxes in the Track grouping parameters-dialog

Each entry is a bitfield, that represents the groups, in which this flag is set to checked or unchecked.

So if you want to get Volume Master(table entry 1) to check if it's set in Group 33(2^0=1) and 35(2^2=4):
  group1=groups_bitfield_table[1]&1
  group2=groups_bitfield_table[1]&4

The following flags(and their accompanying array-entry-index) are available:
                       1 - Volume Master
                       2 - Volume Slave
                       3 - Pan Master
                       4 - Pan Slave
                       5 - Mute Master
                       6 - Mute Slave
                       7 - Solo Master
                       8 - Solo Slave
                       9 - Record Arm Master
                       10 - Record Arm Slave
                       11 - Polarity/Phase Master
                       12 - Polarity/Phase Slave
                       13 - Automation Mode Master
                       14 - Automation Mode Slave
                       15 - Reverse Volume
                       16 - Reverse Pan
                       17 - Do not master when slaving
                       18 - Reverse Width
                       19 - Width Master
                       20 - Width Slave
                       21 - VCA Master
                       22 - VCA Slave
                       23 - VCA pre-FX slave

The GroupState_as_Flags-bitfield is a hint, if a certain flag is set in any of the groups. So, if you want to know, if VCA Master is set in any group, check if flag &1048576 (2^20) is set to 1048576.

This function will work only for Groups 33(2^0) to 64(2^31). To get Groups 1 to 32, use GetTrackGroupFlagsState instead!

It's the entry GROUP_FLAGS_HIGH

returns -1 in case of failure

Returnvalues:
 integer GroupState_as_Flags returns a flagvalue with 23 bits, that tells you, which grouping-flag is set in at least one of the 32 groups available.
returns -1 in case of failure

the following flags are available:
2^0 - Volume Master
2^1 - Volume Slave
2^2 - Pan Master
2^3 - Pan Slave
2^4 - Mute Master
2^5 - Mute Slave
2^6 - Solo Master
2^7 - Solo Slave
2^8 - Record Arm Master
2^9 - Record Arm Slave
2^10 - Polarity/Phase Master
2^11 - Polarity/Phase Slave
2^12 - Automation Mode Master
2^13 - Automation Mode Slave
2^14 - Reverse Volume
2^15 - Reverse Pan
2^16 - Do not master when slaving
2^17 - Reverse Width
2^18 - Width Master
2^19 - Width Slave
2^20 - VCA Master
2^21 - VCA Slave
2^22 - VCA pre-FX slave 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackLockState

Functioncall:

integer lockedstate = ultraschall.GetTrackLockState(integer tracknumber, optional string TrackStateChunk)

Description:
returns, if the track-controls of this track are locked(1) or not(nil).

It's the entry LOCK
Only the LOCK within TrackStateChunks, but not MediaItemStateChunks

Returnvalues:
 integer lockedstate locked(1) or not(nil) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackLayoutNames

Functioncall:

string TCP_Layoutname, string MCP_Layoutname = ultraschall.GetTrackLayoutNames(integer tracknumber, optional string TrackStateChunk)

Description:
returns the current selected layouts for TrackControlPanel and MixerControlPanel for this track as strings. Returns nil, if default is set.

It's the entry LAYOUTS

Returnvalues:
 string TCP_Layoutname name of the TCP-Layoutname 
 string MCP_Layoutname name of the MCP-Layoutname 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackAutomodeState

Functioncall:

integer automodestate = ultraschall.GetTrackAutomodeState(integer tracknumber, optional string TrackStateChunk)

Description:
returns, if the automation-mode for envelopes of this track

It's the entry AUTOMODE

Returnvalues:
 integer automodestate is set to 0 - trim/read, 1 - read, 2 - touch, 3 - write, 4 - latch. 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackIcon_Filename

Functioncall:

string filename_with_path = ultraschall.GetTrackIcon_Filename(integer tracknumber, optional string TrackStateChunk)

Description:
returns the filename with path for the track-icon of the current track. Returns nil, if no trackicon has been set.

It's the entry TRACKIMGFN

Returnvalues:
 string filename_with_path filename with path for the current track-icon. 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackRecCFG

Functioncall:

string reccfg = ultraschall.GetTrackRecCFG(integer tracknumber, optional string TrackStateChunk)

Description:
returns the Rec-configuration-string, with which recordings are made. Returns nil, if no reccfg exists.

It's the entry
Returnvalues:
 string reccfg the string, that encodes the recording configuration of the track. 
 integer reccfgnr the number of the recording-configuration of the track;
0, use default project rec-setting
1, use track-customized rec-setting, as set in the "Track: View track recording settings (MIDI quantize, file format/path) for last touched track"-dialog (action 40604) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMidiInputChanMap

Functioncall:

integer MidiInputChanMap_state = ultraschall.GetTrackMidiInputChanMap(integer tracknumber, optional string TrackStateChunk)

Description:
returns the state of the MIDIInputChanMap for the current track, as set in the Input-MIDI->Map Input to Channel menu. 0 for channel 1, 2 for channel 2, etc. Nil, if not existing.

It's the entry MIDI_INPUT_CHANMAP

Returnvalues:
 integer MidiInputChanMap_state 0 for channel 1, 1 for channel 2, ... 15 for channel 16; nil, source channel. 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMidiCTL

Functioncall:

integer LinkedToMidiChannel, integer unknown = ultraschall.GetTrackMidiCTL(integer tracknumber, optional string TrackStateChunk)

Description:
returns linked to Midi channel and an unknown value. Nil if not existing.

It's the entry MIDICTL

Returnvalues:
 integer LinkedToMidiChannel linked to midichannel 
 integer unknown unknown 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackWidth

Functioncall:

number width = ultraschall.GetTrackWidth(integer tracknumber, optional string TrackStateChunk)

Description:
returns width of the track. 1 if set to +100%.

Note for TrackStateChunk-enthusiasts: When set to +100%, it is not stored in the TrackStateChunk

It's the entry WIDTH

Returnvalues:
 number width width of the track, from -1(-100%) to 1(+100%) 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackPanMode

Functioncall:

integer PanMode = ultraschall.GetTrackPanMode(integer tracknumber, optional string TrackStateChunk)

Description:
returns Panmode of the track.

It's the entry PANMODE

Returnvalues:
 integer PanMode the Panmode of the track
nil - Project Default
0 - Reaper 3.x balance (deprecated)
3 - Stereo Balance/ Mono Pan(Default)
5 - Stereo Balance
6 - Dual Pan 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMidiColorMapFn

Functioncall:

string MidiColorMapFn = ultraschall.GetTrackMidiColorMapFn(integer tracknumber, optional string TrackStateChunk)

Description:
returns MidiColorMap-Filename of the track. Nil if not existing.

It's the entry MIDICOLORMAPFN

Returnvalues:
 string MidiColorMapFn the MidiColorMap-Filename; nil if not existing 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMidiBankProgFn

Functioncall:

string MidiBankProgFn = ultraschall.GetTrackMidiBankProgFn(integer tracknumber, optional string TrackStateChunk)

Description:
returns MidiBankProg-Filename of the track. Nil if not existing.

It's the entry MIDIBANKPROGFN

Returnvalues:
 string MidiBankProgFn the MidiBankProg-Filename; nil if not existing 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackMidiTextStrFn

Functioncall:

string MidiTextStrFn = ultraschall.GetTrackMidiTextStrFn(integer tracknumber, optional string TrackStateChunk)

Description:
returns MidiTextStrFn-Filename of the track. Nil if not existing.

It's the entry MIDIEXTSTRFN

Returnvalues:
 string MidiTextStrFn the MidiTextStrFn-Filename; nil if not existing 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackID

Functioncall:

string TrackID = ultraschall.GetTrackID(integer tracknumber, optional string TrackStateChunk)

Description:
returns TrackID of the track.

It's the entry TRACKID

Returnvalues:
 string TrackID the TrackID as GUID 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackScore

Functioncall:

integer Score1, integer Score2, number Score3, number Score4 = ultraschall.GetTrackScore(integer tracknumber, optional string TrackStateChunk)

Description:
returns Score of the track.

It's the entry SCORE

Returnvalues:
 integer Score1 unknown  
 integer Score2 unknown 
 number Score3 unknown 
 number Score4 unknown 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 GetTrackVolPan

Functioncall:

number Vol, number Pan, number OverridePanLaw, number unknown, number unknown2 = ultraschall.GetTrackVolPan(integer tracknumber, optional string TrackStateChunk)

Description:
returns Vol and Pan-states of the track.

It's the entry VOLPAN

Returnvalues:
 number Vol Volume Settings
-Inf dB(0) to +12dB (3.98107170553497) 
 number Pan Pan Settings
-1(-100%); 0(center); 1(100% R) 
 number OverridePanLaw Override Default Pan Track Law
0dB(1) to -144dB(0.00000006309573) 
 number unknown unknown 
 number unknown2 unknown 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master track; -1, if you want to use the parameter TrackStateChunk instead. 
 optional string TrackStateChunk a TrackStateChunk that you want to use, instead of a given track 


Reaper version 5.40Lua version 5.3 SetTrackName

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackName(integer tracknumber, string name, optional string TrackStateChunk)

Description:
Set the name of a track or a trackstatechunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string name new name of the track 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackPeakColorState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackPeakColorState(integer tracknumber, integer colorvalue, optional string TrackStateChunk)

Description:
Set the color of the track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer colorvalue the color for the track 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackBeatState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackBeatState(integer tracknumber, integer beatstate, optional string TrackStateChunk)

Description:
Set the timebase for a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer beatstate tracktimebase for this track; -1 - Project time base, 0 - Time, 1 - Beats position, length, rate, 2 - Beats position only 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackAutoRecArmState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackAutoRecArmState(integer tracknumber, integer autorecarmstate, optional string TrackStateChunk)

Description:
Set the AutoRecArmState for a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer autorecarmstate autorecarmstate - 1 - autorecarm on, <> than 1 - off 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMuteSoloState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMuteSoloState(integer tracknumber, integer Mute, integer Solo, integer SoloDefeat, optional string TrackStateChunk)

Description:
Set the Track Mute/Solo/Solodefeat for a track or a TrackStateChunk.
Has no real effect on master track.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer Mute Mute set to 0 - Mute off, 1 - Mute On 
 integer Solo Solo set to 0 - Solo off, 1 - Solo ignore routing, 2 - Solo on 
 integer SoloDefeat SoloDefeat set to 0 - off, 1 - on 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackIPhaseState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackIPhaseState(integer tracknumber, integer iphasestate, optional string TrackStateChunk)

Description:
Sets IPhase, the Phase-Buttonstate of the track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer iphasestate 0-off, <> than 0-on 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackIsBusState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackIsBusState(integer tracknumber, integer busstate1, integer busstate2, optional string TrackStateChunk)

Description:
Sets ISBUS-state of the track or a TrackStateChunk; if it's a folder track.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; -1 if you want to use parameter TrackStateChunk 
 integer busstate1=0, integer busstate2=0 track is no folder 
 integer busstate1=1, integer busstate2=1 track is a folder 
 integer busstate1=1, integer busstate2=2 track is a folder but view of all subtracks not compactible 
 integer busstate1=2, integer busstate2= 1 - track is last track in folder(no tracks of subfolders follow) 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackBusCompState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackBusCompState(integer tracknumber, integer buscompstate1, integer buscompstate2, optional string TrackStateChunk)

Description:
Sets BUSCOMP-state of the track or a TrackStateChunk; This is the state, if tracks in a folder are compacted or not.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; -1 if you want to use parameter TrackStateChunk 
 integer buscompstate1 - 0 - no compacting, 1 - compacted tracks, 2 - minimized tracks 
 integer buscompstate2 - 0 - unknown, 1 - unknown 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackShowInMixState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackShowInMixState(integer tracknumber, integer MCPvisible, number MCP_FX_visible, number MCP_TrackSendsVisible, integer TCPvisible, number ShowInMix5, integer ShowInMix6, integer ShowInMix7, integer ShowInMix8, optional string TrackStateChunk)

Description:
Sets SHOWINMIX, that sets visibility of track or TrackStateChunk in MCP and TCP.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer MCPvisible 0 invisible, 1 visible 
 number MCP_FX_visible 0 visible, 1 FX-Parameters visible, 2 invisible 
 number MCPTrackSendsVisible 0 & 1.1 and higher TrackSends in MCP visible, every other number makes them invisible 
 integer TCPvisible 0 track is invisible in TCP, 1 track is visible in TCP
with Master-Track, 1 shows all active envelopes, 0 hides all active envelopes 
 number ShowInMix5 unknown 
 integer ShowInMix6 unknown 
 integer ShowInMix7 unknown 
 integer ShowInMix8 unknown 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackFreeModeState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackFreeModeState(integer tracknumber, integer freemodestate, optional string TrackStateChunk)

Description:
Sets FREEMODE-state of a track or a TrackStateChunk; enables Track-Free Item Positioning.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; -1 if you want to use parameter TrackStateChunk 
 integer freemodestate 0 - off, 1 - on 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackRecState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackRecState(integer tracknumber, integer ArmState, integer InputChannel, integer MonitorInput, integer RecInput, integer MonitorWhileRec, integer presPDCdelay, integer RecordingPath, optional string TrackStateChunk)

Description:
Sets REC, that sets the Recording-state of the track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer ArmState set to 1(armed) or 0(unarmed) 


Reaper version 5.40Lua version 5.3 SetTrackVUState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackVUState(integer tracknumber, integer VUState, optional string TrackStateChunk)

Description:
Sets VU-state of a track or a TrackStateChunk; the way metering shows.

Has no real effect on master track.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer VUState 0 MultiChannelMetering is off, 2 MultichannelMetering is on, 3 Metering is off;seems to have no effect on MasterTrack 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackHeightState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackHeightState(integer tracknumber, integer height, integer heightstate2, optional string TrackStateChunk)

Description:
Sets TRACKHEIGHT-state; the height and compacted state of the track or a TrackStateChunk.

Has no visible effect on the master-track.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer height 24 up to 443 pixels 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackINQState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackINQState(integer tracknumber, integer quantMIDI, integer quantPOS, integer quantNoteOffs, number quantToFractBeat, integer quantStrength, integer swingStrength, integer quantRangeMin, integer quantRangeMax, optional string TrackStateChunk)

Description:
Sets INQ-state, mostly the quantize-settings for MIDI, of a track or a TrackStateChunk, as set in the "Track: View track recording settings (MIDI quantize, file format/path) for last touched track"-dialog (action 40604)

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer quantMIDI quantize MIDI; 0 or 1 
 integer quantPOS quantize to position; -1,prev; 0, nearest; 1, next 
 integer quantNoteOffs quantize note-offs; 0 or 1 
 number quantToFractBeat quantize to (fraction of beat) 
 integer quantStrength quantize strength; -128 to 127 
 integer swingStrength swing strength; -128 to 127 
 integer quantRangeMin quantize range minimum; -128 to 127 
 integer quantRangeMax quantize range maximum; -128 to 127 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackNChansState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackNChansState(integer tracknumber, integer NChans, optional string TrackStateChunk)

Description:
Sets NCHAN-state; the number of channels in this track or a TrackStateChunk, as set in the routing.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer NChans 2 to 64, counted every second channel (2,4,6,8,etc) with stereo-tracks. Unknown, if Multichannel and Mono-tracks count differently. 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackBypFXState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackBypFXState(integer tracknumber, integer FXBypassState, optional string TrackStateChunk)

Description:
Sets FX, FX-Bypass-state of the track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer FXBypassState 0 bypass, 1 activate fx; has only effect, if FX or instruments are added to this track 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackPerfState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackPerfState(integer tracknumber, integer Perf, optional string TrackStateChunk)

Description:
Sets PERF, the TrackPerformance-State of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; -1 if you want to use parameter TrackStateChunk 
 integer Perf performance-state
0 - allow anticipative FX + allow media buffering
1 - allow anticipative FX + prevent media buffering
2 - prevent anticipative FX + allow media buffering
3 - prevent anticipative FX + prevent media buffering 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMIDIOutState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMIDIOutState(integer tracknumber, integer MIDIOutState, optional string TrackStateChunk)

Description:
Sets MIDIOUT, the state of MIDI out for this track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer MIDIOutState %-1 no output
416 %- microsoft GS wavetable synth-send to original channels
417-432 %- microsoft GS wavetable synth-send to channel state minus 416
-31 %- no Output, send to original channel 1
-16 %- no Output, send to original channel 16 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40 SetTrackMainSendState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMainSendState(integer tracknumber, integer MainSendOn, integer ParentChannels, optional string TrackStateChunk)

Description:
Sets MAINSEND, as set in the routing-settings, of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer MainSendOn on(1) or off(0) 
 integer ParentChannels the ParentChannels(0-64), interpreted as beginning with ParentChannels to ParentChannels+NCHAN 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackLockState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackLockState(integer tracknumber, integer LockedState, optional string TrackStateChunk)

Description:
Sets LOCK-State, as set by the menu entry Lock Track Controls, of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; -1 if you want to use parameter TrackStateChunk 
 integer LockedState 1 - locked, 0 - unlocked 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackLayoutNames

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackLayoutNames(integer tracknumber, string TCP_Layoutname, string MCP_Layoutname, optional string TrackStateChunk)

Description:
Sets LAYOUTS, the MCP and TCP-layout by name of the layout as defined in the theme, of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string TCP_Layoutname name of the TrackControlPanel-Layout from the theme to use 
 string MCP_Layoutname name of the MixerControlPanel-Layout from the theme to use 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackAutomodeState

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackAutomodeState(integer tracknumber, integer automodestate, optional string TrackStateChunk)

Description:
Sets AUTOMODE-State, as set by the menu entry Set Track Automation Mode, for a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer automodestate 0 - trim/read, 1 - read, 2 - touch, 3 - write, 4 - latch 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackIcon_Filename

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackIcon_Filename(integer tracknumber, string Iconfilename_with_path, optional string TrackStateChunk)

Description:
Sets TRACKIMGFN, the trackicon-filename with path, of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; -1 if you want to use parameter TrackStateChunk 
 string Iconfilename_with_path filename+path of the imagefile to use as the trackicon 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMidiInputChanMap

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMidiInputChanMap(integer tracknumber, integer InputChanMap, optional string TrackStateChunk)

Description:
Sets MIDI_INPUT_CHANMAP, as set in the Input-MIDI->Map Input to Channel menu, of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer InputChanMap 0 for channel 1, 2 for channel 2, etc. -1 if not existing. 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMidiCTL

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMidiCTL(integer tracknumber, integer LinkedToMidiChannel, integer unknown, optional string TrackStateChunk)

Description:
sets MIDICTL-state, the linkage to Midi-Channels of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer LinkedToMidiChannel unknown 
 integer unknown unknown 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackID

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackID(integer tracknumber, string guid, optional string TrackStateChunk)

Description:
sets the track-id, which must be a valid GUID, of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string guid a valid GUID. Can be generated with the native Reaper-function reaper.genGuid() 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMidiColorMapFn

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMidiColorMapFn(integer tracknumber, string MIDI_ColorMapFN, optional string TrackStateChunk)

Description:
sets the filename+path to the MIDI-ColorMap-graphicsfile of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string MIDI_ColorMapFN filename+path to the MIDI-ColorMap-file 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMidiBankProgFn

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMidiBankProgFn(integer tracknumber, string MIDIBankProgFn, optional string TrackStateChunk)

Description:
sets the filename+path to the MIDI-Bank-Prog-file of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string MIDIBankProgFn filename+path to the MIDI-Bank-Prog-file 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackMidiTextStrFn

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackMidiTextStrFn(integer tracknumber, string MIDITextStrFn, optional string TrackStateChunk)

Description:
sets the filename+path to the MIDI-Text-Str-file of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string MIDITextStrFn filename+path to the MIDI-Text-Str-file 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackPanMode

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackPanMode(integer tracknumber, integer panmode, optional string TrackStateChunk)

Description:
sets the panmode for a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer panmode the Panmode of the track
nil - Project Default
0 - Reaper 3.x balance (deprecated)
3 - Stereo Balance/ Mono Pan(Default)
5 - Stereo Balance
6 - Dual Pan 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackWidth

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackWidth(integer tracknumber, number width, optional string TrackStateChunk)

Description:
sets the width of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 number width width of the track, from -1(-100%) to 1(+100%) 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackScore

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackScore(integer tracknumber, integer unknown1, integer unknown2, number unknown3, number unknown4, optional string TrackStateChunk)

Description:
sets the SCORE of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 integer unknown1 unknown 
 integer unknown2 unknown 
 number unknown3 unknown 
 number unknown4 unknown 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackVolPan

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackVolPan(integer tracknumber, number Vol, number Pan, number OverridePanLaw, number unknown, number unknown2, optional string TrackStateChunk)

Description:
sets the VOLPAN-state of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1, if you want to use parameter TrackStateChunk 
 number Vol Volume Settings; -Inf dB(0) to +12dB (3.98107170553497) 
 number Pan Pan Settings; -1(-100%); 0(center); 1(100% R) 
 number OverridePanLaw Override Default Pan Track Law; 0dB(1) to -144dB(0.00000006309573) 
 number unknown unknown 
 number unknown2 unknown 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 SetTrackRecCFG

Functioncall:

boolean retval, string TrackStateChunk = ultraschall.SetTrackRecCFG(integer tracknumber, string reccfg_string, integer reccfg_nr, optional string TrackStateChunk)

Description:
sets the RECCFG of a track or a TrackStateChunk.

Returnvalues:
 boolean retval true, if successful, false if unsuccessful 
 string TrackStateChunk the altered TrackStateChunk 

Parameters:
 integer tracknumber number of the track, beginning with 1; 0 for master-track; -1 if you want to use parameter TrackStateChunk 
 string reccfg_string the string, that encodes the recording configuration of the track 
 integer reccfgnr the number of the recording-configuration of the track;
0, use default project rec-setting
1, use track-customized rec-setting, as set in the "Track: View track recording settings (MIDI quantize, file format/path) for last touched track"-dialog (action 40604) 
 optional string TrackStateChunk use a trackstatechunk instead of a track; only used when tracknumber is -1 


Reaper version 5.40Lua version 5.3 ToggleScrollingDuringPlayback

Functioncall:

ultraschall.ToggleScrollingDuringPlayback(integer scrolling_switch, boolean move_editcursor, boolean goto_playcursor)

Description:
Toggles scrolling during playback and recording. Let's you choose to put the edit-marker at the playposition, where you toggled scrolling.
You can also move the view to the playcursor-position.

It changes, if necessary, the state of the actions 41817, 40036 and 40262 to scroll or not to scroll; keep that in mind, if you use these actions otherwise as well!

returns -1 in case of error

Returnvalues:
 integer retval -1, in case of an error 

Parameters:
 integer scrolling_switch 1-on, 0-off 
 boolean move_editcursor when scrolling stops, shall the editcursor be moved to current position of the playcursor(true) or not(false) 
 boolean goto_playcursor true, move view to playcursor; false, don't move 


Reaper version 5.40Lua version 5.3 SetPlayCursor_WhenPlaying

Functioncall:

ultraschall.SetPlayCursor_WhenPlaying(number position)

Description:
Changes position of the play-cursor, when playing. Changes view to new playposition. Has no effect during recording, when paused or stop and returns -1 in these cases!


Parameters:
 number position in seconds 


Reaper version 5.40Lua version 5.3 SetPlayAndEditCursor_WhenPlaying

Functioncall:

ultraschall.SetPlayAndEditCursor_WhenPlaying(number position)

Description:
Changes position of the play and edit-cursor, when playing. Changes view to new playposition. Has no effect during recording, when paused or stop and returns -1 in these cases!


Parameters:
 number position in seconds 


Reaper version 5.40Lua version 5.3 JumpForwardBy

Functioncall:

ultraschall.JumpForwardBy(number seconds, boolean seekplay)

Description:
Jumps editcursor forward by seconds seconds. Returns -1 if parameter is negative. During Recording: only the playcursor will be moved, the current recording-position is still at it's "old" position! If you want to move the current recording position as well, use ultraschall.JumpForwardBy_Recording instead.


Parameters:
 number seconds jump forward by seconds 
 boolean seekplay true, move playcursor as well; false, don't move playcursor 


Reaper version 5.40Lua version 5.3 JumpBackwardBy

Functioncall:

ultraschall.JumpBackwardBy(number seconds, boolean seekplay)

Description:
Jumps editcursor backward by seconds seconds. Returns -1 if parameter is negative. During Recording: only the playcursor will be moved, the current recording-position is still at it's "old" position! If you want to move the current recording position as well, use ultraschall.JumpBackwardBy_Recording instead.


Parameters:
 number seconds jump backwards by seconds 
 boolean seekplay true, move playcursor as well; false, leave playcursor at it's old position 


Reaper version 5.40Lua version 5.3 JumpForwardBy_Recording

Functioncall:

ultraschall.JumpForwardBy_Recording(number seconds)

Description:
Stops recording, jumps forward by seconds seconds and restarts recording. Will keep paused-recording, if recording was paused. Has no effect during play,play/pause and stop.


Parameters:
 number seconds restart recording forwards by seconds 


Reaper version 5.40Lua version 5.3 JumpBackwardBy_Recording

Functioncall:

ultraschall.JumpBackwardBy_Recording(number seconds)

Description:
Stops recording, jumps backward by seconds seconds and restarts recording. Will keep paused-recording, if recording was paused. Has no effect during play,play/pause and stop.


Parameters:
 number seconds restart recording backwards by seconds 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetNextClosestItemEdge

Functioncall:

number position, integer item_number, string edgetype, MediaItem found_item = ultraschall.GetNextClosestItemEdge(string trackstring, integer cursor_type, optional number time_position)

Description:
returns the position of the next closest item in seconds. It will return the position of the beginning or the end of that item, depending on what is closer.

Returnvalues:
 number position the position of the next closest item-edge in tracks in trackstring 
 integer item_number the itemnumber in the project 
 string edgetype "beg" for beginning of the item, "end" for the end of the item 
 MediaItem found_item the next closest found MediaItem  

Parameters:
 string trackstring a string with the numbers of tracks to check for closest items, separated by a comma (e.g. "0,1,6") 
 integer cursor_type next closest item related to the current position of 0 - Edit Cursor, 1 - Play Cursor, 2 - Mouse Cursor, 3 - Timeposition 
 optional number time_position only, when cursor_type=3, a time position in seconds, from where to check for the next closest item. When omitted, it will take the current play(during play and rec) or edit-cursor-position. 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetPreviousClosestItemEdge

Functioncall:

number position, number position, integer item_number, string edgetype, MediaItem found_item = ultraschall.GetPreviousClosestItemEdge(string tracks, integer cursor_type, optional number time_position)

Description:
returns the position of the previous closest item-edge in seconds. It will return the position of the beginning or the end of that item, depending on what is closer.

Returnvalues:
 number position the position of the previous closest item edge in tracks in trackstring 
 integer item_number the itemnumber in the project 
 string edgetype "beg" for beginning of the item, "end" for the end of the item 
 MediaItem found_item the next closest found MediaItem  

Parameters:
 string tracks a string with the numbers of tracks to check for closest items, separated by a comma (e.g. "0,1,6") 
 integer cursor_type previous closest item related to the current position of 0 - Edit Cursor, 1 - Play Cursor, 2 - Mouse Cursor, 3 - Timeposition 
 optional time_position only, when cursor_type=3, a time position in seconds, from where to check for the previous closest item. When omitted, it will take the current play(during play and rec) or edit-cursor-position. 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetClosestNextMarker

Functioncall:

number markerindex, number position, string markertitle = ultraschall.GetClosestNextMarker(integer cursor_type, optional number time_position)

Description:
returns the markerindex(counted from all markers), the position and the name of the next closest marker in seconds.

Returnvalues:
 number markerindex the next closest markerindex (of all(!) markers) 
 number position the position of the next closest marker 
 string markertitle the name of the next closest marker 

Parameters:
 integer cursor_type previous closest marker related to the current position of 0 - Edit Cursor, 1 - Play Cursor, 2 - Mouse Cursor, 3 - Timeposition 
 optional number time_position only, when cursor_type=3, a time position in seconds, from where to check for the next closest marker. When omitted, it will take the current play(during play and rec) or edit-cursor-position. 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetClosestPreviousMarker

Functioncall:

number markerindex, number position, string markertitle = ultraschall.GetClosestPreviousMarker(integer cursor_type, optional number time_position)

Description:
returns the markerindex(counted from all markers), the position and the name of the previous closest marker in seconds.

Returnvalues:
 number markerindex the previous closest markerindex (of all(!) markers) 
 number position the position of the previous closest marker 
 string markertitle the name of the previous closest marker 

Parameters:
 integer cursor_type previous closest marker related to the current position of 0 - Edit Cursor, 1 - Play Cursor, 2 - Mouse Cursor, 3 - Timeposition 
 optional number time_position only, when cursor_type=3, a time position in seconds, from where to check for the previous closest marker. When omitted, it will take the current play(during play and rec) or edit-cursor-position. 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetClosestNextRegionEdge

Functioncall:

number markerindex, number position, string markertitle, string edge_type = ultraschall.GetClosestNextRegionEdge(integer cursor_type, optional number time_position)

Description:
returns the regionindex(counted from all markers and regions), the position and the name of the next closest regionstart/end(depending on which is closer to time_position) in seconds.

Returnvalues:
 number markerindex the next closest markerindex (of all(!) markers) 
 number position the position of the next closest region 
 string markertitle the name of the next closest region 
 string edge_type the type of the edge of the region, either "beg" or "end" 

Parameters:
 integer cursor_type previous closest regionstart/end related to the current position of 0 - Edit Cursor, 1 - Play Cursor, 2 - Mouse Cursor, 3 - Timeposition 
 only number time_position only, when cursor_type=3, a time position in seconds, from where to check for the next closest regionstart/end. When omitted, it will take the current play(during play and rec) or edit-cursor-position. 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetClosestPreviousRegionEdge

Functioncall:

number markerindex, number position, string markertitle, string edge_type = ultraschall.GetClosestPreviousRegionEdge(integer cursor_type, optional number time_position)

Description:
returns the regionindex(counted from all markers and regions), the position and the name of the previous closest regionstart/end(depending on which is closer to time_position) in seconds.

Returnvalues:
 number markerindex the previous closest markerindex (of all(!) markers) 
 number position the position of the previous closest marker 
 string markertitle the name of the previous closest marker 
 string edge_type the type of the edge of the region, either "beg" or "end" 

Parameters:
 integer cursor_type previous closest regionstart/end related to the current position of 0 - Edit Cursor, 1 - Play Cursor, 2 - Mouse Cursor, 3 - Timeposition 
 optional number time_position only, when cursor_type=3, a time position in seconds, from where to check for the previous closest regionstart/end. When omitted, it will take the current play(during play and rec) or edit-cursor-position. 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetClosestGoToPoints

Functioncall:

number elementposition_prev, string elementtype_prev, integer number_prev, number elementposition_next, string elementtype_next, integer number_next = ultraschall.GetClosestGoToPoints(string trackstring, number time_position, optional boolean check_itemedge, optional boolean check_marker, optional boolean check_region)

Description:
returns, what are the closest markers/regions/item starts/itemends to position and within the chosen tracks.

returns -1 in case of error

Returnvalues:
 number elementposition_prev previous closest markers/regions/item starts/itemends 
 string elementtype_prev type of the previous closest markers/regions/item starts/itemends
the type can be either Itembeg, Itemend, Marker: name, Region_beg: name; Region_end: name, ProjectStart, ProjectEnd; "name" is the name of the marker or region 
 integer number_prev number of previous closest markers/regions/item starts/itemends 
 number elementposition_next previous closest markers/regions/item starts/itemends 
 string elementtype_next type of the previous closest markers/regions/item starts/itemends
the type can be either Itembeg, Itemend, Marker: name, Region_beg: name; Region_end: name, ProjectStart, ProjectEnd; "name" is the name of the marker or region 
 integer number_next number of previous closest markers/regions/item starts/itemends 

Parameters:
 string trackstring tracknumbers, separated by a comma. 
 number time_position a time position in seconds, from where to check for the next/previous closest items/markers/regions.
-1, for editcursorposition; -2, for playcursor-position, -3, the mouse-cursor-position in seconds(where in the project the mousecursor hovers over) 
 optional boolean check_itemedge true, look for itemedges as possible goto-points; false, do not 
 optional boolean check_marker true, look for markers as possible goto-points; false, do not 
 optional boolean check_region true, look for regions as possible goto-point; false, do not 


Reaper version 5.40Lua version 5.3 ToggleMute

Functioncall:

integer retval = ultraschall.ToggleMute(integer track, number position, integer state)

Description:
Sets mute within the mute-envelope-lane, by inserting the fitting envelope-points. Can be used to program coughbuttons. Returns -1, if it fails.

Returnvalues:
 integer retval toggling was 0 - success, -1 - fail 

Parameters:
 integer track the track-number, for where you want to set the mute-envelope-lane. 
 number position position in seconds 
 integer state 0 for mute the track on this position, 1 for unmuting the track on this position 


Reaper version 5.40Lua version 5.3 ToggleMute_TrackObject

Functioncall:

integer retval = ultraschall.ToggleMute_TrackObject(MediaTrack trackobject, number position, integer state)

Description:
Sets mute within the mute-envelope-lane, by inserting the fitting envelope-points. Can be used to program coughbuttons. Returns -1, if it fails.

Works like ultraschall.ToggleMute but uses a trackobject instead of the tracknumber as parameter.

Returnvalues:
 integer retval toggling was 0 - success, -1 - fail 

Parameters:
 MediaTrack trackobject the track-object for the track, where you want to set the mute-envelope-lane. Refer GetTrack() for more details. 
 number position position in seconds 
 integer state 0 for mute the track on this position, 1 for unmuting the track on this position 


Reaper version 5.40Lua version 5.3 GetNextMuteState

Functioncall:

integer envIDX, number envVal, number envPosition = ultraschall.GetNextMuteState(integer track, number position)

Description:
Returns the next mute-envelope-point-ID, it's value(0 or 1) and it's time. Envelope-Points numbering starts with 0! Returns -1 if not existing.

Returnvalues:
 integer envIDX number of the muteenvelope-point 
 number envVal value of the muteenvelope-point (0 or 1) 
 number envPosition position of the muteenvelope-point in seconds 

Parameters:
 integer track the track-number, for where you want to set the mute-envelope-lane, beginning with 1. 
 number position position in seconds, from where to look for the next mute-envelope-point 


Reaper version 5.40Lua version 5.3 GetPreviousMuteState

Functioncall:

integer envIDX, number envVal, number envPosition = ultraschall.GetPreviousMuteState(integer track, number position)

Description:
Returns the previous mute-envelope-point-ID, it's value(0 or 1) and it's time. Envelope-Points numbering starts with 0! Returns -1 if not existing.

Returnvalues:
 integer envIDX number of the muteenvelope-point 
 number envVal value of the muteenvelope-point (0 or 1) 
 number envPosition position of the muteenvelope-point in seconds 

Parameters:
 integer track the track-number, for where you want to set the mute-envelope-lane, beginning with 1. 
 number position position in seconds, from where to look for the previous mute-envelope-point 


Reaper version 5.40Lua version 5.3 GetNextMuteState_TrackObject

Functioncall:

integer envIDX, number envVal, number envPosition = ultraschall.GetNextMuteState_TrackObject(MediaTrack track, number position)

Description:
Returns the next mute-envelope-point-ID, it's value(0 or 1) and it's time. Envelope-Points numbering starts with 0! Returns -1 if not existing.

Returnvalues:
 integer envIDX number of the muteenvelope-point 
 number envVal value of the muteenvelope-point (0 or 1) 
 number envPosition position of the muteenvelope-point in seconds 

Parameters:
 MediaTrack track the MediaTrack-object, for the track, where you want to set the mute-envelope-lane. 
 number position position in seconds, from where to look for the next mute-envelope-point 


Reaper version 5.40Lua version 5.3 GetPreviousMuteState_TrackObject

Functioncall:

integer envIDX, number envVal, number envPosition = ultraschall.GetPreviousMuteState_TrackObject(MediaTrack track, number position)

Description:
Returns the previous mute-envelope-point-ID, it's value(0 or 1) and it's time. Envelope-Points numbering starts with 0! Returns -1 if not existing.

Returnvalues:
 integer envIDX number of the muteenvelope-point 
 number envVal value of the muteenvelope-point (0 or 1) 
 number envPosition position of the muteenvelope-point in seconds 

Parameters:
 MediaTrack track the MediaTrack-object, for the track, where you want to set the mute-envelope-lane. 
 number position position in seconds, from where to look for the previous mute-envelope-point 


Reaper version 5.40Lua version 5.3 CountMuteEnvelopePoints

Functioncall:

integer retval = ultraschall.CountMuteEnvelopePoints(integer track)

Description:
Returns the number of the envelope-points in the Mute-lane of track "track". Returns -1, if it fails.

Returnvalues:
 integer retval number of mute-envelope-points 

Parameters:
 integer track the track-number, for which you want to count the mute-envelope-points, beginning with 1. 


Reaper version 5.40Lua version 5.3 CheckActionCommandIDFormat

Functioncall:

boolean retval = ultraschall.CheckActionCommandIDFormat(action_command_id)

Description:
Checks, whether an action command id is a valid commandid(which is a number) or a valid _action_command_id (which is a string with an _underscore in the beginning).

Does not check, whether this action_command_id is a useable one, only if it's "syntax" is correct!

Returnvalues:
 boolean retval true, valid action_command_id; false, not a valid action_command_id 

Parameters:
 actioncommand_id the ActionCommandID you want to check; either a number or an action_command_id with an underscore at the beginning 


Reaper version 5.40Lua version 5.3 CheckActionCommandIDFormat2

Functioncall:

boolean retval = ultraschall.CheckActionCommandIDFormat2(action_command_id)

Description:
Checks, whether an action command id is a valid commandid(which is a number) or a valid _action_command_id (which is a string with an _underscore in the beginning).

Unlike CheckActionCommandIDFormat, this checks whether an action-command-id-string is an actual registered one(case sensitive!).

Returnvalues:
 boolean retval true, valid action_command_id; false, not a valid action_command_id 

Parameters:
 actioncommand_id the ActionCommandID you want to check; either a number or an action_command_id with an underscore at the beginning 


Reaper version 5.40Lua version 5.3 ToggleStateAction

Functioncall:

boolean retval = ultraschall.ToggleStateAction(integer section, string actioncommand_id, integer state)

Description:
Toggles state of an action using the actioncommand_id(instead of the CommandID-number)

returns current state of the action after toggling or -1 in case of error.

Returnvalues:
 boolean retval state if the action, after it has been toggled 

Parameters:
 integer section the section of the action(see ShowActionlist-dialog)
0 - Main
100 - Main (alt recording)
32060 - MIDI Editor
32061 - MIDI Event List Editor
32062 - MIDI Inline Editor
32063 - Media Explorer 
 string actioncommand_id the ActionCommandID of the action to toggle 
 integer state 1 or 0 


Reaper version 5.40Lua version 5.3 RefreshToolbar_Action

Functioncall:

ultraschall.RefreshToolbar_Action(integer section, string actioncommand_id)

Description:
Refreshes a toolbarbutton with an ActionCommandID(instead of the CommandID-number)

returns -1 in case of error


Parameters:
 integer section section
0 - Main
100 - Main (alt recording)
32060 - MIDI Editor
32061 - MIDI Event List Editor
32062 - MIDI Inline Editor
32063 - Media Explorer 
 string actioncommand_id ActionCommandID of the action, associated with the toolbarbutton  


Reaper version 5.40Lua version 5.3 ToggleStateButton

Functioncall:

boolean retval = ultraschall.ToggleStateButton(integer section, string actioncommand_id, integer state)

Description:
Toggles state and refreshes the button of an actioncommand_id

returns false in case of error

Returnvalues:
 boolean retval state of the State-Button, after toggling 

Parameters:
 integer section the section of the action(see ShowActionlist-dialog)
0 - Main
100 - Main (alt recording)
32060 - MIDI Editor
32061 - MIDI Event List Editor
32062 - MIDI Inline Editor
32063 - Media Explorer 
 string actioncommand_id the ActionCommandID of the action to toggle 
 integer state 1 or 0 


Reaper version 5.40Lua version 5.3 AddNormalMarker

Functioncall:

integer marker_number = ultraschall.AddNormalMarker(number position, integer shown_number, string markertitle)

Description:
Adds a normal marker. Returns the index of the marker as marker_number.

Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 integer marker_number the overall-marker-index, can be used for reaper's own marker-management functions 

Parameters:
 number position position in seconds. 
 integer shown_number the number, that will be shown within Reaper. Can be multiple times. Use -1 to let Reaper decide the number. 
 string markertitle the title of the marker. 


Reaper version 5.40Lua version 5.3 AddPodRangeRegion

Functioncall:

integer marker_number = ultraschall.AddPodRangeRegion(number startposition, number endposition)

Description:
Adds a region, which shows the time-range from the beginning to the end of the podcast.

Returnvalues:
 integer marker_number the overall-marker-index, can be used for reaper's own marker-management functions 

Parameters:
 number startposition begin of the podcast in seconds 
 number endposition end of the podcast in seconds 


Reaper version 5.77Lua version 5.3 GetMarkerByName

Functioncall:

integer count_markers, array foundmarkers = ultraschall.GetMarkerByName(string searchname, boolean searchisrgn)

Description:
Get all markers/regions that have a certain name. This function is not case-sensitive.

returns -1 in case of an error

Returnvalues:
 integer count_markers the number of found markers/regions 
 array foundmarkers an array with all marker/region-numbers of the found markers; counts only regions or markers(depending on parameter searchisrgn) 

Parameters:
 string searchname the name to look for; must be exact; not case-sensitive 
 boolean searchisrgn true, search only within regions; false, search only within markers 


Reaper version 5.77Lua version 5.3 GetMarkerByName_Pattern

Functioncall:

integer count_markers, array foundmarkers = ultraschall.GetMarkerByName_Pattern(string searchname, boolean searchisrgn)

Description:
Get all markers/regions that have a certain character-sequence in their name. This function is not case-sensitive.

returns -1 in case of an error

Returnvalues:
 integer count_markers the number of found markers/regions 
 array foundmarkers an array with all marker/region-numbers of the found markers; counts only regions or markers(depending on parameter searchisrgn) 

Parameters:
 string searchname the name to look for; a character-sequence that shall be part of the name; not case-sensitive 
 boolean searchisrgn true, search only within regions; false, search only within markers 


Reaper version 5.77Lua version 5.3 GetMarkerAndRegionsByIndex

Functioncall:

string name, integer shown_number, integer color, number pos, optional number rgnend = ultraschall.GetMarkerAndRegionsByIndex(integer idx, boolean searchisrgn)

Description:
Returns the values of a certain marker/region. The numbering of idx is either only for the markers or for regions, depending on what you set with parameter searchisrgn.

returns nil in case of an error

Returnvalues:
 string name the name of the marker/region 
 integer markrgnindexnumber the shown number of the marker/region 
 integer color the color-value of the marker/region 
 number pos the position of the marker/region 
 optional number rgnend the end of the region 

Parameters:
 integer idx the number of the requested marker/region; counts only within either markers or regions, depending on what you've set searchisrgn to 
 boolean searchisrgn true, search only within regions; false, search only within markers 


Reaper version 5.77Lua version 5.3 SetMarkerByIndex

Functioncall:

boolean retval = ultraschall.SetMarkerByIndex(integer idx, boolean searchisrgn, integer shown_number, number position, position rgnend, string name, integer color, integer flags)

Description:
Sets the values of a certain marker/region. The numbering of idx is either only for the markers or for regions, depending on what you set with parameter searchisrgn.

returns nil in case of an error

Returnvalues:
 boolean retval true, setting the marker/region was successful; false, setting of the marker/region was unsuccessful. 

Parameters:
 integer idx the number of the requested marker/region; counts only within either markers or regions, depending on what you've set searchisrgn to 
 boolean searchisrgn true, search only within regions; false, search only within markers 
 integer shown_number the shown-number of the region/marker; no duplicate numbers for regions allowed; nil to keep previous shown_number 
 number position the position of the marker/region in seconds; nil to keep previous position 
 position rgnend the end of the region in seconds; nil to keep previous region-end 
 string name the name of the marker/region; nil to keep the previous name 
 integer color color should be 0 to not change, or ColorToNative(r,g,b)|0x1000000; nil to keep the previous color 
 integer flags flags&1 to clear name; 0, keep it; nil to use the previous setting 


Reaper version 5.40Lua version 5.3 AddEditMarker

Functioncall:

integer marker_number = ultraschall.AddEditMarker(number position, integer shown_number, string edittitle)

Description:
Adds an Edit marker. Returns the index of the marker as marker_number.

Returnvalues:
 integer marker_number the overall-marker-index, can be used for reaper's own marker-management functions 

Parameters:
 number position position in seconds. 
 integer shown_number the number, that will be shown within Reaper. Can be multiple times. Use -1 to let Reaper decide the number. 
 string edittitle the title of the edit-marker; will be shown as _Edit:edittitle 


Reaper version 5.40Lua version 5.3 CountNormalMarkers

Functioncall:

integer number_of_markers = ultraschall.CountNormalMarkers()

Description:
Counts all normal markers.
Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 integer number_of_markers number of normal markers 



Reaper version 5.40Lua version 5.3 CountEditMarkers

Functioncall:

integer number_of_edit_markers = ultraschall.CountEditMarkers()

Description:
Counts all edit-markers.

Returnvalues:
 integer number_of_edit_markers number of edit markers 



Reaper version 5.40Lua version 5.3 GetPodRangeRegion

Functioncall:

number start_position, number end_position = ultraschall.GetPodRangeRegion()

Description:
Gets the start_position and the end_position of the PodRangeRegion.

returns -1 if no PodRangeRegion exists

Returnvalues:
 number start_position beginning of the podrangeregion, that marks the beginning of the podcast 
 number end_position end of the podrangeregion, that marks the end of the podcast 



Reaper version 5.40Lua version 5.3 EnumerateNormalMarkers

Functioncall:

integer retnumber, integer retidxnum, number position, string markertitle = ultraschall.EnumerateNormalMarkers(integer number)

Description:
Get the data of a normal marker.
Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returns -1 in case of error

Returnvalues:
 integer retnumber overallmarker/regionnumber of marker beginning with 1 for the first marker; ignore the order of first,second,etc creation of
markers but counts from position 00:00:00 to end of project. So if you created a marker at position 00:00:00 and move the first created marker to
the end of the timeline, it will be the last one, NOT the first one in the retval! For use with reaper's own marker-functions. 
 integer retidxnum indexnumber of the marker 
 number position the position of the marker 
 string markertitle the name of the marker 

Parameters:
 integer number number of the marker(normal markers only). Refer ultraschall.CountNormalMarkers for getting the number of normal markers. 


Reaper version 5.40Lua version 5.3 EnumerateEditMarkers

Functioncall:

integer retnumber, integer shown_number, number position, string edittitle = ultraschall.EnumerateEditMarkers(integer edit_index)

Description:
Get the data of an edit marker.

Returnvalues:
 integer retnumber overallmarker/regionnumber of marker beginning with 1 for the first marker; ignore the order of first,second,etc creation of
markers but counts from position 00:00:00 to end of project. So if you created a marker at position 00:00:00 and move the first created marker to
the end of the timeline, it will be the last one, NOT the first one in the retval! For use with reaper's own marker-functions. 
 integer shown_number indexnumber of the marker 
 number position the position of the marker 
 string dummyname the name of the marker 

Parameters:
 integer edit_index number of the edit-marker. Refer ultraschall.CountEditMarkers for getting the number of edit-markers. 


Reaper version 5.40Lua version 5.3 GetAllEditMarkers

Functioncall:

integer number_of_editmarkers, array editmarkersarray = ultraschall.GetAllEditMarkers()

Description:
returns the number of editmarkers and an array with each editmarker in the format:

    editmarkersarray[index][0] - position
    editmarkersarray[index][1] - name
    editmarkersarray[index][2] - idx
    

Returnvalues:
 integer number_of_editmarkers the number of editmarkers returned 
 array editmarkersarray an array with all the edit-markers of the project 



Reaper version 5.40Lua version 5.3 GetAllNormalMarkers

Functioncall:

index number_of_normalmarkers, array normalmarkersarray = ultraschall.GetAllNormalMarkers()

Description:
returns the number of normalmarkers and an array with each normalmarker in the format:

normalmarkersarray[index][0] - position
normalmarkersarray[index][1] - name
normalmarkersarray[index][2] - idx of the marker within all markers in project
normalmarkersarray[index][3] - the shown index number of the marker

Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 integer number_of_normalmarkers the number of normalmarkers returned 
 array normalmarkersarray an array, that holds all normal markers of the project 



Reaper version 5.40Lua version 5.3 GetAllMarkers

Functioncall:

integer number_of_all_markers, array allmarkersarray = ultraschall.GetAllMarkers()

Description:
To get all Markers in the project(normal, edit, chapter), regardless of their category.
Doesn't return regions!

returns the number of markers and an array with each marker in the format:

    markersarray[index][0] - position
    markersarray[index][1] - name
    markersarray[index][2] - indexnumber of the marker within all markers in the project
    markersarray[index][3] - the shown index-number
    markersarray[index][4] - the color of the marker
    

Returnvalues:
 integer number_of_allmarkers the number of markers returned 
 array allmarkersarray an array, that holds all markers(not regions!) of the project 



Reaper version 5.40Lua version 5.3 SetNormalMarker

Functioncall:

boolean retval = ultraschall.SetNormalMarker(integer number, number position, integer shown_number, string markertitle)

Description:
Sets values of a normal Marker(no _Chapter:, _Shownote:, etc). Returns true if successful and false if not(i.e. marker doesn't exist)

Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 boolean retval true if successful and false if not(i.e. marker doesn't exist) 

Parameters:
 integer number the number of the normal marker 
 number position position of the marker in seconds 
 integer shown_number the number of the marker 
 string markertitle title of the marker 


Reaper version 5.40Lua version 5.3 SetEditMarker

Functioncall:

boolean retval = ultraschall.SetEditMarker(integer edit_index, number position, integer shown_number, string edittitle)

Description:
Sets values of an Edit Marker. Returns true if successful and false if not(i.e. marker doesn't exist)

Returnvalues:
 boolean retval true if successful and false if not(i.e. marker doesn't exist) 

Parameters:
 integer edit_index the number of the edit marker 
 number position position of the marker in seconds 
 integer shown_number the number of the marker 
 string markertitle title of the marker 


Reaper version 5.40Lua version 5.3 SetPodRangeRegion

Functioncall:

integer retval = ultraschall.SetPodRangeRegion(number startposition, number endposition)

Description:
Sets "_PodRange:"-Region

returns -1 if it fails.

Returnvalues:
 integer retval number of the region, -1 if it fails 

Parameters:
 number startposition begin of the podcast in seconds 
 number endposition end of the podcast in seconds 


Reaper version 5.40Lua version 5.3 DeletePodRangeRegion

Functioncall:

integer retval = ultraschall.DeletePodRangeRegion()

Description:
deletes the PodRange-Region.
Returns false if unsuccessful

Returnvalues:
 boolean retval true, if deleting was successful; false, if not 



Reaper version 5.40Lua version 5.3 DeleteNormalMarker

Functioncall:

boolean retval = ultraschall.DeleteNormalMarker(integer number)

Description:
Deletes a Normal-Marker. Returns true if successful and false if not(i.e. marker doesn't exist) Use ultraschall.EnumerateNormalMarkers to get the correct number.

Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 boolean retval true, if successful, false if not 

Parameters:
 integer number number of a normal marker 


Reaper version 5.40Lua version 5.3 DeleteEditMarker

Functioncall:

boolean retval = ultraschall.DeleteEditMarker(integer edit_index)

Description:
Deletes an _Edit:-Marker. Returns true if successful and false if not(i.e. marker doesn't exist) Use ultraschall.EnumerateEditMarkers to get the correct number.

Returnvalues:
 boolean retval true, if successful, false if not 

Parameters:
 integer edit_index number of an edit marker 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 SecondsToTime

Functioncall:

string time_string = ultraschall.SecondsToTime(number pos)

Description:
converts timeposition in seconds(pos) to a timestring (h)hh:mm:ss.mss

returns nil in case of error

Returnvalues:
 string time_string timestring in (h)hh:mm:ss.mss 

Parameters:
 number pos timeposition in seconds 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 TimeToSeconds

Functioncall:

number position = ultraschall.TimeToSeconds(string timestring)

Description:
converts a timestring days:hours:minutes:seconds.milliseconds to timeposition in seconds
it is ok, to have only some of the last ones given, so i.e. excluding days and hours is ok. Though excluding values inbetween does not work!

A single integer in timestring will be seen as seconds.
To only specifiy milliseconds in particular, start the number with a .
all other values are seperated by :

returns -1 in case of error, timestring is a nil or if you try to add an additional value, added before days

does not check for valid timeranges, so 61 minutes is possible to give, even if hours are present in the string

Returnvalues:
 number position the converted position 

Parameters:
 string timestring a string like: days:hours:minutes:seconds.milliseconds , i.e. 1:16:27:50.098 


Reaper version 5.40Lua version 5.3 ExportEditMarkersToFile

Functioncall:

integer retval = ultraschall.ExportEditMarkersToFile(string filename_with_path, number PodRangeStart, number PodRangeEnd)

Description:
Export Edit-Markers (not regions!) to filename_with_path.

Each line in the exportfile contains an entry for such an edit-marker in the format:

hh:mm:ss.mss Title

Returns -1 in case of error.

Returnvalues:
 integer retval 1 in case of success, -1 if it failed 

Parameters:
 string filename_with_path the name of the export-file 
 number PodRangeStart beginning of the podcast in seconds 
 number PodRangeEnd end of the podcast in seconds 


Reaper version 5.40Lua version 5.3 ExportNormalMarkersToFile

Functioncall:

integer retval = ultraschall.ExportNormalMarkersToFile(string filename_with_path, number PodRangeStart, number PodRangeEnd)

Description:
Export Normal-Markers to filename_with_path. Returns -1 in case of error.

Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 integer retval 1 in case of success, -1 if it failed 

Parameters:
 string filename_with_path the name of the export-file 
 number PodRangeStart beginning of the podcast in seconds 
 number PodRangeEnd end of the podcast in seconds 


Reaper version 5.40Lua version 5.3 ImportEditFromFile

Functioncall:

array editmarkers = ultraschall.ImportEditFromFile(string filename_with_path, PodRangestart)

Description:
Imports editentries from a file and returns an array of the imported values.

returns -1 in case of error

Returnvalues:
 array chapters array[0] is position of marker+PodRangeStart, array[1] is name of the marker 

Parameters:
 string filename_with_path markerfile to be imported 
 number PodRangeStart podcast-start-offset 


Reaper version 5.40Lua version 5.3 ImportMarkersFromFile

Functioncall:

array markers = ultraschall.ImportMarkersFromFile(string filename_with_path, PodrangeStart)

Description:
Imports markerentries from a file and returns an array of the imported values.

returns -1 in case of error

Returnvalues:
 array chapters array[0] is position of marker+PodRangeStart, array[1] is name of the marker 

Parameters:
 string filename_with_path markerfile to be imported 
 number PodRangeStart podcast-start-offset 


Reaper version 5.40Lua version 5.3 MarkerToEditMarker

Functioncall:

integer idx, integer shown_number, number position, string markertitle = ultraschall.MarkerToEditMarker(integer markerindex)

Description:
Converts a normal-marker to an edit-marker.

Normal markers are all markers, that don't include "_Shownote:" or "_Edit" in the beginning of their name, as well as markers with the color 100,255,0(planned chapter).

Returnvalues:
 integer idx overallmarker/regionnumber of marker beginning with 1 for the first marker; ignore the order of first,second,etc creation of
markers but counts from position 00:00:00 to end of project. So if you created a marker at position 00:00:00 and move the first created marker to
the end of the timeline, it will be the last one, NOT the first one in the retval! For use with reaper's own marker-functions. 
 integer shown_number the shown number of the marker 
 number position the position of the marker in seconds 
 string markertitle the markertitle 

Parameters:
 integer markerindex number of the normal-marker. Refer ultraschall.CountNormalMarkers for getting the number of normal-markers. 


Reaper version 5.40Lua version 5.3 EditToMarker

Functioncall:

integer idx, integer shown_number, number position, string markertitle = ultraschall.EditToMarker(integer edit_index)

Description:
Converts an edit-marker to a normal marker.

Returnvalues:
 integer idx overallmarker/regionnumber of marker beginning with 1 for the first marker; ignore the order of first,second,etc creation of
markers but counts from position 00:00:00 to end of project. So if you created a marker at position 00:00:00 and move the first created marker to
the end of the timeline, it will be the last one, NOT the first one in the retval! For use with reaper's own marker-functions. 
 integer shown_number the shown number of the marker 
 number position the position of the marker in seconds 
 string markertitle the markertitle 

Parameters:
 integer edit_index number of the edit-marker. Refer ultraschall.CountEditMarkers for getting the number of edit-markers. 


Reaper version 5.40Lua version 5.3 CreateTrackString_SelectedTracks

Functioncall:

string trackstring = ultraschall.CreateTrackString_SelectedTracks()

Description:
Creates a string with all numbers from selected tracks, separated by a ,

Returns an empty string, if no tracks are selected.

Returnvalues:
 string trackstring a string with the tracknumbers, separated by a string 



Reaper version 5.40Lua version 5.3 ReadFullFile

Functioncall:

string contents, integer length_of_file, integer number_of_lines = ultraschall.ReadFullFile(string filename_with_path, boolean binary)

Description:
Return contents of filename_with_path.

Keep in mind, that on Windows, you need to escape \ by writing \\ in filenames, or it will not work.

Returnvalues:
 string contents the contents of the whole file. 
 integer length_of_file the number of bytes of the file 
 integer number_of_lines number of lines in file (-1 if parameter binary is set to true) 

Parameters:
 string filename_with_path filename of the file to be read 
 boolean binary true if the file shall be read as a binary file; false if read as ASCII. Default is ASCII. 


Reaper version 5.40Lua version 5.3 ReadValueFromFile

Functioncall:

string contents, string linenumbers, integer numberoflines, integer number_of_foundlines = ultraschall.ReadValueFromFile(string filename_with_path, string value)

Description:
Return contents of filename_with_path.

If "value" is given, it will return all lines, containing the value in the file "filename_with_path".
The second line-numbers return-value is very valuable when giving a "value". "Value" is not case-sensitive.
The value can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returnvalues:
 string contents the contents of the file, or the lines that contain parameter value in it, separated by a newline 
 string linenumbers a string, that contains the linenumbers returned as a , separated csv-string 
 integer numberoflines_in_file the total number of lines in the file 
 integer number_of_foundlines the number of found lines 

Parameters:
 string filename_with_path filename of the file to be read 
 string value the value to look in the file for. Not case-sensitive. 


Reaper version 5.40Lua version 5.3 ReadLinerangeFromFile

Functioncall:

string contents, boolean correctnumberoflines, integer number_of_lines = ultraschall.ReadLinerangeFromFile(string filename_with_path, integer firstlinenumber, integer lastlinenumber)

Description:
Return contents of filename_with_path, from firstlinenumber to lastlinenumber. Counting of linenumbers starts with 1 for the first line.
The returned string contains all requested lines, separated by a newline.

Returns nil, if the linenumbers are invalid.

Returnvalues:
 string contents the contents the lines of the file, that you requested 
 boolean correctnumberoflines true, if the number of lines are returned, as requested; false if fewer lines are returned 
 integer number_of_lines the number of read lines 

Parameters:
 string filename_with_path filename of the file to be read 
 integer firstlinenumber the first linenumber to be returned. First line in the file begins with 1! 
 integer lastlinenumber the last linenumber to be returned; -1, for the whole file 


Reaper version 5.40Lua version 5.3 MakeCopyOfFile

Functioncall:

boolean retval = ultraschall.MakeCopyOfFile(string input_filename_with_path, string output_filename_with_path)

Description:
Copies input_filename_with_path to output_filename_with_path.
Only textfiles! For binary-files use MakeCopyOfFile_Binary() instead!

Returns true, if it worked, false if it didn't.

Returnvalues:
 boolean retval true, if copy worked, false if it didn't. 

Parameters:
 string input_filename_with_path filename of the file to copy 
 string output_filename_with_path filename of the copied file to be created. 


Reaper version 5.40Lua version 5.3 MakeCopyOfFile_Binary

Functioncall:

boolean retval = ultraschall.MakeCopyOfFile_Binary(string input_filename_with_path, string output_filename_with_path)

Description:
Copies input_filename_with_path to output_filename_with_path as binary-file.

Returnvalues:
 boolean retval returns true, if copy worked; false if it didn't 

Parameters:
 string input_filename_with_path filename of the file to copy 
 string output_filename_with_path filename of the copied file, that shall be created 


Reaper version 5.40Lua version 5.3 ReadBinaryFileUntilPattern

Functioncall:

integer length, string content = ultraschall.ReadBinaryFileUntilPattern(string input_filename_with_path, string pattern)

Description:
Returns a binary file, up until a pattern. The pattern is not case-sensitive.

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returnvalues:
 integer length the length of the returned data 
 string content the content of the file, that has been read until pattern 

Parameters:
 string filename_with_path filename of the file to be read 
 string pattern a pattern to search for. Case-sensitive. 


Reaper version 5.40Lua version 5.3 ReadBinaryFileFromPattern

Functioncall:

integer length, string content = ultraschall.ReadBinaryFileFromPattern(string input_filename_with_path, string pattern)

Description:
Returns a binary file, from pattern onwards. The pattern is not case-sensitive.

The pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returnvalues:
 integer length the length of the returned data 
 string content the content of the file, that has been read from pattern to the end 

Parameters:
 string filename_with_path filename of the file to be read 
 string pattern a pattern to search for. Case-sensitive. 


Reaper version 5.40Lua version 5.3 CountLinesInFile

Functioncall:

integer linesinfile = ultraschall.CountLinesInFile(string filename_with_path)

Description:
Counts lines in a textfile. In binary files, the number of lines may be weird and unexpected!
Returns -1, if no such file exists.

Returnvalues:
 integer linesinfile number of lines in a textfile; -1 in case of error 

Parameters:
 string filename_with_path filename of the file to be read 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 SetIniFileExternalState

Functioncall:

boolean retval = ultraschall.SetIniFileExternalState(string section, string key, string value, string ini_filename_with_path)

Description:
Sets an external state into ini_filename_with_path. Returns false, if it doesn't work.

Returnvalues:
 boolean retval true, if setting the state was successful; false, if setting was unsuccessful 

Parameters:
 string section section of the external state. No = allowed! 
 string key key of the external state. No = allowed! 
 string value value for the key 
 string filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetIniFileExternalState

Functioncall:

string value = ultraschall.GetIniFileExternalState(string section, string key, string ini_filename_with_path)

Description:
Gets an external state from ini_filename_with_path. Returns -1, if the file does not exist or parameters are invalid.

Returnvalues:
 integer entrylength the length of the returned value 
 string value the value stored in a section->key in a configuration-file 

Parameters:
 string section section of the external state 
 string key key of the external state. No = allowed! 
 string filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 CountIniFileExternalState_sec

Functioncall:

integer sectioncount = ultraschall.CountIniFileExternalState_sec(string ini_filename_with_path)

Description:
Count external-state-[sections] from an ini-configurationsfile.

Returns -1, if the file does not exist.

Returnvalues:
 integer sectioncount number of sections within an ini-configuration-file 

Parameters:
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 CountIniFileExternalState_key

Functioncall:

integer keyscount = ultraschall.CountIniFileExternalState_key(string section, string ini_filename_with_path)

Description:
Count external-state-keys within a specific section, in a ini_filename_with_path.

Returns -1, if file does not exist.

Returnvalues:
 integer keyscount number of keys with section within an ini-configuration-file 

Parameters:
 string section the section within the ini-filename 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 EnumerateIniFileExternalState_sec

Functioncall:

string sectionname = ultraschall.EnumerateIniFileExternalState_sec(integer number_of_section, string ini_filename_with_path)

Description:
Returns the numberth section in an ini_filename_with_path.

Returns nil, in case of an error.

Returnvalues:
 string sectionname the name of the numberth section in the ini-file 

Parameters:
 integer number_of_section the section within the ini-filename; 1, for the first section 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 EnumerateIniFileExternalState_key

Functioncall:

string keyname = ultraschall.EnumerateIniFileExternalState_key(string section, integer number, string ini_filename_with_path)

Description:
Returns the numberth key within a section in an ini_filename_with_path.

Returns nil, in case of an error.

Returnvalues:
 string keyname the name of the numberth key within section in the ini-file 

Parameters:
 string section the name of the section 
 integer number the number of the key within a section within the ini-filename, with 1 for the first key in the section 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 CountSectionsByPattern

Functioncall:

integer number_of_sections, string sectionnames = ultraschall.CountSectionsByPattern(string pattern, string ini_filename_with_path)

Description:
Counts the number of sections within an ini-file, that fit a specific pattern.

Uses "pattern"-string to determine, how often a section with a certain pattern exists. Good for sections, that have a number in them, like [section1], [section2], [section3].
Returns the number of sections, that include that pattern as well as a string, that includes the names of all such sections, separated by a comma.

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returns -1, in case of an error.

Returnvalues:
 integer number_of_sections the number of sections, that fit the pattern 
 string sectionnames a string, like: [section1],[section8],[section99] 

Parameters:
 string pattern the pattern itself. Case sensitive. 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 CountKeysByPattern

Functioncall:

integer number_of_keys, string sections_and_keys = ultraschall.CountKeysByPattern(string pattern, string ini_filename_with_path)

Description:
Counts the number of keys within an ini-file, that fit a specific pattern.

Uses "pattern"-string to determine, how often a key with a certain pattern exists. Good for keys, that have a number in them, like key1, key2, key3.
Returns the number of keys, that include the pattern, as well as a string with all [sections] that contain keys= with a pattern, separated by a , i.e. [section1],key1=,key2=,key3=,[section2],key1=,key4=

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returns -1, in case of an error.

Returnvalues:
 integer number_of_keys the number of keys, that fit the pattern 
 string sections_and_keys a string, like: [section1],Key1=,Key2=,Key3=[section2],Key7= 

Parameters:
 string pattern the pattern itself. Case sensitive. 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 CountValuesByPattern

Functioncall:

integer number_of_keys, string sections_and_keys = ultraschall.CountValuesByPattern(string pattern, string ini_filename_with_path)

Description:
Counts the number of values within an ini-file, that fit a specific pattern.

Uses "pattern"-string to determine, how often a value with a certain pattern exists. Good for values, that have a number in them, like value1, value2, value3
Returns the number of values, that include that pattern as well as a string, that contains the [sections] and the keys= and values , the latter that contain the pattern, separated by a comma
e.g. [section1], key1=, value, key4=, value, [section4], key2=, value

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returns -1, in case of an error.

Returnvalues:
 integer number_of_values the number of values, that fit the pattern 
 string sections_keys_values a string, like: [section1],key1=,value,key4=,value,[section4],key2=,value 

Parameters:
 string pattern the pattern itself. Case sensitive. 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 EnumerateSectionsByPattern

Functioncall:

string sectionname = ultraschall.EnumerateSectionsByPattern(string pattern, integer id, string ini_filename_with_path)

Description:
Returns the numberth section within an ini-file, that fits the pattern, e.g. the third section containing "hawaii" in it.

Uses "pattern"-string to determine if a section contains a certain pattern. Good for sections, that have a number in them, like section1, section2, section3
Returns the section that includes that pattern as a string, numbered by id.

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returns nil, in case of an error.

Returnvalues:
 string sectionname a string, that contains the sectionname 

Parameters:
 string pattern the pattern itself. Case sensitive. 
 integer id the number of section, that contains pattern 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 EnumerateKeysByPattern

Functioncall:

string keyname = ultraschall.EnumerateKeysByPattern(string pattern, string section, integer id, string ini_filename_with_path)

Description:
Returns the numberth key within a section in an ini-file, that fits the pattern, e.g. the third key containing "hawaii" in it.

Uses "pattern"-string to determine if a key contains a certain pattern. Good for keys, that have a number in them, like key1=, key2=, key3=
Returns the key that includes that pattern as a string, numbered by id.

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returns nil, in case of an error.

Returnvalues:
 string keyname a string, that contains the keyname 

Parameters:
 string pattern the pattern itself. Case sensitive. 
 string section the section, in which to look for the key 
 integer id the number of key, that contains pattern 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 EnumerateValuesByPattern

Functioncall:

string value, string keyname = ultraschall.EnumerateValuesByPattern(string pattern, string section, string id, string ini_filename_with_path)

Description:
Returns the numberth value(and it's accompanying key) within a section in an ini-file, that fits the pattern, e.g. the third value containing "hawaii" in it.

Uses "pattern"-string to determine if a value contains a certain pattern. Good for values, that have a number in them, like value1, value2, value3
Returns the value that includes that pattern as a string, numbered by id, as well as it's accompanying key.

Pattern can also contain patterns for pattern matching. Refer the LUA-docs for pattern matching.
i.e. characters like ^$()%.[]*+-? must be escaped with a %, means: %[%]%(%) etc

Returns nil, in case of an error.

Returnvalues:
 string value the value that contains the pattern 
 string keyname a string, that contains the keyname 

Parameters:
 string pattern the pattern itself. Case sensitive. 
 string section the section, in which to look for the key 
 integer id the number of key, that contains pattern 
 string ini_filename_with_path filename of the ini-file 


Reaper version 5.40Lua version 5.3 GetMarkerByScreenCoordinates

Functioncall:

string marker = ultraschall.GetMarkerByScreenCoordinates(integer xmouseposition, boolean retina)

Description:
returns the markers at a given absolute-x-pixel-position. It sees markers according their graphical representation in the arrange-view, not just their position! Returned string will be "Markeridx\npos\nName\nMarkeridx2\npos2\nName2\n...".
Returns only markers, no time markers or regions!

returns nil in case of an error

Returnvalues:
 string marker a string with all markernumbers, markerpositions and markertitles, separated by a newline.
Can contain numerous markers, if there are more markers in one position. 

Parameters:
 integer xmouseposition the absolute x-screen-position, like current mouse-position 
 boolean retina if the screen-resolution is retina or hidpi, turn this true, else false 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetMarkerByTime

Functioncall:

string markers = ultraschall.GetMarkerByTime(number position, boolean retina)

Description:
returns the markers at a given project-position in seconds.
It sees markers according their actual graphical representation in the arrange-view, not just their position.
If, for example, you pass to it the current playposition, the function will return the marker as long as the playcursor is behind the marker-graphics.

Returned string will be "Markeridx\npos\nName\nMarkeridx2\npos2\nName2\n...".
Returns only markers, no time markers or regions!

Returnvalues:
 string marker a string with all markernumbers, markerpositions and markertitles, separated by a newline.
Can contain numerous markers, if there are more markers in one position. 

Parameters:
 number position the time-position in seconds 
 boolean retina if the screen-resolution is retina or hidpi, turn this true, else false 


Reaper version 5.40Lua version 5.3 GetRegionByScreenCoordinates

Functioncall:

string markers = ultraschall.GetRegionByScreenCoordinates(integer xmouseposition, boolean retina)

Description:
returns the regions at a given absolute-x-pixel-position. It sees regions according their graphical representation in the arrange-view, not just their position! Returned string will be "Regionidx\npos\nName\nRegionidx2\npos2\nName2\n...".
Returns only regions, no time markers or other markers!

Returnvalues:
 string marker a string with all regionnumbers, regionpositions and regionnames, separated by a newline.
Can contain numerous regions, if there are more regions in one position. 

Parameters:
 integer xmouseposition the absolute x-screen-position, like current mouse-position 
 boolean retina if the screen-resolution is retina or hidpi, turn this true, else false 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetRegionByTime

Functioncall:

string markers = ultraschall.GetRegionByTime(number position, boolean retina)

Description:
returns the regions at a given absolute-x-pixel-position. It sees regions according their graphical representation in the arrange-view, not just their position! Returned string will be "Regionidx\npos\nName\nRegionidx2\npos2\nName2\n...".
Returns only regions, no time markers or other markers!

Returnvalues:
 string marker a string with all regionnumbers, regionpositions and regionnames, separated by a newline.
Can contain numerous regions, if there are more regions in one position. 

Parameters:
 number position position in seconds 
 boolean retina if the screen-resolution is retina or hidpi, turn this true, else false 


Reaper version 5.40Lua version 5.3 GetTimesignaturesByScreenCoordinates

Functioncall:

string markers = ultraschall.GetTimesignaturesByScreenCoordinates(integer xmouseposition, boolean retina)

Description:
returns the time-signature/tempo-marker at a given absolute-x-pixel-position. It sees time-signature/tempo-markers according their graphical representation in the arrange-view, not just their position! Returned string will be "tempomarkeridx\npos\ntempomarkeridx2\npos2\n...".
Returns only time-signature-markers, no regions or other markers!

Returnvalues:
 string marker a string with all markernumbers and markerpositions, separated by a newline.
Can contain numerous markers, if there are more markers in one position. 

Parameters:
 integer xmouseposition the absolute x-screen-position, like current mouse-position 
 boolean retina if the screen-resolution is retina or hidpi, turn this true, else false 


Reaper version 5.40SWS version 2.8.8Lua version 5.3 GetTimeSignaturesByTime

Functioncall:

string markers = ultraschall.GetTimeSignaturesByTime(number position, boolean retina)

Description:
returns the time-signature/tempo-marker at a given absolute-x-pixel-position. It sees time-signature/tempo-markers according their graphical representation in the arrange-view, not just their position! Returned string will be "tempomarkeridx\npos\ntempomarkeridx2\npos2\n...".
Returns only time-signature-markers, no other markers or regions!

Returnvalues:
 string marker a string with all markernumbers and markerpositions, separated by a newline.
Can contain numerous markers, if there are more markers in one position. 

Parameters:
 number position position in seconds 
 boolean retina if the screen-resolution is retina or hidpi, turn this true, else false 


Reaper version 5.40Lua version 5.3 IsMarkerEdit

Functioncall:

boolean retval = ultraschall.IsMarkerEdit(integer markerid)

Description:
returns true, if the marker is an edit-marker, false if not. Returns nil, if markerid is invalid.
Markerid is the marker-number for all markers, as used by marker-functions from Reaper.

Returnvalues:
 boolean retval true, if it's an edit-marker, false if not 

Parameters:
 integer markerid the markerid of all markers in the project, beginning with 0 for the first marker 


Reaper version 5.40Lua version 5.3 IsMarkerNormal

Functioncall:

boolean retval = ultraschall.IsMarkerNormal(integer markerid)

Description:
returns true, if the marker is a normal-marker, false if not. Returns nil, if markerid is invalid.
Markerid is the marker-number for all markers, as used by marker-functions from Reaper.

Returnvalues:
 boolean retval true, if it's an normal-marker, false if not 

Parameters:
 integer markerid the markerid of all markers in the project, beginning with 0 for the first marker 


Reaper version 5.40Lua version 5.3 IsRegionPodrange

Functioncall:

boolean retval = ultraschall.IsRegionPodrange(integer markerid)

Description:
returns true, if the marker is a Podrange-region, false if not. Returns nil, if markerid is invalid.
Markerid is the marker-number for all markers, as used by marker-functions from Reaper.

Returnvalues:
 boolean retval true, if it's a PodRange-Region, false if not 

Parameters:
 integer markerid the markerid of all markers in the project, beginning with 0 for the first marker 


Reaper version 5.40Lua version 5.3 IsRegionEditRegion

Functioncall:

boolean retval = ultraschall.IsRegionEditRegion(integer markerid)

Description:
returns true, if the marker is an Edit-region, false if not. Returns nil, if markerid is invalid.
Markerid is the marker-number for all markers, as used by marker-functions from Reaper.

Returnvalues:
 boolean retval true, if it's an Edit-Region, false if not 

Parameters:
 integer markerid the markerid of all markers in the project, beginning with 0 for the first marker 


Reaper version 5.40Lua version 5.3 AddEditRegion

Functioncall:

integer markernr = ultraschall.AddEditRegion(number startposition, number endposition, string text)

Description:
Adds a new edit-region and returns index of the newly created edit-marker-region.


Returnvalues:
 integer markernr the number of the newly created region 

Parameters:
 number startposition startposition in seconds 
 number endposition endposition in seconds 
 string text the title of the marker 


Reaper version 5.40Lua version 5.3 SetEditRegion

Functioncall:

boolean retval = ultraschall.SetEditRegion(integer number, number position, number endposition, string edittitle)

Description:
Sets the values of an already existing edit-region. To retain an already set position, endposition and/or edittitle, use nil.
Returns true in case of success, false if not.
Note: if you set the new beginning of the region before another region, the indexnumber of the edit-region changes. So if you want to set an edit-region repeatedly, you should get the indexnumber using ultraschall.EnumerateEditRegion, or you might accidently change another region!

Returnvalues:
 boolean retval true, in case of success, false if not 

Parameters:
 integer number the number of the edit-region, beginning with 1 for the first edit-region 
 number startposition startposition in seconds, nil to retain the old value 
 number endposition endposition in seconds, nil to retain the old value 
 string text the title of the marker, nil to retain the old value 


Reaper version 5.40Lua version 5.3 DeleteEditRegion

Functioncall:

boolean retval = ultraschall.DeleteEditRegion(integer number)

Description:
Deletes an already existing edit-region.
Returns true in case of success, false if not.

Returnvalues:
 boolean retval true, in case of success, false if not 

Parameters:
 integer number the number of the edit-region, beginning with 1 for the first edit-region 


Reaper version 5.40Lua version 5.3 EnumerateEditRegion

Functioncall:

integer retval, number position, number endposition, string title, integer rgnindexnumber = ultraschall.EnumerateEditRegion(integer number)

Description:
Returns the values of an edit-region.

Returnvalues:
 integer retval the overall marker-index-number of all markers in the project, -1 in case of error 
 number position position in seconds 
 number endposition endposition in seconds 
 string title the title of the region 
 integer rgnindexnumber the overall region index number, as used by other of Reaper's own marker-functions 

Parameters:
 integer number the number of the edit-region, beginning with 1 for the first edit-region 


Reaper version 5.40Lua version 5.3 CountEditRegions

Functioncall:

integer retval = ultraschall.CountEditRegions()

Description:
returns the number of edit-regions in the project.

Returnvalues:
 integer retval the number of edit-regions in the project 



Reaper version 5.40Lua version 5.3 GetKBIniFilepath

Functioncall:

string kb_ini_path = ultraschall.GetKBIniFilepath()

Description:
Returns the path and filename of the Reaper-kb.ini-file.

Returnvalues:
 string kb_ini_path path and filename of the reaper-kb.ini 



Reaper version 5.40Lua version 5.3 CountKBIniActions

Functioncall:

integer actions = ultraschall.CountKBIniActions(string filename_with_path)

Description:
Count the number of "ACT"-Actions of the Reaper-kb.ini-file.
Returns -1, if no such file exists.

Returnvalues:
 integer actions number of actions in the reaper-kb.ini 



Reaper version 5.40Lua version 5.3 CountKBIniScripts

Functioncall:

integer scripts = ultraschall.CountKBIniScripts(string filename_with_path)

Description:
Count the number of "SCR"-Scripts of the Reaper-kb.ini-file.
Returns -1, if no such file exists.

Returnvalues:
 integer scripts number of scripts in the reaper-kb.ini 



Reaper version 5.40Lua version 5.3 CountKBIniKeys

Functioncall:

integer keys = ultraschall.CountKBIniKeys(string filename_with_path)

Description:
Count the number of "KEY"-Keybindings of the Reaper-kb.ini-file.
Returns -1, if no such file exists.

Returnvalues:
 integer keys number of keys in the reaper-kb.ini 



Reaper version 5.40Lua version 5.3 GetKBIniActions

Functioncall:

integer consolidate, integer section, string ActionCommandID, string description, string ActionsToBeExecuted = ultraschall.GetKBIniActions(string filename_with_path, integer idx)

Description:
Get the states of "ACT"-Action number idx. Returns consolidate, section, ActionCommandID, description, ActionsToBeExecuted.
Returns -1, if no such entry or file exists.

Returnvalues:
 integer consolidate consolidate-state
1 consolidate undo points,
2 show in Actions-Menu,
3 consolidate undo points AND show in Actions Menu;
maybe 4 and higher? 

Parameters:
 string filename_with_path path and filename of the reaper-kb.ini 
 integer idx the number of the action to get, beginning with 1 for the first one 


Reaper version 5.40Lua version 5.3 GetKBIniScripts

Functioncall:

integer terminateinstance, integer section, string ActionCommandID, string description, string scriptfile = ultraschall.GetKBIniScripts(string filename_with_path, integer idx)

Description:
Get the states of "SCR"-Scripts number idx. Returns terminateinstance, section, ActionCommandID, description, scriptfile.
Returns -1, if no such entry or file exists.

Returnvalues:
 integer terminateinstance the state of terminating instances
4 - Dialogwindow appears(Terminate, New Instance, Abort), if another instance of a given script is started, that's already running
260 - always Terminate Instances, when an instance of the script is already running
516 - always start a New Instance of the script already running 

Parameters:
 string filename_with_path path and filename of the reaper-kb.ini 
 integer idx the number of the action to get, beginning with 1 for the first one 


Reaper version 5.40Lua version 5.3 GetKBIniKeys

Functioncall:

integer keytype_modifier_midichan, integer key_midinote, string ActionCommandID, integer section = ultraschall.GetKBIniKeys(string filename_with_path, integer idx)

Description:
Get the states of "KEY"-Keybinding-number idx, for MIDI/Key-bindings. Returns keytype_modifier_midichan, key_midinote, ActionCommandID, section.

For a detailed description in how KEY-entries work, refer to Reaper-Filetype-Descriptions.html#Reaper-kb.ini.

Returns -1, if no such entry or file exists.
Doesn't return OSC-bindings!

Returnvalues:
 integer keytype_modifier_midichan Type of Keytype, modifier or midichannel
For a detailed description in how keytype/modifier in KEY-entries work, refer to Reaper-Filetype-Descriptions.html#Reaper-kb.ini
 integer key_midinote the key(like ASCII-Codes) or midinote.
For a detailed description in how key/midinotes in KEY-entries work, refer to Reaper-Filetype-Descriptions.html#Reaper-kb.ini

Parameters:
 string filename_with_path path and filename of the reaper-kb.ini 
 integer idx the number of the action to get, beginning with 1 for the first one 


Reaper version 5.40Lua version 5.3 GetKBIniActionsID_ByActionCommandID

Functioncall:

string retval = ultraschall.GetKBIniActionsID_ByActionCommandID(filename_with_path, ActionCommandID)

Description:
Returns the indexnumber(s) of actions by ActionCommandIDs within a reaper-kb.ini.
Returns -1, if no such entry or file exists.

Returnvalues:
 string retval the ids of actions with ActionCommandID, separated by a , 

Parameters:
 string filename_with_path path and filename of the reaper-kb.ini 
 string ActionCommandID the ActionCommandID 


Reaper version 5.40Lua version 5.3 GetKBIniScripts_ByActionCommandID

Functioncall:

string retval = ultraschall.GetKBIniScripts_ByActionCommandID(filename_with_path, ActionCommandID)

Description:
Returns the indexnumber(s) of scripts by ActionCommandIDs within a reaper-kb.ini.
Returns -1, if no such entry or file exists.

Returnvalues:
 string retval the ids of scripts with ActionCommandID, separated by a , 

Parameters:
 string filename_with_path path and filename of the reaper-kb.ini 
 string ActionCommandID the ActionCommandID 


Reaper version 5.40Lua version 5.3 GetKBIniKeys_ByActionCommandID

Functioncall:

string retval = ultraschall.GetKBIniKeys_ByActionCommandID(filename_with_path, ActionCommandID)

Description:
Returns the indexnumber(s) of keys by ActionCommandIDs within a reaper-kb.ini.
Returns -1, if no such entry or file exists.

Returnvalues:
 string retval the ids of keys with ActionCommandID, separated by a , 

Parameters:
 string filename_with_path path and filename of the reaper-kb.ini 
 string ActionCommandID the ActionCommandID 


Reaper version 5.40Lua version 5.3 ReadFileAsLines_Array

Functioncall:

array contents, boolean correctnumberoflines, integer number_of_lines = ultraschall.ReadFileAsLines_Array(string filename_with_path, integer firstlinenumber, integer lastlinenumber)

Description:
Return contents of filename_with_path, from firstlinenumber to lastlinenumber as an array. Counting of linenumbers starts with 1 for the first line.
The returned array contains all requested lines, which each entry holding one returned line.

Returns nil, if the linenumbers are invalid.

Returnvalues:
 array contents the contents the lines of the file, that you requested as an array, in which each entry hold one line of the file 
 boolean correctnumberoflines true, if the number of lines are returned, as you requested; false if fewer lines are returned 
 integer number_of_lines the number of lines returned 

Parameters:
 string filename_with_path filename of the file to be read 
 integer firstlinenumber the first linenumber to be returned. First line in the file begins with 1! 
 integer lastlinenumber the last linenumber to be returned; -1, read all lines in the file 


Reaper version 5.40Lua version 5.3 SetKBIniActions

Functioncall:

boolean retval, integer actionnumber = ultraschall.SetKBIniActions(string filename_with_path, integer consolidate, integer section, string ActionCommandID, string Description, string ActionCommandIDs, boolean replace)

Description:
Adds or sets(if it already exists) an "ACT"-action of a reaper-kb.ini.
Returns true/false when adding or setting worked/didn't work, as well as the action-number within the reaper-kb.ini

Needs a restart of Reaper for this change to take effect!

Returnvalues:
 boolean retval true, if adding/setting worked, false if it didn't 
 integer actionnumber the entrynumber within the reaper-kb.ini of this action 

Parameters:
 string filename_with_path filename with path for the reaper-kb.ini 
 integer consolidate consolidation state of this action
1 consolidate undo points,
2 show in Actions-Menu,
3 consolidate undo points AND show in Actions Menu;
maybe 4 and higher? 


Reaper version 5.40Lua version 5.3 SetKBIniScripts

Functioncall:

boolean retval, integer scriptnumber = ultraschall.SetKBIniScripts(string filename_with_path, integer terminate, integer section, string ActionCommandID, string Description, string Scriptname, boolean replace)

Description:
Adds or sets(if it already exists) an "SCR"-script of a reaper-kb.ini.
Returns true/false when adding or setting worked/didn't work, as well as the script-number within the reaper-kb.ini

Needs a restart of Reaper for this change to take effect!

Returnvalues:
 boolean retval true, if adding/setting worked, false if it didn't 
 integer scriptnumber the entrynumber within the reaper-kb.ini of this script 

Parameters:
 string filename_with_path filename with path for the reaper-kb.ini 
 integer terminate_state state of handling mulitple running scripts
4 - Dialogwindow appears(Terminate, New Instance, Abort), if another instance of a given script is started, that's already running
260 - always Terminate Instances, when an instance of the script is already running
516 - always start a New Instance of the script already running 


Reaper version 5.40Lua version 5.3 SetKBIniKeys

Functioncall:

boolean retval, integer keynumber = ultraschall.SetKBIniKeys(string filename_with_path, integer keytype_modifier_midichan, integer key_midinote, string ActionCommandID, integer section, boolean replace)

Description:
Adds or sets(if it already exists) a "KEY"-key of a reaper-kb.ini.
Returns true/false when adding or setting worked/didn't work, as well as the keybinding-number within the reaper-kb.ini.
Additional keybindings cannot share the same keytype_modifier_midichan, key_midinote and section at the same time, as every such keybind must be unique.

For a detailed description in how KEY-entries work, refer to Reaper-Filetype-Descriptions.html#Reaper-kb.ini.

Does not support OSC-keybindings!

Needs a restart of Reaper for this change to take effect!

Returnvalues:
 boolean retval true, if adding/setting worked, false if it didn't 
 integer scriptnumber the entrynumber within the reaper-kb.ini of this script 

Parameters:
 string filename_with_path filename with path for the reaper-kb.ini 
 integer keytype_modifier_midichan Type of Keytype, modifier or midichannel
For a detailed description in how keytype/modifier in KEY-entries work, refer to Reaper-Filetype-Descriptions.html#Reaper-kb.ini
 integer key_midinote the key(like ASCII-Codes) or midinote.
For a detailed description in how key/midinotes in KEY-entries work, refer to Reaper-Filetype-Descriptions.html#Reaper-kb.ini
 string ActionCommandID the ActionCommandID associated with this shortcut. 
 integer section the section, in which this shortcut is used
0 - Main
100 - Main (alt recording)
32060 - MIDI Editor
32061 - MIDI Event List Editor
32062 - MIDI Inline Editor
32063 - Media Explorer 


Reaper version 5.40Lua version 5.3 DeleteKBIniActions

Functioncall:

boolean retval = ultraschall.DeleteKBIniActions(string filename_with_path, integer idx)

Description:
Deletes an "ACT"-action of a reaper-kb.ini.
Returns true/false when deleting worked/didn't work.

Needs a restart of Reaper for this change to take effect!

Returnvalues:
 boolean retval true, if deleting worked, false if it didn't 

Parameters:
 string filename_with_path filename with path for the reaper-kb.ini 
 integer idx indexnumber of the action within the reaper-kb.ini 


Reaper version 5.40Lua version 5.3 DeleteKBIniScripts

Functioncall:

boolean retval = ultraschall.DeleteKBIniScripts(string filename_with_path, integer idx)

Description:
Deletes an "SCR"-script of a reaper-kb.ini.
Returns true/false when deleting worked/didn't work.

Needs a restart of Reaper for this change to take effect!

Returnvalues:
 boolean retval true, if deleting worked, false if it didn't 

Parameters:
 string filename_with_path filename with path for the reaper-kb.ini 
 integer idx indexnumber of the script within the reaper-kb.ini 


Reaper version 5.40Lua version 5.3 DeleteKBIniKeys

Functioncall:

boolean retval = ultraschall.DeleteKBIniKeys(string filename_with_path, integer idx)

Description:
Deletes a "KEY"-keybinding of a reaper-kb.ini.
Returns true/false when deleting worked/didn't work.

Needs a restart of Reaper for this change to take effect!

Returnvalues:
 boolean retval true, if deleting worked, false if it didn't 

Parameters:
 string filename_with_path filename with path for the reaper-kb.ini 
 integer idx indexnumber of the keybinding within the reaper-kb.ini 


Reaper version 5.40Lua version 5.3 IsValidProjectStateChunk

Functioncall:

boolean retval = ultraschall.IsValidProjectStateChunk(string ProjectStateChunk)

Description:
Checks, whether ProjectStateChunk is a valid ProjectStateChunk

Returnvalues:
 boolean retval true, if it's a valid ProjectStateChunk; false, if not 

Parameters:
 string ProjectStateChunk the string to check, if it's a valid ProjectStateChunk 


Reaper version 5.40Lua version 5.3 GetProject_ReaperVersion

Functioncall:

string reaperversion, string timestamp = ultraschall.GetProject_ReaperVersion(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the reaperversion and the timestamp from an RPP-Projectfile or a ProjectStateChunk.

It's the entry "<REAPER_PROJECT"

Returns nil in case of error or if no such entry exists.

Returnvalues:
 string reaperversion the version of Reaper, with which this project had been saved 
 string timestamp a timestamp for this project 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderCFG

Functioncall:

string render_cfg = ultraschall.GetProject_RenderCFG(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the render-cfg-string, that contains all render-settings of a project from an RPP-Projectfile or a ProjectStateChunk.

It's the entry <RENDER_CFG

Returns nil in case of error or if no such entry exists.

Returnvalues:
 string render_cfg the renderstring, which contains all render-settings for a project/projectstatechunk 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RippleState

Functioncall:

integer ripplestate = ultraschall.GetProject_RippleState(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the ripple-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry RIPPLE

Returns nil in case of error or if no such entry exists.

Returnvalues:
 integer ripplestate 0, no Ripple; 1, Ripple One Track; 2, Ripple All 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_GroupOverride

Functioncall:

integer group_override1, integer group_override2, integer group_override3 = ultraschall.GetProject_GroupOverride(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the group-override-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry GROUPOVERRIDE

Returns nil in case of error or if no such entry exists.

Returnvalues:
 integer group_override1 the group-override state 
 integer track_group_enabled the track_group_enabled-setting, as set in the context-menu of the Master-Track; 1, checked; 0, unchecked 
 integer group_override3 the group-override state 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_AutoCrossFade

Functioncall:

integer autocrossfade_state = ultraschall.GetProject_AutoCrossFade(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the autocrossfade-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry AUTOXFADE

Returns nil in case of error or if no such entry exists.

Returnvalues:
 integer autocrossfade_state the autocrossfade-state 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 string ProjectStateChunk a ProjectStateChunk to use instead if a filename 


Reaper version 5.40Lua version 5.3 GetProject_EnvAttach

Functioncall:

integer env_attach = ultraschall.GetProject_EnvAttach(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the EnvAttach-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry ENVATTACH

Returns nil in case of error.

Returnvalues:
 integer env_attach the env-attach state 

Parameters:
 string projectfilename_with_path filename with path of the rpp-project-file; nil, use parameter ProjectStateChunk instead 
 string ProjectStateChunk a projectstatechunk to read the value from; only used, projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_MixerUIFlags

Functioncall:

integer state1, integer state2 = ultraschall.GetProject_MixerUIFlags(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the MixerUI-state-flags from an RPP-Projectfile or a ProjectStateChunk.

It's the entry MIXERUIFLAGS

Returns nil in case of error.

Returnvalues:
 integer state1 folders, receives, etc
0 - Show tracks in folders, Auto arrange tracks in mixer
1 - Show normal top level tracks
2 - Show Folders
4 - Group folders to left
8 - Show tracks that have receives
16 - Group tracks that have receives to left
32 - don't show tracks that are in folder
64 - No Autoarrange tracks in mixer
128 - ?
256 - ? 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_PeakGain

Functioncall:

number peakgain_state = ultraschall.GetProject_PeakGain(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the GetProject_PeakGain-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry PEAKGAIN

Returns nil in case of error.

Returnvalues:
 number peakgain_state peakgain-state 

Parameters:
 string projectfilename_with_path filename with path of the rpp-project-file 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_Feedback

Functioncall:

integer feedback_state = ultraschall.GetProject_Feedback(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the GetProject_Feedback-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry FEEDBACK

Returns nil in case of error.

Returnvalues:
 integer feedback_state feedback-state 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_PanLaw

Functioncall:

number panlaw_state = ultraschall.GetProject_PanLaw(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the GetProject_PanLaw-state from an RPP-Projectfile or a ProjectStateChunk, as set in the project-settings->Advanced->Pan law/mode->Pan:law(db).

It's the entry PANLAW

Returns nil in case of error.

Returnvalues:
 number panlaw_state state of the panlaw, as set in the project-settings->Advanced->Pan law/mode->Pan:law(db). 0.5(-6.02 db) to 1(default +0.0 db) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.941Lua version 5.3 GetProject_ProjOffsets

Functioncall:

number start_time, integer start_measure, integer base_ruler_marking_off_this_measure = ultraschall.GetProject_ProjOffsets(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the Project Offset-state from an RPP-Projectfile or a ProjectStateChunk, start time as well as start measure.
as set in ProjectSettings->ProjectSettings->Project Start Time/Measure and the checkbox Base Ruler Marking Off This Measure-checkbox

It's the entry PROJOFFS

Returns nil in case of error.

Returnvalues:
 number start_time the project-start-time in seconds 
 integer start_measure starting with 0, unlike the Settingswindow, where the 0 becomes 1 as measure 
 integer base_ruler_marking_off_this_measure 0, checkbox unchecked; 1, checkbox checked 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_MaxProjectLength

Functioncall:

integer limit_project_length, number projectlength_limit = ultraschall.GetProject_MaxProjectLength(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the maximum-project-length from an RPP-Projectfile or a ProjectStateChunk, as set in ProjectSettings->Advanced->
as set in ProjectSettings->ProjectSettings->Project Start Time/Measure.

It's the entry MAXPROJLEN

Returns nil in case of error.

Returnvalues:
 integer limit_project_length checkbox "Limit project length, stop playback/recording at:" - 0 off, 1 on 
 number projectlength_limit projectlength-limit in seconds 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_Grid

Functioncall:

integer gridstate1, integer gridstate2, number gridstate3, integer gridstate4, number gridstate5, integer gridstate6, integer gridstate7, number gridstate8 = ultraschall.GetProject_Grid(string projectfilename_with_path)

Description:
Returns the grid-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry GRID

Returns nil in case of error.

Returnvalues:
 integer gridstate1 gridstate1 
 integer gridstate2 gridstate2 
 number gridstate3 gridstate3 
 integer gridstate4 gridstate4 
 number gridstate5 gridstate5 
 integer gridstate6 gridstate6 
 integer gridstate7 gridstate7 
 number gridstate8 gridstate8 

Parameters:
 string projectfilename_with_path filename with path of the rpp-project-file 


Reaper version 5.40Lua version 5.3 GetProject_Timemode

Functioncall:

integer ruler_timemode, integer timemode2, integer showntime, integer timemode4, integer timemode5 = ultraschall.GetProject_Timemode(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the timemode-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry TIMEMODE

Returns nil in case of error.

Returnvalues:
 integer ruler_timemode ruler-timemode-state
-1, Use ruler time unit
  0, Minutes:Seconds
  1, Measures.Beats / Minutes:Seconds
  2, Measures.Beats
  3, Seconds
  4, Samples
  5, Hours:Minutes:Seconds:Frames
  8, Absolute Frames 
 integer timemode2 timemode-state 
 integer showntime Transport shown time
      -1 - use ruler time unit
       0 - minutes:seconds
       1 - measures:beats/minutes:seconds
       2 - measures:beats
       3 - seconds
       4 - samples
       5 - hours:minutes:seconds:frames
       8 - absolute frames 
 integer timemode4 timemode-state 
 integer timemode5 timemode-state 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_VideoConfig

Functioncall:

integer preferredVidSizeX, integer preferredVidSizeY, integer settingsflags = ultraschall.GetProject_VideoConfig(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the videoconfig-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry VIDEO_CONFIG

Returns nil in case of error.

Returnvalues:
 integer preferredVidSizeX preferred video size, x pixels 
 integer preferredVidSizeY preferred video size, y pixels 
 integer settingsflags settings
             0 - turned on/selected: use high quality filtering, preserve aspect ratio(letterbox) when resizing,
                                     Video colorspace set to Auto,
                                     Items in higher numbered tracks replace lower, as well as Video colorspace set to Auto
             1 - Video colorspace: I420/YV12
             2 - Video colorspace: YUV2
             3 - RGB
             256 - Items in lower numbered tracks replace higher
             512 - Always resize video sources to preferred video size
             1024 - Always resize output to preferred video size
             2048 - turn off "Use high quality filtering when resizing"
             4096 - turn off "preserve aspect ratio (letterbox) when resizing" 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_PanMode

Functioncall:

integer panmode_state = ultraschall.GetProject_PanMode(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the panmode-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry PANMODE

Returns nil in case of error.

Returnvalues:
 integer panmode_state panmode-state
0 reaper 3.x balance (deprecated)
3 Stereo balance / mono pan (default)
5 Stereo pan
6 Dual Pan 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_CursorPos

Functioncall:

number cursorpos = ultraschall.GetProject_CursorPos(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the cursorposition-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry CURSOR

Returns nil in case of error.

Returnvalues:
 number cursorpos editcursorposition in seconds 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_HorizontalZoom

Functioncall:

number hzoom, integer hzoomscrollpos, integer scrollbarfactor = ultraschall.GetProject_HorizontalZoom(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the horizontal-zoom-state from an RPP-Projectfile or a ProjectStateChunk.
Keep in mind, that hzoomscrollpos and scrollbarfactor depend on each other. hzoomscrollpos is a smaller positioning-unit, while scrollbarfactor is the bigger positioning-unit.
Experiment with it to get an idea.

It's the entry ZOOM

Returns nil in case of error.

Returnvalues:
 number hzoom HorizontalZoomfactor, 0.007 to 1000000 
 integer hzoomscrollpos horizontalscrollbarposition - 0 - 4294967296 
 integer scrollbarfactor 0 to 500837, counts up, when maximum hzoomscrollpos overflows 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_VerticalZoom

Functioncall:

integer vzoom = ultraschall.GetProject_VerticalZoom(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the verticalzoom from an RPP-Projectfile or a ProjectStateChunk.

It's the entry VZOOMEX

Returns nil in case of error.

Returnvalues:
 integer vzoom vertical zoomfactor(0-40) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_UseRecConfig

Functioncall:

integer rec_cfg = ultraschall.GetProject_UseRecConfig(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the rec-cfg-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry USE_REC_CFG

Returns nil in case of error.

Returnvalues:
 integer rec_cfg recording-cfg-state
0 - Automatic .wav (recommended)
1 - Custom (use ultraschall.GetProject_ApplyFXCFG to get recording_cfg_string)
2 - Recording Format 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RecMode

Functioncall:

integer rec_mode = ultraschall.GetProject_RecMode(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the rec-mode-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry RECMODE

Returns nil in case of error.

Returnvalues:
 integer rec_mode recording-mode-state
0 - Autopunch/Selected Items
1 - normal
2 - Time Selection/Auto Punch 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_SMPTESync

Functioncall:

integer smptesync_state1, number smptesync_fps, integer smptesync_resyncdrift, integer smptesync_skipdropframes, integer smptesync_syncseek, integer smptesync_freewheel, integer smptesync_userinput, number smptesync_offsettimecode, integer smptesync_stop_rec_drift, integer smptesync_state10, integer smptesync_stop_rec_lacktime = ultraschall.GetProject_SMPTESync(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the smpte-sync-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry SMPTESYNC

Returns nil in case of error.

Returnvalues:
 integer smptesync_state1 flag
0 - external timecode synchronization disabled
1 - external timecode synchronization enabled
4 - Start playback on valid timecode when stopped
8 - turned off: display flashing notification window when waiting for sync for recording
16 - playback off
32 - recording off
256 - MTC - 24/30fps MTC is 23.976/29.97ND works only with smptesync_userinput set to 4159
512 - MTC - 24/30fps MTC is 24/30ND 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_Loop

Functioncall:

integer loopbutton_state = ultraschall.GetProject_Loop(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the loop-button-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry LOOP

Returns nil in case of error.

Returnvalues:
 integer loop_mode loopbutton-state, 0 - off, 1 - on 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_LoopGran

Functioncall:

integer loopgran_state1, number loopgran_state2 = ultraschall.GetProject_LoopGran(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the loop_gran-state from an RPP-Projectfile or a ProjectStateChunk.

It's the entry LOOPGRAN

Returns nil in case of error.

Returnvalues:
 integer loopgran_state1 loopgran_state1 
 number loopgran_state2 loopgran_state2 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RecPath

Functioncall:

string prim_recpath, string sec_recpath = ultraschall.GetProject_RecPath(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the primary and secondary recording-path from an RPP-Projectfile or a ProjectStateChunk.

It's the entry RECORD_PATH

Returns nil in case of error.

Returnvalues:
 string prim_recpath the primary recording path 
 string sec_recpath the secondary recording path 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RecordCFG

Functioncall:

string recording_cfg_string = ultraschall.GetProject_RecordCFG(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the recording-configuration as encoded BASE64-string from an RPP-Projectfile or a ProjectStateChunk, as set in ProjectSettings->Media->Recording.

It's the entry <RECORD_CFG

Returns nil in case of error.

Returnvalues:
 recording_cfg_string the record-configuration as encoded string 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_ApplyFXCFG

Functioncall:

string applyfx_cfg_string = ultraschall.GetProject_ApplyFXCFG(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the audioformat-configuration, for fx-appliance-operation, as an encoded BASE64-string from an RPP-Projectfile or a ProjectStateChunk, as set in ProjectSettings->Media->Format for Apply FX, Glue, Freeze, etc

It's the entry <APPLY_CFG

Returns nil in case of error.

Returnvalues:
 string applyfx_cfg_string the file-format-configuration for fx-appliance as encoded string 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderFilename

Functioncall:

string render_filename = ultraschall.GetProject_RenderFilename(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the render-filename from an RPP-Projectfile or a ProjectStateChunk. If it contains only a path or nothing, you should check the Render_Pattern using GetProject_RenderPattern, as a render-pattern influences the rendering-filename as well.

It's the entry RENDER_FILE

Returns nil in case of error.

Returnvalues:
 string render_filename the filename for rendering, check also GetProject_RenderPattern 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderPattern

Functioncall:

string render_pattern = ultraschall.GetProject_RenderPattern(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the render-pattern, that tells Reaper, how to automatically name the render-file, from an RPP-Projectfile or a ProjectStateChunk. If it contains nothing, you should check the Render_Pattern using GetProject_RenderFilename, as a render-pattern influences the rendering-filename as well.

It's the entry RENDER_PATTERN

Returns nil in case of error.

Returnvalues:
 string render_pattern the pattern, with which the rendering-filename will be automatically created. Check also GetProject_RenderFilename
   Capitalizing the first character of the wildcard will capitalize the first letter of the substitution.
    Capitalizing the first two characters of the wildcard will capitalize all letters.

    Directories will be created if necessary. For example if the render target is "$project/track", the directory "$project" will be created.

$item    media item take name, if the input is a media item
$itemnumber  1 for the first media item on a track, 2 for the second...
$track    track name
$tracknumber  1 for the first track, 2 for the second...
$parenttrack  parent track name
$region    region name
$regionnumber  1 for the first region, 2 for the second...
$namecount  1 for the first item or region of the same name, 2 for the second...
$start    start time of the media item, render region, or time selection
$end    end time of the media item, render region, or time selection
$startbeats  start time in beats of the media item, render region, or time selection
$endbeats  end time in beats of the media item, render region, or time selection
$timelineorder  1 for the first item or region on the timeline, 2 for the second...
$project    project name
$tempo    project tempo at the start of the render region
$timesignature  project time signature at the start of the render region, formatted as 4-4
$filenumber  blank (optionally 1) for the first file rendered, 1 (optionally 2) for the second...
$filenumber[N]  N for the first file rendered, N+1 for the second...
$note    C0 for the first file rendered,C#0 for the second...
$note[X]    X (example: B2) for the first file rendered, X+1 (example: C3) for the second...
$natural    C0 for the first file rendered, D0 for the second...
$natural[X]  X (example: F2) for the first file rendered, X+1 (example: G2) for the second...
$format    render format (example: wav)
$samplerate  sample rate (example: 44100)
$sampleratek  sample rate (example: 44.1)
$year    year
$year2    last 2 digits of the year
$month    month number
$monthname  month name
$day    day of the month
$hour    hour of the day in 24-hour format
$hour12    hour of the day in 12-hour format
$ampm    am if before noon,pm if after noon
$minute    minute of the hour
$second    second of the minute
$user    user name
$computer  computer name

(this description has been taken from the Render Wildcard Help within the Render-Dialog of Reaper) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderFreqNChans

Functioncall:

integer unknown, integer rendernum_chans, integer render_frequency = ultraschall.GetProject_RenderFreqNChans(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns an unknown number, the render-frequency and rendernumber of channels from an RPP-Projectfile or a ProjectStateChunk.
It's the entry RENDER_FMT

Returns nil in case of error.

Returnvalues:
 integer unknown unknown number 
 integer rendernum_chans Number_Channels 0-seems default-project-settings(?), 1-Mono, 2-Stereo, ... up to 64 channels 
 integer render_frequency RenderFrequency -2147483647 to 2147483647, except 0, which seems to be default-project-settings-frequency 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderSpeed

Functioncall:

integer render_speed = ultraschall.GetProject_RenderSpeed(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the rendering-speed from an RPP-Projectfile or a ProjectStateChunk.
It's the entry RENDER_1X

Returns nil in case of error.

Returnvalues:
 integer render_speed render_speed
0-Fullspeed Offline
1-1x Offline
2-Online Render
3-Offline Render (Idle)
4-1x Offline Render (Idle) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderRange

Functioncall:

integer bounds, number time_start, number time_end, integer tail, integer tail_length = ultraschall.GetProject_RenderRange(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the render-range, render-timestart, render-timeend, render-tail and render-taillength from an RPP-Projectfile or a ProjectStateChunk. To get RENDER_STEMS, refer GetProject_RenderStems

It's the entry RENDER_RANGE

Returns nil in case of error.

Returnvalues:
 integer bounds the bounds of the project to be rendered
0 Custom Time Range
1 Entire Project
2 Time Selection,
3 Project Regions
4 Selected Media Items(in combination with RENDER_STEMS 32); to get RENDER_STEMS, refer GetProject_RenderStems 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderResample

Functioncall:

integer resample_mode, integer playback_resample_mode, integer project_smplrate4mix_and_fx = ultraschall.GetProject_RenderResample(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns Resamplemode for a)Rendering and b)Playback as well as c)if both are combined from an RPP-Projectfile or a ProjectStateChunk.

It's the entry RENDER_RESAMPLE

Returns nil in case of error.

Returnvalues:
 integer resample_mode Resample_Mode
0-medium (64pt Sinc),
1-Low (Linear Interpolation),
2-Lowest (Point Sampling),
3-Good(192pt Sinc),
4-Better(384pt Sinc),
5-Fast (IIR + Linear Interpolation),
6-Fast (IIRx2 + Linear Interpolation),
7-Fast (16pt sinc) - Default,
8-HQ (512pt Sinc),
9-Extreme HQ (768pt HQ Sinc) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_AddMediaToProjectAfterRender

Functioncall:

integer addmedia_after_render_state = ultraschall.GetProject_AddMediaToProjectAfterRender(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns, if rendered media shall be added to the project afterwards, from an RPP-Projectfile or a ProjectStateChunk.
It's the entry RENDER_ADDTOPROJ

Returns nil in case of error.

Returnvalues:
 integer addmedia_after_render_state 1, rendered media shall be added to the project afterwards; 0, don't add 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderStems

Functioncall:

integer render_stems = ultraschall.GetProject_RenderStems(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the render-stems-state from an rpp-project-file or a ProjectStateChunk.

It's the entry RENDER_STEMS

Returns nil in case of error.

Returnvalues:
 integer render_stems the state of Render Stems
0 - Source Master Mix,
1 - Source Master mix + stems,
3 - Source Stems, selected tracks,
4 - Multichannel Tracks to Multichannel Files,
8 - Source Region Render Matrix,
16 - Tracks with only Mono-Media to Mono Files,  
32 Selected Media Items(in combination with RENDER_RANGE->Bounds->4, refer to GetProject_RenderRange to get RENDER_RANGE) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_RenderDitherState

Functioncall:

integer renderdither_state = ultraschall.GetProject_RenderDitherState(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the render-dither-state from an rpp-project-file or a ProjectStateChunk.

It's the entry RENDER_DITHER

Returns nil in case of error.

Returnvalues:
 integer renderdither_state the state of render dithering
0 - Dither Master Mix,
1 - Don't Dither Master Mix,
2 - Noise-shaping On Master Mix,
3 - Dither And Noiseshape Master Mix 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_TimeBase

Functioncall:

integer timebase = ultraschall.GetProject_TimeBase(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the timebase-state from an rpp-project-file or a ProjectStateChunk.
It's the entry TIMELOCKMODE x

Returns nil in case of error.

Returnvalues:
 integer timebase the timebase for items/envelopes/markers as set in the project settings
0 - Time,
1 - Beats (position, length, rate),
2 - Beats (position only) 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_TempoTimeSignature

Functioncall:

integer tempotimesignature = ultraschall.GetProject_TempoTimeSignature(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the timebase for tempo/time-signature as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
It's the entry TEMPOENVLOCKMODE

Returns nil in case of error.

Returnvalues:
 integer tempotimesignature the timebase for tempo/time-signature as set in the project settings
0 - Time
1 - Beats 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_ItemMixBehavior

Functioncall:

integer item_mix_behav_state = ultraschall.GetProject_ItemMixBehavior(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the item mix behavior, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
It's the entry ITEMMIX

Returns nil in case of error.

Returnvalues:
 integer item_mix_behav_state item mix behavior
0 - Enclosed items replace enclosing items
1 - Items always mix
2 - Items always replace earlier items 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.77Lua version 5.3 GetProject_DefPitchMode

Functioncall:

integer def_pitch_mode_state = ultraschall.GetProject_DefPitchMode(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the default-pitch-mode, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.

It's the entry DEFPITCHMODE

Returns nil in case of error.

Returnvalues:
 integer def_pitch_mode_state the default pitch mode
      0 - Soundtouch(Default)
      1 - Soundtouch(High Quality)
      2 - Soundtouch(Fast)
      131072 - Simple Windowed(fast) (50ms window, 25ms fade)
      131073 - Simple Windowed(fast) (50ms window, 16ms fade)
      131074 - Simple Windowed(fast) (50ms window, 10ms fade)
      131075 - Simple Windowed(fast) (50ms window, 7ms fade)
      131076 - Simple Windowed(fast) (75ms window, 37ms fade)
      131077 - Simple Windowed(fast) (75ms window, 25ms fade)
      131078 - Simple Windowed(fast) (75ms window, 15ms fade)
      131079 - Simple Windowed(fast) (75ms window, 10ms fade)
      131080 - Simple Windowed(fast) (100ms window, 50ms fade)
      131081 - Simple Windowed(fast) (100ms window, 33ms fade)
      131082 - Simple Windowed(fast) (100ms window, 20ms fade)
      131083 - Simple Windowed(fast) (100ms window, 14ms fade)
      131084 - Simple Windowed(fast) (150ms window, 75ms fade)
      131085 - Simple Windowed(fast) (150ms window, 50ms fade)
      131086 - Simple Windowed(fast) (150ms window, 30ms fade)
      131087 - Simple Windowed(fast) (150ms window, 21ms fade)
      131088 - Simple Windowed(fast) (225ms window, 112ms fade)
      131089 - Simple Windowed(fast) (225ms window, 75ms fade)
      131090 - Simple Windowed(fast) (225ms window, 45ms fade)
      131091 - Simple Windowed(fast) (225ms window, 32ms fade)
      131092 - Simple Windowed(fast) (300ms window, 150ms fade)
      131093 - Simple Windowed(fast) (300ms window, 100ms fade)
      131094 - Simple Windowed(fast) (300ms window, 60ms fade)
      131095 - Simple Windowed(fast) (300ms window, 42ms fade)
      131096 - Simple Windowed(fast) (40ms window, 20ms fade)
      131097 - Simple Windowed(fast) (40ms window, 13ms fade)
      131098 - Simple Windowed(fast) (40ms window, 8ms fade)
      131099 - Simple Windowed(fast) (40ms window, 5ms fade)
      131100 - Simple Windowed(fast) (30ms window, 15ms fade)
      131101 - Simple Windowed(fast) (30ms window, 10ms fade)
      131102 - Simple Windowed(fast) (30ms window, 6s fade)
      131103 - Simple Windowed(fast) (30ms window, 4ms fade)
      131104 - Simple Windowed(fast) (20ms window, 10ms fade)
      131105 - Simple Windowed(fast) (20ms window, 6ms fade)
      131106 - Simple Windowed(fast) (20ms window, 4ms fade)
      131107 - Simple Windowed(fast) (20ms window, 2ms fade)
      131108 - Simple Windowed(fast) (10ms window, 5ms fade)
      131109 - Simple Windowed(fast) (10ms window, 3ms fade)
      131110 - Simple Windowed(fast) (10ms window, 2ms fade)
      131111 - Simple Windowed(fast) (10ms window, 1ms fade)
      131112 - Simple Windowed(fast) (5ms window, 2ms fade)
      131113 - Simple Windowed(fast) (5ms window, 1ms fade)
      131114 - Simple Windowed(fast) (5ms window, 1ms fade)
      131115 - Simple Windowed(fast) (5ms window, 1ms fade)
      131116 - Simple Windowed(fast) (3ms window, 1ms fade)
      131117 - Simple Windowed(fast) (3ms window, 1ms fade)
      131118 - Simple Windowed(fast) (3ms window, 1ms fade)
      131119 - Simple Windowed(fast) (3ms window, 1ms fade)
      393216 - elastique 2.28 Pro Normal
      393217 - elastique 2.28 Pro Preserve Formants(Lowest Pitches)
      393218 - elastique 2.28 Pro Preserve Formants(Lower Pitches)
      393219 - elastique 2.28 Pro Preserve Formants(Low Pitches)
      393220 - elastique 2.28 Pro Preserve Formants(Most Pitches)
      393221 - elastique 2.28 Pro Preserve Formants(High Pitches)
      393222 - elastique 2.28 Pro Preserve Formants(Higher Pitches)
      393223 - elastique 2.28 Pro Preserve Formants(Highest Pitches)
      393224 - elastique 2.28 Pro Mid/Side
      393225 - elastique 2.28 Pro Mid/Side, Preserve Formants(Lowest Pitches)
      393226 - elastique 2.28 Pro Mid/Side, Preserve Formants(Lower Pitches)
      393227 - elastique 2.28 Pro Mid/Side, Preserve Formants(Low Pitches)
      393228 - elastique 2.28 Pro Mid/Side, Preserve Formants(Most Pitches)
      393229 - elastique 2.28 Pro Mid/Side, Preserve Formants(High Pitches)
      393230 - elastique 2.28 Pro Mid/Side, Preserve Formants(Higher Pitches)
      393231 - elastique 2.28 Pro Mid/Side, Preserve Formants(Highest Pitches)
      393232 - elastique 2.28 Pro Synchronized: Normal
      393233 - elastique 2.28 Pro Synchronized: Preserve Formants(Lowest Pitches)
      393234 - elastique 2.28 Pro Synchronized: Preserve Formants(Lower Pitches)
      393235 - elastique 2.28 Pro Synchronized: Preserve Formants(Low Pitches)
      393236 - elastique 2.28 Pro Synchronized: Preserve Formants(Most Pitches)
      393237 - elastique 2.28 Pro Synchronized: Preserve Formants(High Pitches)
      393238 - elastique 2.28 Pro Synchronized: Preserve Formants(Higher Pitches)
      393239 - elastique 2.28 Pro Synchronized: Preserve Formants(Highest Pitches)
      393240 - elastique 2.28 Pro Synchronized: Mid/Side
      393241 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Lowest Pitches)
      393242 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Lower Pitches)
      393243 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Low Pitches)
      393244 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Most Pitches)
      393245 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(High Pitches)
      393246 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Higher Pitches)
      393247 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Highest Pitches)
      458752 - elastique 2.28 Efficient Normal
      458753 - elastique 2.28 Efficient Mid/Side
      458754 - elastique 2.28 Efficient Synchronized: Normal
      458755 - elastique 2.28 Efficient Synchronized: Mid/Side
      524288 - elastique 2.28 Soloist Monophonic
      524289 - elastique 2.28 Soloist Monophonic [Mid/Side]
      524290 - elastique 2.28 Soloist Speech
      524291 - elastique 2.28 Soloist Speech [Mid/Side]
      589824 - elastique 3.2.3 Pro Normal
      589825 - elastique 3.2.3 Pro Preserve Formants(Lowest Pitches)
      589826 - elastique 3.2.3 Pro Preserve Formants(Lower Pitches)
      589827 - elastique 3.2.3 Pro Preserve Formants(Low Pitches)
      589828 - elastique 3.2.3 Pro Preserve Formants(Most Pitches)
      589829 - elastique 3.2.3 Pro Preserve Formants(High Pitches)
      589830 - elastique 3.2.3 Pro Preserve Formants(Higher Pitches)
      589831 - elastique 3.2.3 Pro Preserve Formants(Highest Pitches)
      589832 - elastique 3.2.3 Pro Mid/Side
      589833 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Lowest Pitches)
      589834 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Lower Pitches)
      589835 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Low Pitches)
      589836 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Most Pitches)
      589837 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(High Pitches)
      589838 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Higher Pitches)
      589839 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Highest Pitches)
      589840 - elastique 3.2.3 Pro Synchronized: Normal
      589841 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Lowest Pitches)
      589842 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Lower Pitches)
      589843 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Low Pitches)
      589844 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Most Pitches)
      589845 - elastique 3.2.3 Pro Synchronized: Preserve Formants(High Pitches)
      589846 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Higher Pitches)
      589847 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Highest Pitches)
      589848 - elastique 3.2.3 Pro Synchronized: Mid/Side
      589849 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Lowest Pitches)
      589850 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Lower Pitches)
      589851 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Low Pitches)
      589852 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Most Pitches)
      589853 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(High Pitches)
      589853 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Higher Pitches)
      589855 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Highest Pitches)
      655360 - elastique 3.2.3 Efficient Normal
      655361 - elastique 3.2.3 Efficient Mid/Side
      655362 - elastique 3.2.3 Efficient Synchronized: Normal
      655363 - elastique 3.2.3 Efficient Synchronized: Mid/Side
      720896 - elastique 3.2.3 Soloist (Monophonic)
      720897 - elastique 3.2.3 Soloist (Monophonic Mid Side)
      720898 - elastique 3.2.3 Soloist (Speech)
      720898 - elastique 3.2.3 Soloist (Monophonic Mid Side)

      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Fast, Window: Standard
      851968 - nothing
      851969 - Preserve Formants
      851970 - Mid/Side
      851971 - Preserve Formants (Mid Side)
      851972 - Independent Phase
      851973 - Preserve Formants, Independent Phase
      851974 - Mid/Side, Independent Phase
      851975 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Fast, Window: Standard
      851984 - nothing
      851985 - Preserve Formants
      851986 - Mid/Side
      851987 - Preserve Formants (Mid Side)
      851988 - Independent Phase
      851989 - Preserve Formants, Independent Phase
      851990 - Mid/Side, Independent Phase
      851991 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Fast, Window: Standard
      852000 - nothing
      852001 - Preserve Formants
      852002 - Mid/Side
      852003 - Preserve Formants (Mid Side)
      852004 - Independent Phase
      852005 - Preserve Formants, Independent Phase
      852006 - Mid/Side, Independent Phase
      852007 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Fast, Window: Standard
      852016 - nothing
      852017 - Preserve Formants
      852018 - Mid/Side
      852019 - Preserve Formants (Mid Side)
      852020 - Independent Phase
      852021 - Preserve Formants, Independent Phase
      852022 - Mid/Side, Independent Phase
      852023 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Fast, Window: Standard
      852032 - nothing
      852033 - Preserve Formants
      852034 - Mid/Side
      852035 - Preserve Formants (Mid Side)
      852036 - Independent Phase
      852037 - Preserve Formants, Independent Phase
      852038 - Mid/Side, Independent Phase
      852039 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Fast, Window: Standard
      852048 - nothing
      852049 - Preserve Formants
      852050 - Mid/Side
      852051 - Preserve Formants (Mid Side)
      852052 - Independent Phase
      852053 - Preserve Formants, Independent Phase
      852054 - Mid/Side, Independent Phase
      852055 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Fast, Window: Standard
      852064 - nothing
      852065 - Preserve Formants
      852066 - Mid/Side
      852067 - Preserve Formants (Mid Side)
      852068 - Independent Phase
      852069 - Preserve Formants, Independent Phase
      852070 - Mid/Side, Independent Phase
      852071 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Fast, Window: Standard
      852080 - nothing
      852081 - Preserve Formants
      852082 - Mid/Side
      852083 - Preserve Formants (Mid Side)
      852084 - Independent Phase
      852085 - Preserve Formants, Independent Phase
      852086 - Mid/Side, Independent Phase
      852087 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Fast, Window: Standard
      852096 - nothing
      852097 - Preserve Formants
      852098 - Mid/Side
      852099 - Preserve Formants (Mid Side)
      852100 - Independent Phase
      852101 - Preserve Formants, Independent Phase
      852102 - Mid/Side, Independent Phase
      852103 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: HighQ, Window: Standard
      852112 - nothing
      852113 - Preserve Formants
      852114 - Mid/Side
      852115 - Preserve Formants (Mid Side)
      852116 - Independent Phase
      852117 - Preserve Formants, Independent Phase
      852118 - Mid/Side, Independent Phase
      852119 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: HighQ, Window: Standard
      852128 - nothing
      852129 - Preserve Formants
      852130 - Mid/Side
      852131 - Preserve Formants (Mid Side)
      852132 - Independent Phase
      852133 - Preserve Formants, Independent Phase
      852134 - Mid/Side, Independent Phase
      852135 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: HighQ, Window: Standard
      852144 - nothing
      852145 - Preserve Formants
      852146 - Mid/Side
      852147 - Preserve Formants (Mid Side)
      852148 - Independent Phase
      852149 - Preserve Formants, Independent Phase
      852150 - Mid/Side, Independent Phase
      852151 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: HighQ, Window: Standard
      852160 - nothing
      852161 - Preserve Formants
      852162 - Mid/Side
      852163 - Preserve Formants (Mid Side)
      852164 - Independent Phase
      852165 - Preserve Formants, Independent Phase
      852166 - Mid/Side, Independent Phase
      852167 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: HighQ, Window: Standard
      852176 - nothing
      852177 - Preserve Formants
      852178 - Mid/Side
      852179 - Preserve Formants (Mid Side)
      852180 - Independent Phase
      852181 - Preserve Formants, Independent Phase
      852182 - Mid/Side, Independent Phase
      852183 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: HighQ, Window: Standard
      852192 - nothing
      852193 - Preserve Formants
      852194 - Mid/Side
      852195 - Preserve Formants (Mid Side)
      852196 - Independent Phase
      852197 - Preserve Formants, Independent Phase
      852198 - Mid/Side, Independent Phase
      852199 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: HighQ, Window: Standard
      852208 - nothing
      852209 - Preserve Formants
      852210 - Mid/Side
      852211 - Preserve Formants (Mid Side)
      852212 - Independent Phase
      852213 - Preserve Formants, Independent Phase
      852214 - Mid/Side, Independent Phase
      852215 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: HighQ, Window: Standard
      852224 - nothing
      852225 - Preserve Formants
      852226 - Mid/Side
      852227 - Preserve Formants (Mid Side)
      852228 - Independent Phase
      852229 - Preserve Formants, Independent Phase
      852230 - Mid/Side, Independent Phase
      852231 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: HighQ, Window: Standard
      852240 - nothing
      852241 - Preserve Formants
      852242 - Mid/Side
      852243 - Preserve Formants (Mid Side)
      852244 - Independent Phase
      852245 - Preserve Formants, Independent Phase
      852246 - Mid/Side, Independent Phase
      852247 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Consistent, Window: Standard
      852256 - nothing
      852257 - Preserve Formants
      852258 - Mid/Side
      852259 - Preserve Formants (Mid Side)
      852260 - Independent Phase
      852261 - Preserve Formants, Independent Phase
      852262 - Mid/Side, Independent Phase
      852263 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Consistent, Window: Standard
      852272 - nothing
      852273 - Preserve Formants
      852274 - Mid/Side
      852275 - Preserve Formants (Mid Side)
      852276 - Independent Phase
      852277 - Preserve Formants, Independent Phase
      852278 - Mid/Side, Independent Phase
      852279 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Consistent, Window: Standard
      852288 - nothing
      852289 - Preserve Formants
      852290 - Mid/Side
      852291 - Preserve Formants (Mid Side)
      852292 - Independent Phase
      852293 - Preserve Formants, Independent Phase
      852294 - Mid/Side, Independent Phase
      852295 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Consistent, Window: Standard
      852304 - nothing
      852305 - Preserve Formants
      852306 - Mid/Side
      852307 - Preserve Formants (Mid Side)
      852308 - Independent Phase
      852309 - Preserve Formants, Independent Phase
      852310 - Mid/Side, Independent Phase
      852311 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Consistent, Window: Standard
      852320 - nothing
      852321 - Preserve Formants
      852322 - Mid/Side
      852323 - Preserve Formants (Mid Side)
      852324 - Independent Phase
      852325 - Preserve Formants, Independent Phase
      852326 - Mid/Side, Independent Phase
      852327 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Consistent, Window: Standard
      852336 - nothing
      852337 - Preserve Formants
      852338 - Mid/Side
      852339 - Preserve Formants (Mid Side)
      852340 - Independent Phase
      852341 - Preserve Formants, Independent Phase
      852342 - Mid/Side, Independent Phase
      852343 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Consistent, Window: Standard
      852352 - nothing
      852353 - Preserve Formants
      852354 - Mid/Side
      852355 - Preserve Formants (Mid Side)
      852356 - Independent Phase
      852357 - Preserve Formants, Independent Phase
      852358 - Mid/Side, Independent Phase
      852359 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Consistent, Window: Standard
      852368 - nothing
      852369 - Preserve Formants
      852370 - Mid/Side
      852371 - Preserve Formants (Mid Side)
      852372 - Independent Phase
      852373 - Preserve Formants, Independent Phase
      852374 - Mid/Side, Independent Phase
      852375 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Consistent, Window: Standard
      852384 - nothing
      852385 - Preserve Formants
      852386 - Mid/Side
      852387 - Preserve Formants (Mid Side)
      852388 - Independent Phase
      852389 - Preserve Formants, Independent Phase
      852390 - Mid/Side, Independent Phase
      852391 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Fast, Window: Short
      852400 - nothing
      852401 - Preserve Formants
      852402 - Mid/Side
      852403 - Preserve Formants (Mid Side)
      852404 - Independent Phase
      852405 - Preserve Formants, Independent Phase
      852406 - Mid/Side, Independent Phase
      852407 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Fast, Window: Short
      852416 - nothing
      852417 - Preserve Formants
      852418 - Mid/Side
      852419 - Preserve Formants (Mid Side)
      852420 - Independent Phase
      852421 - Preserve Formants, Independent Phase
      852422 - Mid/Side, Independent Phase
      852423 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Fast, Window: Short
      852432 - nothing
      852433 - Preserve Formants
      852434 - Mid/Side
      852435 - Preserve Formants (Mid Side)
      852436 - Independent Phase
      852437 - Preserve Formants, Independent Phase
      852438 - Mid/Side, Independent Phase
      852439 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Fast, Window: Short
      852448 - nothing
      852449 - Preserve Formants
      852450 - Mid/Side
      852451 - Preserve Formants (Mid Side)
      852452 - Independent Phase
      852453 - Preserve Formants, Independent Phase
      852454 - Mid/Side, Independent Phase
      852455 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Fast, Window: Short
      852464 - nothing
      852465 - Preserve Formants
      852466 - Mid/Side
      852467 - Preserve Formants (Mid Side)
      852468 - Independent Phase
      852469 - Preserve Formants, Independent Phase
      852470 - Mid/Side, Independent Phase
      852471 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Fast, Window: Short
      852480 - nothing
      852481 - Preserve Formants
      852482 - Mid/Side
      852483 - Preserve Formants (Mid Side)
      852484 - Independent Phase
      852485 - Preserve Formants, Independent Phase
      852486 - Mid/Side, Independent Phase
      852487 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Fast, Window: Short
      852496 - nothing
      852497 - Preserve Formants
      852498 - Mid/Side
      852499 - Preserve Formants (Mid Side)
      852500 - Independent Phase
      852501 - Preserve Formants, Independent Phase
      852502 - Mid/Side, Independent Phase
      852503 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Fast, Window: Short
      852512 - nothing
      852513 - Preserve Formants
      852514 - Mid/Side
      852515 - Preserve Formants (Mid Side)
      852516 - Independent Phase
      852517 - Preserve Formants, Independent Phase
      852518 - Mid/Side, Independent Phase
      852519 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Fast, Window: Short
      852528 - nothing
      852529 - Preserve Formants
      852530 - Mid/Side
      852531 - Preserve Formants (Mid Side)
      852532 - Independent Phase
      852533 - Preserve Formants, Independent Phase
      852534 - Mid/Side, Independent Phase
      852535 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: HighQ, Window: Short
      852544 - nothing
      852545 - Preserve Formants
      852546 - Mid/Side
      852547 - Preserve Formants (Mid Side)
      852548 - Independent Phase
      852549 - Preserve Formants, Independent Phase
      852550 - Mid/Side, Independent Phase
      852551 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: HighQ, Window: Short
      852560 - nothing
      852561 - Preserve Formants
      852562 - Mid/Side
      852563 - Preserve Formants (Mid Side)
      852564 - Independent Phase
      852565 - Preserve Formants, Independent Phase
      852566 - Mid/Side, Independent Phase
      852567 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: HighQ, Window: Short
      852576 - nothing
      852577 - Preserve Formants
      852578 - Mid/Side
      852579 - Preserve Formants (Mid Side)
      852580 - Independent Phase
      852581 - Preserve Formants, Independent Phase
      852582 - Mid/Side, Independent Phase
      852583 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: HighQ, Window: Short
      852592 - nothing
      852593 - Preserve Formants
      852594 - Mid/Side
      852595 - Preserve Formants (Mid Side)
      852596 - Independent Phase
      852597 - Preserve Formants, Independent Phase
      852598 - Mid/Side, Independent Phase
      852599 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: HighQ, Window: Short
      852608 - nothing
      852609 - Preserve Formants
      852610 - Mid/Side
      852611 - Preserve Formants (Mid Side)
      852612 - Independent Phase
      852613 - Preserve Formants, Independent Phase
      852614 - Mid/Side, Independent Phase
      852615 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: HighQ, Window: Short
      852624 - nothing
      852625 - Preserve Formants
      852626 - Mid/Side
      852627 - Preserve Formants (Mid Side)
      852628 - Independent Phase
      852629 - Preserve Formants, Independent Phase
      852630 - Mid/Side, Independent Phase
      852631 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: HighQ, Window: Short
      852640 - nothing
      852641 - Preserve Formants
      852642 - Mid/Side
      852643 - Preserve Formants (Mid Side)
      852644 - Independent Phase
      852645 - Preserve Formants, Independent Phase
      852646 - Mid/Side, Independent Phase
      852647 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: HighQ, Window: Short
      852656 - nothing
      852657 - Preserve Formants
      852658 - Mid/Side
      852659 - Preserve Formants (Mid Side)
      852660 - Independent Phase
      852661 - Preserve Formants, Independent Phase
      852662 - Mid/Side, Independent Phase
      852663 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: HighQ, Window: Short
      852672 - nothing
      852673 - Preserve Formants
      852674 - Mid/Side
      852675 - Preserve Formants (Mid Side)
      852676 - Independent Phase
      852677 - Preserve Formants, Independent Phase
      852678 - Mid/Side, Independent Phase
      852679 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Consistent, Window: Short
      852688 - nothing
      852689 - Preserve Formants
      852690 - Mid/Side
      852691 - Preserve Formants (Mid Side)
      852692 - Independent Phase
      852693 - Preserve Formants, Independent Phase
      852694 - Mid/Side, Independent Phase
      852695 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Consistent, Window: Short
      852704 - nothing
      852705 - Preserve Formants
      852706 - Mid/Side
      852707 - Preserve Formants (Mid Side)
      852708 - Independent Phase
      852709 - Preserve Formants, Independent Phase
      852710 - Mid/Side, Independent Phase
      852711 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Consistent, Window: Short
      852720 - nothing
      852721 - Preserve Formants
      852722 - Mid/Side
      852723 - Preserve Formants (Mid Side)
      852724 - Independent Phase
      852725 - Preserve Formants, Independent Phase
      852726 - Mid/Side, Independent Phase
      852727 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Consistent, Window: Short
      852736 - nothing
      852737 - Preserve Formants
      852738 - Mid/Side
      852739 - Preserve Formants (Mid Side)
      852740 - Independent Phase
      852741 - Preserve Formants, Independent Phase
      852742 - Mid/Side, Independent Phase
      852743 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Consistent, Window: Short
      852752 - nothing
      852753 - Preserve Formants
      852754 - Mid/Side
      852755 - Preserve Formants (Mid Side)
      852756 - Independent Phase
      852757 - Preserve Formants, Independent Phase
      852758 - Mid/Side, Independent Phase
      852759 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Consistent, Window: Short
      852768 - nothing
      852769 - Preserve Formants
      852770 - Mid/Side
      852771 - Preserve Formants (Mid Side)
      852772 - Independent Phase
      852773 - Preserve Formants, Independent Phase
      852774 - Mid/Side, Independent Phase
      852775 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Consistent, Window: Short
      852784 - nothing
      852785 - Preserve Formants
      852786 - Mid/Side
      852787 - Preserve Formants (Mid Side)
      852788 - Independent Phase
      852789 - Preserve Formants, Independent Phase
      852790 - Mid/Side, Independent Phase
      852791 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Consistent, Window: Short
      852800 - nothing
      852801 - Preserve Formants
      852802 - Mid/Side
      852803 - Preserve Formants (Mid Side)
      852804 - Independent Phase
      852805 - Preserve Formants, Independent Phase
      852806 - Mid/Side, Independent Phase
      852807 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Consistent, Window: Short
      852816 - nothing
      852817 - Preserve Formants
      852818 - Mid/Side
      852819 - Preserve Formants (Mid Side)
      852820 - Independent Phase
      852821 - Preserve Formants, Independent Phase
      852822 - Mid/Side, Independent Phase
      852823 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Fast, Window: Long
      852832 - nothing
      852833 - Preserve Formants
      852834 - Mid/Side
      852835 - Preserve Formants (Mid Side)
      852836 - Independent Phase
      852837 - Preserve Formants, Independent Phase
      852838 - Mid/Side, Independent Phase
      852839 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Fast, Window: Long
      852848 - nothing
      852849 - Preserve Formants
      852850 - Mid/Side
      852851 - Preserve Formants (Mid Side)
      852852 - Independent Phase
      852853 - Preserve Formants, Independent Phase
      852854 - Mid/Side, Independent Phase
      852855 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Fast, Window: Long
      852864 - nothing
      852865 - Preserve Formants
      852866 - Mid/Side
      852867 - Preserve Formants (Mid Side)
      852868 - Independent Phase
      852869 - Preserve Formants, Independent Phase
      852870 - Mid/Side, Independent Phase
      852871 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Fast, Window: Long
      852880 - nothing
      852881 - Preserve Formants
      852882 - Mid/Side
      852883 - Preserve Formants (Mid Side)
      852884 - Independent Phase
      852885 - Preserve Formants, Independent Phase
      852886 - Mid/Side, Independent Phase
      852887 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Fast, Window: Long
      852896 - nothing
      852897 - Preserve Formants
      852898 - Mid/Side
      852899 - Preserve Formants (Mid Side)
      852900 - Independent Phase
      852901 - Preserve Formants, Independent Phase
      852902 - Mid/Side, Independent Phase
      852903 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Fast, Window: Long
      852912 - nothing
      852913 - Preserve Formants
      852914 - Mid/Side
      852915 - Preserve Formants (Mid Side)
      852916 - Independent Phase
      852917 - Preserve Formants, Independent Phase
      852918 - Mid/Side, Independent Phase
      852919 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Fast, Window: Long
      852928 - nothing
      852929 - Preserve Formants
      852930 - Mid/Side
      852931 - Preserve Formants (Mid Side)
      852932 - Independent Phase
      852933 - Preserve Formants, Independent Phase
      852934 - Mid/Side, Independent Phase
      852935 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Fast, Window: Long
      852944 - nothing
      852945 - Preserve Formants
      852946 - Mid/Side
      852947 - Preserve Formants (Mid Side)
      852948 - Independent Phase
      852949 - Preserve Formants, Independent Phase
      852950 - Mid/Side, Independent Phase
      852951 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Fast, Window: Long
      852960 - nothing
      852961 - Preserve Formants
      852962 - Mid/Side
      852963 - Preserve Formants (Mid Side)
      852964 - Independent Phase
      852965 - Preserve Formants, Independent Phase
      852966 - Mid/Side, Independent Phase
      852967 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: HighQ, Window: Long
      852976 - nothing
      852977 - Preserve Formants
      852978 - Mid/Side
      852979 - Preserve Formants (Mid Side)
      852980 - Independent Phase
      852981 - Preserve Formants, Independent Phase
      852982 - Mid/Side, Independent Phase
      852983 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: HighQ, Window: Long
      852992 - nothing
      852993 - Preserve Formants
      852994 - Mid/Side
      852995 - Preserve Formants (Mid Side)
      852996 - Independent Phase
      852997 - Preserve Formants, Independent Phase
      852998 - Mid/Side, Independent Phase
      852999 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: HighQ, Window: Long
      853008 - nothing
      853009 - Preserve Formants
      853010 - Mid/Side
      853011 - Preserve Formants (Mid Side)
      853012 - Independent Phase
      853013 - Preserve Formants, Independent Phase
      853014 - Mid/Side, Independent Phase
      853015 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: HighQ, Window: Long
      853024 - nothing
      853025 - Preserve Formants
      853026 - Mid/Side
      853027 - Preserve Formants (Mid Side)
      853028 - Independent Phase
      853029 - Preserve Formants, Independent Phase
      853030 - Mid/Side, Independent Phase
      853031 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: HighQ, Window: Long
      853040 - nothing
      853041 - Preserve Formants
      853042 - Mid/Side
      853043 - Preserve Formants (Mid Side)
      853044 - Independent Phase
      853045 - Preserve Formants, Independent Phase
      853046 - Mid/Side, Independent Phase
      853047 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: HighQ, Window: Long
      853056 - nothing
      853057 - Preserve Formants
      853058 - Mid/Side
      853059 - Preserve Formants (Mid Side)
      853060 - Independent Phase
      853061 - Preserve Formants, Independent Phase
      853062 - Mid/Side, Independent Phase
      853063 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: HighQ, Window: Long
      853072 - nothing
      853073 - Preserve Formants
      853074 - Mid/Side
      853075 - Preserve Formants (Mid Side)
      853076 - Independent Phase
      853077 - Preserve Formants, Independent Phase
      853078 - Mid/Side, Independent Phase
      853079 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: HighQ, Window: Long
      853088 - nothing
      853089 - Preserve Formants
      853090 - Mid/Side
      853091 - Preserve Formants (Mid Side)
      853092 - Independent Phase
      853093 - Preserve Formants, Independent Phase
      853094 - Mid/Side, Independent Phase
      853095 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: HighQ, Window: Long
      853104 - nothing
      853105 - Preserve Formants
      853106 - Mid/Side
      853107 - Preserve Formants (Mid Side)
      853108 - Independent Phase
      853109 - Preserve Formants, Independent Phase
      853110 - Mid/Side, Independent Phase
      853111 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Consistent, Window: Long
      853120 - nothing
      853121 - Preserve Formants
      853122 - Mid/Side
      853123 - Preserve Formants (Mid Side)
      853124 - Independent Phase
      853125 - Preserve Formants, Independent Phase
      853126 - Mid/Side, Independent Phase
      853127 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Consistent, Window: Long
      853136 - nothing
      853137 - Preserve Formants
      853138 - Mid/Side
      853139 - Preserve Formants (Mid Side)
      853140 - Independent Phase
      853141 - Preserve Formants, Independent Phase
      853142 - Mid/Side, Independent Phase
      853143 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Consistent, Window: Long
      853152 - nothing
      853153 - Preserve Formants
      853154 - Mid/Side
      853155 - Preserve Formants (Mid Side)
      853156 - Independent Phase
      853157 - Preserve Formants, Independent Phase
      853158 - Mid/Side, Independent Phase
      853159 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Consistent, Window: Long
      853168 - nothing
      853169 - Preserve Formants
      853170 - Mid/Side
      853171 - Preserve Formants (Mid Side)
      853172 - Independent Phase
      853173 - Preserve Formants, Independent Phase
      853174 - Mid/Side, Independent Phase
      853175 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Consistent, Window: Long
      853184 - nothing
      853185 - Preserve Formants
      853186 - Mid/Side
      853187 - Preserve Formants (Mid Side)
      853188 - Independent Phase
      853189 - Preserve Formants, Independent Phase
      853190 - Mid/Side, Independent Phase
      853191 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Consistent, Window: Long
      853200 - nothing
      853201 - Preserve Formants
      853202 - Mid/Side
      853203 - Preserve Formants (Mid Side)
      853204 - Independent Phase
      853205 - Preserve Formants, Independent Phase
      853206 - Mid/Side, Independent Phase
      853207 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Consistent, Window: Long
      853216 - nothing
      853217 - Preserve Formants
      853218 - Mid/Side
      853219 - Preserve Formants (Mid Side)
      853220 - Independent Phase
      853221 - Preserve Formants, Independent Phase
      853222 - Mid/Side, Independent Phase
      853223 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Consistent, Window: Long
      853232 - nothing
      853233 - Preserve Formants
      853234 - Mid/Side
      853235 - Preserve Formants (Mid Side)
      853236 - Independent Phase
      853237 - Preserve Formants, Independent Phase
      853238 - Mid/Side, Independent Phase
      853239 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Consistent, Window: Long
      853248 - nothing
      853249 - Preserve Formants
      853250 - Mid/Side
      853251 - Preserve Formants (Mid Side)
      853252 - Independent Phase
      853253 - Preserve Formants, Independent Phase
      853254 - Mid/Side, Independent Phase
      853255 - Preserve Formants, Mid/Side, Independent Phase 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_TakeLane

Functioncall:

integer take_lane_state = ultraschall.GetProject_TakeLane(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the take-lane-state from an rpp-project-file or a ProjectStateChunk.

It's the entry TAKELANE

Returns nil in case of error.

Returnvalues:
 integer take_lane_state take-lane-state 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_SampleRate

Functioncall:

integer sample_rate, integer project_sample_rate, integer force_tempo_time_sig = ultraschall.GetProject_SampleRate(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the take-lane-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.

It's the entry SAMPLERATE

Returns nil in case of error.

Returnvalues:
 integer sample_rate Project Sample Rate in Hz 
 integer project_sample_rate Checkbox: Project Sample Rate 
 integer force_tempo_time_sig Checkbox: Force Project Tempo/Time Signature changes to occur on whole samples  

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_TrackMixingDepth

Functioncall:

integer track_mixing_depth = ultraschall.GetProject_TrackMixingDepth(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the track-mixing-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
It's the entry INTMIXMODE

Returns -1 in case of error, nil if it's set to 64bit(default)!

Returnvalues:
 integer track_mixing_depth track mixing depth
nil - 64bit float (default)
1 - 32 bit float
2 - 39 bit integer
3 - 24 bit integer
4 - 16 bit integer
5 - 12 bit integer
6 - 8 bit integer 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_TrackStateChunk

Functioncall:

string trackstatechunk = ultraschall.GetProject_TrackStateChunk(string projectfilename_with_path, intger idx, boolean deletetrackid, optional string ProjectStateChunk)

Description:
Returns an RPPXML-trackstatechunk from an rpp-project-file or a ProjectStateChunk, with tracknumber idx. IDX is 1 for the first track in the project-file, 2 for the second, etc
Returns -1 in case of error.

Use GetProject_NumberOfTracks to get the number of tracks within an rpp-file.

The returned trackstatechunk can be inserted into the current project with InsertTrack_TrackStateChunk.

Returnvalues:
 string trackstatechunk an RPP-XML-Trackstate-chunk, that can be used by functions like reaper.SetTrackStateChunk() 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 integer idx the tracknumber you want to have 
 boolean deletetrackid deletes the trackID in the trackstate-chunk, to avoid possible conflicts within a project, where it shall be imported to 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 GetProject_NumberOfTracks

Functioncall:

integer number_of_tracks = ultraschall.GetProject_NumberOfTracks(string projectfilename_with_path, optional string GetProject_NumberOfTracks)

Description:
Returns the number of tracks within an rpp-project-file or a GetProject_NumberOfTracks.
Returns -1 in case of error.

Note: Beware of files with thousands of items, as this can take ages or even leave Reaper to hang!

Returnvalues:
 integer number_of_tracks the number of tracks within an projectfile 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 InsertTrack_TrackStateChunk

Functioncall:

boolean retval, MediaTrack MediaTrack = ultraschall.InsertTrack_TrackStateChunk(string trackstatechunk)

Description:
Creates a new track at the end of the project and sets it's trackstate, using the parameter trackstatechunk.
Returns, if it succeeded and the newly created MediaTrack.

Returnvalues:
 boolean retval true, if creation succeeded, false if not 
 MediaTrack MediaTrack the newly created track, as MediaItem-trackobject 

Parameters:
 string trackstatechunk the rpp-xml-Trackstate-Chunk, as created by reaper.GetTrackStateChunk or GetProject_TrackStateChunk 


Reaper version 5.40Lua version 5.3 GetProject_Selection

Functioncall:

number start_selection, number end_selection, number start_selection2, number end_selection2 = ultraschall.GetProject_Selection(string projectfilename_with_path, optional string ProjectStateChunk)

Description:
Returns the selection-range from an RPP-Projectfile or a ProjectStateChunk.

It's the entry SELECTION

Returns nil in case of error or if no such entry exists.

Returnvalues:
 number start_selection start of the time-selection 
 number end_selection end of the time-selection 
 number start_selection2 start of the time-selection 
 number end_selection2 end of the time-selection 

Parameters:
 string projectfilename_with_path filename with path for the rpp-projectfile; nil, if you want to use parameter ProjectStateChunk 
 optional string ProjectStateChunk a ProjectStateChunk to use instead if a filename; only used, when projectfilename_with_path is nil 


Reaper version 5.40Lua version 5.3 SetProject_RippleState

Functioncall:

integer retval = ultraschall.SetProject_RippleState(string projectfilename_with_path, integer ripple_state, optional string ProjectStatechunk)

Description:
Sets the ripple-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer ripple_state 0, no Ripple; 1, Ripple One Track; 2, Ripple All 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_Selection

Functioncall:

integer retval = ultraschall.SetProject_Selection(string projectfilename_with_path, number starttime, number endtime, number starttime2, number endtime2, optional string ProjectStatechunk)

Description:
Sets the ripple-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 number starttime start of the selection in seconds 
 number endtime end of the selection in seconds 
 number starttime2 start of the second selection in seconds 
 number endtime2 end of the second selection in seconds 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_GroupOverride

Functioncall:

integer retval = ultraschall.SetProject_GroupOverride(string projectfilename_with_path, integer group_override1, optional string ProjectStateChunk)

Description:
Sets the group-override-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer group_override1 the group-override state 
 integer group_override2 the group-override state 
 integer group_override3 the group-override state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_AutoCrossFade

Functioncall:

integer retval = ultraschall.SetProject_AutoCrossFade(string projectfilename_with_path, integer autocrossfade_state, optional string ProjectStateChunk)

Description:
Sets the autocrossfade-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer autocrossfade_state autocrossfade-state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_EnvAttach

Functioncall:

integer retval = ultraschall.SetProject_EnvAttach(string projectfilename_with_path, integer env_attach, optional string ProjectStateChunk)

Description:
Sets the env_attach-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer env_attach env_attach-state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_MixerUIFlags

Functioncall:

integer state_bitfield1, integer state_bitfield2 = ultraschall.SetProject_MixerUIFlags(string projectfilename_with_path, integer state_bitfield1, integer state_bitfield2, optional string ProjectStateChunk)

Description:
Sets the Mixer-UI-state-flags in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer state_bitfield1 folders, receives, etc
             0 - Show tracks in folders, Auto arrange tracks in mixer
             1 - Show normal top level tracks
             2 - Show Folders
             4 - Group folders to left
             8 - Show tracks that have receives
             16 - Group tracks that have receives to left
             32 - don't show tracks that are in folder
             64 - No Autoarrange tracks in mixer
             128 - ?
             256 - ? 


Reaper version 5.40Lua version 5.3 SetProject_PeakGain

Functioncall:

integer retval = ultraschall.SetProject_PeakGain(string projectfilename_with_path, number peakgain_state, optional string ProjectStateChunk)

Description:
Sets the peak-gain-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 number peakgain_state peak-gain-state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_Feedback

Functioncall:

integer retval = ultraschall.SetProject_Feedback(string projectfilename_with_path, integer feedback_state, optional string ProjectStateChunk)

Description:
Sets the feedback-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer feedback_state feedback-state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_PanLaw

Functioncall:

integer retval = ultraschall.SetProject_PanLaw(string projectfilename_with_path, number panlaw_state, optional string ProjectStateChunk)

Description:
Sets the panlaw-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 number panlaw_state state of the panlaw, as set in the project-settings->Advanced->Pan law/mode->Pan:law(db). 0.5(-6.02 db) to 1(default +0.0 db) 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.941Lua version 5.3 SetProject_ProjOffsets

Functioncall:

integer retval = ultraschall.SetProject_ProjOffsets(string projectfilename_with_path, number start_time, integer start_measure, integer base_ruler_marking_off_this_measure, optional ProjectStateChunk)

Description:
Sets the project-offset-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.

The project-offset, as set in the ProjectSettings -> Project Time Start, Project start measure and Base Ruler Marking Off This Measure-checkbox

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 number start_time the project-start-time in seconds 
 integer start_measure the start-measure; starting with 0, unlike in the Project-Settings-window, where the 0 becomes 1 as startmeasure 
 integer base_ruler_marking_off_this_measure 0, checkbox unchecked; 1, checkbox checked 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_MaxProjectLength

Functioncall:

integer retval = ultraschall.SetProject_MaxProjectLength(string projectfilename_with_path, integer limit_project_length, number projectlength_limit, optional string ProjectStateChunk)

Description:
Sets the max-project-length-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer limit_project_length checkbox "Limit project length, stop playback/recording at:" - 0 off, 1 on 
 number projectlength_limit projectlength-limit in seconds 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_Grid

Functioncall:

integer retval = ultraschall.SetProject_Grid(string projectfilename_with_path, integer gridstate1, integer gridstate2, number gridstate3, integer gridstate4, number gridstate5, integer gridstate6, integer gridstate7, number gridstate8, optional string ProjectStateChunk)

Description:
Sets the setproject-grid-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer gridstate1 gridstate1 
 integer gridstate2 gridstate2 
 number gridstate3 gridstate3 
 integer gridstate4 gridstate4 
 number gridstate5 gridstate5 
 integer gridstate6 gridstate6 
 integer gridstate7 gridstate7 
 number gridstate8 gridstate8 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_Timemode

Functioncall:

integer retval = ultraschall.SetProject_Timemode(string projectfilename_with_path, integer timemode1, integer timemode2, integer showntime, integer timemode4, integer timemode5, optional string ProjectStateChunk)

Description:
Sets the timemode-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer ruler_timemode ruler-timemode-state
-1, Use ruler time unit
  0, Minutes:Seconds
  1, Measures.Beats / Minutes:Seconds
  2, Measures.Beats
  3, Seconds
  4, Samples
  5, Hours:Minutes:Seconds:Frames
  8, Absolute Frames 
 integer timemode2 timemode-state 
 integer showntime Transport shown time
              -1 - use ruler time unit
              0 - minutes:seconds
              1 - measures:beats/minutes:seconds
              2 - measures:beats
              3 - seconds
              4 - samples
              5 - hours:minutes:seconds:frames
              8 - absolute frames 
 integer timemode4 timemode-state 
 integer timemode5 timemode-state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_VideoConfig

Functioncall:

integer retval = ultraschall.SetProject_VideoConfig(string projectfilename_with_path, integer preferredVidSizeX, integer preferredVidSizeY, integer settingsBitfield, optional string ProjectStateChunk)

Description:
Sets the video-config-settings, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer preferredVidSizeX preferred video size, x pixels 
 integer preferredVidSizeY preferred video size, y pixels 
 integer settingsBitfield settings
             0 - turned on/selected: use high quality filtering, preserve aspect ratio(letterbox) when resizing,
                                     Video colorspace set to Auto,
                                     Items in higher numbered tracks replace lower, as well as Video colorspace set to Auto
             1 - Video colorspace: I420/YV12
             2 - Video colorspace: YUV2
             3 - RGB
             256 - Items in lower numbered tracks replace higher
             512 - Always resize video sources to preferred video size
             1024 - Always resize output to preferred video size
             2048 - turn off "Use high quality filtering when resizing"
             4096 - turn off "preserve aspect ratio (letterbox) when resizing" 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_PanMode

Functioncall:

integer retval = ultraschall.SetProject_PanMode(string projectfilename_with_path, integer panmode_state, optional string ProjectStateChunk)

Description:
Sets the panmode-settings, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer panmode_state panmode-state - ProjectSettings->Advanced->Pan law/mode->Pan mode
             0 reaper 3.x balance (deprecated)
             3 Stereo balance / mono pan (default)
             5 Stereo pan
             6 Dual Pan 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_CursorPos

Functioncall:

integer retval = ultraschall.SetProject_CursorPos(string projectfilename_with_path, number cursorpos, optional string ProjectStateChunk)

Description:
Sets the cursor-position in an rpp-project-file or a ProjectStateChunk
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 number cursorpos editcursorposition in seconds 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_HorizontalZoom

Functioncall:

integer retval = ultraschall.SetProject_HorizontalZoom(string projectfilename_with_path, number hzoom, integer hzoomscrollpos, integer scrollbarfactor, optional string ProjectStateChunk)

Description:
Sets the horizontal-zoom in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 number hzoom HorizontalZoomfactor, 0.007 to 1000000 
 integer hzoomscrollpos horizontalscrollbarposition - 0 - 4294967296 
 integer scrollbarfactor 0 to 500837, counts up, when maximum hzoomscrollpos overflows 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_VerticalZoom

Functioncall:

integer retval = ultraschall.SetProject_VerticalZoom(string projectfilename_with_path, integer vzoom, optional string ProjectStateChunk)

Description:
Sets the vertical-zoom from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer vzoom vertical zoomfactor(0-40) 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_UseRecConfig

Functioncall:

integer retval = ultraschall.SetProject_UseRecConfig(string projectfilename_with_path, integer rec_cfg, optional string ProjectStateChunk)

Description:
Sets the UseRec-Config in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer rec_cfg recording-cfg-state
              0 - Automatic .wav (recommended)
              1 - Custom (use ultraschall.GetProject_ApplyFXCFG to get recording_cfg_string)
              2 - Recording Format 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RecMode

Functioncall:

integer retval = ultraschall.SetProject_RecMode(string projectfilename_with_path, integer rec_mode, optional string ProjectStateChunk)

Description:
Sets the recording-mode-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer rec_mode recording mode
0, Autopunch/Selected Items
1, normal
2, Time Selection/Auto Punch 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_SMPTESync

Functioncall:

integer retval = ultraschall.SetProject_SMPTESync(string projectfilename_with_path, integer smptesync_state1, number smptesync_fps, integer smptesync_resyncdrift, integer smptesync_skipdropframes, integer smptesync_syncseek, integer smptesync_freewheel, integer smptesync_userinput, number smptesync_offsettimecode, integer smptesync_stop_rec_drift, integer smptesync_state10, integer smptesync_stop_rec_lacktime, optional string ProjectStateChunk)

Description:
Sets the TimeCodeSyncronization-SMPTE-Config in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer smptesync_state1 flag
             0 - external timecode synchronization disabled
             1 - external timecode synchronization enabled
             4 - Start playback on valid timecode when stopped
             8 - turned off: display flashing notification window when waiting for sync for recording
             16 - playback off
             32 - recording off
             256 - MTC - 24/30fps MTC is 23.976/29.97ND works only with smptesync_userinput set to 4159
             512 - MTC - 24/30fps MTC is 24/30ND 


Reaper version 5.40Lua version 5.3 SetProject_Loop

Functioncall:

integer retval = ultraschall.SetProject_Loop(string projectfilename_with_path, integer loopbutton_state, optional string ProjectStateChunk)

Description:
Sets the UseRec-Config in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer loop_mode loopbutton-state, 0, off; 1, on 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_LoopGran

Functioncall:

integer retval = ultraschall.SetProject_LoopGran(string projectfilename_with_path, integer loopgran_state1, number loopgran_state2, optional string ProjectStateChunk)

Description:
Sets the Loop-Gran-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer loopgran_state1 loopgran_state1 
 number loopgran_state2 loopgran_state2 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RecPath

Functioncall:

integer retval = ultraschall.SetProject_RecPath(string projectfilename_with_path, string prim_recpath, string sec_recpath, optional string ProjectStateChunk)

Description:
Sets the primary and secondary recording-paths in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 string prim_recpath primary recording path 
 string sec_recpath secondary recording path 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RecordCFG

Functioncall:

integer retval = ultraschall.SetProject_RecordCFG(string projectfilename_with_path, string recording_cfg_string, optional string ProjectStateChunk)

Description:
Sets the recording-configuration as encoded string in an RPP-Projectfile or a ProjectStateChunk, as set in ProjectSettings->Media->Recording.

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 recording_cfg_string the record-configuration as encoded string 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderCFG

Functioncall:

integer retval = ultraschall.SetProject_RenderCFG(string projectfilename_with_path, string rendercfg_string, optional string ProjectStateChunk)

Description:
Sets the render-configuration as encoded string in an RPP-Projectfile or a ProjectStateChunk, as set in Render-Settings

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 rendercfg_string the render-configuration as encoded string 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_ApplyFXCFG

Functioncall:

integer retval = ultraschall.SetProject_ApplyFXCFG(string projectfilename_with_path, string applyfx_cfg_string, optional string ProjectStateChunk)

Description:
Sets the audioformat-configuration, for fx-appliance-operation, as an encoded string in an RPP-Projectfile or a ProjectStateChunk, as set in ProjectSettings->Media->Format for Apply FX, Glue, Freeze, etc

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 string applyfx_cfg_string the file-format-configuration for fx-appliance as encoded string 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderFilename

Functioncall:

integer retval = ultraschall.SetProject_RenderFilename(string projectfilename_with_path, string renderfilename, optional string ProjectStateChunk)

Description:
Sets the render-filename in an rpp-projectfile or a ProjectStateChunk. Set to "", if you want to set a render-pattern with SetProject_RenderPattern.

The rendername is influenced by the settings in the RENDER_PATTERN-entry in the RPP-file, see SetProject_RenderPattern to influence or remove the RENDER_PATTERN-entry(Removing RENDER_PATTERN may help when Reaper rendering it to the name given in parameter render_filename.

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk insteadO 
 string render_filename the filename for rendering, check also GetProject_RenderPattern 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderPattern

Functioncall:

integer retval = ultraschall.SetProject_RenderPattern(string projectfilename_with_path, string render_pattern, optional string ProjectStateChunk)

Description:
Sets the render-filename in an rpp-projectfile or a ProjectStateChunk. Set it to "", if you want to set the render-filename with SetProject_RenderFilename.

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 string render_pattern the pattern, with which the rendering-filename will be automatically created. Check also GetProject_RenderFilename
Capitalizing the first character of the wildcard will capitalize the first letter of the substitution.
Capitalizing the first two characters of the wildcard will capitalize all letters.

Directories will be created if necessary. For example if the render target is "$project/track", the directory "$project" will be created.

$item    media item take name, if the input is a media item
$itemnumber  1 for the first media item on a track, 2 for the second...
$track    track name
$tracknumber  1 for the first track, 2 for the second...
$parenttrack  parent track name
$region    region name
$regionnumber  1 for the first region, 2 for the second...
$namecount  1 for the first item or region of the same name, 2 for the second...
$start    start time of the media item, render region, or time selection
$end    end time of the media item, render region, or time selection
$startbeats  start time in beats of the media item, render region, or time selection
$endbeats  end time in beats of the media item, render region, or time selection
$timelineorder  1 for the first item or region on the timeline, 2 for the second...
$project    project name
$tempo    project tempo at the start of the render region
$timesignature  project time signature at the start of the render region, formatted as 4-4
$filenumber  blank (optionally 1) for the first file rendered, 1 (optionally 2) for the second...
$filenumber[N]  N for the first file rendered, N+1 for the second...
$note    C0 for the first file rendered,C#0 for the second...
$note[X]    X (example: B2) for the first file rendered, X+1 (example: C3) for the second...
$natural    C0 for the first file rendered, D0 for the second...
$natural[X]  X (example: F2) for the first file rendered, X+1 (example: G2) for the second...
$format    render format (example: wav)
$samplerate  sample rate (example: 44100)
$sampleratek  sample rate (example: 44.1)
$year    year
$year2    last 2 digits of the year
$month    month number
$monthname  month name
$day    day of the month
$hour    hour of the day in 24-hour format
$hour12    hour of the day in 12-hour format
$ampm    am if before noon,pm if after noon
$minute    minute of the hour
$second    second of the minute
$user    user name
$computer  computer name

(this description has been taken from the Render Wildcard Help within the Render-Dialog of Reaper) 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderFreqNChans

Functioncall:

integer retval = ultraschall.SetProject_RenderFreqNChans(string projectfilename_with_path, integer unknown, integer rendernum_chans, integer render_frequency, optional string ProjectStateChunk)

Description:
Returns an unknown number, the render-frequency and rendernumber of channels from an RPP-Projectfile or a ProjectStateChunk.

Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer unknown unknown number 
 integer rendernum_chans Number_Channels 0-seems default-project-settings(?), 1-Mono, 2-Stereo, ... up to 64 channels 
 integer render_frequency RenderFrequency -2147483647 to 2147483647, except 0, which seems to be default-project-settings-frequency 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderSpeed

Functioncall:

integer retval = ultraschall.SetProject_RenderSpeed(string projectfilename_with_path, integer render_speed, optional string ProjectStateChunk)

Description:
Sets a rendering-speed in an RPP-Projectfile or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer render_speed render_speed
             0-Fullspeed Offline
             1-1x Offline
             2-Online Render
             3-Offline Render (Idle)
            4-1x Offline Render (Idle) 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderRange

Functioncall:

integer retval = ultraschall.SetProject_RenderRange(string projectfilename_with_path, integer bounds, number time_start, number time_end, integer tail, integer tail_length, optional string ProjectStateChunk)

Description:
Sets the render-range, render-timestart, render-timeend, render-tail and render-taillength in an RPP-Projectfile or a ProjectStateChunk.
To get RENDER_STEMS, refer GetProject_RenderStems
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer bounds the bounds of the project to be rendered
             0 Custom Time Range
             1 Entire Project
             2 Time Selection,
             3 Project Regions
             4 Selected Media Items(in combination with RENDER_STEMS 32); to get RENDER_STEMS, refer GetProject_RenderStems 


Reaper version 5.40Lua version 5.3 SetProject_RenderResample

Functioncall:

integer retval = ultraschall.SetProject_RenderResample(string projectfilename_with_path, integer resample_mode, integer playback_resample_mode, integer project_smplrate4mix_and_fx, optional string ProjectStateChunk)

Description:
Resamplemode for a)Rendering and b)Playback as well as c)if both are combined from an RPP-Projectfile or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer resample_mode Resample_Mode
             0-medium (64pt Sinc),
             1-Low (Linear Interpolation),
             2-Lowest (Point Sampling),
             3-Good(192pt Sinc),
             4-Better(384pt Sinc),
             5-Fast (IIR + Linear Interpolation),
             6-Fast (IIRx2 + Linear Interpolation),
             7-Fast (16pt sinc) - Default,
             8-HQ (512pt Sinc),
             9-Extreme HQ (768pt HQ Sinc) 


Reaper version 5.40Lua version 5.3 SetProject_AddMediaToProjectAfterRender

Functioncall:

integer retval = ultraschall.SetProject_AddMediaToProjectAfterRender(string projectfilename_with_path, integer addmedia_after_render_state, optional string ProjectStateChunk)

Description:
Returns, if rendered media shall be added to the project afterwards, from an RPP-Projectfile or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer addmedia_after_render_state 1 - rendered media shall be added to the project afterwards, 0 - don't add 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderStems

Functioncall:

integer retval = ultraschall.SetProject_RenderStems(string projectfilename_with_path, integer render_stems, optional string ProjectStateChunk)

Description:
Sets the render-stems-state from an RPP-Projectfile or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer render_stems the state of Render Stems
0 - Source Master Mix,
1 - Source Master mix + stems,
3 - Source Stems, selected tracks,
4 - Multichannel Tracks to Multichannel Files,
8 - Source Region Render Matrix,
16 - Tracks with only Mono-Media to Mono Files,  
32 - Selected Media Items(in combination with RENDER_RANGE->Bounds->4, refer to GetProject_RenderRange to get RENDER_RANGE) 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_RenderDitherState

Functioncall:

integer retval = ultraschall.SetProject_RenderDitherState(string projectfilename_with_path, integer renderdither_state, optional string ProjectStateChunk)

Description:
Sets the render-dither-state from an RPP-Projectfile or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer renderdither_state the state of render dithering
             0 - Dither Master Mix,
             1 - Don't Dither Master Mix,
             2 - Noise-shaping On Master Mix,
             3 - Dither And Noiseshape Master Mix 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_TimeBase

Functioncall:

integer retval = ultraschall.SetProject_TimeBase(string projectfilename_with_path, integer timebase, optional string ProjectStateChunk)

Description:
Sets the timebase, as set in the project-settings, in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer timebase the timebase for items/envelopes/markers as set in the project settings
             0 - Time,
             1 - Beats (position, length, rate),
             2 - Beats (position only) 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_TempoTimeSignature

Functioncall:

integer retval = ultraschall.SetProject_TempoTimeSignature(string projectfilename_with_path, integer tempotimesignature, optional string ProjectStateChunk)

Description:
Sets the timebase, as set in the project-settings, in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer tempotimesignature the timebase for tempo/time-signature as set in the project settings
             0 - Time
             1 - Beats 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_ItemMixBehavior

Functioncall:

integer retval = ultraschall.SetProject_ItemMixBehavior(string projectfilename_with_path, integer item_mix_behav_state, optional string ProjectStateChunk)

Description:
Sets the item mix behavior, as set in the project-settings, from an rpp-project-file.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path filename with path of the rpp-project-file 
 integer item_mix_behav_state item mix behavior
              0 - Enclosed items replace enclosing items
              1 - Items always mix
              2 - Items always replace earlier items 


Reaper version 5.77Lua version 5.3 SetProject_DefPitchMode

Functioncall:

integer retval = ultraschall.SetProject_DefPitchMode(string projectfilename_with_path, integer def_pitch_mode_state, optional string ProjectStateChunk)

Description:
Sets the default-pitch-mode, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer def_pitch_mode_state the default pitch mode
      0 - Soundtouch(Default)
      1 - Soundtouch(High Quality)
      2 - Soundtouch(Fast)
      131072 - Simple Windowed(fast) (50ms window, 25ms fade)
      131073 - Simple Windowed(fast) (50ms window, 16ms fade)
      131074 - Simple Windowed(fast) (50ms window, 10ms fade)
      131075 - Simple Windowed(fast) (50ms window, 7ms fade)
      131076 - Simple Windowed(fast) (75ms window, 37ms fade)
      131077 - Simple Windowed(fast) (75ms window, 25ms fade)
      131078 - Simple Windowed(fast) (75ms window, 15ms fade)
      131079 - Simple Windowed(fast) (75ms window, 10ms fade)
      131080 - Simple Windowed(fast) (100ms window, 50ms fade)
      131081 - Simple Windowed(fast) (100ms window, 33ms fade)
      131082 - Simple Windowed(fast) (100ms window, 20ms fade)
      131083 - Simple Windowed(fast) (100ms window, 14ms fade)
      131084 - Simple Windowed(fast) (150ms window, 75ms fade)
      131085 - Simple Windowed(fast) (150ms window, 50ms fade)
      131086 - Simple Windowed(fast) (150ms window, 30ms fade)
      131087 - Simple Windowed(fast) (150ms window, 21ms fade)
      131088 - Simple Windowed(fast) (225ms window, 112ms fade)
      131089 - Simple Windowed(fast) (225ms window, 75ms fade)
      131090 - Simple Windowed(fast) (225ms window, 45ms fade)
      131091 - Simple Windowed(fast) (225ms window, 32ms fade)
      131092 - Simple Windowed(fast) (300ms window, 150ms fade)
      131093 - Simple Windowed(fast) (300ms window, 100ms fade)
      131094 - Simple Windowed(fast) (300ms window, 60ms fade)
      131095 - Simple Windowed(fast) (300ms window, 42ms fade)
      131096 - Simple Windowed(fast) (40ms window, 20ms fade)
      131097 - Simple Windowed(fast) (40ms window, 13ms fade)
      131098 - Simple Windowed(fast) (40ms window, 8ms fade)
      131099 - Simple Windowed(fast) (40ms window, 5ms fade)
      131100 - Simple Windowed(fast) (30ms window, 15ms fade)
      131101 - Simple Windowed(fast) (30ms window, 10ms fade)
      131102 - Simple Windowed(fast) (30ms window, 6s fade)
      131103 - Simple Windowed(fast) (30ms window, 4ms fade)
      131104 - Simple Windowed(fast) (20ms window, 10ms fade)
      131105 - Simple Windowed(fast) (20ms window, 6ms fade)
      131106 - Simple Windowed(fast) (20ms window, 4ms fade)
      131107 - Simple Windowed(fast) (20ms window, 2ms fade)
      131108 - Simple Windowed(fast) (10ms window, 5ms fade)
      131109 - Simple Windowed(fast) (10ms window, 3ms fade)
      131110 - Simple Windowed(fast) (10ms window, 2ms fade)
      131111 - Simple Windowed(fast) (10ms window, 1ms fade)
      131112 - Simple Windowed(fast) (5ms window, 2ms fade)
      131113 - Simple Windowed(fast) (5ms window, 1ms fade)
      131114 - Simple Windowed(fast) (5ms window, 1ms fade)
      131115 - Simple Windowed(fast) (5ms window, 1ms fade)
      131116 - Simple Windowed(fast) (3ms window, 1ms fade)
      131117 - Simple Windowed(fast) (3ms window, 1ms fade)
      131118 - Simple Windowed(fast) (3ms window, 1ms fade)
      131119 - Simple Windowed(fast) (3ms window, 1ms fade)
      393216 - elastique 2.28 Pro Normal
      393217 - elastique 2.28 Pro Preserve Formants(Lowest Pitches)
      393218 - elastique 2.28 Pro Preserve Formants(Lower Pitches)
      393219 - elastique 2.28 Pro Preserve Formants(Low Pitches)
      393220 - elastique 2.28 Pro Preserve Formants(Most Pitches)
      393221 - elastique 2.28 Pro Preserve Formants(High Pitches)
      393222 - elastique 2.28 Pro Preserve Formants(Higher Pitches)
      393223 - elastique 2.28 Pro Preserve Formants(Highest Pitches)
      393224 - elastique 2.28 Pro Mid/Side
      393225 - elastique 2.28 Pro Mid/Side, Preserve Formants(Lowest Pitches)
      393226 - elastique 2.28 Pro Mid/Side, Preserve Formants(Lower Pitches)
      393227 - elastique 2.28 Pro Mid/Side, Preserve Formants(Low Pitches)
      393228 - elastique 2.28 Pro Mid/Side, Preserve Formants(Most Pitches)
      393229 - elastique 2.28 Pro Mid/Side, Preserve Formants(High Pitches)
      393230 - elastique 2.28 Pro Mid/Side, Preserve Formants(Higher Pitches)
      393231 - elastique 2.28 Pro Mid/Side, Preserve Formants(Highest Pitches)
      393232 - elastique 2.28 Pro Synchronized: Normal
      393233 - elastique 2.28 Pro Synchronized: Preserve Formants(Lowest Pitches)
      393234 - elastique 2.28 Pro Synchronized: Preserve Formants(Lower Pitches)
      393235 - elastique 2.28 Pro Synchronized: Preserve Formants(Low Pitches)
      393236 - elastique 2.28 Pro Synchronized: Preserve Formants(Most Pitches)
      393237 - elastique 2.28 Pro Synchronized: Preserve Formants(High Pitches)
      393238 - elastique 2.28 Pro Synchronized: Preserve Formants(Higher Pitches)
      393239 - elastique 2.28 Pro Synchronized: Preserve Formants(Highest Pitches)
      393240 - elastique 2.28 Pro Synchronized: Mid/Side
      393241 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Lowest Pitches)
      393242 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Lower Pitches)
      393243 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Low Pitches)
      393244 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Most Pitches)
      393245 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(High Pitches)
      393246 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Higher Pitches)
      393247 - elastique 2.28 Pro Synchronized: Mid/Side, Preserve Formants(Highest Pitches)
      458752 - elastique 2.28 Efficient Normal
      458753 - elastique 2.28 Efficient Mid/Side
      458754 - elastique 2.28 Efficient Synchronized: Normal
      458755 - elastique 2.28 Efficient Synchronized: Mid/Side
      524288 - elastique 2.28 Soloist Monophonic
      524289 - elastique 2.28 Soloist Monophonic [Mid/Side]
      524290 - elastique 2.28 Soloist Speech
      524291 - elastique 2.28 Soloist Speech [Mid/Side]
      589824 - elastique 3.2.3 Pro Normal
      589825 - elastique 3.2.3 Pro Preserve Formants(Lowest Pitches)
      589826 - elastique 3.2.3 Pro Preserve Formants(Lower Pitches)
      589827 - elastique 3.2.3 Pro Preserve Formants(Low Pitches)
      589828 - elastique 3.2.3 Pro Preserve Formants(Most Pitches)
      589829 - elastique 3.2.3 Pro Preserve Formants(High Pitches)
      589830 - elastique 3.2.3 Pro Preserve Formants(Higher Pitches)
      589831 - elastique 3.2.3 Pro Preserve Formants(Highest Pitches)
      589832 - elastique 3.2.3 Pro Mid/Side
      589833 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Lowest Pitches)
      589834 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Lower Pitches)
      589835 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Low Pitches)
      589836 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Most Pitches)
      589837 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(High Pitches)
      589838 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Higher Pitches)
      589839 - elastique 3.2.3 Pro Mid/Side, Preserve Formants(Highest Pitches)
      589840 - elastique 3.2.3 Pro Synchronized: Normal
      589841 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Lowest Pitches)
      589842 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Lower Pitches)
      589843 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Low Pitches)
      589844 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Most Pitches)
      589845 - elastique 3.2.3 Pro Synchronized: Preserve Formants(High Pitches)
      589846 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Higher Pitches)
      589847 - elastique 3.2.3 Pro Synchronized: Preserve Formants(Highest Pitches)
      589848 - elastique 3.2.3 Pro Synchronized: Mid/Side
      589849 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Lowest Pitches)
      589850 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Lower Pitches)
      589851 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Low Pitches)
      589852 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Most Pitches)
      589853 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(High Pitches)
      589853 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Higher Pitches)
      589855 - elastique 3.2.3 Pro Synchronized: Mid/Side, Preserve Formants(Highest Pitches)
      655360 - elastique 3.2.3 Efficient Normal
      655361 - elastique 3.2.3 Efficient Mid/Side
      655362 - elastique 3.2.3 Efficient Synchronized: Normal
      655363 - elastique 3.2.3 Efficient Synchronized: Mid/Side
      720896 - elastique 3.2.3 Soloist (Monophonic)
      720897 - elastique 3.2.3 Soloist (Monophonic Mid Side)
      720898 - elastique 3.2.3 Soloist (Speech)
      720898 - elastique 3.2.3 Soloist (Monophonic Mid Side)

      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Fast, Window: Standard
      851968 - nothing
      851969 - Preserve Formants
      851970 - Mid/Side
      851971 - Preserve Formants (Mid Side)
      851972 - Independent Phase
      851973 - Preserve Formants, Independent Phase
      851974 - Mid/Side, Independent Phase
      851975 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Fast, Window: Standard
      851984 - nothing
      851985 - Preserve Formants
      851986 - Mid/Side
      851987 - Preserve Formants (Mid Side)
      851988 - Independent Phase
      851989 - Preserve Formants, Independent Phase
      851990 - Mid/Side, Independent Phase
      851991 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Fast, Window: Standard
      852000 - nothing
      852001 - Preserve Formants
      852002 - Mid/Side
      852003 - Preserve Formants (Mid Side)
      852004 - Independent Phase
      852005 - Preserve Formants, Independent Phase
      852006 - Mid/Side, Independent Phase
      852007 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Fast, Window: Standard
      852016 - nothing
      852017 - Preserve Formants
      852018 - Mid/Side
      852019 - Preserve Formants (Mid Side)
      852020 - Independent Phase
      852021 - Preserve Formants, Independent Phase
      852022 - Mid/Side, Independent Phase
      852023 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Fast, Window: Standard
      852032 - nothing
      852033 - Preserve Formants
      852034 - Mid/Side
      852035 - Preserve Formants (Mid Side)
      852036 - Independent Phase
      852037 - Preserve Formants, Independent Phase
      852038 - Mid/Side, Independent Phase
      852039 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Fast, Window: Standard
      852048 - nothing
      852049 - Preserve Formants
      852050 - Mid/Side
      852051 - Preserve Formants (Mid Side)
      852052 - Independent Phase
      852053 - Preserve Formants, Independent Phase
      852054 - Mid/Side, Independent Phase
      852055 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Fast, Window: Standard
      852064 - nothing
      852065 - Preserve Formants
      852066 - Mid/Side
      852067 - Preserve Formants (Mid Side)
      852068 - Independent Phase
      852069 - Preserve Formants, Independent Phase
      852070 - Mid/Side, Independent Phase
      852071 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Fast, Window: Standard
      852080 - nothing
      852081 - Preserve Formants
      852082 - Mid/Side
      852083 - Preserve Formants (Mid Side)
      852084 - Independent Phase
      852085 - Preserve Formants, Independent Phase
      852086 - Mid/Side, Independent Phase
      852087 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Fast, Window: Standard
      852096 - nothing
      852097 - Preserve Formants
      852098 - Mid/Side
      852099 - Preserve Formants (Mid Side)
      852100 - Independent Phase
      852101 - Preserve Formants, Independent Phase
      852102 - Mid/Side, Independent Phase
      852103 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: HighQ, Window: Standard
      852112 - nothing
      852113 - Preserve Formants
      852114 - Mid/Side
      852115 - Preserve Formants (Mid Side)
      852116 - Independent Phase
      852117 - Preserve Formants, Independent Phase
      852118 - Mid/Side, Independent Phase
      852119 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: HighQ, Window: Standard
      852128 - nothing
      852129 - Preserve Formants
      852130 - Mid/Side
      852131 - Preserve Formants (Mid Side)
      852132 - Independent Phase
      852133 - Preserve Formants, Independent Phase
      852134 - Mid/Side, Independent Phase
      852135 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: HighQ, Window: Standard
      852144 - nothing
      852145 - Preserve Formants
      852146 - Mid/Side
      852147 - Preserve Formants (Mid Side)
      852148 - Independent Phase
      852149 - Preserve Formants, Independent Phase
      852150 - Mid/Side, Independent Phase
      852151 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: HighQ, Window: Standard
      852160 - nothing
      852161 - Preserve Formants
      852162 - Mid/Side
      852163 - Preserve Formants (Mid Side)
      852164 - Independent Phase
      852165 - Preserve Formants, Independent Phase
      852166 - Mid/Side, Independent Phase
      852167 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: HighQ, Window: Standard
      852176 - nothing
      852177 - Preserve Formants
      852178 - Mid/Side
      852179 - Preserve Formants (Mid Side)
      852180 - Independent Phase
      852181 - Preserve Formants, Independent Phase
      852182 - Mid/Side, Independent Phase
      852183 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: HighQ, Window: Standard
      852192 - nothing
      852193 - Preserve Formants
      852194 - Mid/Side
      852195 - Preserve Formants (Mid Side)
      852196 - Independent Phase
      852197 - Preserve Formants, Independent Phase
      852198 - Mid/Side, Independent Phase
      852199 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: HighQ, Window: Standard
      852208 - nothing
      852209 - Preserve Formants
      852210 - Mid/Side
      852211 - Preserve Formants (Mid Side)
      852212 - Independent Phase
      852213 - Preserve Formants, Independent Phase
      852214 - Mid/Side, Independent Phase
      852215 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: HighQ, Window: Standard
      852224 - nothing
      852225 - Preserve Formants
      852226 - Mid/Side
      852227 - Preserve Formants (Mid Side)
      852228 - Independent Phase
      852229 - Preserve Formants, Independent Phase
      852230 - Mid/Side, Independent Phase
      852231 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: HighQ, Window: Standard
      852240 - nothing
      852241 - Preserve Formants
      852242 - Mid/Side
      852243 - Preserve Formants (Mid Side)
      852244 - Independent Phase
      852245 - Preserve Formants, Independent Phase
      852246 - Mid/Side, Independent Phase
      852247 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Consistent, Window: Standard
      852256 - nothing
      852257 - Preserve Formants
      852258 - Mid/Side
      852259 - Preserve Formants (Mid Side)
      852260 - Independent Phase
      852261 - Preserve Formants, Independent Phase
      852262 - Mid/Side, Independent Phase
      852263 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Consistent, Window: Standard
      852272 - nothing
      852273 - Preserve Formants
      852274 - Mid/Side
      852275 - Preserve Formants (Mid Side)
      852276 - Independent Phase
      852277 - Preserve Formants, Independent Phase
      852278 - Mid/Side, Independent Phase
      852279 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Consistent, Window: Standard
      852288 - nothing
      852289 - Preserve Formants
      852290 - Mid/Side
      852291 - Preserve Formants (Mid Side)
      852292 - Independent Phase
      852293 - Preserve Formants, Independent Phase
      852294 - Mid/Side, Independent Phase
      852295 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Consistent, Window: Standard
      852304 - nothing
      852305 - Preserve Formants
      852306 - Mid/Side
      852307 - Preserve Formants (Mid Side)
      852308 - Independent Phase
      852309 - Preserve Formants, Independent Phase
      852310 - Mid/Side, Independent Phase
      852311 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Consistent, Window: Standard
      852320 - nothing
      852321 - Preserve Formants
      852322 - Mid/Side
      852323 - Preserve Formants (Mid Side)
      852324 - Independent Phase
      852325 - Preserve Formants, Independent Phase
      852326 - Mid/Side, Independent Phase
      852327 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Consistent, Window: Standard
      852336 - nothing
      852337 - Preserve Formants
      852338 - Mid/Side
      852339 - Preserve Formants (Mid Side)
      852340 - Independent Phase
      852341 - Preserve Formants, Independent Phase
      852342 - Mid/Side, Independent Phase
      852343 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Consistent, Window: Standard
      852352 - nothing
      852353 - Preserve Formants
      852354 - Mid/Side
      852355 - Preserve Formants (Mid Side)
      852356 - Independent Phase
      852357 - Preserve Formants, Independent Phase
      852358 - Mid/Side, Independent Phase
      852359 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Consistent, Window: Standard
      852368 - nothing
      852369 - Preserve Formants
      852370 - Mid/Side
      852371 - Preserve Formants (Mid Side)
      852372 - Independent Phase
      852373 - Preserve Formants, Independent Phase
      852374 - Mid/Side, Independent Phase
      852375 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Consistent, Window: Standard
      852384 - nothing
      852385 - Preserve Formants
      852386 - Mid/Side
      852387 - Preserve Formants (Mid Side)
      852388 - Independent Phase
      852389 - Preserve Formants, Independent Phase
      852390 - Mid/Side, Independent Phase
      852391 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Fast, Window: Short
      852400 - nothing
      852401 - Preserve Formants
      852402 - Mid/Side
      852403 - Preserve Formants (Mid Side)
      852404 - Independent Phase
      852405 - Preserve Formants, Independent Phase
      852406 - Mid/Side, Independent Phase
      852407 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Fast, Window: Short
      852416 - nothing
      852417 - Preserve Formants
      852418 - Mid/Side
      852419 - Preserve Formants (Mid Side)
      852420 - Independent Phase
      852421 - Preserve Formants, Independent Phase
      852422 - Mid/Side, Independent Phase
      852423 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Fast, Window: Short
      852432 - nothing
      852433 - Preserve Formants
      852434 - Mid/Side
      852435 - Preserve Formants (Mid Side)
      852436 - Independent Phase
      852437 - Preserve Formants, Independent Phase
      852438 - Mid/Side, Independent Phase
      852439 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Fast, Window: Short
      852448 - nothing
      852449 - Preserve Formants
      852450 - Mid/Side
      852451 - Preserve Formants (Mid Side)
      852452 - Independent Phase
      852453 - Preserve Formants, Independent Phase
      852454 - Mid/Side, Independent Phase
      852455 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Fast, Window: Short
      852464 - nothing
      852465 - Preserve Formants
      852466 - Mid/Side
      852467 - Preserve Formants (Mid Side)
      852468 - Independent Phase
      852469 - Preserve Formants, Independent Phase
      852470 - Mid/Side, Independent Phase
      852471 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Fast, Window: Short
      852480 - nothing
      852481 - Preserve Formants
      852482 - Mid/Side
      852483 - Preserve Formants (Mid Side)
      852484 - Independent Phase
      852485 - Preserve Formants, Independent Phase
      852486 - Mid/Side, Independent Phase
      852487 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Fast, Window: Short
      852496 - nothing
      852497 - Preserve Formants
      852498 - Mid/Side
      852499 - Preserve Formants (Mid Side)
      852500 - Independent Phase
      852501 - Preserve Formants, Independent Phase
      852502 - Mid/Side, Independent Phase
      852503 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Fast, Window: Short
      852512 - nothing
      852513 - Preserve Formants
      852514 - Mid/Side
      852515 - Preserve Formants (Mid Side)
      852516 - Independent Phase
      852517 - Preserve Formants, Independent Phase
      852518 - Mid/Side, Independent Phase
      852519 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Fast, Window: Short
      852528 - nothing
      852529 - Preserve Formants
      852530 - Mid/Side
      852531 - Preserve Formants (Mid Side)
      852532 - Independent Phase
      852533 - Preserve Formants, Independent Phase
      852534 - Mid/Side, Independent Phase
      852535 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: HighQ, Window: Short
      852544 - nothing
      852545 - Preserve Formants
      852546 - Mid/Side
      852547 - Preserve Formants (Mid Side)
      852548 - Independent Phase
      852549 - Preserve Formants, Independent Phase
      852550 - Mid/Side, Independent Phase
      852551 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: HighQ, Window: Short
      852560 - nothing
      852561 - Preserve Formants
      852562 - Mid/Side
      852563 - Preserve Formants (Mid Side)
      852564 - Independent Phase
      852565 - Preserve Formants, Independent Phase
      852566 - Mid/Side, Independent Phase
      852567 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: HighQ, Window: Short
      852576 - nothing
      852577 - Preserve Formants
      852578 - Mid/Side
      852579 - Preserve Formants (Mid Side)
      852580 - Independent Phase
      852581 - Preserve Formants, Independent Phase
      852582 - Mid/Side, Independent Phase
      852583 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: HighQ, Window: Short
      852592 - nothing
      852593 - Preserve Formants
      852594 - Mid/Side
      852595 - Preserve Formants (Mid Side)
      852596 - Independent Phase
      852597 - Preserve Formants, Independent Phase
      852598 - Mid/Side, Independent Phase
      852599 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: HighQ, Window: Short
      852608 - nothing
      852609 - Preserve Formants
      852610 - Mid/Side
      852611 - Preserve Formants (Mid Side)
      852612 - Independent Phase
      852613 - Preserve Formants, Independent Phase
      852614 - Mid/Side, Independent Phase
      852615 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: HighQ, Window: Short
      852624 - nothing
      852625 - Preserve Formants
      852626 - Mid/Side
      852627 - Preserve Formants (Mid Side)
      852628 - Independent Phase
      852629 - Preserve Formants, Independent Phase
      852630 - Mid/Side, Independent Phase
      852631 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: HighQ, Window: Short
      852640 - nothing
      852641 - Preserve Formants
      852642 - Mid/Side
      852643 - Preserve Formants (Mid Side)
      852644 - Independent Phase
      852645 - Preserve Formants, Independent Phase
      852646 - Mid/Side, Independent Phase
      852647 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: HighQ, Window: Short
      852656 - nothing
      852657 - Preserve Formants
      852658 - Mid/Side
      852659 - Preserve Formants (Mid Side)
      852660 - Independent Phase
      852661 - Preserve Formants, Independent Phase
      852662 - Mid/Side, Independent Phase
      852663 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: HighQ, Window: Short
      852672 - nothing
      852673 - Preserve Formants
      852674 - Mid/Side
      852675 - Preserve Formants (Mid Side)
      852676 - Independent Phase
      852677 - Preserve Formants, Independent Phase
      852678 - Mid/Side, Independent Phase
      852679 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Consistent, Window: Short
      852688 - nothing
      852689 - Preserve Formants
      852690 - Mid/Side
      852691 - Preserve Formants (Mid Side)
      852692 - Independent Phase
      852693 - Preserve Formants, Independent Phase
      852694 - Mid/Side, Independent Phase
      852695 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Consistent, Window: Short
      852704 - nothing
      852705 - Preserve Formants
      852706 - Mid/Side
      852707 - Preserve Formants (Mid Side)
      852708 - Independent Phase
      852709 - Preserve Formants, Independent Phase
      852710 - Mid/Side, Independent Phase
      852711 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Consistent, Window: Short
      852720 - nothing
      852721 - Preserve Formants
      852722 - Mid/Side
      852723 - Preserve Formants (Mid Side)
      852724 - Independent Phase
      852725 - Preserve Formants, Independent Phase
      852726 - Mid/Side, Independent Phase
      852727 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Consistent, Window: Short
      852736 - nothing
      852737 - Preserve Formants
      852738 - Mid/Side
      852739 - Preserve Formants (Mid Side)
      852740 - Independent Phase
      852741 - Preserve Formants, Independent Phase
      852742 - Mid/Side, Independent Phase
      852743 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Consistent, Window: Short
      852752 - nothing
      852753 - Preserve Formants
      852754 - Mid/Side
      852755 - Preserve Formants (Mid Side)
      852756 - Independent Phase
      852757 - Preserve Formants, Independent Phase
      852758 - Mid/Side, Independent Phase
      852759 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Consistent, Window: Short
      852768 - nothing
      852769 - Preserve Formants
      852770 - Mid/Side
      852771 - Preserve Formants (Mid Side)
      852772 - Independent Phase
      852773 - Preserve Formants, Independent Phase
      852774 - Mid/Side, Independent Phase
      852775 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Consistent, Window: Short
      852784 - nothing
      852785 - Preserve Formants
      852786 - Mid/Side
      852787 - Preserve Formants (Mid Side)
      852788 - Independent Phase
      852789 - Preserve Formants, Independent Phase
      852790 - Mid/Side, Independent Phase
      852791 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Consistent, Window: Short
      852800 - nothing
      852801 - Preserve Formants
      852802 - Mid/Side
      852803 - Preserve Formants (Mid Side)
      852804 - Independent Phase
      852805 - Preserve Formants, Independent Phase
      852806 - Mid/Side, Independent Phase
      852807 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Consistent, Window: Short
      852816 - nothing
      852817 - Preserve Formants
      852818 - Mid/Side
      852819 - Preserve Formants (Mid Side)
      852820 - Independent Phase
      852821 - Preserve Formants, Independent Phase
      852822 - Mid/Side, Independent Phase
      852823 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Fast, Window: Long
      852832 - nothing
      852833 - Preserve Formants
      852834 - Mid/Side
      852835 - Preserve Formants (Mid Side)
      852836 - Independent Phase
      852837 - Preserve Formants, Independent Phase
      852838 - Mid/Side, Independent Phase
      852839 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Fast, Window: Long
      852848 - nothing
      852849 - Preserve Formants
      852850 - Mid/Side
      852851 - Preserve Formants (Mid Side)
      852852 - Independent Phase
      852853 - Preserve Formants, Independent Phase
      852854 - Mid/Side, Independent Phase
      852855 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Fast, Window: Long
      852864 - nothing
      852865 - Preserve Formants
      852866 - Mid/Side
      852867 - Preserve Formants (Mid Side)
      852868 - Independent Phase
      852869 - Preserve Formants, Independent Phase
      852870 - Mid/Side, Independent Phase
      852871 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Fast, Window: Long
      852880 - nothing
      852881 - Preserve Formants
      852882 - Mid/Side
      852883 - Preserve Formants (Mid Side)
      852884 - Independent Phase
      852885 - Preserve Formants, Independent Phase
      852886 - Mid/Side, Independent Phase
      852887 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Fast, Window: Long
      852896 - nothing
      852897 - Preserve Formants
      852898 - Mid/Side
      852899 - Preserve Formants (Mid Side)
      852900 - Independent Phase
      852901 - Preserve Formants, Independent Phase
      852902 - Mid/Side, Independent Phase
      852903 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Fast, Window: Long
      852912 - nothing
      852913 - Preserve Formants
      852914 - Mid/Side
      852915 - Preserve Formants (Mid Side)
      852916 - Independent Phase
      852917 - Preserve Formants, Independent Phase
      852918 - Mid/Side, Independent Phase
      852919 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Fast, Window: Long
      852928 - nothing
      852929 - Preserve Formants
      852930 - Mid/Side
      852931 - Preserve Formants (Mid Side)
      852932 - Independent Phase
      852933 - Preserve Formants, Independent Phase
      852934 - Mid/Side, Independent Phase
      852935 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Fast, Window: Long
      852944 - nothing
      852945 - Preserve Formants
      852946 - Mid/Side
      852947 - Preserve Formants (Mid Side)
      852948 - Independent Phase
      852949 - Preserve Formants, Independent Phase
      852950 - Mid/Side, Independent Phase
      852951 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Fast, Window: Long
      852960 - nothing
      852961 - Preserve Formants
      852962 - Mid/Side
      852963 - Preserve Formants (Mid Side)
      852964 - Independent Phase
      852965 - Preserve Formants, Independent Phase
      852966 - Mid/Side, Independent Phase
      852967 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: HighQ, Window: Long
      852976 - nothing
      852977 - Preserve Formants
      852978 - Mid/Side
      852979 - Preserve Formants (Mid Side)
      852980 - Independent Phase
      852981 - Preserve Formants, Independent Phase
      852982 - Mid/Side, Independent Phase
      852983 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: HighQ, Window: Long
      852992 - nothing
      852993 - Preserve Formants
      852994 - Mid/Side
      852995 - Preserve Formants (Mid Side)
      852996 - Independent Phase
      852997 - Preserve Formants, Independent Phase
      852998 - Mid/Side, Independent Phase
      852999 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: HighQ, Window: Long
      853008 - nothing
      853009 - Preserve Formants
      853010 - Mid/Side
      853011 - Preserve Formants (Mid Side)
      853012 - Independent Phase
      853013 - Preserve Formants, Independent Phase
      853014 - Mid/Side, Independent Phase
      853015 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: HighQ, Window: Long
      853024 - nothing
      853025 - Preserve Formants
      853026 - Mid/Side
      853027 - Preserve Formants (Mid Side)
      853028 - Independent Phase
      853029 - Preserve Formants, Independent Phase
      853030 - Mid/Side, Independent Phase
      853031 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: HighQ, Window: Long
      853040 - nothing
      853041 - Preserve Formants
      853042 - Mid/Side
      853043 - Preserve Formants (Mid Side)
      853044 - Independent Phase
      853045 - Preserve Formants, Independent Phase
      853046 - Mid/Side, Independent Phase
      853047 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: HighQ, Window: Long
      853056 - nothing
      853057 - Preserve Formants
      853058 - Mid/Side
      853059 - Preserve Formants (Mid Side)
      853060 - Independent Phase
      853061 - Preserve Formants, Independent Phase
      853062 - Mid/Side, Independent Phase
      853063 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: HighQ, Window: Long
      853072 - nothing
      853073 - Preserve Formants
      853074 - Mid/Side
      853075 - Preserve Formants (Mid Side)
      853076 - Independent Phase
      853077 - Preserve Formants, Independent Phase
      853078 - Mid/Side, Independent Phase
      853079 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: HighQ, Window: Long
      853088 - nothing
      853089 - Preserve Formants
      853090 - Mid/Side
      853091 - Preserve Formants (Mid Side)
      853092 - Independent Phase
      853093 - Preserve Formants, Independent Phase
      853094 - Mid/Side, Independent Phase
      853095 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: HighQ, Window: Long
      853104 - nothing
      853105 - Preserve Formants
      853106 - Mid/Side
      853107 - Preserve Formants (Mid Side)
      853108 - Independent Phase
      853109 - Preserve Formants, Independent Phase
      853110 - Mid/Side, Independent Phase
      853111 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Compound, Pitch Mode: Consistent, Window: Long
      853120 - nothing
      853121 - Preserve Formants
      853122 - Mid/Side
      853123 - Preserve Formants (Mid Side)
      853124 - Independent Phase
      853125 - Preserve Formants, Independent Phase
      853126 - Mid/Side, Independent Phase
      853127 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Compound, Pitch Mode: Consistent, Window: Long
      853136 - nothing
      853137 - Preserve Formants
      853138 - Mid/Side
      853139 - Preserve Formants (Mid Side)
      853140 - Independent Phase
      853141 - Preserve Formants, Independent Phase
      853142 - Mid/Side, Independent Phase
      853143 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Compound, Pitch Mode: Consistent, Window: Long
      853152 - nothing
      853153 - Preserve Formants
      853154 - Mid/Side
      853155 - Preserve Formants (Mid Side)
      853156 - Independent Phase
      853157 - Preserve Formants, Independent Phase
      853158 - Mid/Side, Independent Phase
      853159 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Percussive, Pitch Mode: Consistent, Window: Long
      853168 - nothing
      853169 - Preserve Formants
      853170 - Mid/Side
      853171 - Preserve Formants (Mid Side)
      853172 - Independent Phase
      853173 - Preserve Formants, Independent Phase
      853174 - Mid/Side, Independent Phase
      853175 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Percussive, Pitch Mode: Consistent, Window: Long
      853184 - nothing
      853185 - Preserve Formants
      853186 - Mid/Side
      853187 - Preserve Formants (Mid Side)
      853188 - Independent Phase
      853189 - Preserve Formants, Independent Phase
      853190 - Mid/Side, Independent Phase
      853191 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Percussive, Pitch Mode: Consistent, Window: Long
      853200 - nothing
      853201 - Preserve Formants
      853202 - Mid/Side
      853203 - Preserve Formants (Mid Side)
      853204 - Independent Phase
      853205 - Preserve Formants, Independent Phase
      853206 - Mid/Side, Independent Phase
      853207 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Crisp, Detector: Soft, Pitch Mode: Consistent, Window: Long
      853216 - nothing
      853217 - Preserve Formants
      853218 - Mid/Side
      853219 - Preserve Formants (Mid Side)
      853220 - Independent Phase
      853221 - Preserve Formants, Independent Phase
      853222 - Mid/Side, Independent Phase
      853223 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Mixed, Detector: Soft, Pitch Mode: Consistent, Window: Long
      853232 - nothing
      853233 - Preserve Formants
      853234 - Mid/Side
      853235 - Preserve Formants (Mid Side)
      853236 - Independent Phase
      853237 - Preserve Formants, Independent Phase
      853238 - Mid/Side, Independent Phase
      853239 - Preserve Formants, Mid/Side, Independent Phase
      
      Rubber Band Library - Transients: Smooth, Detector: Soft, Pitch Mode: Consistent, Window: Long
      853248 - nothing
      853249 - Preserve Formants
      853250 - Mid/Side
      853251 - Preserve Formants (Mid Side)
      853252 - Independent Phase
      853253 - Preserve Formants, Independent Phase
      853254 - Mid/Side, Independent Phase
      853255 - Preserve Formants, Mid/Side, Independent Phase 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_TakeLane

Functioncall:

integer retval = ultraschall.SetProject_TakeLane(string projectfilename_with_path, integer take_lane_state, optional string ProjectStateChunk)

Description:
Sets the take-lane-state in an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer take_lane_state take-lane-state 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_SampleRate

Functioncall:

integer retval = ultraschall.SetProject_SampleRate(string projectfilename_with_path, integer sample_rate, integer project_sample_rate, integer force_tempo_time_sig, optional string ProjectStateChunk)

Description:
Sets the project-samplerate-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer sample_rate Project Sample Rate in Hz 
 integer project_sample_rate Checkbox: Project Sample Rate 
 integer force_tempo_time_sig Checkbox: Force Project Tempo/Time Signature changes to occur on whole samples  
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 SetProject_TrackMixingDepth

Functioncall:

integer retval = ultraschall.SetProject_TrackMixingDepth(string projectfilename_with_path, integer mixingdepth, optional string ProjectStateChunk)

Description:
Sets the project-samplerate-state, as set in the project-settings, from an rpp-project-file or a ProjectStateChunk.
Returns -1 in case of error.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 

Parameters:
 string projectfilename_with_path the filename of the projectfile; nil to use Parameter ProjectStateChunk instead 
 integer mixingdepth the track mixing depth
   1 - 32 bit float
   2 - 39 bit integer
   3 - 24 bit integer
   4 - 16 bit integer
   5 - 12 bit integer
   6 - 8 bit integer 
 optional string ProjectStateChunk a projectstatechunk, that you want to be changed 


Reaper version 5.40Lua version 5.3 MoveTrackEnvelopePointsBy

Functioncall:

integer retval = ultraschall.MoveTrackEnvelopePointsBy(number startposition, number endposition, number moveby, MediaTrack MediaTrack, boolean cut_at_border)

Description:
Moves the envelopepoints between startposition and endposition by moveby in MediaTrack.
It moves all trackenvelope-points for all track-envelopes available.

Does NOT move item-envelopepoints!

Returns -1 in case of failure.

Returnvalues:
 integer retval -1 in case of failure 

Parameters:
 number startposition the startposition in seconds 
 number endposition the endposition in seconds 
 number moveby in seconds, negative values: move toward beginning of project, positive values: move toward the end of project 
 MediaTrack MediaTrack the MediaTrack object of the track, where the EnvelopsPoints shall be moved 
 boolean cut_at_border true, cut envelope-points, that would move outside section between startposition and endposition 


Reaper version 5.40Lua version 5.3 GetAllMarkersBetween

Functioncall:

integer number_of_all_markers, array allmarkersarray = ultraschall.GetAllMarkersBetween(number startposition, number endposition)

Description:
To get all Markers in the project(normal, edit, chapter), regardless of their category, between startposition and endposition.
Doesn't return regions!

returns the number of markers and an array with each marker in the format:

    markersarray[index][0] - position
    markersarray[index][1] - name
    markersarray[index][2] - indexnumber of the marker within all markers in the project
    markersarray[index][3] - the shown index-number
    markersarray[index][4] - the color of the marker

returns -1 in case of error    

Returnvalues:
 integer number_of_allmarkers the number of markers returned 
 array allmarkersarray an array, that holds all markers(not regions!) of the project 

Parameters:
 number startposition the earliest position a returned marker may have 
 number endposition the latest position a returned marker may have 


Reaper version 5.40Lua version 5.3 GetAllRegions

Functioncall:

integer number_of_all_regions, array allregionsarray = ultraschall.GetAllRegions()

Description:
To get all Regions in the project(normal, edit, chapter), regardless of their category.
Doesn't return markers!

returns the number of markers and an array with each marker in the format:

    regionarray[index][0] - position
    regionarray[index][1] - endposition
    regionarray[index][2] - name
    regionarray[index][3] - indexnumber of the region within all markers in the project
    regionarray[index][4] - the shown index-number
    regionarray[index][5] - the color of the region
    

Returnvalues:
 integer number_of_allregions the number of regions returned 
 array regionsarray an array, that holds all regions(not markers!) of the project 



Reaper version 5.40Lua version 5.3 GetAllRegionsBetween

Functioncall:

integer number_of_all_regions, array allregionsarray = ultraschall.GetAllRegionsBetween(number startposition, number endposition, boolean partial)

Description:
To get all Regions in the project(normal, edit, chapter), regardless of their category between start- and endposition.
Set partial to true, if you want to get regions as well, that are only partially between start- and endposition
Doesn't return markers!

returns the number of markers and an array with each marker in the format:

    regionarray[index][0] - position
    regionarray[index][1] - endposition
    regionarray[index][2] - name
    regionarray[index][3] - indexnumber of the region within all markers in the project
    regionarray[index][4] - the shown index-number
    regionarray[index][5] - the color of the region
    

Returnvalues:
 integer number_of_allregions the number of regions returned 
 array regionsarray an array, that holds all regions(not markers!) of the project 

Parameters:
 number startposition the earliest position a returned region may have 
 number endposition the latest position a returned region may have 
 boolean retval true, to get regions that are partially within start and endposition as well; false, only regions completely within start/endposition. 


Reaper version 5.40Lua version 5.3 RemoveDuplicateTracksInTrackstring

Functioncall:

integer retval, string trackstring, array trackstringarray, integer number_of_entries = ultraschall.RemoveDuplicateTracksInTrackstring(string trackstring)

Description:
Sorts tracknumbers in trackstring and throws out duplicates. It also throws out entries, that are no numbers.
Returns the "cleared" trackstring as string and as array, as well as the number of entries. Returns -1 in case of failure.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 
 string trackstring the cleared trackstring, -1 in case of error 
 array trackstringarray the "cleared" trackstring as an array 
 integer number_of_entries the number of entries in the trackstring 

Parameters:
 string trackstring the tracknumbers, separated by a comma 


Reaper version 5.40Lua version 5.3 GetMediaItemsAtPosition

Functioncall:

integer number_of_items, array MediaItemArray, array MediaItemStateChunkArray = ultraschall.GetMediaItemsAtPosition(number position, string trackstring)

Description:
Gets all Mediaitems at position, from the tracks given by trackstring.
Returns a MediaItemArray with the found MediaItems; returns -1 in case of error

Returnvalues:
 integer number_of_items the number of items at position 
 array MediaItemArray an array, that contains all MediaItems at position from the tracks given by trackstring. 
 array MediaItemStateChunkArray an array, that contains all Mediaitem's MediaItemStatechunks at position from the tracks given by trackstring. 

Parameters:
 number position position in seconds 
 string trackstring the tracknumbers, separated by a comma 


Reaper version 5.40Lua version 5.3 OnlyMediaItemsOfTracksInTrackstring

Functioncall:

integer retval, array MediaItemArray = ultraschall.OnlyMediaItemsOfTracksInTrackstring(array MediaItemArray, string trackstring)

Description:
Throws all MediaItems out of the MediaItemArray, that are not within the tracks, as given with trackstring.
Returns the "cleared" MediaItemArray; returns -1 in case of error

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 
 array MediaItemArray the "cleared" array, that contains only Items in tracks, as given by trackstring, -1 in case of error 

Parameters:
 array MediaItemArray an array with MediaItems; no nil-entries allowed, will be seen as the end of the array 
 string trackstring the tracknumbers, separated by a comma 


Reaper version 5.40Lua version 5.3 SplitMediaItems_Position

Functioncall:

boolean retval, array MediaItemArray = ultraschall.SplitMediaItems_Position(number position, string trackstring, boolean crossfade)

Description:
Splits items at position, in the tracks given by trackstring.
If auto-crossfade is set in the Reaper-preferences, crossfade turns it on(true) or off(false).

Returns false, in case of error.

Returnvalues:
 boolean retval true - success, false - error 
 array MediaItemArray an array with the items on the right side of the split 

Parameters:
 number position the position in seconds 
 string trackstring the numbers for the tracks, where split shall be applied to; numbers separated by a comma 
 boolean crossfade true or nil, automatic crossfade(if enabled) will be applied; false, automatic crossfade is off 


Reaper version 5.40Lua version 5.3 SplitItemsAtPositionFromArray

Functioncall:

boolean retval, array MediaItemArray = ultraschall.SplitItemsAtPositionFromArray(number position, array MediaItemArray, boolean crossfade)

Description:
Splits items in MediaItemArray at position, in the tracks given by trackstring.
If auto-crossfade is set in the Reaper-preferences, crossfade turns it on(true) or off(false).

Returns false, in case of error.

Returnvalues:
 boolean retval true - success, false - error 
 array MediaItemArray an array with the items on the right side of the split 

Parameters:
 number position the position in seconds 
 array MediaItemArray an array with the items, where split shall be applied to. No nil-entries allowed! 
 boolean crossfade true - automatic crossfade(if enabled) will be applied; false - automatic crossfade is off 


Reaper version 5.95Lua version 5.3 DeleteMediaItem

Functioncall:

boolean retval, string MediaItemStateChunk = ultraschall.DeleteMediaItem(MediaItem MediaItem)

Description:
deletes a MediaItem. Returns true, in case of success, false in case of error.

returns the MediaItemStateChunk of the deleted MediaItem as well, so you can do additional processing with a deleted item.

Returnvalues:
 boolean retval true, delete was successful; false was unsuccessful 
 string MediaItemStateChunk the StateChunk of the deleted MediaItem
the statechunk contains an additional entry "ULTRASCHALL_TRACKNUMBER" which holds the tracknumber, in which the deleted MediaItem was located 

Parameters:
 MediaItem MediaItem the MediaItem to be deleted 


Reaper version 5.95Lua version 5.3 DeleteMediaItemsFromArray

Functioncall:

boolean retval, array MediaItemArray = ultraschall.DeleteMediaItemsFromArray(array MediaItemArray)

Description:
deletes the MediaItems from MediaItemArray. Returns true, in case of success, false in case of error.
In addition, it returns a MediaItemStateChunkArray, that contains the statechunks of all deleted MediaItems

Returnvalues:
 boolean retval true, delete was successful; false was unsuccessful 
 array MediaItemStateChunkArray and array with all statechunks of all deleted MediaItems;
each statechunk contains an additional entry "ULTRASCHALL_TRACKNUMBER" which holds the tracknumber, in which the deleted MediaItem was located 

Parameters:
 array MediaItemArray a array with MediaItem-objects to delete; no nil entries allowed 


Reaper version 5.95Lua version 5.3 DeleteMediaItems_Position

Functioncall:

boolean retval, array MediaItemStateChunkArray = ultraschall.DeleteMediaItems_Position(number position, string trackstring)

Description:
Delete the MediaItems at given position, from the tracks as given by trackstring.
returns, if deleting was successful and an array with all statechunks of all deleted MediaItems

Returnvalues:
 boolean retval true, delete was successful; false was unsuccessful 
 array MediaItemStateChunkArray and array with all statechunks of all deleted MediaItems;
each statechunk contains an additional entry "ULTRASCHALL_TRACKNUMBER" which holds the tracknumber, in which the deleted MediaItem was located 

Parameters:
 number position the position in seconds 
 string trackstring the tracknumbers, separated by a comma 


Reaper version 5.40Lua version 5.3 GetAllMediaItemsBetween

Functioncall:

integer count, array MediaItemArray, array MediaItemStateChunkArray = ultraschall.GetAllMediaItemsBetween(number startposition, number endposition, string trackstring, boolean inside)

Description:
Gets all MediaItems between startposition and endposition from the tracks as given by trackstring.
Set inside to true to get only items, that are fully within the start and endposition, set it to false, if you also want items, that are just partially inside(end or just the beginning of the item).

Returns the number of items, an array with all the MediaItems and an array with all the MediaItemStateChunks of the items, as used by functions as InsertMediaItem_MediaItemStateChunk, reaper.GetItemStateChunk and reaper.SetItemStateChunk.
The statechunks include a new element "ULTRASCHALL_TRACKNUMBER", which contains the tracknumber of where the item originally was in; important, if you delete the items as you'll otherwise loose this information!
Returns -1 in case of failure.

Returnvalues:
 integer count the number of selected items 
 array MediaItemArray an array with all the found MediaItems 
 array MediaItemStateChunkArray an array with the MediaItemStateChunks, that can be used to create new items with InsertMediaItem_MediaItemStateChunk 

Parameters:
 number startposition startposition in seconds 
 number endposition endposition in seconds 
 string trackstring the tracknumbers, separated by a comma 
 boolean inside true, only items that are completely within selection; false, include items that are partially within selection 


Reaper version 5.40Lua version 5.3 MoveMediaItemsAfter_By

Functioncall:

boolean retval = ultraschall.MoveMediaItemsAfter_By(number old_position, number change_position_by, string trackstring)

Description:
Moves all items after old_position by change_position_by-seconds. Affects only items, that begin after oldposition, so items that start before and end after old_position do not move.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true in case of success; false in case of failure 

Parameters:
 number oldposition the position, from where the movement shall be applied to, in seconds 
 number change_position_by the change of the position in seconds; positive - toward the end of the project, negative - toward the beginning. 
 string trackstring the tracknumbers, separated by a comma 


Reaper version 5.40Lua version 5.3 MoveMediaItemsBefore_By

Functioncall:

boolean retval = ultraschall.MoveMediaItemsBefore_By(number old_position, number change_position_by, string trackstring)

Description:
Moves all items before old_position by change_position_by-seconds. Affects only items, that end before oldposition, so items that start before and end after old_position do not move.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true in case of success; false in case of failure 

Parameters:
 number oldposition the position, from where the movement shall be applied to, in seconds 
 number change_position_by the change of the position in seconds; positive - toward the end of the project, negative - toward the beginning. 
 string trackstring the tracknumbers, separated by a comma 


Reaper version 5.40Lua version 5.3 MoveMediaItemsBetween_To

Functioncall:

boolean retval = ultraschall.MoveMediaItemsBetween_To(number startposition, number endposition, number newposition, string trackstring, boolean inside)

Description:
Moves the items between sectionstart and sectionend to newposition, within the tracks given by trackstring.
If inside is set to true, only items completely within the section are moved; if set to false, also items are affected, that are just partially within the section.

Items, that start after sectionstart, and therefore have an offset, will be moved to newposition+their offset. Keep that in mind.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true in case of success; false in case of failure 

Parameters:
 number startposition begin of the item-selection in seconds 
 number endposition end of the item-selection in seconds 
 number newposition new position in seconds 
 string trackstring the tracknumbers, separated by a , 
 boolean inside true, only items completely within the section; false, also items partially within the section 


Reaper version 5.40Lua version 5.3 ChangeLengthOfMediaItems_FromArray

Functioncall:

boolean retval = ultraschall.ChangeLengthOfMediaItems_FromArray(array MediaItemArray, number newlength)

Description:
Changes the length of the MediaItems in MediaItemArray to newlength.
They will all be set to the new length, regardless of their old length. If you want to change the length of the items not >to< newlength, but >by< newlength, use ChangeDeltaLengthOfMediaItems_FromArray instead.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true in case of success; false in case of failure 

Parameters:
 array MediaItemArray an array with items to be changed. No nil entries allowed! 
 number newlength the new length of the items in seconds 


Reaper version 5.40Lua version 5.3 ChangeDeltaLengthOfMediaItems_FromArray

Functioncall:

boolean retval = ultraschall.ChangeDeltaLengthOfMediaItems_FromArray(array MediaItemArray, number deltalength)

Description:
Changes the length of the MediaItems in MediaItemArray by deltalength.
If you want to change the length of the items not >by< deltalength, but >to< deltalength, use ChangeLengthOfMediaItems_FromArray instead.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true in case of success; false in case of failure 

Parameters:
 array MediaItemArray an array with items to be changed. No nil entries allowed! 
 number deltalength the change of the length of the items in seconds, positive value - longer, negative value - shorter 


Reaper version 5.40Lua version 5.3 ChangeOffsetOfMediaItems_FromArray

Functioncall:

boolean retval = ultraschall.ChangeOffsetOfMediaItems_FromArray(array MediaItemArray, number newoffset)

Description:
Changes the audio-offset of the MediaItems in MediaItemArray to newoffset.
It affects all(!) takes that the MediaItems has.
If you want to change the offset of the items not >to< newoffset, but >by< newoffset, use ChangeDeltaOffsetOfMediaItems_FromArray instead.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true, in case of success; false, in case of failure 

Parameters:
 array MediaItemArray an array with items to be changed. No nil entries allowed! 
 number newoffset the new offset of the items in seconds 


Reaper version 5.40Lua version 5.3 ChangeDeltaOffsetOfMediaItems_FromArray

Functioncall:

boolean retval = ultraschall.ChangeDeltaOffsetOfMediaItems_FromArray(array MediaItemArray, number deltaoffset)

Description:
Changes the audio-offset of the MediaItems in MediaItemArray by deltaoffset.
It affects all(!) takes of the MediaItems have.
If you want to change the offset of the items not >by< deltaoffset, but >to< deltaoffset, use ChangeOffsetOfMediaItems_FromArray instead.

Returns false in case of failure, true in case of success.

Returnvalues:
 boolean retval true in case of success; false in case of failure 

Parameters:
 array MediaItemArray an array with items to be changed. No nil entries allowed! 
 number newoffset the new offset of the items in seconds 


Reaper version 5.40Lua version 5.3 SectionCut

Functioncall:

integer number_items, array MediaItemArray_StateChunk = ultraschall.SectionCut(number startposition, number endposition, string trackstring, boolean add_to_clipboard)

Description:
Cuts out all items between startposition and endposition in the tracks given by trackstring.

Returns number of cut items as well as an array with the mediaitem-statechunks, which can be used with functions as InsertMediaItem_MediaItemStateChunk, reaper.GetItemStateChunk and reaper.SetItemStateChunk.
Returns -1 in case of failure.

Returnvalues:
 integer number_items the number of cut items 
 array MediaItemArray_StateChunk an array with the mediaitem-states of the cut items. 

Parameters:
 number startposition the startposition of the section in seconds 
 number endposition the endposition of the section in seconds 
 string trackstring the tracknumbers, separated by , 
 boolean add_to_clipboard true, puts the cut items into the clipboard; false, don't put into the clipboard 


Reaper version 5.40Lua version 5.3 SectionCut_Inverse

Functioncall:

integer number_items_beforestart, array MediaItemArray_StateChunk_beforestart, integer number_items_afterend, array MediaItemArray_StateChunk_afterend = ultraschall.SectionCut_Inverse(number startposition, number endposition, string trackstring, boolean add_to_clipboard)

Description:
Cuts out all items before(!) startposition and after(!) endposition in the tracks given by trackstring; it keeps all items inbetween startposition and endposition.

Returns number of cut items as well as an array with the mediaitem-statechunks, which can be used with functions as InsertMediaItem_MediaItemStateChunk, reaper.GetItemStateChunk and reaper.SetItemStateChunk.
Returns -1 in case of failure.

Returnvalues:
 integer number_items_beforestart the number of cut items before startposition 
 array MediaItemArray_StateChunk_beforestart an array with the mediaitem-states of the cut items before startposition 
 integer number_items_afterend the number of cut items after endposition 
 array MediaItemArray_StateChunk_afterend an array with the mediaitem-states of the cut items after endposition 

Parameters:
 number startposition the startposition of the section in seconds 
 number endposition the endposition of the section in seconds 
 string trackstring the tracknumbers, separated by , 
 boolean add_to_clipboard true, puts the cut items into the clipboard; false, don't put into the clipboard 


Reaper version 5.95Lua version 5.3 PutMediaItemsToClipboard_MediaItemArray

Functioncall:

boolean retval = ultraschall.PutMediaItemsToClipboard_MediaItemArray(MediaItemArray MediaItemArray)

Description:
Puts the items in MediaItemArray into the clipboard.

Returns false in case of an error

Returnvalues:
 boolean retval true, if successful; false, if not 

Parameters:
 MediaItemArray MediaItemArray an array with all MediaItems, that shall be put into the clipboard 


Reaper version 5.40Lua version 5.3 RippleCut

Functioncall:

integer number_items, array MediaItemArray_StateChunk = ultraschall.RippleCut(number startposition, number endposition, string trackstring, boolean moveenvelopepoints, boolean add_to_clipboard)

Description:
Cuts out all items between startposition and endposition in the tracks given by trackstring. After cut, it moves the remaining items after(!) endposition toward projectstart, by the difference between start and endposition.

Returns number of cut items as well as an array with the mediaitem-statechunks, which can be used with functions as InsertMediaItem_MediaItemStateChunk, reaper.GetItemStateChunk and reaper.SetItemStateChunk.
Returns -1 in case of failure.

Returnvalues:
 integer number_items the number of cut items 
 array MediaItemArray_StateChunk an array with the mediaitem-states of the cut items 

Parameters:
 number startposition the startposition of the section in seconds 
 number endposition the endposition of the section in seconds 
 string trackstring the tracknumbers, separated by , 
 boolean moveenvelopepoints moves envelopepoints, if existing, as well 
 boolean add_to_clipboard true, puts the cut items into the clipboard; false, don't put into the clipboard 


Reaper version 5.40Lua version 5.3 RippleCut_Reverse

Functioncall:

integer number_items, array MediaItemArray_StateChunk = ultraschall.RippleCut_Reverse(number startposition, number endposition, string trackstring, boolean moveenvelopepoints, boolean add_to_clipboard)

Description:
Cuts out all items between startposition and endposition in the tracks given by trackstring. After cut, it moves the remaining items before(!) startposition toward projectend, by the difference between start and endposition.

Returns number of cut items as well as an array with the mediaitem-statechunks, which can be used with functions as InsertMediaItem_MediaItemStateChunk, reaper.GetItemStateChunk and reaper.SetItemStateChunk.
Returns -1 in case of failure.

Returnvalues:
 integer number_items the number of cut items 
 array MediaItemArray_StateChunk an array with the mediaitem-states of the cut items 

Parameters:
 number startposition the startposition of the section in seconds 
 number endposition the endposition of the section in seconds 
 string trackstring the tracknumbers, separated by , 
 boolean moveenvelopepoints moves envelopepoints, if existing, as well 
 boolean add_to_clipboard true, puts the cut items into the clipboard; false, don't put into the clipboard 


Reaper version 5.40Lua version 5.3 InsertMediaItem_MediaItem

Functioncall:

integer retval, MediaItem MediaItem, number startposition, number endposition, number length = ultraschall.InsertMediaItem_MediaItem(number position, MediaItem MediaItem, MediaTrack MediaTrack)

Description:
Inserts MediaItem in MediaTrack at position. Returns the newly created(or better: inserted) MediaItem as well as startposition, endposition and length of the inserted item.

Returns -1 in case of failure.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 
 MediaItem MediaItem the newly created MediaItem 
 number startposition the startposition of the inserted MediaItem in seconds 
 number endposition the endposition of the inserted MediaItem in seconds 
 number length the length of the inserted MediaItem in seconds 

Parameters:
 number position the position of the newly created mediaitem 
 MediaItem MediaItem the MediaItem that shall be inserted into a track 
 MediaTrack MediaTrack the track, where the item shall be inserted to 


Reaper version 5.40Lua version 5.3 InsertMediaItem_MediaItemStateChunk

Functioncall:

integer retval, MediaItem MediaItem, number startposition, number endposition, number length = ultraschall.InsertMediaItem_MediaItemStateChunk(number position, string MediaItemStateChunk, MediaTrack MediaTrack)

Description:
Inserts a new MediaItem in MediaTrack at position. Uses a mediaitem-state-chunk as created by functions like GetAllMediaItemsBetween, reaper.GetItemStateChunk and reaper.SetItemStateChunk.. Returns the newly created MediaItem.

Returns -1 in case of failure.

Returnvalues:
 integer retval -1 in case of error, 1 in case of success 
 MediaItem MediaItem the newly created MediaItem 
 number startposition the startposition of the inserted MediaItem in seconds 
 number endposition the endposition of the inserted MediaItem in seconds 
 number length the length of the inserted MediaItem in seconds 

Parameters:
 number position the position of the newly created mediaitem 
 string MediaItemStatechunk the Statechunk for the MediaItem, that shall be inserted into a track 
 MediaTrack MediaTrack the track, where the item shall be inserted to; nil, use the statechunk-entry ULTRASCHALL_TRACKNUMBER for the track instead. 


Reaper version 5.40Lua version 5.3 InsertMediaItemArray

Functioncall:

integer number_of_items, array MediaItemArray = ultraschall.InsertMediaItemArray(number position, array MediaItemArray, string trackstring)

Description:
Inserts the MediaItems from MediaItemArray at position into the tracks, as given by trackstring.

Returns the number of newly created items, as well as an array with the newly create MediaItems.
Returns -1 in case of failure.

Note: this inserts the items only in the tracks, where the original items came from. Items from track 1 will be included into track 1. Trackstring only helps to include or exclude the items from inclusion into certain tracks.
If you have a MediaItemArray with items from track 1,2,3,4,5 and you give trackstring only the tracknumber for track 3 and 4 -> 3,4, then only the items, that were in tracks 3 and 4 originally, will be included, all the others will be ignored.

Returnvalues:
 integer number_of_items the number of MediaItems created 
 array MediaItemArray an array with the newly created MediaItems 

Parameters:
 number position the position of the newly created mediaitem 
 array MediaItemArray an array with the MediaItems to be inserted 
 string trackstring the numbers of the tracks, separated by a , 


Reaper version 5.40Lua version 5.3 GetMediaItemStateChunksFromItems

Functioncall:

integer number_of_items, array MediaItemArray_StateChunks = ultraschall.GetMediaItemStateChunksFromItems(array MediaItemArray)

Description:
Returns the MediaItem-StateChunks for all MediaItems in MediaItemArray. It returns the number of items as well as an array, with each entry one MediaItemStateChunk.

StateChunks are used by the reaper-functions reaper.GetItemStateChunk and reaper.SetItemStateChunk.

Returns -1 in case of failure.

Returnvalues:
 integer number_of_items the number of trackstatechunks, usually the same as MediaItems in MediaItemArray 
 array MediaItemArray_StateChunks an array with the StateChunks of the MediaItems in MediaItemArray 

Parameters:
 array MediaItemArray an array with the MediaItems you want the statechunks of 


Reaper version 5.40Lua version 5.3 RippleInsert

Functioncall:

integer number_of_items, array MediaItemArray, number endpos_inserted_items = ultraschall.RippleInsert(number position, array MediaItemArray, string trackstring, boolean moveenvelopepoints, boolean movemarkers)

Description:
It inserts the MediaItems from MediaItemArray at position into the tracks, as given by trackstring. It moves the items, that were there before, accordingly toward the end of the project.

Returns the number of newly created items, as well as an array with the newly created MediaItems and the endposition of the last(projectposition) inserted item into the project.
Returns -1 in case of failure.

Note: this inserts the items only in the tracks, where the original items came from. Items from track 1 will be included into track 1. Trackstring only helps to include or exclude the items from inclusion into certain tracks.
If you have a MediaItemArray with items from track 1,2,3,4,5 and you give trackstring only the tracknumber for track 3 and 4 -> 3,4, then only the items, that were in tracks 3 and 4 originally, will be included, all the others will be ignored.

Returnvalues:
 integer number_of_items the number of newly created items