Overview
The current MADRIX Script version is 3.23.
There are a lot of new features within MADRIX and therefore also in MADRIX Script.
News For Script Engine Version 3.23 (MADRIX 5.7)
New General Functions:
▪GetMadrixTime
▪lerp
▪clamp
▪fclamp
▪step
▪smoothstep
Updated General Functions:
▪GetTime
▪GetDate
▪CreatePixelTransposeTable
New Global Macro Functions:
▪CuelistPause
▪SetupRegisterLoadById
▪SetupRegisterLoadNext
▪SetupRegisterLoadPrevious
▪TimelinesGetDuration
New Storage Place Macro Functions:
▪GetPlaceTime
New Effect Macro Functions:
▪GetEffectTime
▪GradientSetColorPositionRelativeDistances
New MAS Functions:
▪GetEffectTime
Updated Functions For Trigger Effects (TRI):
▪SetTriggerPort
New Effect SCE Bar Bounce:
▪SetColorMode
▪GetColorMode
▪SetInterpolationType
▪GetInterpolationType
▪SetWidth
▪GetWidth
▪SetPeakWidth
▪GetPeakWidth
▪SetPeakPosition
▪GetPeakPosition
▪SetCrossWidth
▪GetCrossWidth
▪SetCrossAxes
▪GetCrossAxes
▪SetCount
▪GetCount
▪SetColorFadeIn
▪GetColorFadeIn
▪SetColorFadeOut
▪GetColorFadeOut
▪SetBounceMode
▪GetBounceMode
▪SetDisplayMode
▪GetDisplayMode
▪SetDisplacement
▪GetDisplacement
▪SetDisplacementSpeed
▪GetDisplacementSpeed
▪SetDisplacementDistribution
▪GetDisplacementDistribution
New Effect SCE Cells:
▪SetCount
▪SetCountX
▪GetCountX
▪SetCountY
▪GetCountY
▪SetCountZ
▪GetCountZ
▪SetSize
▪GetSize
▪SetOuterGlow
▪GetOuterGlow
▪SetRenderingMode
▪GetRenderingMode
▪SetCellDistribution
▪SetCellDistributionX
▪GetCellDistributionX
▪SetCellDistributionY
▪GetCellDistributionY
▪SetCellDistributionZ
▪GetCellDistributionZ
▪SetInterpolationType
▪GetInterpolationType
New Functions For SCE Capture, SCE Image, SCE Screen Capture, SCE Video:
▪SetDynamicRange
▪GetDynamicRangeMin
▪GetDynamicRangeMax
News For Script Engine Version 3.18 (MADRIX 5.6)
New General Functions:
▪SetGlobalInt
▪GetGlobalInt
▪ResetGlobalInt
▪GetGlobalIntCount
▪SetGlobalIntRange
▪GetGlobalIntRange
▪SetGlobalFloat
▪GetGlobalFloat
▪ResetGlobalFloat
▪GetGlobalFloatCount
▪SetGlobalFloatRange
▪GetGlobalFloatRange
▪SetGlobalString
▪GetGlobalString
▪ResetGlobalString
▪GetGlobalStringCount
▪SetGlobalStringRange
▪GetGlobalStringRange
▪SetGlobalColor
▪GetGlobalColor
New Global Macro Functions:
▪SetFilterColorByGlobalId
▪GetFilterColorGlobalId
▪SetStrobeColorByGlobalId
▪GetStrobeColorGlobalId
New Functions For Cue List:
▪CuelistSetPlaybackMode
▪CuelistGetPlaybackMode
New Functions For Color Table:
▪ColorTableSetByGlobalId
▪ColorTableGetGlobalId
New Functions For Color Gradient:
▪GradientSetByGlobalId
▪GradientGetGlobalId
New Functions For M2L Color Table:
▪M2LColorTableSetByGlobalId
▪M2LColorTableGetGlobalId
New Functions For SCE Explosions:
▪SparkleColorTableSetByGlobalId
▪SparkleColorTableGetGlobalId
New Functions For S2L Frequency Flash:
▪SetThreshold
▪GetThreshold
▪SetFrequency
▪GetFrequency
▪SetBandwidth
▪GetBandwidth
▪Note: SetSensitivity(), GetSensitivity(), SetMinBand(), GetMinBand(), SetMaxBand(), GetMaxBand() have been deprecated [in MADRIX Version 5.6 / Script Version 3.18].
New Functions For M2L Note Flash:
▪SetThreshold
▪GetThreshold
▪SetTone
▪GetTone
▪SetBandwidth
▪GetBandwidth
▪Note: SetSensitivity(), GetSensitivity(), SetMinBand(), GetMinBand(), SetMaxBand(), GetMaxBand() have been deprecated [in MADRIX Version 5.6 / Script Version 3.18].
Updated S2L Functions [Now Also Available in Storage Place Macro and Global Macro]:
▪GetSoundLevel
Updated M2l Functions [Now Also Available in Storage Place Macro and Global Macro]:
▪GetNoteValue
▪GetBassValue
▪GetAllNoteValues
▪GetAllIntervals
▪IsInterval
▪IsNote
▪GetTonality
▪GetBassTone
▪GetBassType
▪GetToneScale
▪IsTonality
Updated Fields Now Also Available in Storage Place Macro and Global Macro:
▪SOUND_DATA_LEFT
▪SOUND_DATA_RIGHT
Updated Structures:
▪struct time / struct timecode
Notes:
- struct time has been converted to struct timecode.
- Existing scripts and macros will continue to work as expected.
- From now on, use struct timecode instead.
- The following functions should be used with struct timecode from now on:
GetTime(), GetTimeSunrise(), GetTimeSunset(), GetTimeSunriseCity(), GetTimeSunsetCity(), GetVideoLength(), SetVideoTime(), GetVideoTime(), SetVideoStartTime(), GetVideoStartTime(), SetVideoEndTime(), GetVideoEndTime()
News For Script Engine Version 3.14 (MADRIX 5.5)
New Effects:
▪SCE Morse Code
New Functions And Constants For SCE Fill Drops, SCE Fill Random, And SCE Fill Snake:
▪SetBlendingMode
▪GetBlendingMode
▪BLENDING_MODE_ALPHA
▪BLENDING_MODE_SUBSTITUTION
▪SetFlush
▪GetFlush
New Functions For SCE Video:
▪SetHue
▪GetHue
▪SetSaturation
▪GetSaturation
▪SetBrightness
▪GetBrightness
▪SetContrast
▪GetContrast
New Functions For S2L EQ Spectrum:
▪SetDisplayRangeMin
▪GetDisplayRangeMin
▪SetDisplayRangeMax
▪GetDisplayRangeMax
▪SetFrequencyRangeMin
▪GetFrequencyRangeMin
▪SetFrequencyRangeMax
▪GetFrequencyRangeMax
▪Note: DIRECTION_RADIAL has been deprecated for S2L EQ / Spectrum [in MADRIX Version 5.5 / Script Version 3.14]. Use DIRECTION_RADIAL_SLICES or DIRECTION_RADIAL_BARS instead.
New Functions For M2L Single Tone Spectrum:
▪SetDisplayRangeMin
▪GetDisplayRangeMin
▪SetDisplayRangeMax
▪GetDisplayRangeMax
New General Functions For TRI Effects:
▪AddTrigger
▪SetTriggerPort
▪GetTriggerPort
New General Functions:
▪GetMidiOutCount
▪HasMidiOut
▪IsMidiOutEnabled
▪SendMidiNote
▪SendMidiControl
▪SendMidiMessage
Updated General Functions:
▪GetTimeCode
▪GetMidiInControl
▪GetMidiInControlValue
▪GetMidiInNote
▪GetMidiInNoteValue
New Global Macro Functions:
▪CuelistsGetCount
▪CuelistsSelect
▪CuelistsGetSelected
▪TimelinesGetCount
▪TimelinesSelect
▪TimelinesGetSelected
▪TimelinesGetActive
▪TimelinesPlay
▪TimelinesPause
▪TimelinesStop
▪TimelinesIsPlaying
▪TimelinesIsPaused
▪TimelinesIsStopped
▪TimelinesGetTimeCode
▪TimelinesGetStartTimeCode
▪TimelinesGetEndTimeCode
▪TimelinesGotoTimeCode
▪TimelinesGetMarkerCount
▪TimelinesGotoMarker
▪TimelinesGetCueSegmentCount
▪TimelinesGotoCueSegment
▪TimelinesGetAudioSegmentCount
▪TimelinesGotoAudioSegment
Updated Global Macro Functions:
▪CueSetTimeCode
▪CueSetDuration
▪CueSetTimeCodeString
▪CueSetDurationString
New Global Structure:
▪timecode
News For Script Engine Version 3.12 (MADRIX 5.3)
Added Support For:
▪BlackTrax
New General Functions:
▪FilterColor
▪CaptureScreen
▪DrawPixelBitmap
▪DrawVectorBitmap
▪DrawPixelBitmap3D
▪DrawVectorBitmap3D
New Functions For the Global Macro:
▪ImportFixtureGroupController
News For Script Engine Version 3.10 (MADRIX 5.1)
New Effects:
▪SCE Credits
▪SCE Split Shapes
▪SCE Water
▪TRI Flash
▪TRI Fluid
▪TRI Split Shapes
▪TRI Water
New Functions For SCE Capture:
▪SetAlphaBlending
▪GetAlphaBlending
New Functions For SCE Gradient And SCE Wave / Radial:
▪SetDisplacement
▪GetDisplacement
▪SetDisplacementSpeed
▪GetDisplacementSpeed
▪SetDisplacementDistribution
▪GetDisplacementDistribution
Changed Functions For SCE Wave / Radial
▪SetPeak
▪GetPeak
New And Updated Functions For MADRIX Effects That Use The Shape Table:
▪ShapeTableSetShapeMinSize
▪ShapeTableGetShapeMinSize
▪ShapeTableAddShape
New And Updated Functions for MADRIX Effects That Use The String Table:
▪StringTableGetPagesCount
▪StringTableAddPage
▪StringTableRemovePage
▪StringTableMovePageToNext
▪StringTableMovePageToPrev
▪StringTableInvertPages
▪StringTableSwapPages
▪StringTableGetCount
▪StringTableMoveStringUp
▪StringTableMoveStringDown
▪StringTableInvert
▪StringTableSwapStrings
▪StringTableGetString
▪StringTableSetString
▪StringTableAddString
▪StringTableRemoveString
New Functions For SCE Drops, S2L Drops, M2L Drops, And TRI Drops:
▪SetPeak (now uses float instead of int)
▪GetPeak (now uses float instead of int)
New Constants For Effects That Use Rendering Mode Extended:
▪SHAPE_TYPE_PENTAGON_OUTLINED
▪SHAPE_TYPE_PENTAGON_OUTLINED_IMPLODE
▪SHAPE_TYPE_PENTAGON_OUTLINED_EXPLODE
▪SHAPE_TYPE_PENTAGON_OUTLINED_PULSE
▪SHAPE_TYPE_PENTAGON_FILLED
▪SHAPE_TYPE_PENTAGON_FILLED_IMPLODE
▪SHAPE_TYPE_PENTAGON_FILLED_EXPLODE
▪SHAPE_TYPE_PENTAGON_FILLED_PULSE
▪SHAPE_TYPE_HEXAGON_OUTLINED
▪SHAPE_TYPE_HEXAGON_OUTLINED_IMPLODE
▪SHAPE_TYPE_HEXAGON_OUTLINED_EXPLODE
▪SHAPE_TYPE_HEXAGON_OUTLINED_PULSE
▪SHAPE_TYPE_HEXAGON_FILLED
▪SHAPE_TYPE_HEXAGON_FILLED_IMPLODE
▪SHAPE_TYPE_HEXAGON_FILLED_EXPLODE
▪SHAPE_TYPE_HEXAGON_FILLED_PULSE
News For Script Engine Version 3.08 (MADRIX 5.0e)
Updated Functions And Constants For The Global Macro:
▪CueSetTimeCode
▪CueSetDuration
▪LEFT, RIGHT, and MAIN (streamlined from STORAGE_LEFT and STORAGE_RIGHT)
News For Script Engine Version 3.07 (MADRIX 5.0c)
New Effects:
▪SCE Rotating Shapes
▪TRI Shapes
New Functions And Constants For MADRIX Effects That Use The Shape Table:
▪ShapeTableGetShapeCount
▪ShapeTableMoveShapeUp
▪ShapeTableMoveShapeDown
▪ShapeTableSwapShapes
▪ShapeTableAddShape
▪ShapeTableRemoveShape
▪ShapeTableSetShapeType
▪ShapeTableGetShapeType
▪ShapeTableSetShapeAlignment
▪ShapeTableGetShapeAlignment
▪ShapeTableSetShapeOrigin
▪ShapeTableGetShapeOrigin
▪ShapeTableSetShapeInnerGlow
▪ShapeTableGetShapeInnerGlow
▪ShapeTableSetShapeBorder
▪ShapeTableGetShapeBorder
▪ShapeTableSetShapeOuterGlow
▪ShapeTableGetShapeOuterGlow
▪ShapeTableSetMode
▪ShapeTableGetMode
▪SHAPETABLE_MODE_LOOP
▪SHAPETABLE_MODE_SHUFFLE
New Functions For SCE Drops, S2L Drops, And M2L Drops:
▪Shape Table
▪Shape Rotation
▪SetLengthMin
▪GetLengthMin
▪SetPixelLengthMin
▪GetPixelLengthMin
▪SetLengthMax
▪GetLengthMax
▪SetPixelLengthMax
▪GetPixelLengthMax
▪SetLengthDistribution
▪GetLengthDistribution
▪SeedRandomLength
▪SetRotationOffset
▪GetRotationOffset
▪SetDisplacement
▪GetDisplacement
▪SetDisplacementSpeed
▪GetDisplacementSpeed
▪SetDisplacementDistribution
▪GetDisplacementDistribution
New Constants For MADRIX Effects That Use Shapes And For RenderShape:
▪ORIGIN_GEOMETRIC_CENTER
News For Script Engine Version 3.04 (MADRIX 5.0)
▪MADRIX 5.0 includes a large number of (technical) improvements. That is why parts of Script Engine Version 3.04 were updated as well.
▪Previous macros and scripts written for MADRIX 3.X should work for MADRIX 5.X without any changes in most cases.
New Effects:
▪TRI Color Change
▪TRI Drops
▪TRI Explosions
▪TRI Tubes
New Filters (FX):
▪FILTER_BRIGHTNESS_GRAPH_XYZ
▪FILTER_BRIGHTNESS_GRAPH_XZY
▪FILTER_BRIGHTNESS_GRAPH_YXZ
▪FILTER_RGB_TO_BGR
▪FILTER_RGB_TO_BRG
▪FILTER_RGB_TO_GRB
▪FILTER_RGB_TO_GBR
▪FILTER_RGB_TO_RBG
▪FILTER_RGBW_TO_WBGR
▪FILTER_RGBW_TO_WBRG
▪FILTER_RGBW_TO_WGRB
▪FILTER_RGBW_TO_WGBR
▪FILTER_RGBW_TO_WRBG
▪FILTER_RGBW_TO_WRGB
▪FILTER_RGBW_TO_BWGR
▪FILTER_RGBW_TO_BWRG
▪FILTER_RGBW_TO_GWRB
▪FILTER_RGBW_TO_GWBR
▪FILTER_RGBW_TO_RWBG
▪FILTER_RGBW_TO_RWGB
▪FILTER_RGBW_TO_BGWR
▪FILTER_RGBW_TO_BRWG
▪FILTER_RGBW_TO_GRWB
▪FILTER_RGBW_TO_GBWR
▪FILTER_RGBW_TO_RBWG
▪FILTER_RGBW_TO_RGWB
▪FILTER_SWAP_H_1X
▪FILTER_SWAP_H_2X
▪FILTER_SWAP_H_3X
▪FILTER_SWAP_H_4X
▪FILTER_SWAP_H_5X
▪FILTER_SWAP_V_1X
▪FILTER_SWAP_V_2X
▪FILTER_SWAP_V_3X
▪FILTER_SWAP_V_4X
▪FILTER_SWAP_V_5X
▪FILTER_SWAP_HV_1X
▪FILTER_SWAP_HV_2X
▪FILTER_SWAP_HV_3X
▪FILTER_SWAP_HV_4X
▪FILTER_SWAP_HV_5X
▪FILTER_SWAP_D_1X
▪FILTER_SWAP_D_2X
▪FILTER_SWAP_D_3X
▪FILTER_SWAP_D_4X
▪FILTER_SWAP_D_5X
▪FILTER_SWAP_HD_1X
▪FILTER_SWAP_HD_2X
▪FILTER_SWAP_HD_3X
▪FILTER_SWAP_HD_4X
▪FILTER_SWAP_HD_5X
▪FILTER_SWAP_VD_1X
▪FILTER_SWAP_VD_2X
▪FILTER_SWAP_VD_3X
▪FILTER_SWAP_VD_4X
▪FILTER_SWAP_VD_5X
▪FILTER_SWAP_HVD_1X
▪FILTER_SWAP_HVD_2X
▪FILTER_SWAP_HVD_3X
▪FILTER_SWAP_HVD_4X
▪FILTER_SWAP_HVD_5X
New Functions For MADRIX Effects That Use The Center Control:
▪SetCenterX
▪GetCenterX
▪SetCenterY
▪GetCenterY
▪SetCenterZ
▪GetCenterZ
▪SetCenter
▪SetPixelCenterX
▪GetPixelCenterX
▪SetPixelCenterY
▪GetPixelCenterY
▪SetPixelCenterZ
▪GetPixelCenterZ
▪SetPixelCenter
New Functions For SCE Wave / Radial:
▪Center Control (replaces the Position Control)
New Functions For SCE Graph:
▪SetShapeRotation
▪GetShapeRotation
▪SetBorder
▪GetBorder
▪SetPixelBorder
▪GetPixelBorder
▪SetOuterGlow
▪GetOuterGlow
▪SetPixelOuterGlow
▪GetPixelOuterGlow
▪SetInnerGlow
▪GetInnerGlow
▪SetPixelInnerGlow
▪GetPixelInnerGlow
New Functions For SCE Starfield:
▪SetShapeRotation
▪GetShapeRotation
▪SetRenderingMode
▪GetRenderingMode
▪SetPathAligned
▪GetPathAligned
▪SetBorder
▪GetBorder
▪SetPixelBorder
▪GetPixelBorder
▪SetOuterGlow
▪GetOuterGlow
▪SetPixelOuterGlow
▪GetPixelOuterGlow
▪SetInnerGlow
▪GetInnerGlow
▪SetPixelInnerGlow
▪GetPixelInnerGlow
New Functions For The Effect Parameter Chaser:
▪ChaserSetAutostart
▪ChaserGetAutostart
▪ChaserToggleAutostart
New Functions And Constants For The Cue List:
▪CuelistSetTimecodeSource
▪CuelistGetTimecodeSource
▪CuelistSetTimecodeFormat
▪CuelistGetTimecodeFormat
▪TIMECODE_SOURCE_NONE
▪TIMECODE_SOURCE_ARTNET
▪TIMECODE_SOURCE_MIDI
▪TIMECODE_SOURCE_SMPTE
▪TIMECODE_SOURCE_SYSTEM_TIME
▪TIMECODE_FORMAT_24_FPS
▪TIMECODE_FORMAT_25_FPS
▪TIMECODE_FORMAT_30_DROP
▪TIMECODE_FORMAT_30_FPS
New Functions For The Global Macro:
▪GetAudioInputFader (replaces GetAudioFader)
▪SetAudioInputFader (replaces SetAudioFader)
▪GetAudioInputMute
▪SetAudioInputMute
▪GetAudioOutputFader
▪SetAudioOutputFader
▪GetAudioOutputMute
▪SetAudioOutputMute
New Functions:
▪Numbers starting with 0x are interpreted as hexadecimal values
▪hex
▪Hex
New Graphical User Interface Elements:
▪ctrlcheckbutton
▪ctrlcheckbutton2
▪ctrlcheckbutton3
▪ctrlcheckbutton4
▪ctrlcheckbutton5
▪ctrlcheckbutton6
Changed Functions:
▪PixelFloodFill now has an optional parameter to specify the z-plane
▪VectorFloodFill now has an optional parameter to specify the z-plane
▪ReadAsync now has an optional parameter to specify the file encoding
New Operators For Expressions:
▪++ (as prefix)
▪-- (as prefix)
▪~
▪^ and ^=
▪| and |=
▪& and &=
▪<< and <<=
▪>> and >>=
▪>>> and >>>=