Multistep Envelope User Manual The multistep envelope is a time/level type, where you specify levels, and the

times that it takes to get from one level to the next. Levels are specified by inserting breakpoints along a line, then moving the breakpoints up or down to change levels, and left or right to change times. To insert a breakpoint do right-click wherever you want one. To delete a breakpoint do a right-click on it. The first and last breakpoints move up and down together, because the envelope starts from where it ended. There are two breakpoints with a vertical red line running thru them. If there is no other breakpoint between them, the red lines indicate the segment where the envelope reaches the sustain level, marked by the hori!ontal red line. "n this level the envelope stays as long as the key is held down. If you insert one or more breakpoints between the red markers the sustain segment becomes a loop . This means that this part will be repeated as long as the note is sustained. If there are more than # breakpoints the sustain or loop segment can be shifted by moving the vertical red lines with the mouse. They snap to the next breakpoint, except the start and the end point. $lease note that the envelope doesn%t &ump from the loop end to the loop start. Instead it starts a segment from the loop end to the next breakpoint to the right of the loop start breakpoint. The interrupted line indicates this segment. If you want to simulate a &ump from the loop end to the loop start you need to insert a short segment at the end or beginning of the loop, which performs this &ump. 'pon releasing the key, the envelope continues with the segments after the second red marker. If it reaches the end breakpoint, it holds the end level until the envelope is started again. (ragging the small s)uares between breakpoints can change the line*s shape between the breakpoints from concave, to straight, to convex. Zoom and Envelope Ruler There are two ways to set the visible range of the envelope. +ou can use the background of the envelope as well as the the ruler underneath the envelope, If you click on the background of the envelope without hitting the envelope itself, you can shift the envelope and !oom in/out simultaneously, (ragging to the left or right shifts the envelope, dragging up !ooms out and dragging down !ooms in. If you want to shift and !oom in/out independendly you can use the ruler. 'se the left mouse to shift and the right mouse to !oom in. (ouble-click on the ruler or on envelope display to set the !oom factor so that the whole envelope fits on the display. $lease note that the !oom factor does not only change the display, but also sets the )uanti!ation time for the %Tempo -ync% function .described later/. 0ote also that when

!ooming, the point of the envelope where you right click is fixed. 1hen !ooming out this is only the case until the beginning of the envelope is visible at the left end of the ruler. 'pon further !ooming out, the !ero point becomes fixed. Envelope Parameter Displays and Functions 0ow let*s investigate the envelope parameter displays and functions above the envelope. 2licking on a number and dragging up or down edits the value. -ome of them also update automatically if you select another breakpoint. Step shows the index number of the selected breakpoint. 2licking on it and dragging up or down selects another breakpoint. Last shows and sets the total number of envelope breakpoints. The maximum number is 34. Mode has two options, %-ticky% and %5ix%. In %-ticky% mode, if you move a breakpoint left or right, the envelope to the right of the breakpoint moves as well to maintain the same times and levels past the breakpoint being edited. In %5ix% mode, the total envelope time doesn*t change. 6oving a breakpoint to the right not only lengthens its distance compared to the breakpoint to its left, but shortens the distance compared to the breakpoint at its right. Time Abs, shortform of absolute time, shows and sets the amount of time in seconds from the start of the envelope to the breakpoint being edited. Time Rel, shortform of relative time, shows and sets the amount of time in seconds from the breakpoint being edited to the breakpoint at its immediate left. Level shows and sets the breakpoint level. Shape shows and sets the shape of the line between breakpoints. 4.3 indicates a straight line. 7 indicates a maximally convex curve. 4.43 indicates a maximally concave curve. Sync, shortform of %Tempo -ync%, superimposes a grid on the envelope display that corresponds to rhythmic values, such as )uarter notes, eighth notes, 78th notes, etc. 9reakpoints can be snapped to these points. The )uanti!ation value depends on the current !oom factor .see section %:oom and ;nvelope <uler%/. If the incoming tempo information at the 9$6 input of the macro .see below/ changes, the envelope times are re-computed to match the current song tempo. ;xample, If the envelope loop is set to a 7 beat duration, it will remain 7 beat long as the tempo changes. If an envelope has already been created, enabling Tempo -ync will not change the existing breakpoints. =owever, you can edit an existing envelope by moving the breakpoints so that they snap to the nearest )uanti!ation value. $lease note that the breakpoints are snapping to the )uantisation points if they are dragged by the mouse. If the time values are changed by clicking and dragging on the

%Time >bs% and %Time <el% displays they do not snap, which allows %in between% values. The displayed times do not vary with changing tempo. Instead they are calculated for a tempo of 7?4 9$6 .beats per minute/. 1hich means a length of ? seconds e)uals a whole note or one bar. Grid shows the calibration of the ruler markings. 1hen %Tempo -ync% is enabled, the ruler markings will be calibrated in rhythmic values instead of seconds. The grid si!e depends on the current !oom factor .see section % Zoom and Envelope Ruler'/. 2licking and dragging this display sets the !oom factor. Beat Time shows and sets the absolute time of the breakpoint being edited in rhythm notation. The first value is the number of bar, the second indicates the 7/@ note in that bar and the third the 7/78 note in that 7/@ note. The counting starts with 7. 1hich means the start of the envelope is 7/7/7. The displayed beat time do not vary with changing tempo. Instead it is calculated for a tempo of 7?4 9$6 .beats per minute/. $lease note that the resolution of the beat time display is limited to 78th notes. -o it is possible that the actual segment time is in between two 78th notes. Envelope Preset offers a drop-down menu that comes with several common envelope types. L means %Load% and lets you load the selected envelope from the preset list. - means %-tore and lets you save the current envelope in the preset list. To save an envelope you created, select an envelope in the list and click on the %-%-button. +ou can change the name of the stored envelopes in the properties of the preset list. Builder Manual: Important note, The envelope does not work correctly in ensembles set to %<eaktor @ Legacy 6ode%. It will not initialise in the right way. $lease make sure that %<eaktor @ Legacy 6ode% in the left-most folder of the ensemble properties is not checkedAA Macro Inputs G Input for the Bate signal. .B/ C 4 starts the envelope and determines it%s peak value. .B/ D 4 starts the release period. TMd sets the re-trigger mode. It defines the way the envelope starts at incoming Bate signals. 1ith 4 the envelope first resets to the level of the start breakpoint .the first visible breakpoint from the left/ before it starts the first segment. 1ith 7 the envelope starts at its current level. 1ith ? the envelope will start at its current level if the first segment is shorter than 744 ms, otherwise it will make a short additional segment of 3 ms to the start breakpoint. >fter that the actual first segment starts. 6ode 7 and ? help to reduce glitches if note stealing occurs, which means if the envelope is retriggered before it reaches its end. 6ode ? makes sure that the first segment .with a duration longer than 744 ms/ sounds always the same no matter if note stealing occurs or not."nly the additional 3 ms segment will sound differently, depending on the current level of the envelope at trigger trime. 6ode 4 can be used for

modulation if note stealing is not a problem, e.g. pitch modulation, wavetable modulation etc. BPM sets the tempo in beats per minutes. The envelope times are synced to this tempo if %Tempo -ync% is enabled. TSc sets the time scaling. The segment times are multiplicated by this factor. > valueD7 leaves them unaltered. This input can be used to implement velocity sensitivity of the segment times. Ho to customi!e" The envelope can be customi!ed in some aspects. 6ainly regarding the look of it. The paths in the following text refers to the macro hierarchy inside the envelope%s main macro. #b$ect %olours .B'I/Braph (isplay/2olor 2onstants/ The color of the following ob&ects in the envelope display can be set, breakpoints, shapepoints, conecting line between breakpoints, loop markers, frame around the envelope field, the middle line in the bipolar envelope and the beat grid including different transparencies for bars, 7/@ notes. 5or the ruler the colour of the grid can be set. >ll values should be in the range 4 to 7. 6ore infos can be found in the mouse over help of the constant names. The Bac&'round %olours of the envelope display and the ruler can be set in the properties of the corresponding %multi displays%. These can be found on the panel underneath the mouse area modules of the displays. In the structure you can find these modules in the following macros, ;nv (isplay, .B'I/Braph (isplay/, <uler (isplay .B'I/Braph (isplay/<uler/ The Si!e o( the Envelope )isplay and the Ruler can be set in the properties of the corresponding %multi displays% .see %background colours% for location/. It is necessary that the ruler and the envelope display have the same %-i!e E% number and that the mouse area modules on top of the multi displays have the same si!e as the multi display underneath themA If you change the si!e of the envelope display, you must also set the %E $ixel% and %+ $ixel% constants in B'I/Braph (isplay/2onstants macro to the same values as in the multi display. >fter changing the si!e &ust click on the display so the graphic is redrawn. The numbers of + pixels of the envelope display determines the stepsi!e when a breakpoint is dragged with the mouse in vertical direction to change the level. The connection between value range, numbers of + pixel, breakpoint si!e in pixel .see below/ and stepsi!e is the following, unipolar .value range 4 to 7/, stepsi!eD7/.+ pixel - breakpoint si!e in pixel/ bipolar .value range -7 to 7/, stepsi!eD?/.+ pixel - breakpoint si!e in pixel/ 5or instance, to achieve a stepsi!e of .47 with an unipolar ..4? with a bipolar/ envelope you can choose following combinations, -i!e 9rkpD3, + $ixelD 743 -i!e 9rkpDF, + $ixelD 74F

-i!e 9rkpDG, + $ixelD 74G etc. The Si!e o( the Brea&points and Shapepoints in pixels can be set in B'I/Braph (isplay/2onstants with the %-i!e 9rkp% and %-i!e -h% constants. $lease note that they have to be an odd number, due to symmetry reasons. ;ven numbers are converted internally to odd numbers and the given e)uation in the previous section concerning the stepsi!e isn%t true anymoreA The %lic& Tolerance can be set with the constant %2lick Tol% in pixels. This value increases the click area which lets you select the breakpoint or shapepoint. :ero means that you need to hit inside the s)uares, one means that you can click also one pixel beside them to select them. The Len'th o( the Grid Lines o( the Ruler in %Tempo -ync% can be set with the %Length 9ar%, %Length 7/@%, %Length <est%. >s the names indicate, you can set different length for grid lines that fall on the beginning of a bar, for 7/@ notes between bars, and the %rest%, which are grid lines between 7/@ notes. The length is set in relation to the ruler heigth. "ne means that the line goes from the top to the bottom of the ruler. The Ma*imum +umbers o( Grid Lines can be set with %6ax B 9% .for %Tempo -ync% enabled/ and %6ax B T% .for %Tempo -ync% disabled/. These values can be ad&usted to the E si!e of the envelope display &udged by personal taste. 1ith increasing E si!es of the envelope display, there is space for more grid lines, so the maximum number could be increased. 0ote, If one of these values is changed it might be necessary to ad&ust the numbers of ob&ects of the multi display of the envelope >0( the rulerAA. To find out the needed numbers of ob&ects &ust look at the value at the upper input of the substract module underneath the envelope >0( ruler multidisplay in the structure and type that number in the %number of ob&ects% field of the properties of the multi displays. (oublecheck if the output of the subtract module is !eroA .see %background colours% for the location of the multidisplays/. The +umbers o( Linear Subse'ments in the )isplay can be set in with the %-ubsegs% constant.If this value is changed it is necessary to ad&ust the numbers of ob&ects of the multi display of the envelope. To find out the needed numbers of ob&ects &ust look at the value at the upper input of the substract module underneath the multidisplay in the structure and type that number in the %number of ob&ects% field of the properties of the multi display. (oublecheck if the output of the subtract module is !eroA .see %background colours% for the location of the multidisplay/. To change the Ma*imum +umbers o( Brea&points the new number has to be typed in at several different module properties. It is necessary to type in the same value in all of themA, 7. B'I/6emory -ocket/6emory $lugin, the array si!e of all %snap value HI% modules have to be set to this new number.

?. Bui/$reset, the %+ -i!e% value of the following event table modules have to be set to the new value, Time, >bs Time, Level, -hape #. >udio ;ngine/>rray and 6arker/>rray of 9rkpnts 1rite, The si!e of all arrays has to be set to the new value. @. If the maximum numbers of breakpoints is changed it is necessary to ad&ust the numbers of ob&ects of the multi display of the envelope. To find out the needed numbers of ob&ects &ust look at the value at the upper input of the substract module underneath the multidisplay in the structure and type that number in the %number of ob&ects% field of the properties of the multi display. (oublecheck if the output of the subtract module is !eroA .see %background colours% for the location of the multidisplay/. 3. $lease make sure that the mouse over text of the Last display mentions the right maximum number of breakpoints. In B'I/Braph (isplay/2onstants you can also specify the Ma*imum Time a segment can have. This value should not be greater than GGGGGG, which corresponds to GGG seconds. In .>udio ;ngine/2onstants/ you can set the following parameters, Attac& Thresh, -ets the Threshold o( the Se'ment Time (or the Tri''er Mode - in milliseconds. .see description of the %T6d% macro input above/ E*tra Ramp T, -ets the Len'th o( the Additional Ramp in Tri''er Mode - in milliseconds. .see description of the %T6d% macro input above/ Bitmaps -ome controls and displays which come with the envelope use bitmaps to show their values. These are, -ync, Brid, 7/@ and 7/78 note display of the 9eat Time, the L and buttons of the presets and 6ode. They explain themself, &ust open their properties to see the different %animations%. I included the original bitmaps seperatly so they can be edited. Sharin' Preset Memory o( several Envelopes in one Ensemble To let several envelopes share the same presets so you can exchange envelopes between them you need to make the event tables in the Bui/$reset macro to share the same memory, means that there is only one memory, but with multible clients. $lease read the manual about event tables. Import.E*port bet een di((erent Ensembles To import the data of one envelope to another you can choose one of two ways. +ou can replace the %B'I/6emory -ocket/6emory $lugin% macro by the 6emory $lugin macro of the envelope you want to copy from. This macro contains all data of the envelope. "r you can store the wanted envelope as a preset, save the Bui/$reset macro as a seperate file, replace the preset macro of the envelope you want to copy to and load the wanted preset in the envelope. $lease note that presets do not store the state of the %Tempo -ync% button.