Expert-sleepers Augustus Loop v2.4.1 Manuel d'utilisateur

Expert SleepersAugustus Loopv2.4.1User Manual

Mac OS X! 66Windows! 67Version History! 68v2.4.1 28th October 2013! 68v2.4.0 (Windows) 20th August 2013 / (Mac) 3rd December 2012! 68v2.3.4 4th Novemb

Issues with keyboard input! 74Contact! 75Acknowledgements! 76Lua! 76oscpack! 76glew! 77FreeType! 78FTGL! 78libpng! 78zlib! 78

IntroductionAugustus Loop is an emulation of a tape-based delay effect, with some extra features to facilitate its use as a looping device. (If you&

•Ability to sync multiple instances of the plug-in running at once.•Automatic fades up and down to allow smooth transitions in your playing.

InstallationMac OS X, Audio Unit (AU)One file (ExSlAugustusLoop.component) contains all variants of the plug-in.Simply copy the file to the folder:Libra

System RequirementsMac OS XAugustus Loop v2.2.0 and above require at least Mac OS X version 10.6.8. The plug-in is Intel-only, and built for both 3

RegistrationThe downloadable version of Augustus Loop stops working after 15 minutes every time you use it. To stop this happening, you need to buy

What’s New in Version 2This section summarises the new features of Augustus Loop version 2. It is aimed at users who are already familiar with th

of the interface. With Augustus Loop you can move user interface elements around, re-move things you don’t use, add new buttons to drive your o

QuickstartAugustus Loop is designed to be used as an insert effect, but you can use it as a send effect if you wish.By default, the effect produces a

Copyright © 2009-2013 Expert Sleepers. All rights reserved. This manual, as well as the software described in it, is furnished under licence and may b

Using Augustus LoopUsing the controlsKnobsBasic use of the knobs is to click on them and drag the mouse up and down. However you can obtain different

OverviewHere's a block diagram of the 'circuitry' of Augustus Loop. It can help to visualise this when understanding the effe

Delay TimeThe delay time controls consist of a slider and four text boxes.Max DelayThis field sets the maximum de-lay time the plug-in is capable o

Delay TapsA total of nine knobs make up this section.Eight of these are in pairs, giving you control of delay time and feedback level for each of the

PitchPitchThis text field simply reflects the current pitch value. You can type numbers directly in here. The values represent semitones (12 sem

In a more complex example, say the tap times are set to 100%, 75%, 50% and 25%. When the tape is reversed, the tap times become 100%, 125%, 150% and

FilterCutoffControls the filter cut-off frequency (in Hz).QControls the filter resonance.TypeAllows you to smoothly change between the following filter t

ShapeControls the shape of the saturation. At '1.0' the effect is that of soft saturation and clip-ping. At '0.0' the effect is o

SyncThe controls in the Sync group (to the right of the delay slider) allow you to sync the delay time to the tempo of the host ap-plication, or to an

•Tempo - the plug-in takes its tempo information from the group master, instead of from the host application. If you enable ‘Host Tempo’ as abov

ContentsIntroduction! 12Installation! 14Mac OS X, Audio Unit (AU)! 14Mac OS X, VST! 14Mac OS X, AAX! 14Windows (VST)! 14Windows (AAX)! 14System Requir

LevelsDryControls the amount of the input signal that is fed directly to the plug-in's output.The level meter to the left of the ‘D

LoopTap RecWhen first clicked,•silences the effect output•sets the pitch to 0.0•turns off the 'reverse' featureWhen clicked again, sets the

Clear LoopWipes the virtual 'tape'. Because this can be a lengthy operation (especially when the max delay time is large) you should not exp

The menu below the indicator allows you to automatically clear the loop (i.e. as if you pressed the 'Clear Loop' button) when

InertiaPitch InertiaThe ‘Inertia’ knob controls how long the tape speed takes to react to changes in pitch (including reversing and stopping the ta

Also note that if you want a totally clean loop, you should also set the filter to 'Thru' and turn off the saturation. NB setting the saturat

Waveform DisplayThe waveform, or ‘tape’, display is shown and hidden by the small button marked ‘Tape’ just above the Delay Time controls.Showing th

Augustus Loop Fx LoopIntroductionThe normal Augustus Loop configuration is a stereo or mono-to-stereo plug-in. As of ver-sion 1.8.0, another configurati

leaves it - i.e. it affects the delay time. The compensation controls allow you to make up for this, so the delay time you specify is the one you act

PreferencesPressing the ‘Prefs’ button brings up a dialogue where various preferences are set. These global settings are shared by all instan

Using the controls! 20Knobs! 20Sliders! 20Dropdown menus! 20Value edit boxes! 20Name/value display! 20Overview! 21Delay Time! 22Max Delay! 22Delay Tim

OSC Base PortSets the base port number for OSC. See the section on OSC, below.MIDI outputThis checkbox enables or disables the output of MIDI clock me

Ignore AudioUnitResetThis setting applies to the Audio Unit version of the plug-in only. Audio Unit plug-ins usually have the ability to be ‘r

SkinsPreambleFrom Augustus Loop v2.0.0 onwards it is possible to completely redefine the plug-in’s GUI. Typical uses for this would be to simp

Anatomy of a SkinSkins use the standard Mac OS X bundle system. Since this is essentially just a folder hier-archy with a special structure, this work

!return 773, 491endgetFont()This function should return a list of fonts that the GUI should attempt to use as the general purpose font for e.g. group

Functions callable from createUI()The following functions are defined by the skin system, and may be called from your createUI() function

You can create multiple renderers, but there is a concept of a ‘current’ renderer. When a new slider is created, it automatically associates itsel

y = y + miscButtonsGroup:height()group:bounds()Returns the extremities of the group. E.g.local minx, miny, maxx, maxy = delayTimeGroup:bounds()group:s

u, v specify the location in the renderer’s image of the sub-image to be used to draw the button.The optional ‘hold’ parameter lets you create a butt

x, y, w, h specify the position, width and height of the button.u, v specify the position of the sub-image within the renderer’s image to be used to

Gain! 27Lo Freq/Lo Amnt! 27Hi Freq/Hi Amnt! 27Sync! 28Host Tempo! 28Beat Divisor & Triplet! 28Beats! 28Using Beats with Tap Record! 28Sync Groups!

delaySlider( x, y, w, h, orient, u, v, du, dv )Creates Augustus Loop’s slider that controls the delay time. The parameters correspond to those of the

u, v specify the position of the sub-image within the texture image to be used to draw the meter. w, h specify the meter’s width and height.levelMeter

Functions callable from luaButton functionsThese functions should not be called from your createUI() function, but can be used within functions invoke

sendOSC( address, path [, format ] [, values ] )Sends an OSC message. ‘values’ is an optional array of data items to be sent with the mes-sage. If ‘va

Pre-defined Global ValuesThe system defines some values before calling your script, which you can use to make the script’s behaviour dependent on, for e

MIDI controlMost of Augustus Loop's controls can be controlled via MIDI.There is a preference setting in the 'Prefs' dialog that contro

OSC ControlFrom version 2.0.0 Augustus Loop can be controlled via the Open Sound Control (OSC) protocol.If you’re new to OSC, start by visiting ope

replies to 10.0.0.2:7000 with (assuming parameter 14 has the value 64.0)/foo 14 64.0/getAll s:returnUrl s:returnPathBehaves exactly as if a /get messa

Lua function, as can best be managed given the varying limitations of the two. Specifically, the following table describes the mapping from OSC types t

MIDI & OSC ScriptingPreambleFrom Augustus Loop v2.0.0 onwards it is possible to extend the plug-in’s MIDI & OSC functionality via use

Digital Mode! 34Record O"set! 35Waveform Display! 36Augustus Loop Fx Loop! 37Introduction! 37Using the Fx Loops! 37Setting up your DAW for Fx Loo

Script locationsAugustus Loop looks for MIDI & OSC scripts in standard locations. Scripts must have the filename extension “.lua”.Mac OS XAugustus

pitch = getParameter( “Pitch” )pitch = getParameter( paramID_Pitch )setParameter( param, value )Sets the value of the plug-in parameter. See the descr

E.g.sendOSC( "osc.udp://localhost:7001", "/foo" )sendOSC( "osc.udp://localhost:7001", "/foo", { 3, 5.2, "

requestAllPolyPressure( function )Request that the given function be called in response to any MIDI poly pressure (poly-phonic aftertouch) even

local function handlePC( channel, value )!-- do stuffendrequestProgramChange( 2, handlePC )requestPolyPressure( key, function )Request that the given

endrequestTimedCallback( 2.0, timerTimeOut )requestPeriodicCallback( interval, function )Requests that the given function should be called every inter

The OSC packet should include a float value after the path, which will be the value for the parameter. E.g.registerOSCPathForParameter( "/1/fader1

WindowsThe system OutputDebugString API. Use an application like Sysinternal’s DebugView to view it.

Version Historyv2.4.1 28th October 2013•First AAX release.•Fixed skinning, broken by v2.4.0.v2.4.0 (Windows) 20th August 2013 / (Mac) 3rd December 201

•Fixed compatibility with OS X 10.5. •Worked around a bug in Digital Performer 7.1 which would cause a crash when the plug-in prefs dialog was used.

The Skin Script! 43getWindowSize()! 43getFont()! 44getLabelFont()! 44getTextFieldFont()! 44createUI()! 44Functions callable from createUI()! 45setBann

•Added waveform display.•The ‘Max Delay Time’ parameter now has a smaller minimum value (1.0 seconds) and is not rounded to the nearest 10 sec

•Further enhanced the plug-ins’ resilience to font installation issues.v1.7.1, 17th March 2008•(Mac OS X versions only) Fixed a possible crash if a sy

v1.4.3, 13th July 2005•Tempo is calculated and displayed even if MIDI clock output is disabled.•MIDI clock generation is completely rewritten internal

•Fixed issue with 48kHz operation.•Fixed behaviour of MIDI remote control of pitch parameter.•Fixed problem with Freeze Loop button staying on after t

Release NotesIssues with keyboard inputThere are known issues with some hosts, in particular Ableton Live, and all plug-ins that require keyboard inp

ContactThe Expert Sleepers website is here:http://www.expert-sleepers.co.uk/Or you can [email protected] you can use the forum, which i

AcknowledgementsThe software described in this manual makes use of the following open source projects. The author is greatly indebted to them for

glewThe OpenGL Extension Wrangler LibraryCopyright (C) 2002-2007, Milan Ikits <milan ikits[]ieee org>Copyright (C) 2002-2007, Marcelo E. Magallo

PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LI-ABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

waveformDisplay:setMoving( v )! 51waveformDisplay:isMoving()! 51getParameterID( param )! 51Functions callable from luaButton functions! 52getParameter

Share your scripts!! 59Script locations! 60Mac OS X! 60Windows! 60Overriding the default script! 60MIDI & OSC Script Functions! 60getParameterID(