Sie sind auf Seite 1von 114

Diagnostics

Technology

Licensing

InstallingCantabile3

ToinstallCantabilesimplyruntheinstaller.Therearenooptions,simplyfollowthesteps.

Theonlypre-requisitesareacompatibleoperatingsystem(WindowsXPSP3orlater)andMicrosoft.NET.

ForacompletewalkthroughofinstallingandconfigurationCantabile,seethisvideo.

ManuallyInstalling.NET

CantabilerequirestheMicrosoft.NETinordertorun.Normallytheinstallerwilldetectiftherequiredversionisalready

installedandifnotwillautomaticallydownloadandinstallitforyou.Ifthemachineyou'reinstallingondoesn'thavean

internetconnectionthiswillfailandyou'llneedtoinstallitmanuallyyourself.

Ifyou'renotsureifyouneedthis,runtheCantabileinstalleranditwillnotifyyouifthedownloadisrequiredbeforethe

setupstarts.Ifit'srequiredandyoudon'thaveaninternetconnection,canceltheCantabileinstaller,install.NETusingthe

linkbelowandthenre-runtheCantabileinstaller.

BeforeCantabilebuild3500-Microsoft.NET4.0

Cantabilebuild3500andlater-Microsoft.NET4.7.1

IfyoulettheCantabileinstallerdownloadandinstall.NET,pleasebepatient-it'stakesafewminutestoinstall.

DriversandPlugins

AsidefromCantabileitselfyou'llalsoneedasuitableaudiodriver,MIDIdriversandpluginsinstalled.Configuringtheseis

beyondthescopeofthisdocumenthoweverifyou'renewtocomputerbasedmusic,thisguidemighthelpyougetstarted.

X86vsX64

Cantabileisavailablefortwoplatforms-x86andx64.Theinstallerinstallsbotheditionsandcreatestwoshortcutsinyour

Windowsstartmenu-oneforeachplatform.

Windowsstartmenu-oneforeachplatform. Foradetailedexplanationofx86vsx64, seehere .

Foradetailedexplanationofx86vsx64,seehere.

ConfiguringCantabile

Onceyou'veinstalledCantabile,seeGettingStartedforhowtoconfigureitforthefirsttime.

GettingStartedwithCantabile3

ThisguideexplainshowtogetstartedwithCantabile,includingconfiguringanaudiodriver,MIDIdevices,VSTplugins.It

assumesyou'refamiliarwithbasiccomputermusicterminologyandconcepts-ifnotpleasereadthisfirst.

ForacompletewalkthroughofinstallingandconfigurationCantabile,seethisvideo.

ThefirsttimeyourunCantabileyou'llbepresentedwithaseriesofscreensthatwillhelpyousetupCantabileforthefirst

time.

time. AudioEngineOptions

AudioEngineOptions

Onthesecondscreenyou'llbepromptedfortheaudiodrivertouseaswellasthebuffersizeandsampleratetheaudio

engineshouldrunat.Normallythedefaultwillsuffice.

Note:ifyouselecttheNullaudiodriverifwon'tgetanysoundoutput-it'sforMIDIonlyprocessing.

AudioPorts

AudioPorts

Nextyou'llneedtoconfiguresomeaudioports.Audioportsdefinethemappingbetweenyoursongfilesandthephysical

hardware.

Cantabilewillautomaticallycreateadefaultsetofaudioportsandtakeaguessathowyoumightlikethemmappedtothe

audiodriveryouselectedinthepreviousstep.Youcanacceptthesedefaults,tweakthechannelassignmentsorcreatea

completelynewsetofports.

Attheveryleastyoushouldhaveanoutputaudioportwithitschannelsassignedtooutputchannelsontheaudiodriver.

MIDIPorts

MIDIPorts

Similarlytoaudioports,MIDIportsprovideamappingbetweenyoursongandphysicalMIDIdevices.

CantabilewillcreateacoupleofdefaultMIDIportsforyoubutdoesn'tautomaticallymapthoseportstophysicalhardware.

IfyouhaveexternalMIDIdevicesmakesureyoumapthemherebyrightclickingonaportandcreatingtheassignment.

PluginsFolder

PluginsFolder

Finally,CantabileneedstoknowwhereyourVSTpluginsareinstalled.Youcanalsoselectapresetsfolder-any.fxbor.fxp

filesfoundinthisfolderwillalsobeshowninthepluginselector.

ClickFinishandyou'rereadytostartingusingCantabile. WorkingwithPlugins

ClickFinishandyou'rereadytostartingusingCantabile.

WorkingwithPlugins

OneofthemostcommontaskswhenusingCantabileissettinguppluginsandtheroutesbetweenthem.Thisguideisa

simplewalkthroughforinsertingacoupleofpluginsandconnectingthemtogether.

InsertingaPlugin

Toinsertaplugin,eitherclicktheAddPluginbuttoninCantabile'smainwindowarea,orchooseInsert->Pluginfromthe

mainmenu.You'llbepresentedwiththepluginselector:

mainmenu.You'llbepresentedwiththepluginselector:

Locatethepluginyou'reafterbybrowsingthecategoriesontheleftandthelistontheright,orasashortcutjusttypethe

firstfewlettersoftheplugin'snameandthelistwillbefiltereddown.eg:

Formoreinformationaboutmanagingpluginsincludingsettingplugintags,see ManagingPlugins . AutomaticRoutes

Formoreinformationaboutmanagingpluginsincludingsettingplugintags,seeManagingPlugins.

AutomaticRoutes

Whenapluginisinserted,Cantabileautomaticallycreatescertainroutes.InthiscaseitcreatedaMIDIroutefromthe

defaultMIDIinputport(MainKeyboard)tothepluginandanaudioroutefromtheplugintothedefaultaudiooutputport

(MainSpeakers).

(MainSpeakers). EditingPluginSettings

EditingPluginSettings

Toopenaplugin'suserinterfaceeitherdoubleclickonit'sname("IvoryVST1"inthiscase),orselectitandchooseEdit->

PluginEditorfromthemainmenu.Youcanalsoedittheplugin'sparametersusingCantabile'sparametereditorby

Alt+doubleclickingtheplugin,orbychoosingEdit->PluginParametersfromthemainmenu.

Inthisexample,onceakeysethasbeenloadedintoIvorytheplugincanbeplayedfromwhateverMIDIdeviceismappedto

theMainKeyboardport(inOptions->MIDIPorts).

RoutingtoaSecondPlugin

SupposenowwewanttosendtheoutputofIvorythroughaneffect.Usingthesameprocedureaboveinserttheeffect

plugin(inthiscaseFabFilter).Thistime,CantabilecreatesaroutefromthenewplugintotheMainSpeakersoutputportbut

doesn'tconnectanyinputroutestotheplugin.Thisisdeliberatetopreventaccidentallycreatingfeedbackloops.

TorouteIvorythroughFabFilter,justchangeitsaudiooutputroutetosendtotheplugin:

TorouteIvorythroughFabFilter,justchangeitsaudiooutputroutetosendtotheplugin:

NowIvory'soutputwillbeprocessedbytheeffectpluginandthensenttothemainspeakers.

FormoreinformationseePortsandRoutes.

RoutingDiagrams

Theaboveexample,usesCantabileTableRoutingView.YoucanalsouseRoutingDiagramstomorevisuallyconfigure

objectsandroutes.SeeRoutingDiagrams.

UnderstandingPortsandRoutes PortsandroutesarefundamentalconceptsinCantabilethatareusedtoconnectobjectstogether.

UnderstandingPortsandRoutes

PortsandroutesarefundamentalconceptsinCantabilethatareusedtoconnectobjectstogether.

Portsareconnectionpointsonanobject.eg:aninputportonaplugin,andoutputporttoasoundcard,aninputport

fromaMIDIdeviceetc

Routesrepresenttheconnectionsbetweenports.eg:aMIDIroutefromyourkeyboardinputporttoaninputportona

plugin,oranaudioroutefromaneffecttoyoursoundcard.

Aportsiseitheraninputportoranoutputportandaroutealwaysconnectanoutputporttoaninputport.Aportcan

acceptmultiplerouteconnectionseg:connectingtwoMIDIKeyboardportstooneplugin,orconnectingtheaudiooutputof

aplugintotwosetsofoutputspeakers.

It'sconvenienttothisofaportassocketandarouteasacable.

EditingRoutes

Cantabile'smainRoutingpaneldisplaysalistofobjects(InputPorts,Plugins,MediaPlayers,etc

expandabletoshowthesetofroutesconnectingtheobjecttootherobjects.

)andeachobjectis

ThefollowingexampleshowsanIvorypluginwithoneroutefromits"StereoOut"portconnectedtothe"MainSpeakers"

outputport.

outputport. Tocreateadditionalroutesfromanobject,clicktheAddRoutebutton.

Tocreateadditionalroutesfromanobject,clicktheAddRoutebutton.

ToeditanexistingrouteclickintheSourceandDestinationcolumnstochangetheconnections

Todeletearoute,selectitandpresstheDeletekey.

Tocollapseanobjecttohideit'sroutesbyclickingthedownwardspointingtrianglearrowatthefarleftoftheplugin

slot.

YoucanalsouseRoutingDiagramstomorevisuallyconfigureobjectsandroutes.SeeRoutingDiagrams.

slot. YoucanalsouseRoutingDiagramstomorevisuallyconfigureobjectsandroutes.See RoutingDiagrams .

Example

Thefollowingscreenshotshowstworoutes:

aMIDIroutefromtheMainKeyboardtothemdaPianopluginand

anaudioroutefromtheplugintotheMainSpeakers

anaudioroutefromtheplugintotheMainSpeakers RoutingDiagrams

RoutingDiagrams

RoutingDiagramsprovideamorevisualwaytoviewandedittheroutesinasongorrack:

Ascanbeseenintheabovescreenshot,theroutingviewisdividedintothreemainareas: InputPortsontheLeft OutputPortsontheRight

Ascanbeseenintheabovescreenshot,theroutingviewisdividedintothreemainareas:

InputPortsontheLeft

OutputPortsontheRight

ObjectsandRoutesintheMiddle

SwitchingBetweenTabletoRoutingDiagrams

Thetableviewandtheroutingdiagramviewsbothshowthesamesetofobjectsandroutes.Youcanswitchbetweenthe

twoviewsusingtheviewselectorbuttonsatthetoprighthandcornerofthescreen:

Youcanalsoswitchviewsviathemain View menu,orpressing

YoucanalsoswitchviewsviathemainViewmenu,orpressingCtrl+Shift+Xwilltogglebetweenthetwoviews.

AddingNewObjects

Theeasiestwaytoaddanewobjecttoaroutingdiagramsisviathelarge"add"buttons.Whentheroutingviewisempty,a

singlecenteredaddbuttonalwaysappears:

singlecenteredaddbuttonalwaysappears:

Afteryou'veaddedthefirstobject,addbuttonswillappearingridlocationsasyoumovethemousearoundthescreen:

Youcanalsoaddobjectsbyrightclickinginablankpartofthediagram,orviathemain Insert menu. CreatingRoutes

Youcanalsoaddobjectsbyrightclickinginablankpartofthediagram,orviathemainInsertmenu.

CreatingRoutes

Routesarerepresentedaswiresthatconnectbetweenports.

Toaddanewroute,simplyclickonanyportanddragittoanotherport.Herearouteisbeingaddedbydraggingfromthe

"OnscreenKeyboard"portandconnectingittothe"MIDIIn"portonaplugin:

NotethatyoucanonlyconnectMIDIportstootherMIDIportsandaudioportstoaudioports.

EditingRoutes

Toeditanexistingroute,selectitbyclickingonitandthenusetheroundhandlesateitherendtomovetheconnectiontoa

differentport:

differentport: DeletingObjectsandRoutes

DeletingObjectsandRoutes

AnyobjectorroutecanbedeletedbyselectingitandpressedtheDeletekey.

MovingObjects

Oftenyou'llwanttorepositionobjectsinthediagramtomakeitmorevisuallypleasing.Todothis,simplyclickontheobject

anddragittothenewlocation.

Bydefaultobjectswill"snap"topredefinedgridlocationsinthediagram.Youcansuppressthissnappingbyholdingthe

Shiftkeyasyoudragtheobject.(PressShiftafterstartingthedragotherwiseyou'llstartapanaction-seebelow).

AutoArrange

Cantabilecanautomaticallyarrangetheobjectsinaroutingdiagramtoprovideapleasinglayout.Toautoarrangearouting

diagram,chooseAutoArrangefromtherightclickmenu,orsimplypressA.

AutoArrange fromtherightclickmenu,orsimplypress A .

Autoarrangecanbehandyifyou'veaddednewobjectsusingtheTableViewandCantabiledoesn'thaveaconceptof

whereyou'dliketheobjectdisplayedinthediagram.InthiscaseCantabilewilltrytopickareasonableposition,but

dependingonhowrouteshavebeensubsequentlyaddedthelayoutmaynotbeideal.

NotethatAutoArrangewillrepositionallobjects.Don'tusethiscommandifyou'vealreadypreciselylaidoutthediagramin

apreferredmanner.

ReshapingRoutes

Sometimesyoumightliketoreshapearoute.

Forexample,thisrouteoverlapswithanunrelatedplugin:

Forexample,thisrouteoverlapswithanunrelatedplugin:

Byusingthesmallerinsethandleontheroute,itcanbereshapedtobemorevisuallypleasing:

ObjectandRouteSettings Alongthebottomoftheroutingdiagramsisasettingsbarthatshowssettingsforthecurrentlyselectedobject:

ObjectandRouteSettings

Alongthebottomoftheroutingdiagramsisasettingsbarthatshowssettingsforthecurrentlyselectedobject:

Thisbarverycloselyresemblesthesamesettingsinthetableview.

Thisbarverycloselyresemblesthesamesettingsinthetableview.

HidingObjectPorts

Bydefault,theroutingdiagramshowstheportsoneachobject.Whilethisprovidesthemostdetailandisbestwhensetting

upasong,sometimesitcanmakethediagramappearmorecomplexthanitneedstobe.

Forasimplerview,presstheTabtotoggleobjectportsonandoff.

Here'saroutingdigramwithportsshown:

Here'sthesamediagramportsturnedhidden:

Here'sthesamediagramportsturnedhidden:

Here'sthesamediagramportsturnedhidden:

Whiletheportsarehidden,youcanstillinteractwiththemastheytemporarilyappearwhenthemouseishoveredoveran

object.

SelectingMultipleObjects

Youcanselectmultipleobjectsby:

holdingtheCtrlwhileclickingoneachobjectorroute

clickinginablankareaofthediagramanddraggingarectanglearoundthedesiredobjects(thiswillonlyselectobjects,

notroutes)

Multipleselectioncanbeusedtodeletedmultipleobjectsatonce,ortomovemultipleobjectsasagroup.

Zooming

Routingdiagramscanbezoomedin/outasfollows:

UsingthemousewheelwhilepressingtheCtrlkey

PressingCtrl+UpandCtrl+Down

UsingtheView->Zoommenu

Ontouchscreenswithpinchgestures

YoucanresettothedefaultzoomlevelbypressingCtrl+1.

Scrolling

Scrolling(akapanning)theroutingdiagramsissupportedby:

UsingthescrollbarsScrolling(akapanning)theroutingdiagramsissupportedby: Usingthemousewheelforverticalscrollingorhold Shift

UsingthemousewheelforverticalscrollingorholdShiftforhorizontalscrolling

Sometrackpadssupportbothhorizontalandverticalscrollingbytwofingerdrag

Shift+clickanddrag +clickanddrag

PreferredRoutingView

YoucansetyourpreferredroutingviewinOptions->General->UserInterface:

Thepreferredviewisusedtoselectwhichview(tableordiagram)shouldbeusedfornewsongsandrack(andsongsand

rackscreatedinversionsofCantabilesavedbeforeroutingdiagramswereintroduced).Onceasongorrackhasbeen

saved,itwillstorethecurrentviewandreverttothatmodewhenthesongisnextopeen.

InputandOutputPortArea

Theinputandoutputportareascanberesizedbyclickinganddraggingontheirborder

Theinputandoutputportscanbere-orderedandrepositionedusingthelittlegripperbars

MainWindowControlsandSettings

ThepagegivesanoverviewofallthecontrolsandsettingsonCantabile'smainwindow.

MainToolbar

MainToolbar

RecordButton-startsandstopstherecorder.RightclicktoconfigureAutoRecord.SeeRecording.(CantabileSoloand

Performeronly)

MasterTransportControls-Play,Pause,Stop

MasterTransportSelector-choosewhetherthemetronome,MIDIclock,oramediaplayeristhemastertransportfor

timinginformation.

Statuspaneldisplayingthecurrenttransportposition,timesignature,tempo,beatindicatorsandaloadindicator.

TapTempoButton-quicklysetthetempobytapping.Canalsoflashintimewithtempo(rightclicktoconfigure)

MetronomeButton-showsandhidesthemetronometoolbar

LiveModeButton-switchtoLiveMode(CantabilePerformeronly)

GlobalOutputGain-savedglobally,notwiththesong

PanicButton-sendsnoteoffandcontrollerreseteventstoallpluginsandMIDIoutputports.

AudioenginePowerButton-glowinggreenindicatestheengineisrunning.

MetronomeToolbar

ClickingtheMetronomebuttononthemaintoolbarshowsandhidesthemetronometoolbar:

Seehere formoreinformationonthemetronome.

Seehereformoreinformationonthemetronome.

Table/DiagramRoutingViewSwitch

TothetoprightofthemainwindowwhenontheRoutingtab,there'saswitchtoselectbetweentheroutingtableviewand

routingdiagramview:

routingdiagramview: See RoutingDiagrams formore. InputPortsSlot

SeeRoutingDiagramsformore.

InputPortsSlot

See RoutingDiagrams formore. InputPortsSlot Songlevelinputgaincontrol Songleveltransposesettings

Songlevelinputgaincontrol

Songleveltransposesettings

Audioinputlevelmeter

MIDIinputactivityindicator

OutputPortsSlot

MIDIinputactivityindicator OutputPortsSlot Songleveloutputgaincontrol Audiooutputlevelindicator

Songleveloutputgaincontrol

Audiooutputlevelindicator

MIDIoutputactivityindicator

MIDIRouteSlots

MIDIoutputactivityindicator MIDIRouteSlots ThelittlenotesymbolindicatesthisisaMIDIroute

ThelittlenotesymbolindicatesthisisaMIDIroute Enabledon/offselector Asourceport(ie:"MainKeyboard")

Atargetobjectandport(ie:"IvoryVST1-MIDIIn")

MIDIFilterSettings(greenindicatorshowstherearefiltersactiveonthisroute)

Routesettingsdisplayandcontrol(ie:"Omni"),clicktodisplayMIDIroutesettings

MIDIactivityindicatorthatindicateswhenthisrouteisreceivingand/orsendingMIDI

AudioRouteSlots

AudioRouteSlots Thelittlewaveformsymbolindicatesthisisanaudioroute
AudioRouteSlots Thelittlewaveformsymbolindicatesthisisanaudioroute

Thelittlewaveformsymbolindicatesthisisanaudioroute

Enabledon/offselector

Asourceport

Atargetobjectandport

Againsettingtocontrolthesignallevelsent

Alevelmetershowingtheaudiolevelbeingsent(ie:afterthegainsettingisapplied)

PluginSlots

Expand/CollapseArrow-clicktoexpandorcollapsetheplugintoshowroutesfromthisplugin

Expand/CollapseArrow-clicktoexpandorcollapsetheplugintoshowroutesfromthisplugin

BypassMode-Bypassesallinputaudiodirectlytooutput(sameassettingthewet/dryknobtocompletelydry)

Run/SuspendModeIndicator-lightsupgreenwhenthepluginisrunning,orangewhensuspendedandgreyifunloaded.

PluginName-Clicktoselecttheplugin,orrightclickforcontextmenu.

PresetName-Nameofthecurrentlyselectedpluginpreset,clicktochange.

MIDIFilterSettings(greenindicatorshowstherearefiltersactiveonthisroute)

GainControl-Controlsthegainlevelofoutputsignalsfromtheplugin

Wet/DryKnob-Controlsthemixingofinputwithoutputsignalstocontroltheamountofaudioeffect

BalanceKnob-Controlsleft/rightbalanceorpan.

FadeKnob-Controlsfront/rearbalanceorpan.

OutputLevelMeter-Showsthesignalleveloutputfromthepluginaftergainandwet/drycontrolshavebeenapplied

MIDIActivityIndicators-Lightsupwhenthepluginisreceivingand/orsendingMIDIevents.

FormoreinformationseeWorkingwithPlugins.

MediaPlayerSlots

(CantabileSoloandPerformerOnly)

. MediaPlayerSlots (CantabileSoloandPerformerOnly)

Expand/CollpaseArrow-clicktoexpandorcollapsethemediaplayertoshowroutes.

TransportButtons-playandpausebuttonsallowcontrolofthismediaplayerevenwhenit'snotthemastertransport

MediaPlayerName-clicktoselectthemediaplayer,orrightclickforcontextmenu.

FileSelector-choosewhichfilefromthepreconfiguredplaylistshouldbeplayed.

GainControl-Controlsthegainlevelofoutputsignalsfromtheplugin.

SpeedKnob-Adjuststheplaybackspeedofthismediaplayer.

BalanceKnob-Controlsleft/rightbalanceorpan.

FadeKnob-Controlsfront/rearbalanceorpan.

OutputLevelMeter-Showsthesignalleveloutputfromthemediaplayeraftergainandwet/drycontrolshavebeen

applied.

MIDIInputIndicator-LightsupwhenthemediaplayerissendingMIDIevents.

PlayPositionPercentage-displaysthecurrentplaypositionasapercentageoftheentirefilelength.

FormoreinformationseeMediaPlayers.

RackSlots

Formoreinformationsee MediaPlayers . RackSlots
Formoreinformationsee MediaPlayers . RackSlots

Expand/CollpaseArrow-clicktoexpandorcollapsetheracktoshowroutes.

RackIcon

Run/SuspendModeIndicator-lightsupgreenwhenthepluginisrunning,orangewhensuspended.

RackName-Clicktoselecttherack,orrightclickforcontextmenu.

RackStateSelector-Clicktoselectadifferentrackstate(CantabilePerformerOnly)

RackGainSetting-Controlsthegainlevelofaudiooutputsignalsfromtherack.

OutputLevelMeter-Showsthesignalleveloutputfromtherackaftergainandwet/drycontrolshavebeenapplied

MIDIActivityIndicators-Lightsupwhenthepluginisreceivingand/orsendingMIDIevents.

TickerBar

TickerBar See TickerBar .(CantabilePerformerOnly) ControllerBar See

SeeTickerBar.(CantabilePerformerOnly)

ControllerBar

See TickerBar .(CantabilePerformerOnly) ControllerBar See ControllerBar .(CantabilePerformerOnly) OnscreenKeyboard

SeeControllerBar.(CantabilePerformerOnly)

OnscreenKeyboard

Seehere forhowtousetheon-screenkeyboard. ToolTipsandHelpPanels

Seehereforhowtousetheon-screenkeyboard.

ToolTipsandHelpPanels

Cantabilehasacoupleofin-appfeaturestohelpgetyougetuptospeed.

HelpPanels

HelppanelsdisplayalittlepanelatthetopofthevariousworkareasinCantabileexplainingwhattheydo,alinktofurther

informationaboutthatpanel("TellMeMore")andanbuttontodismissthepanel("OK,Gotit").

Onceyou'recomfortableworkingwithCantabileyoucandismissallthepanels(orre-showthemall)usingtheHelp->Hide

HelpPanelscommand:

HelpPanelscommand: Tooltips

Tooltips

TooltipsareanothergreatwaytolearnwhatallofCantabile'ssettingsandbuttonsdo:

IfyoufindthetooltipsdistractingsoyoucanturnthemoffviatheHelpmenu:

UpgradingfromCantabile2

UpgradingfromCantabile2

ThisguideexplainshowtoupgradeCantabile2sessionfilesandsetlists.

Background

Cantabile3introducesseveralfundamentalconceptualchangesoverCantabile2.Whileingeneralthesechangesgreatly

improveCantabile'susabilityandfunctionalitytheypresentachallengewhenupgradingoldsessionandsetlistfiles.

Thisguidegivesanoverviewoftheseconceptualchangesandprovidestipsforhowtobestapproachupgrading.

BeforeYouConvertYourVersion2Files

BeforeupgradingyourCantabile2sessionfilesyoushouldmakesureyouhaveabackupofyouroldfiles.Although

Cantabile3doesn'toverwriteyouroldsessionfiles,backingupisalwaysagoodidea.

Also,it'shighlyrecommendedthatyouspendsometimelearningthenewconceptsinCantabile3.Inparticularyoushould

befamiliarwithsetlists,songs,racksandthenewaudioandMIDIroutingcapabilitiesofCantabile.

Finally,youshouldmakesureallthepluginsusedinyouroldfilesareknowntoCantabile3-checkyourVSTpathandmake

sureyou'verecentlyrunapluginscan.

UpgradingSessiontoSongFiles

InCantabile3,sessionfileshavebeenrenamedtosongfiles.

ToupgradeaCantabile2sessionfile,simplyopenitusingtheFileOpencommand.You'llbepromptedforwheretosave

theconvertedfile.

Afterconversionthefilewillbeopenedbutwillprobablyneedadjustmentandreviewbeforeitwillworkcorrectly.(See

sectionsbelow)

Attheveryleast,theupgradeprocesswillbringacross:

Allpluginsandpluginstate

UpgradingSetListFiles

InCantabile2,eachentryinasetlistconsistsofasongname,asessionfileandasub-sessionname.Thishasbeen

simplifiedinCantabile3andeachentryisnowjustthenameofasongfile.

Whenupgradingsetlists,Cantabileperformsthefollowingactions:

Theoriginalsessionfileisconvertedtoalinkedrack(unlessarackofthesamenamealreadyexists)

Anewsongfileiscreatedthatreferencesthelinkedrack

Thesongfileissavedusingsong'snamefromtheoriginalsetlistentry

Thesongfilesetsthelinkedrack'sstatetothesub-sessionnamefromthesetlist

Thenewsetlistiscreatedreferencingthenewsongfiles

You'llnoticethatconversionofsongfilesisslightlydifferentherecomparedtoupgradingasinglesessionfileinthat

sessionsareconvertedtoracks,notsongs.

Theothersideeffectofthisisthatifyouhaveasetlistwheremanysongsreferenceonesessionfilethentheresultingset

listwillconsistofalistofsongfilesallreferencingthesamelinkedrack.

Ifyou'reusingsetlistsinCantabile2youshouldingeneralupgradethesetlistsratherthanindividualsessions.

HandlingMIDIDeviceNaming

InCantabile2,sessionfilesdirectlyreferencethenamesofMIDIdevices(eg:EdirolPCR-M88).InCantabile3devicesare

mappedthroughnamedportswhichyouconfigureinsettings(eg:MainKeyboard)

Inupgradingaversion2file,Cantabilewilltrytomapdevicenamestoportsbylookingforaportwithadirectonetoone

mappingtothatdevice.

Itwillalsohoweverlookataport'saliasnames-soifyouknowyouwanttomapaparticulardevicenametoaparticular

portspecifythedevicenameintheport'saliasfield.

Finally,ifarackintheoriginalfilewassettoacceptinputfromanyinputdevice,theupgradedsessionwillcreatearouting

fromadevicenamed"Any"-whichprobablywon'texistbutcaneasilyberesolved-seebelow.

AfterupgradingasessionfileyoushouldcheckallthereferencedMIDIdevicenames.Missingorunmatcheddeviceswillbe

shownasabrokenroutesandcanbeeasilyfixedbyeither:

Changingtheroutetoreferenceanavailabledevice,

Creatinganewportwiththereferencedname,or

Settinganaliasnamesonexistingportstoautomaticallymapolddevicenamestothenewports.(SeeOptions->MIDI

Ports->Edit)

AliasesareagoodoptionwhenyouhavemanysongsthatreferenceadevicethathasanewnameinCantabile3.After

matchingtoanaliasname,Cantabilewillrenametheroutetousetheactualportname.Onceallyoursessionshavebeen

upgradedyoucanremovethealiasname.

AudioChannelMapping

InCantabile,allaudiochannelsweremappedthroughthemasterbus.Cantabile3nolongerhasaconceptofmasterbus

andusesnamedportsinstead.

Whenupgradingaversion2file,Cantabilewillcreateportsonallplugins,mediaplayersandrackswiththesamenumberof

channelsasthemasterbusintheupgradedsongfile.Theseportswillbenamed"AudioIn"and"AudioOut".

Iftheoldsessionusedastereomasterbusandnocomplicatedaudiochannelmappingmostsessionsshouldjustupgrade.

Ifyouroldsessionusedamorecomplicatedmulti-channelmasterbusoraudioroutingsyou'llalmostcertainlyneedto

revisittheaudiochannelmappings.Youshouldchecktheeachplugin,racksandmediaplayerbyselectingthemoneby

oneandusingtheAudioPortscommandintheEditmenu.

ConfiguringAudioPorts

Anaudioportdefineshowasetofchannelsaremappedbetweenanaudioobjectandroutesconnectedtotheport.An

audioportcanbeeitheraninputportoranoutputport.Forexample:

Aplugininputportmapsaudiosignalsfromconnectingincomingroutestotheplugin'sinputchannels.

Apluginoutputportmapsaudiosignalsfromtheplugintoconnectedoutgoingroutes.

Anaudioportconsistsofasetofchannelsandeachchannelhasanumberofassignments-eachdefininghowanaudio

signalismappedtoorfromtheport.

Thefollowingscreenshotshowstheaudioportsettingsforatypicalaudioeffectplugin:

Thispluginhasatypicalsetofstereoin/stereooutaudioports.Notethetwoassignmentsoneachoftheoutputport

channelswhichisexplainedbelow(seeWet/DryMixControl)

Notesonusingthiswindow:

ClicktheAddbuttontoaddadditionalaudioports,ormorechannelstoanexistingport.

Rightclickingachannelallowsforquicklycreatingsimple1to1channelassignments.

Doubleclickaportorchanneltoedititssettings.

EditingachannelusingtheEditAudioChannelwindow:

Notes: Achannelcanhavemultipleassignmentstothetarget/sourceobject

Notes:

Achannelcanhavemultipleassignmentstothetarget/sourceobject

Eachassignmenthasitsownmixlevelthatcontrolsthesignalleveloftheassignment

Dependingonthecontext,eachassignmentmayhaveasettingtocontrolthepanandfadeplacementofthischannel

(seebelow).

AudioDrivertoAudioPortMappings

Cantabilesupportsmappingofaudiosignalsfromtheaudiodrivertoasetofaudioinput/outputports.Bydefiningaudio

portsinthismanner,Cantabile'ssongfilescanbeconfiguredtoworkwithaknownsetofaudioportsandareisolatedfrom

theunderlyinghardware.Shouldthehardwareconfigurationchange,theaudioportscanbereconfiguredforthenew

hardwareandthesongscancontinuetorununmodified.

AudiodriverportsaredefinedinOptions->AudioPortsandCantabilemaintainsaseparatesetofassignmentsforeach

audiodriver.

PluginAudioPortMappings

Theotherplaceaudioportsareusedisonplugins.Eachplugininstancehasit'sownsetofconfigurableaudioports.Whena

pluginisfirstinsertedintoasongCantabileautomaticallycreatesasetofaudioportconfigurationsbasedoninformation

fromtheplugin.Typicallythedefaultconfigurationwillworkfinehoweversometimesitmightbenecessarytochangethe

audioportconfiguration.ThisisdonebyselectingtheplugininCantabile'smainwindowandchoosingEdit->PluginAudio

Portsfromthemainmenu.

Wet/DryMixControl

Inthescreenshotaboveitwasnotedthattheoutputportoftheexamplepluginhastwoassignmentsforeachoutput

channel.Ifyoutakeacloserlookatthesetwoassignments,you'llseethefirstisanassignmentfromtheplugin'soutput

channel(asexpected),butthereisalsoasecondassignmentfromtheplugin'sinputchanneltotheoutputport.

Thissecondassignmentiswhatallowswet/drymixlevelsoneffectpluginstowork.

Audiooutputportsonpluginssupportcreationofassignmentsfromthreedistinctsources:

1. Theplugin'soutput

2. Theplugin'sinput

3. Anyoftheinputportchannels

Thepluginsoutputisselfexplanatoryandallowsmappingthesignalgeneratedbytheplugintotheoutputport.An

assignmentfromtheplugin'sinputsetsupthedrysignaltobeusedinwet/drymixing.Asthewet/drymixlevelisadjusted

forthisplugintheoutputsignalwillcrossfadefromtheplugin'sinputwhendrytotheplugin'soutputwhenwet.

Anyassignmentsfromaninputportdirectlytoanoutputportarepass-throughaudiosignalsandnotaffectedbytheplugin

slot'smixorgaincontrols.

PanandFadeSettings

Forpluginoutputportseachaudiochannelassignmenthasadditionalsettingstocontrolhowit'saffectedbytheplugin

slot'spanandfadeknobsandineachcaseallowssettingadirection(none,left,right)or(none,front,back)andapanor

balancemode.

Balancemodeprovidestypicalstereobalancecontrol,droppingthesignallevelonjustonesidetowardszero,causingthe

soundtomoveintheotherdirection.Panmodeusesapanninglawtoplaceamonosignal-typicallyreducingthesignal

levelwhencentered.

Insimplerterms,balancemodeshouldbeusedforachannelthatisacomponentofastereoorsurroundsignal.Panmode

shouldbeusedformonosignalsbeingplacedinastereoorsurroundenvironment.

MappingAllPluginChannels

BydefaultCantabilewillautomaticallycreateoneortwoaudioportsforbothaplugin'sinputandoutputs(dependingonthe

functionalityoftheplugin).Byonlycreatingalimitedsetofportsitcanreducetheprocessingloadbynotcreatingports

thatwon'tbeused.

Somepluginshowevermighthaveadditionalaudiochannelsthatyoumightneedtoaccess.Therearetwowaysyoucan

mapthesechannelstoaudioports:

1. Manuallycreatenewportsandmapthemtotheplugin'saudiochannels(asdescribedabove)

2. Rightclickonthepluginslotandchoose"MapAllChannels".

Thesecondoptionwillreplacetheexistingaudioportswithanewsetthatmapsalloftheplugin'schannels.Youcanthen

eitherdeletethetheportsyoudon'tactuallyneedorusetheTrimUnusedPortscommand(describedbelow).

TrimmingUnusedPluginPorts

Ifyou'reusingsongscreatedfromolderversionsofCantabilewherethedefaultwastomapallchannelsfornewplugin

instances,youmightfindthosepluginshaveunusedaudioportsthataren'tneededandmaybecontributingunnecessarily

totheprocessingload.

Tohelpmitigateagainstthisyoucanusethe"TrimUnusedPorts"commandtoremoveallportsthataren'tinuse.Thereare

twoversionsofthiscommand:

twoversionsofthiscommand:

Thefirstcommandremovesallunusedportsforallpluginsinthecurrentrack.Thesecondremovestheunusedportsjust

fortheselectedplugin(andisalsoavailableviarightclickonthepluginslot).

MappingChannelsbetweenAudioPorts

Cantabilesupportsconnectinganyaudiooutputporttoanyaudioinputport.Thisraisesthequestionofhowtwoportswith

adifferentnumberofchannelsineachareconnected.Whichchannelconnectstowhich?

Thefollowingrulesdescribehowthisisresolved:

NtoN-Ifthenumberofchannelsinthesourceaudioportmatchesthenumberofchannelsinthetargetaudioport,the

channelsaresimplymapped1to1.

1toN-Ifthesourceaudioporthasonechannelandthetargetaudioporthasmultiplechannels,theonesource

channelismappedtoeverytargetchannel.

Nto1-Ifthesourceaudioporthasmorethanonechannelandthetargetaudioporthasonechannel,allthesource

channelsaremappedtotheonetargetchannel,withthemixleveldivideddownbythenumberofsourcechannels.eg:

mappingastereoporttoamonoportcreatestwoassignmentseachat50%mixlevel.

NtoM-Ifthenumberofchannelsinthesourceandtargetdon'tmatchandtheybothhavemorethan1channel,

Cantabilewillcreateonetooneassignmentsforasmanychannelsasitcanandleavetheothersdisconnected.

Notethatyoucan'tchangetheaboveassignmentrules-Cantabilealwaysconnectsaudioportsinthisway.Iftwoaudio

portsareincompatibleandyouneedtoconnectthetwoobjects,simplycreateanothercompatibleaudioportoneither

objectandconnectusingthatport.

MIDIRouteSettings

MIDIroutesprovideconnectionsbetweenMIDIportsandprovideanumberofcontrolsthatdetermineswhichMIDIevents

arepassedthroughandhowthoseeventsaremanipulatedbeforebeingforwardedtotheirdestination.

Sourcechannel OnlyrouteseventsmatchingoneormoreMIDIchannels

Sourcechannel

OnlyrouteseventsmatchingoneormoreMIDIchannels

Targetchannel

ChangesroutedMIDIeventstotheselectedMIDIchannel

NoteRange(LowestNote/HighestNote)

Limiteventstoaparticularkeyboardnoterange(ie:keyboardsplits)

Transpose

Transposeallnotesbythespecifiedinterval

LearnMode

Allowslearningthenoterangeandtranposesettings(seebelow)

IgnoreGlobalTranposeSetting

Whenselectedtheglobaltransposesettingisignoredforthisroute.Usefulwhenroutingtorhythmicinstruments(drum

kitsetc

)

NotesOnly(SuppressAllOtherEvents)

Onlyroutesnoteandaftertouchevents.Allotherevents(eg:controllers)aresuppressed.Usefulwhenyouhavetwo

separatenoterangesmappedusingtworoutestotheoneinstrument.Byselectingthissettingononeroutethetarget

instrumentwillonlygetonesetofcontrollerevents.

ShowOnKeyboardAs:(choosecolor)

WhenselectedthekeyboardrangeisshownonCantabile'son-screenkeyboard.Youcanalsoselectacolor.

VelocityCurve

AdjuststhevelocitycurveforMIDInoteandaftertouchevents.

OnlyRouteWhenThisProgramNumberisActive

Restrictsroutingtoonlytakeplaceifthespecifiedprogramnumberwasthelastreceivedprogramevent.

Condition

RestrictsroutingtowhenaparticularCCconditionistrue.eg:onlyroutewhenaparticularpedalispressed.

MIDIFilters

EveryMIDIroutealsosupportsasetofMIDIFiltersthatprovideevenmorefinegrainedcontroloverMIDIpassingthrough

theroute.ToedittheMIDIFiltersforaroute,selecttherouteinCantabile'smainwindowandchooseEdit->MIDIFilters

fromthemainmenu.NotethatMIDIFiltersareappliedaftertheregularMIDIroutesettingsshownabove.

LearnMode

YoucansimplifytheentryofkeyrangeandtransposesettingsbyusingLearnMode:

1. Turnonthe"LearnMode"option

2. Clicktoplacefocusineitherofthenoterangefields,orthetransposefield

3. Playanotetosetthefield'svalue(thenotemustbeplayedonthesamedeviceastherouteisconnectedto).

4. Turnofflearnmode

Tosetthetranspose,playtwonotes-theintervalwillbecalculatedbasedontheprevioustwonotesplayed.eg:playingC4

thenE4willsetthetransposeto"+0.4-upamajor3rd".

MIDIFilters

MIDIFilterssupportapplyingawiderangeoftransformationstoMIDIeventsastheypassthroughthesystem.

AccessingMIDIFilters

AccessingMIDIFilters

TobringuptheMIDIfiltereditorselecteitheraMIDIRouteSlotoraPluginSlotandchooseEdit->MIDIFiltersfromthe

mainmenu.

YoucanalsoaccesstheMIDIfiltersviatheMIDIfilterbuttonintheobject'sslotinthemainwindow:

NotethesmallgreenindicatoronthisbuttonshowsthatthereareactiveMIDIFiltersonthisobject.

PortMIDIFilters

MIDIportsalsohaveMIDIFiltersupportandprovideaconvenientwaytomassageincomingMIDIeventsacrossallsongs.

ForexampleyoucanaddMIDIFilterstoanenvironmentMIDIInputport.

1. OpenCantabile'sOptions

2. SwitchtotheMIDIPortspage

3. DoubleclickonaMIDIPort

4. ClicktheMIDIFiltersbutton

MIDIFilterProcessingOrder ForMIDIRoutes,MIDIFiltersareappliedaftertheotherMIDIroutesettings.

MIDIFilterProcessingOrder

ForMIDIRoutes,MIDIFiltersareappliedaftertheotherMIDIroutesettings.

ForPlugins,MIDIFiltersareappliedbeforetheeventsareforwardedtotheplugin.

MIDIFilterTypes

MIDIMonitoring

Sometimesit'susefultobeabletochecktheMIDIeventspassingthroughthesystem.Tosupportthis,Cantabileincludesa

simpleMIDImonitor-apopupwindowthatdisplaysMIDIeventsinreal-time.

TobringupaMIDImonitor,selecteitherapluginslotorMIDIrouteslotandchooseView->MIDIMonitorfromthemain

menu.

Somenotes:

ForMIDIRoutes,themonitorshowseventsbeingsentbytheroute.

ForPlugins,themonitorshowseventsreceivedbytheplugin.

TheMIDImonitorhasalimitednumberofeventsthatitshows(toavoidconsumingtoomuchmemory)

YoucanlocktheMIDImonitorfromautomaticscrollingbymovingtheselectionfromthelastrow(ie:presstheUp

arrow,orclickanotherrow)

Youcanresumeautomaticscrollingbymovingtheselectionbacktothelastentryinthelist(ie:presstheEndkey)

GlobalTranspose

Cantabilesupportsaglobaltransposesettings.Toaccessthetransposesettingseither:

FromtheEditmenu,selectSetTranspose,or

ClicktheTransposebuttonontheInputPortsslot(whichalsoshowsthecurrenttransposesetting)

Thetransposesettingswindowappearsasasmallpopup:

Thetransposesettingswindowappearsasasmallpopup:

Thetransposesettingswindowappearsasasmallpopup: GlobalTranspose

GlobalTranspose

Thissettingcontrolsthesongwidetransposesetting.ItissavedwiththesongfileandaffectsallMIDIroutesintheloaded

songandandreferencedracks.

Thetransposesettingcanbecontrolledbystatesandthisbehaviorenabledbydefault.Todisablestatecontrol,selectthe

InputPortsslotandremovethecheckmarknextto"Transpose"inthestatebehaviorpanel.(seehereformore).

ExcludingMIDIRoutesfromTranspose

YoucanpreventaMIDIRoutefrombeingaffectedbytheglobaltransposesettingbyopeningtheroute'soptionsand

selecting"IgnoreGlobalTransposeSettings".

Thiscanbeusefulintwosituations:

1. Forroutestopercussiveinstrumentsthatshouldn'tbetransposed.

2. Forrouteswherethetransposesettinghasalreadybeenapplied.

Notes

NotesaretransposedafteranyinputportMIDIroutesplitorkeyrangesettingshavebeenapplied(thisallowsadjusting

thetransposesettingswithoutaffectingsplitpoints).

ThetranspositionsettingistakenintoaccountbyCantabile'sheldnotetrackingsochangingitwhilenotesareheld

won'tresultinstucknotes.

TheInputPortsslotshowsthecurrenttranspositionamountas

tone.

eg:"+1.0"=uponeoctavewhile-0.2=downone

ManagingPlugins

Cantabileprovidesvarioustoolsformanagingandorganizingplugins.

SettingtheVSTPluginPath

Cantabileneedstoknowwhereyou'veinstalledyourVSTplugins.ThisisdoneinOptions->PluginOptions:

WhenyouchangetheVSTpath,Cantabilewillscanthespecifiedfolderstolocateinformationaboutallofyourinstalled

WhenyouchangetheVSTpath,Cantabilewillscanthespecifiedfolderstolocateinformationaboutallofyourinstalled

plugins.ThediscoveredpluginswillthenappearintheInsertPluginwindow.

Note:

intheabovescreenshotyoucanalsospecifya"Presets"folder.Anypluginbanksorprograms(eg:.fxb,.fxp,

)filessavedtothisfolderwillalsoappearintheInsertPluginwindow.

.cantabileBank,.cantabileProgrametc

youcanspecifymultipleVSTfoldersbyseparatingeachwithasemicolon(;)character.

ScanningPluginFolders

IfyouinstallnewpluginstoyouVSTpath,anewpluginscanwillneedtoberunbeforethosepluginsarediscovered.Ifyou

turnontheoption"Rescanpluginfoldersonstartup"(seeabovescreenshot)thesenewpluginswillbeautomatically

discoveredwhenyourestartCantabile.

TodiscovernewpluginsthatareinstalledwhileCantabileisrunningyoucanmanuallyinvokeapluginscanbychoosing

"ScanPluginFolders"fromtheToolsmenu.

Therearetwopluginscanningmodes:

Quick-looksfornewandremovedplugins,doesn'tre-scanpluginsthathaven'tchanged

Full-allcurrentlyknownplugininformationisdiscardedandeverypluginisre-scanned.

InsertingaPlugin

Onceyourpluginfolder(s)havebeenscannedallthefoundpluginswillbeshownintheInsertPluginwindow(Insertmenu-

>Plugin

).

TheInsertPluginwindowhasvariouswaysofbrowsingandfindingplugins:

Typethefirstfewlettersofthepluginandthelistwillbefilteredtoonlyshowthosethatmatchwhatyou'vetyped.

Usethecategoriesintheleftpaneltobrowseforpluginsofaparticulartype.

Usethe"ByFolder"categorytobrowsepluginsasthey'reorganizedondisk.

USethe"ByTags"categorytobrowsepluginsorganizedwithyourowntags(seebelow).

Onceyou'vefoundthepluginyou'reaftereitherdoubleclickit,orselectitandpressOKtoinsertit.

PluginInformation

Whenasinglepluginisselectedinthepluginlist,informationaboutthatpluginwillbeshowninthepanelbelowthelist,

including:

Thefullpaththepluginondisk

Thepluginscapabilitiessuchasthenumberofaudioinputs/outputs,whetheritsupportsMIDIinputoutput,audio

precisionsupportetc

Thepluginvendorie:whodevelopedtheplugin

FavouritePlugins

YoucanmarkpluginsasbeingaFavouritetohaveitappearintheFavouritescategory:

Tomarkapluginasafavourite,simplyselectitinthelistandturnonthe"Favourite"checkbox.

HiddenPlugins

HiddenPlugins

Youcanalsomarkpluginsashiddeninwhichcasetheywillonlyappearinthe"Hidden"categoryandwillbeexcludedfrom

allothercategoriesandsearchresults.

Tounhideaplugin,finditintheHiddencategoryandremovethecheckmarkfromtheHiddenoption.

DefaultPluginCategory

YoucanchoosewhichplugincategoryisselectedwhenyoufirstbringuptheInsertPluginwindowviathe"More"button

dropdown.

eg:supposeyouwanttheInsertPluginwindowtoalwaysstartontheFavouritesgroup:

PluginTags

PluginTags

Ifyouhavealargelibraryofpluginsyoumightliketoorganizeyourpluginsusing"tags"-alistofwordsthatbetter

describethetypeofplugin.eg:youmightliketotagKontaktasa"Sampler"andVB3asan"Organ".

Tosetaplugin'stags:

1. SelectthepluginintheInsertPluginwindow

2. Rightclickonitandchoose"EditTags",orsimplyCtrl+T

You'llbepresentedwiththeEditPluginTagswindowandthefirsttimeyoubringitupitwillbeempty.Justtypethenames

ofthetagsyou'dliketoassigntothispluginandpressOK:

ofthetagsyou'dliketoassigntothispluginandpressOK:

BackintheInsertPluginwindow,you'llnoticethesecondcolumnnowshowsthetags:

andifyouselectthe"ByTag"groupontheleft,you'llbeabletobrowseallpluginswithparticulartags:

andifyouselectthe"ByTag"groupontheleft,you'llbeabletobrowseallpluginswithparticulartags:

Asyoucreatemoretags,you'llnoticetheyappearintheEditTagswindowandyoucansimplycheck/uncheckthem:

Alsonote:

Alsonote:

Toremoveatagfromaplugin,bringuptheEditTagswindowandremovethecheckmarkforthattag.

Youcansetthetagsformultiplepluginsatonce-justselectalltherelevantpluginsbeforebringinguptheEditTags

window.

UserInformationStorage

Alluserenteredinformationaboutplugins(favouriteplugins,hiddenpluginsandplugintags)arestoredinthefile

"plugins.user.json"whichcanbefoundinthesettingsfolder(Toolsmenu->OpenSettingsFolder).

Pleasebesuretobackupthisfilesoyoudon'tlosethesesettings.Youcanalsocopythisfilebetweenconfigurationsto

havethesametagsacrossmultipleconfigurations.

AudioEngineOptions

TheAudioEngineoptionspageprovidessettingsthatcontrolvariousimportantaspectsofCantabileaudioprocessing:

AudioDriver TheaudiodriverdropdownletsyouchoosewhichaudiodriverCantabilewilluseforaudioprocessing.Cantabilesupports

AudioDriver

TheaudiodriverdropdownletsyouchoosewhichaudiodriverCantabilewilluseforaudioprocessing.Cantabilesupports

ASIOdriversforfullaudioinput/outputsupportandWASAPIforoutputaudioonly.

IngeneralwerecommendusingtheASIOdriverthatwasshippedwithyoursounddevice.Ifnosuchdriverwasprovided(or

ifitsunreliable)youcanusethegeneralpurposeASIOdriverASIO4ALLwhichworkswellwithCantabile.

Mostaudiodriverswilltakeexclusivecontroloftheassociatedsounddevicemakingthatdeviceunavailabletoother

programs.Thisisbecauseexclusiveaccessprovidesthebestpossiblelatencyandaudioperformance.Ifyouneedtouse

anotheraudioprogramwhileCantabileisrunningyoucaneither:

1. StopCantabile'saudioengine(thepowerbuttonatthetoprightofthemainwindow)whileusingtheotherprogram

2. CheckifyourASIOdriversupportsasharedmode.(somedo,notall)

3. ChooseaWASAPIdriverandsetthesampleratedropdownto"SharedMode".

Thethirdoptionisagoodchoiceifyouwanttoplayalongwithothermusicplayedfromyourcomputer(eg:playingalong

withaYouTubevideo).

MostASIOdrivershaveadditionalsettingsthatcanbeaccessedviathe"ControlPanel"button.

SampleRateandBufferSize

ThesamplerateandbuffersizeoptionscontrolthesizeofeachaudiobufferprocessedbyCantabile.Theavailablechoices

herearedictatedbythecapabilitiesoftheselectedaudiodriver.

Ingeneral:

Thehigherthesampleratethebetterthequality,butattheexpenseofadditionalprocessingload.

Thehigherthebuffersize,thelesschanceofaudiodropoutsbutattheexpenseofpossibleaudiodropouts.

Ingeneralforliveperformanceworkwerecommendsettingthesamplerate44,100Hzandbuffersizeto256samples.This

providesagoodbalancebetweenacceptablelatencyandsufficientheadroomtonotcauseaudiodropouts.

ForadetailedexplanationofhowtoconfiguretheseoptionsseeourfreeeBookGlitchFree.

DoubleBufferedAudio

Whenthedoublebufferedaudiooptionisenabled,theaudioengineintroducesanadditionalaudiobufferbetweenthe

audiodriverandtheaudioengine.

Thiscanworkparticularlywellwithsomepoorlydesignedaudiodriversthatconsumeasignificantportionoftheaudiocycle

beforepassingcontroltoCantabile.Italsoprovidesanextracushiontodealwithsmallunexpectedstallsintheaudio

processing.

Notethattheextralayerofbufferingalsocausesadditionallatency-effectivelydoublingthebuffersize.

Someconsiderations:

Ifyoufindyou'regettingaudiodropoutswhenprocessingloadisstillbelow100%(eg:somedriverscancausedropouts

evenwithloadaslowas85%)thenusingdoublebufferingmightbeagoodoption.

Youcanexperimentwiththisoptionbyenablingitandthenhalving(oratleastsignificantlyreducing)thebuffersize.If

yougetacceptableperformanceinthisconfigurationthenusingthisoptionmightbeagoodchoiceasitprovidesthat

extracushionforunexpectedstalls.

NumberofAudioThreads

Cantabile'saudioenginecanprocessmultiplesimultaneoustasksonseparatethreads.Normallyyoushouldsetthisoption

tothenumberofphysicalprocessorcoressupportedbyyourcomputer.Don'tsetthistothenumberofvirtualhyper-

threadingcores-thisalmostalwayshasdetrimentalaffectsonaudioprocessing.

Otherconsiderations:

Someplugins(particularlyolder,non-supportedplugins)haveissueswithmulti-coreprocessing.Settingthenumberof

audiocorestooneeffectivelydisablesmulti-coreprocessingandmighteliminateproblemswiththeseplugins.

Ifyou'reusingpluginsthathavetheirownmulti-coreprocessingsupport,youmaygetbetterperformancebyreducing

thenumberofCantabileaudiothreads-freeupsomeforpluginprocessing.

Again,refertoGlitchFreeforamoredetaileddiscussionofthistopic.

Multi-ProcessorMode

Asmentionedabove,somepluginshaveissueswithmulti-coreprocessing.ThisoptioncontrolshowaggressivelyCantabile

triestoschedulepluginprocessingtodifferentcores.Ifyoufindissueswhenrunningmultipleinstancesofthesameplugin

causingcrashesorotherunexpectedbehaviouryoucantrysettingthisoptionto"Compatible".

Ifcompatiblemoderesolvestheissue,pleasereportthepluginthat'scausingtheproblem.

PreventMemoryPaging

Thisoptioncanhelponoldmachines(pre-Window10)thatdon'thavesufficientmemorytoreliablyrunlargesamplebased

plugins.Ingeneralthisoptionshouldnolongerbeused.

SampleRateConversionQuality

Thisoptioncontrolsthesamplerateconversionofaudiofileplaybackandisonlyusedwhenplayingaudiofileswitha

sampleratedifferenttothecurrentlyselectedaudioenginesamplerate.

SwitchtoPowerPlan

Whenrunninganyreal-timeaudiosoftwareyoushouldswitchtheselectedWindowsPowerPlantothe"HighPerformance"

plan.TosavemanuallydoingthiseverytimeyourunCantabile,youcanselectapowerplanhereandCantabilewill

automaticallyactivateitwhentheaudioenginestartsandsetitbackwhentheengineisstopped.

EnableOutputLimiter

Toavoidhardclippingofoutputaudio,youcanuseCantabile'saudiolimitertoautomaticallyreduceloudsignalsbackinto

range.

DoublePrecision(64-bit)Audio

Selectthisoptiontoenable64-bitfloatingmathprocessingforaudiosignalprocessing.Generallyforliveperformancework

thisisexcessiveandshouldbeleftturnedoff.SeeGlitchFreeforamoredetaileddiscussionofthistopic.

Racks

Racksprovidetheabilitytogrouptogetherasetofobjectsintoaself-contained"blackbox"thatworksasastandaloneunit.

Forexampleyoucouldputaninstrumentpluginconnectedtoasetofeffectpluginsintoarack.Thatrackwouldthen

appearintheparentsongasasingleself-containedslotwrappingallthepluginsandtheirwiring.

InsertingaRack

Toaddaracktoasong,clicktheAddObjectbuttonandchooseoneoffollowingcommands:

EmbeddedRack-insertsanewemptyEmbeddedRack

EmbeddedRack-insertsanewemptyEmbeddedRack

EmbeddedRack(fromfile)-insertsanEmbeddedRackandinitializesitwiththecontentsofasavedrackfile

NewLinkedRack-createsanewlinkedrack(willpromptforthenametherackshouldbesavedas)

ExistingLinkedRack-selectanexistingrackfiletobeinsertedasalinkedrack

(SeebelowfordetailsonLinkedvsEmbeddedracks)

EditingaRack

Toeditthecontentsofarack,simplydoubleclickitsnameintheparentsongfile(orselectitandpressEnter).

Wheneditingarack,Cantabile'smainwindowsplitsandshowstherack'scontentinthelowerhalf:

Editingthecontentsofaracksisidenticaltoworkingwithasong.Insertplugins,connectthemusingroutes,setupbindings

etc

exactlyasyouwouldforasong.

Toclosetherackclickthe"eject"button:

RackPorts RackssupportasetofaudioandMIDIportsthatcanbeusedtocreaterouteconnectionsbetweenracks.Bydefault,each

RackPorts

RackssupportasetofaudioandMIDIportsthatcanbeusedtocreaterouteconnectionsbetweenracks.Bydefault,each

rackhasthefollowingports:

MIDIInrackhasthefollowingports: MIDIOut StereoIn StereoOut

MIDIOutrackhasthefollowingports: MIDIIn StereoIn StereoOut

StereoInrackhasthefollowingports: MIDIIn MIDIOut StereoOut

StereoOutrackhasthefollowingports: MIDIIn MIDIOut StereoIn

Externallytotherackyouconnectyoursongandrackfilesbycreatingroutesbetweenthesongandtheracksports.

Internallyyouconnectaracksportstopluginsandotherobjectsintherack.

Forexample,here'showasongwithasinglerackcontaininganinstrumentandaneffectmightbewiredup.

Internallytotherack:

Internallytotherack:

Therack'sMIDIInportisconnectedtotheinstrument

Theinstrumentisconnectedtotheeffect

Theeffectisconnectedtotherack'sStereoOutport

Externally,inthesong:

TheMainKeyboardenvironmentportisconnectedtotherack'sMIDIIn

TheRack'sStereoOutisconnectedtotheMainSpeakersenvironmentport.

Althougheachrackhasadefaultsetofinputandoutputports,youcancreateyourownportconfigurationsby:

Rightclickingontheportslotintheparentsongfileandselecting"RackAudioPorts"or"RackMIDIPorts"

Withtherackopenforediting,rightclickontheInputPortsorOutputPortsslotandchoosingfromthesametwo

commands.

commands. TheBackgroundRack

TheBackgroundRack

Asidefromracksthatyouexplicitlyloadintoasongthereisonespecialrackcalledthe"BackgroundRack"thatistypically

usedforbindingsthatneedtoworkacrossallsongsbutcanalsobeusedtoloadplugins,mediaplayersortriggersthatyou

needavailableinallsessions.

Toaccessthebackgroundrack,fromtheViewmenuchoose"BackgroundRack".

ChangestothebackgroundrackarealwayssavedautomaticallywhentheCantabileisclosed.

LinkedvsEmbeddedRacks

RackscaneitherEmbeddedorLinked:

EmbeddedRacksaresavedaspartoftheparentsongandcan'tbesharedacrosssongs(althoughtheycanbeexported

andre-importedintoothersongs)

LinkedRacksaresavedinaseparate.cantabileRackfileandcanbesharedacrossmultiplesongs.Theyprovidethe

abilitytoshareplugininstancesacrossmultiplesongsmakingsongswitchingfaster.

LinkedracksareonlysupportedinCantabilePerformer.

RacksvsSongs

Racksandsongsareverysimilarandworkingwitharackisalmostidenticaltoeditingasong.

Songsandracksbothsupport:

Routing-asetofplugins,mediaplayersandnestedembeddedracksandtheroutesthatconnectthemtogether.

Bindings-assignmentsthatautomaticallyconnectobjectssettingsandMIDIdevices.

Songsprovidethesamefunctionalityasracks,butadd:

TempoandTimesignaturesettings

AGlobaltransposesetting

Abilitytoloadlinkedracks

Notethatonlysongscanloadlinkedracks.Rackscanhaveembeddedracksbutcan'tloadlinkedracks.

AsongistheprimaryfileyouworkwithatanyonetimeinCantabileandonlyonecanbeloadedatatime.

SongandLinkedRackLifetimes

The"lifetime"ofsongsandracksishandleddifferently.

Whenswitchingsongsthesongandallroutesbetweenthesongandit'sloadedracksareimmediatelyclosedandanyheld

notesreleased.Embeddedracksareclosedwhentheparentsongisclosed.

Linkedracksonlyclosedwhenthecurrentsongnolongerreferstothem.Ifyouswitchbetweentwosongsthatusethe

samerack,thatrackwillbekeptloadedandcontinuetoprocessuninterrupted.

SongandRackPre-loading

SongandRackStates(CantabilePerformerOnly)

InCantabilePerformer,bothsongsandrackssupportStateshoweverthey'retypicallyusedfordifferentpurposes:

Inracks,statesaretypicallyusedtoswitchbetweendifferentsoundswhereeachstateworkssimilarlytoapluginpreset

andisselectablefromtheparentsong'sjustlikeapluginpreset

Forsongs,statesaretypicallyusedtorepresentthepartsofasong(eg:intro,chorus,verse).

Theterms"SongState"and"SongPart"areusedinterchangablyinCantabile.

Per-SongRackSettings(CantabilePerformerOnly)

Wheneditingthestatebehaviorofobjectsinarackyoucanindicatethatthesettingshouldbestoredonaper-songbasis.

Thisallowsforcontroloverarack'ssettingsonaper-songbasiswithouthavingtocreatestatesforeverypossible

combination.SeeStatesformoreinformation.

Metronome

Cantabileincludesametronomethatservestwomainpurposes:

1. Asageneralpurposemetronomeforpractice

2. Toprovidetiminginformationforplugins(eg:stepsequencers,syncedloopsetc

)

ShowingtheMetronomeToolbar

Toshowthemetronome:

) ShowingtheMetronomeToolbar Toshowthemetronome: ClicktheMetronomebuttononthemaintoolbar,or Press Ctrl+M

ClicktheMetronomebuttononthemaintoolbar,or

PressCtrl+M

Ineithercase,keyboardfocuswillbemovedtothemetronome.

Tohidethemetronome:

PresstheMetronomebuttonagain,or

Whilethemetronomehaskeyboardfocus,pressShift+Escape.

YoucanalsoreturnfocusfromthemetronometothemainpluginlistbypressingEscape.

MetronomeControls

Escape . MetronomeControls

Themetronometoolbarisdividedintothreesections:timesignature,tempoandsounds.Mostsettingsareselfexplanatory

butnotethefollowing:

Bothtimesignatureandtempohaveasetofassociatedpresets.Toaddorremovepresetsusethebuttonsatthe

bottomofeachpopup.

Thetempocanbeadjustedbyselectingapresetfromthedropdown,usingtheup/downarrowkeyswhilethetempo

indicatorhasfocus,usingthe+/-buttonsonthetoolbar,ortheslider.

Thelasttwocontrolsenablethemetronomesoundsandadjusttheirvolume.(Seebelowforconfiguringmetronome

sounds).

ThecurrenttempoandtimesignaturearesavedinthesongfileandinCantabilePerformercanalsobecontrolledby

Thetempopresets,timesignaturepresetsandmetronomesoundsettingsaresavedglobally(ie:notpersong).

StartingandStoppingtheMetronome

Themetronomecanbestarted,stoppedandpausedusingthetransportcontrolsonthemaintoolbar.Thestatuspanelwill

updatetoshowthecurrenttransportposition,timinginformationandcurrentbeat.

SynchronizingtoanExternalMIDIClockSource

SynchronizingtoanExternalMIDIClockSource

Cantabilecanalsosynchronizeit'stimingtoanexternalMIDIclocksourceandactasaMIDIclockmastertootherdevices.

Formoreinformationaboutthis,seeMIDIClock.

RoutingMetronomeSounds

Inordertohearsoundsfromthemetronomeyoumustconfigureanaudioportnamed"Metronome".Allmetronomesounds

aresenttothisport.Ifit'snotpresent,ornotconnectedtoactivespeakerchannelsyouwon'thearthemetronomesounds.

Cantabilewillautomaticallycreateanaudioportforthemetronomehoweveryouneedtomakesurethechannelismapped

toatleastoneaudiodriverchannel.Inthefollowingexamplethemetronomesignalhasbeenmappedtobothmain

speakers(HDAudioOutput1and2).

TapTempoandTempoFlashIndicators

TapTempoandTempoFlashIndicators

Themetronometempocanalsobesetbytappingthe"TapTempo"buttononthemaintoolbar(ortheequivalentbuttonon

the controllerbar ):

YoucanalsoconfiguretheTapTempobuttontoflashintimewiththecurrenttempo:

RightclickontheTapTempobuttonandchoosefromthefollowing:

RightclickontheTapTempobuttonandchoosefromthefollowing:

Flash-flashesintimewiththecurrentmastertransportwhenit'splaying.

FlashWhenStopped-flashesintimewiththemastertransportwhenplayingbutalsoflashesthecurrenttempoeven

whenthetransportisstopped(butit'snotsynchronizedwithanytiminginformationusedinternallybyCantabile).

Thesecondoptionisusefulifyoudon'tactivelyusethemetronomefortimingbutneedavisualindicatorofaspecific

tempo.

ChangingMetronomeSounds

Therearetwobuiltinsoundsetsforthemetronome-ClassicandModern,butyoucanalsoselectcustomsoundsifyou

prefer.

You'llneedtwosoundsfilesoneforthefirstbeatofthebar/measureandonefortheotherbeats.Thesefilesmustbewave

filesandonlythefirsttwosecondsofeachisused.

filesandonlythefirsttwosecondsofeachisused. ThesesettingscanbefoundontheGeneraloptionspage.

ThesesettingscanbefoundontheGeneraloptionspage.

DisablingMeasureSounds

Bydefaultthemetronomesoundsuseadifferentsoundforthefirstbeatofeachmeasure.Youcandisablethissoundand

usethesamesoundforallbeats:

1. Rightclickonthebuttontoenablemetronomesounds

2. Choosing"EnableMeasureSounds"totogglethemeasuresoundson/off.

AboutMetronomeBindings

LikemostothersettingsinCantabilethemetronomecanbecontrolledremotelyviabindings.Therearehoweverafew

nuancesaboutthemetronomebindingsthatyoushouldbeawareof.

Themetronometemporangesfrom30to300bpm.NormalMIDIcontinuouscontrollers(CCs)howeverhavearangeof0-

127.ThetempobindingsupportssettingatargetrangesoyoucansethowtomaptheCCvalueontoatempo.

Themetronometimesignaturecanbeboundeitherbyselectingapreset(thedropdowntimesignaturesinthemetronome

bar)orbydirectbindingstothetimesignaturenumeratoranddenominator.

Thenumeratorrangesfrom2to12.

Thedenominatorsupportsvalue1,2,4,8,16and32.Othervalueswillbeignored.

Thedenominator(2^n)bindingacceptsvalueswherethedenominatoriscalculatedas2^nandnisavaluefrom0to5.

ThismatchestheMIDImethodsforspecifyingtimesignaturedenominators:

0=/11=/2 2=/4 3=/8 4=/16 5=/32

1=/20=/1 2=/4 3=/8 4=/16 5=/32

2=/40=/1 1=/2 3=/8 4=/16 5=/32

3=/80=/1 1=/2 2=/4 4=/16 5=/32

4=/160=/1 1=/2 2=/4 3=/8 5=/32

5=/320=/1 1=/2 2=/4 3=/8 4=/16

Whencreatingbindingstothetimesignaturetherangeshouldbesetaccordingtohowyou'retryingtocontrolthetempo.If

you'rebindingaknoborslidertothetimesignatureyoushouldmapthefullrangeofthecontrollertothefullrangeofthe

bindingtarget.

eg:0 127->1 12

Thiswillallowmovingthesliderfromoneendtotheothertoselectthefullrangeofvalues.

Ifyou'retryingtoprogramaticallycontrolthesevaluesyou'llprobablywanttochangethebinding'srangemappingtoa1:1

mapping

eg:

Numerator:1 12->1 12mapping eg: Denominator:2 32->2 32 Denominator(2^n):0 5->0 5

Denominator:2 32->2 32mapping eg: Numerator:1 12->1 12 Denominator(2^n):0 5->0 5

Denominator(2^n):0 5->0 5eg: Numerator:1 12->1 12 Denominator:2 32->2 32

Thiswillletyousendexplicitvaluestodirectlysetthemetronomesettings.

MediaPlayers

CantabilesupportplaybackofAudioandMIDIfiles.Thefollowingfileformatsaresupported:.mp3,.wav,.flacand.midor

.midi.

ThisvideowalkthroughalsodemonstratesworkingwithMediaPlayers.

CantabileSoloandCantabilePerformerOnly.

UsingaMediaPlayers

TocreateaMediaPlayer,fromtheInsertmenuchooseMediaPlayer:

CantabileSoloandCantabilePerformerOnly. UsingaMediaPlayers TocreateaMediaPlayer,fromtheInsertmenuchooseMediaPlayer:

Onceinserted,anewMediaPlayerslotwillappearinthemainpanel:

Onceinserted,anewMediaPlayerslotwillappearinthemainpanel:

Eachmediaplayersupportsaplaylistofmediafiles.Tosetuptheplaylist,doubleclickonthemediaplayerandthenclick

theAddbuttontoloadsomemediafiles:

theAddbuttontoloadsomemediafiles:

Theaboveexampleshowsaplaylistwithtwo.mp3filesandthree.midifiles.

Thenextstepistoconfigureroutesfromthemediaplayertoeitheroutputdevices,orplugins.Bydefaulteachmediaplayer

iscreatedwithonestereooutputportandoneMIDIoutputport.

ThefollowingscreenshotshowstheMIDIoutputroutedtoaVSTiandtheaudiooutputroutedtoaneffectplugin:

Youcannowusetheplayer'stransportbuttonstoplaytheselectedfile.Thefileselectordropdowncanbeusedtoselect

whichfileistobeplayed.

TimelineView

Toviewthecontentsofamediafile,setplayrangesandloopmodes,usetheTimelinePanel.

TimelinePanel . MasterTransportSelection

MasterTransportSelection

ThemastertransportprovidesthemastertiminginformationthatotherpartsofCantabilecansynchronizeto.Forexample

themastertransportprovidestiminginformationtoanyloadedpluginsandisusedtocontrolMIDIoutputclocksignals.

BydefaultthemastertransportcontrolsCantabile'sbuilt-inmetronome.Whenusingmediafileshoweveritisoften

desirabletousetiminginformationfromtheplayingfile.Tochangethemastertransport,simplyselecttherequired

transportfromthedropdownonthemaintoolbar:

transportfromthedropdownonthemaintoolbar:

Themaintransportbuttonsonthemaintoolbaralwayscontrolwhicheverobjectisselectedinthemastertransportdrop

down.

SynchronizationofMediaPlayerswithMasterTransport

Mediafilescanbesynchronizedtothemastertransport-whichmightbeanothermediaplayer,themetronomeorthe

externalMIDIclock.

Whenamediaplayerissynchronizeditstartsandstopsplayingwhenthemastertransportstartsandstops.Also

synchronizedmediaplayerstrackthecurrentplaypositionofthemaster.

Tosynchronizeamediaplayer,rightclickonitandchooseoneoftheslavesynchoronizationmodes:

Off-notsynchronized

Master-makesthismediaplayerthemastertransport

SlaveRealtimeMaster-makesthismediaplayerthemastertransport SlaveMaster

SlaveMasterMaster-makesthismediaplayerthemastertransport SlaveRealtime

Thedifferencebetweenrealtimeandmusicalistheplaybackspeed/tempoofthesyncedmediafile.

Realtime-thesyncedmediafileplaysatit'snativespeedanddependsontheslaveandmasterbothhavingthesame

tempoinordertostayinsync.eg:Ametronomesettoaparticulartempoandanaudiofilerecordedatthesame

tempo.

Musical-herethetargetMIDIplayerignoresthetempoinformationintheMIDIfileandinsteadtracksthemaster

transport.eg:whenamidifileissyncedtothemetronome,changingthetempoofthemetronomewillcausethemidi

filetoplayfaster/slower.

TheMusicalsyncmodeonlyworkswithMIDIfiles.Ifselectedforanaudiofile,musicalsyncingwillbeusedwhensettingthe

startpositionforplayback,butduringplaytheaudiofilealwaysplaysatitsnativespeed.

CustomizingAudioandMIDIPorts

Asmentionedabove,eachmediaplayeriscreatedwithadefaultsetofMIDIandAudiooutputports.Youcanhowever

createnewports,orreconfiguretheexistingonestosuityourneeds.

Rightclickonthemediaplayerandchooseeither"MIDIPort"or"AudioPorts":

ConfiguringportsissimilartoanywhereelseinCantabilewhereportscanbeedited.Here'stheaudioporteditor:

ConfiguringportsissimilartoanywhereelseinCantabilewhereportscanbeedited.Here'stheaudioporteditor: MIDIportsaresimilar:

MIDIportsaresimilar:

Afteryou'vecreatedtherequiredportsyoucanrouteeachporttodifferentpluginsorphysicaloutputs. EditingPer-fileSettings

Afteryou'vecreatedtherequiredportsyoucanrouteeachporttodifferentpluginsorphysicaloutputs.

EditingPer-fileSettings

Eachmediafilemanagedbythemediaplayerhasasetofpropertiesthatcontrolhowit'strackand/orchannelsaremapped

totheplayer'soutputportsaswellasvarioustempoandtimingsettings

Toedittheseproperties,doubleclickthemediaplayertoopenthePlayListeditorandthendoubleclickafiletoeditit's

assignments.Youcanalsodirectlyeditthecurrentlyloadedfile'sassignmentsbychoosing"EditCurrentFileSettings"after

rightclickingonthemediaplayerslot.

rightclickingonthemediaplayerslot. Thesesettingsperformthefollowingfunctions:

Thesesettingsperformthefollowingfunctions:

TempoandTimeSignature

Foraudiofilesthisdefinesthetempoandtimesignatureoftheaudioandisusedtoprovidemusicaltiminginformation

whentheaudiofileisthemastertransport(seebelow).ForMIDIfilesthisinformationnormallycomesfromtheMIDIfile

itselfhoweverthesesettingscanbeusedtooverrideanyembeddedtiminginformation.

Gain

Providescontrolovertheoutputlevelofthemediaplayerforthisfile.Foraudiofilesthegainisapplieddirectlytothe

outputsignal.ForMIDIfilesthevelocityofnoteeventsisadjustedtosimulatevolumegain.

Speed

Controlstheplaybackspeedasapercentageoftheoriginalspeed.

PortAssignments

UsethissectiontomapaudiofilechannelsandMIDIfiletrackstothemediaplayersoutputports.Youcancreate

multipleassignmentsfromeachsourcetrackchannelifnecessary-eachwithdifferentaudiogainsettingsorMIDItrack

filters.

Bindings

MediafilescanberemotelytriggeredfromaMIDIcontrolsurfaceusingBindings.Forexamplethefollowingbinding

starts/stopsthemediaplayereachtimeabuttonwithCC#16ispressedonthe"MainKeyboard"device.

StateSupport(CantabilePerformerOnly)

StateSupport(CantabilePerformerOnly)

MediaplayerscanalsobecontrolledviaStates.Statescanbeusedtocontrolthefollowingsettingsbetweenstates:

SelectedFileGainLevel PlaybackSpeed PanandFade UserNotes SlotColor Recording

GainLevelSelectedFile PlaybackSpeed PanandFade UserNotes SlotColor Recording

PlaybackSpeedSelectedFile GainLevel PanandFade UserNotes SlotColor Recording

PanandFadeSelectedFile GainLevel PlaybackSpeed UserNotes SlotColor Recording

UserNotesSelectedFile GainLevel PlaybackSpeed PanandFade SlotColor Recording

SlotColorSelectedFile GainLevel PlaybackSpeed PanandFade UserNotes Recording

Recording

CantabilesupportsaudioandMIDIrecording,includingautomaticrecordingwheretherecorderstartsandstops

automaticallyasyouplay.Cantabilecanbeleftinautorecordmodeanditwillcaptureeverythingyouplay.

Thisvideowalkthroughalsodemonstratesworkingwiththerecorder.

CantabileSoloandCantabilePerformerOnly.

SelectingwhattoRecord

TherecordercapturesaudioandMIDIdatafromasetofinputand/oroutputportsthatyouselect.Forexampleyoumight

choosetorecordincomingMIDIfromyourmainkeyboardaswellasaudiosenttothespeakers.

Toselecttheportsthatshouldberecorded,fromtheViewmenu,choose"RecorderPorts".Thiswillshowasmallpanelat

thebottomoftherecordingslistwhereyoucanchoosewhichportstorecord.

Notethataportdoesn'tneedtobeconnectedtoaphysicaldevicetorecordit.Thiscanbehandytorecordsignalsfrom

insidethesong-simplycreateanaudioorMIDIoutputport,leaveitdisconnected,setuparoutetosendthesignaltobe

recordedandthenselecttheportintherecordingportslist.

ManualRecording

Tostartrecording,clicktheRecordbuttononthemaintoolbar,usetheshortcutkey('R'bydefault)orchoosethe"Record"

commandfromthe"Control"menu.

RecordingwillcontinueuntilyoustoptherecordingbypressingtheRecordbuttonagain.Oncetherecordinghas

completed,anewentrywillappearintherecordinglist.

Recordingswithadurationoflessthan5secondswillbediscarded.YoucanadjustthisdurationinRecordingOptions.

AutomaticRecording

Toenableautomaticrecording,fromtheControlmenuchoose"AutoRecord",orrightclickontheRecordbuttononthe

maintoolbarandchoose"AutoRecord".

Whenauto-recordisenabled,thesmallindicatortothebottomrightoftheRecordbuttononthemaintoolbarwilllightup.

Foraporttobemonitoredforactivity,itmustbebothselectedforrecordingandthetypeofportmustbeenabledin

RecordingOptions.BydefaultonlyaudioandMIDIinputportsareenabled.Toenableautomaticrecordingforoutputports

youmustenablethoseporttypesinOptions.

Autorecordwillstoprecordingafter5secondofsilence.Whenmonitoringaudioports,thereisanoisethresholdsetting

thatcanbeusedifambientnoiseistriggeringtheaudiorecorder.BothofthesesettingscanbeadjustedinRecording

Options.

RecordingFiles

EachrecordingwillbesavedasoneMIDIfileandoneAudiofile(unlessnoportsofaparticulartypeareenabled).

ForMIDIfileseachportselectedforrecordingwillbewrittentoaseparateMIDItrack.Thetrackwillbenamedusingthe

portname.

ForAudiofileseachportwillbewrittenasaconsecutiviesetofchannels.Forexample,ifyouhavetwostereoportsselected

theresultingwavefilewillhavefourchannels.

PinnedandUnpinnedRecordings

Inthelistofrecordings,eachrecordinghasa"pin".Unpinnedrecordingswillbedeletedafter7days(adjustableinOptions).

Pinnedrecordingsareneverautomaticallydeleted.

Bydefaultallrecordingsarepinnedandwillbekeptindefinitely.InRecordingOptions,youcanchoosetonotpinnew

recordings.Inthiscaseallrecordingswilleventuallybeautomaticallydeleted-unlessyoumanuallypinthem.

WorkingwithRecordings

Therecordingslistshowsalistofallpreviousrecordings.Youcanusethislistmanageyourrecordings.Therightclick

contextmenuincludescommandstorename,delete,re-orderandlaunchWindowsExplorerwiththerecordingselected.

Therearealsocommandstodeleteallunpinnedrecordingsaswellastoclearthelistwithoutdeletingrecordings.

RecordingFilenamesandLocations

RecordingFilenamesandLocations

YoucanchangewhererecordingsaresavedandthenameofrecordingfilesinOptions.

Notethattherecordinglistisindependentoftheloadedsongfileandissavedinaspecialfileintherecordingfolder.Ifyou

changetherecordingfolder,anewlistisloaded.Byusingmultiplerecordingfoldersyoucanmanagemultiplesetsof

recordings.

MIDITimeFormatOptions

WhenrecordingMIDI,severaldifferenttimeformatsareavailable:

Realtime(Compatible)

Thisisthedefaultrecordingformatthatismostcompatiblewithothersoftware.Itrecordsinreal-time(ie:eacheventis

timestampedwithmillisecondaccuracy).Tempoandtime-signatureinformationisn'tcapturedinthismode.

Realtime(SMPTE)

ThisformatisverysimilartoRealtime(Compatible)exceptthefileismarkedasSMPTEtimeformat.Thisisamore

correctformatforthistypeofrecordingbutsomesoftwareprogramsdon'tsupportit.

Musical(Relative)andMusical(Absolute)

Intheseformatseventsaretimestampedusingmusicaltimeformat.

Thisformatisbestforimportingintoothersoftwareprogramswheremaintainingcorrectmusicaltimeismoreimportant

thanmillisecondaccuracy.InthisformatthetempoandtimesignatureofCantabile'smastertransportisalsorecorded

(evenifitchangesduringtherecording).

In"relative"modeeventswillbetimestampedsuchthattherecordingstartsjustbeforethefirstrecordedevents.In

"absolute"modeeventswillbetimestampedusingtheexacttimeofthemastertransport.

Tobetterunderstandthedifferencebetweenrelativeandabsolutemodes,considerthisscenario:supposearecordingis

startedwhenthecurrentmastertransportisatbar50(perhapsbecausethemetronomehasbeenrunningforawhile).

Inabsolutemode,therecordingwouldhave50barsofsilenceatthestart.

Inrelativemode,therecordedeventswouldbeatthestartoftherecording.

Notethatthemusicalrecordingformatsrequirearunningmastertransport.Ifthemastertransportisn'tplayingwhenthe

recordingstarts,therecorderwillautomaticallystartit(ifitcan).Similarly,ifthemastertransportstopswhilearecordingis

inprogress,therecordingwillalsostop.

Bindings

TherecordercanbeexternallycontrolledusingBindings.

ie:youcanassignbuttonsonyourkeyboardtostart/stoprecording,enable/disableautomaticrecording,pin/unpinthelast

recordingetc

recordingetc See Bindings formore. Bindings

SeeBindingsformore.

Bindings

BindingsletyoucontrolnearlyallsettingsinCantabile(andanyloadedplugins)fromanexternalMIDIdevicelikea

keyboard,controlsurfaceordrumpad.CantabilesupportsmanydifferentMIDIcontrollereventsandmanydifferent

controllableelementswithinCantabile.

CantabilePerformercansupports"reversebindings"whereasettinginsideCantabilecanbereflectedtoanexternalMIDI

devicesothatwheneverthesettingchangesanappropriateMIDImessageissent.

Note:"Bindings"isthenewnameforwhatwascalled"MIDIAssignments"inearlierversionsofCantabile

BindingsEditor

BindingsareeditedusingtheBindingstabinCantabile'smainwindow:

Youcanswitchtothistabeitherwiththemouse,orbypressingCtrl+DorbyusingCtrl+Tab/Ctrl+Shift+Tab. LearningBindingSource

Youcanswitchtothistabeitherwiththemouse,orbypressingCtrl+DorbyusingCtrl+Tab/Ctrl+Shift+Tab.

LearningBindingSource

TheeasiestwaytocreateanewbindingistoletCantabile"learn"it.Clickthe"NewBinding"buttonandchoosethe"

(learn)"option.

(learn)"option.

AwindowwillappearthatshowsallincomingMIDIevents.Moveorpressthecontrollerthatyouwanttobindanditshould

appearinthelist.Doubleclicktheeventyouwanttobindandanewbindingwiththatsourcecontrollerwillbecreated.

Youcanthenusethedropdownsintheothercolumnstoconfigurewhatit'sboundto.Thebindingseditorsupports

undo/redo,copy/paste,andmoveup/downcommands

LearningBindingTargets

Theotherwaytocreateabindingisbyrightclickingonthetargetsettingyouwanttobindto.Forexampletocreatea

bindingtothemastergainsetting,rightclickonitanchooseCreateBinding:

You'llthenbepromptedtomovethecontrolyouwanttobindtowiththeappropriatetargetbindingpointselected:

LearningPluginParameterBindingTargets

Tocreatealearnabindingtopluginparameter,opentheplugin'seditorandchooseCreateParameterBinding:

Tocreatealearnabindingtopluginparameter,opentheplugin'seditorandchooseCreateParameterBinding:

WhiletheLearnBindingwindowisopenyoucanmoveanysettingintheplugineditorandtheassociatedparameterwillbe

selectedintheBindTodropdown.HeretheAmplifierAttackknobwasturnedresultinginthe"A_Attack"parameterbeing

selected:

selected: BindingSettings

BindingSettings

Dependingonthekindofbinding(MIDI->Setting,Setting->MIDI,MIDI->MIDIetc

editormayormaynotbeapplicable.

)differentcolumnsinthebindings

Hereisarandomselectionofbindingsthatdemonstratesomeofthedifferentwaysbindingsmightappear.

Thefollowingdescribeseachcolumn: State

Thefollowingdescribeseachcolumn:

State

TheLEDindicatorlightsupwhenthebindingisactive-ie:whenitsrespondingtochangesfromthesource.

Thecheckmarkcanbeusedtoenable/disablethebinding

The"play"buttoncanbeusedtoinvokesimplecommandbasedbindings(notavailableonallbindings)

Source

Thesourceofbindingevent.ThiscouldbeanexternalMIDIdeviceoraninternalobjectsuchasthe"MasterLevels"

SourceChannel/Property

ThesecondpartofthesourcecolumnisusedtoselectMIDIChannelnumberforMIDIsources,orthesourcepropertyor

triggereventforobjectsources.

EventKind

TheMIDIeventkindtomonitor(seebelowformore)

EventController

Dependingontheeventkind,theremightbeanadditionalcontrollernumbersetting.(eg:forMIDICCevents,thiswould

betheCCnumber).Sometriggereventssupportadelaysettinghere.eg:thesong"OnLoad"triggersupportsadelay

beforeinvokingthetargetofthebinding.

Target

Theobjecttobecontrolledbythebinding

TargetChannel/Property

ThesecondpartofthetargetcolumnisusedtoselecttheMIDIChannelforMIDItargets,orthetargetpropertyfor

objecttargets.

Action

ForMIDItargets,theMIDIeventtosend(CC,PitchChange,Noteetc

Value

)

Dependingonthetypeofsourceandtargetobjectsthismightbeavaluetovaluemapping,orotheroptionsthatcontrol

howthebindingworks.

JumpPreventionandRotaryEncoder(RelativeCC)Support

RoutingModes

Bindingshavearoutingmodethatdetermineshowprocessingproceedsafterthebindinghasbeenmatchedtoanincoming

event:

Continue

Theoriginaleventcontinuestoberoutedasifthebindingdidn'texist.

Suppress

Theoriginaleventissuppressed.SubsequentbindingsandotherMIDItargetswon'treceivetheevent.Thismodeis

usefulwhenbindingspecificnotestoaction(eg:bindingthelowestkeyonyourkeyboardtomovetothenextsong)

BlockUntilComplete

Thetargetoftheeventisinvoked,andallincomingMIDIonthesameMIDIportisqueuedforprocessinguntiltarget

actionhascompleted.Thismodeisusefulwhenbindingtoslowactionswhereyouwanttomakesuretheactionhas

completedbeforesendingsubsequentevents.(eg:loadingasongandthensendingconfigurationevents).

Tosettheroutingmodeofabindingrightclickonthebindingandchoosetheroutingmodefromthemenu.

Note:somebindingtargetssupportimmediateanddelayedversionsofthesameaction.eg:"SetList->LoadNextSong

(Delayed)"and"SetList->LoadNextSong(Instant)".Theblockedroutingmodedoesn'tworkonthedelayedversionsof

theseactionsasincomingMIDIwillonlybeblockedandqueueduntilthedelayedloadhasbeeninitiated,notcompleted.

BindingDelays

Somebindings(notablytriggerbindingssuchasSong-OnLoad)haveanoptiontospecifyadelaybeforethebindingis

invokedandaseconddelayafterthebindinghasbeeninvoked.

invokedandaseconddelayafterthebindinghasbeeninvoked.

The"beforedelay"isselfexplanatoryandintroducesadelaybetweenthetimeofthetriggeringeventandthetimethe

targetsideofthebindingisinvoked.

The"afterdelay"isaseconddelaythatwillbeintroducedbetweenthetimethisbindingisinvokedandthenextdelayable

bindingisinvoked.Iftherearenootherdelayablebindingsafterthisonethenthissettinghasnoeffect.

The"BlockOtherOperationsUntilComplete"optionspecifieswhathappensifcertainmajoroperationsoccur(suchassong

orstateswitch,engineshutdownetc

)whilethebindingisinthepre-delayperiod:

Whenenabled,theoperationwillblockuntilthebindinghasfired.

Whendisabled,thebindingwillbecanceledandwontfire.

Forexamplesupposeyouhaveabindingconfiguredtofire10secondsafterasongloads.Thensupposeyouloadthesong

andthenimmediatelyswitchtoanothersong(beforethe10secondtimeout).Ifthebindingisconfiguredasblockingthen

Cantabilewillblockthesongswitchuntilthe10secondtimeexpires,thebindingwillthenbeinvokedandthenthenew

songwillbeinvoked.Ifthebindingisconfiguredasnon-blockingthedelayedactionwillbecanceledandthesongswitch

willhappenimmediately.

Bydefaultbindingsaremarkedasblocking.Ifit'snotimportantthatthebindingbereliablyinvokedthenmarkingthe

bindingas"non-blocking"willallowforfastersongandstateswitchingbecausetheenginedoesn'tneedtowaitforthe

bindingstofire.

Sys-ExBindings

(CantabilePerformerOnly)

Abindingcangeneratesys-exdataifthetargetisaMIDIportandtheeventkindissetto"SyeEx".Fordetailsonsettingup

sys-exbindings,seetheSys-exExpressionreference.

GlobalBindings

Oftenyouwillwanttoconfigurebindingsthatworkacrossallsongs.

eg:itdoesn'tmakemuchsensetocreateabindinginasongtoloadthenextsonginasetlistsinceyou'dneedtocreatean

identicalbindinginallsongsforitworkcorrectly.

Forthisreason,Cantabilehasa"BackgroundRack"-aspecialrackthatisalwaysrunninginthebackgroundandwhose

primarypurposeisforglobalbindings.

Tocreateglobalbindings:

1. FromtheViewmenu,choose"BackgroundRack"

2. SwitchtoitsBindingtab

3. Createbindingsasperanyotherrack

Notethatnotallbindingtargetsareavailablefromthebackgroundrack.eg:youcanbindtoaspecificplugininasong

becausethatsongmightnotbeloadedwhenthebindingisinvoked.

Song,RackandBackgroundRackBindings

Eachsongandrackhasit'sownsetofbindingsandbindingsareprocessedinthefollowingorder:

1. Songbindings

2. Bindingsinracksloadedintotheactivesong,intheordertheracksareinthesong

3. Allotherrack’sbindings(exceptthebackgroundrack)butinanundefinedorder

4. TheBackgroundrack’sbindings

ThemostimportantpartofallthisisthattheSongbindingstakeprecedenceovertheBackgroundrackbindings.

Let’ssayyouhaveabuttononanexternalcontrollerthatforallyoursongsyouwantittoperformsomefunction.Youcould

createabindingforthatactioninthebackgroundrack.

Nowlet’ssayforthatforoneparticularsongyouwanttochangethatbuttontoperformsomeotheraction.Ifyoucreate

thatbindinginthesongandsetitsroutingmodetosuppress — thesong’sbindingwilltakeprecedenceoverthebackground

rackbindingsandeffectivelyoverrideit.

SpecialEventKinds

MosteventkindsareselfexplanatoryastheysimplyreflecttheassociatedMIDIevent.ForMIDIContinuousController

events(CC's)howeverthereareacoupleofdifferentwaystheycanbeused-dependingmostlyonthetypeofphysical

controlthey'reoriginatingfrom:

Toexplainsomeofthese: Controller ThisisanormalMIDICCeventthatcanbeassignedtoavariablevalue(eg:againlevel) Controller(Fine)

Toexplainsomeofthese:

Controller ThisisanormalMIDICCeventthatcanbeassignedtoavariablevalue(eg:againlevel) Controller(Fine)

ThesebindingscombineMIDICC0-31with32-63tocreateamoreprecise14bitcontroller.

Controller(Button)

AmomentaryMIDIbuttonthatsendsavalue>64whenpressedand<64whenreleased.Thiskindofbindingisedge-

triggeredinthatitinvokesthetargetwhenthevaluecrossesfromlessthat64togreaterthan64.

Controller(NoEdgeButton)

UsethisforMIDIbuttonsthatsendanon-zerovaluewhenpressedandnoeventoraCCvalueof0whenreleased.ie:it

triggersonanynon-zerovalue. Controller(Switch)

Thisisfornon-momentaryon/offMIDIbuttonsandswitchesthatsendavalue>=64whenonand<64whenoff.

BindingstoRoutes

Unlikemostotherobjects,routesdonotautomaticallyappearasassignableobjectsintheBindingseditor.Thisisbecause

bydefaultroutesdon'thaveanameandthereforecan'tbereferenced.

TocreateanbindingtoanaudioorMIDIroute:

1. SelecttherouteinCantabile'smainwindow

2. FromtheEditmenuchoose"Rename",orpressF2

3. TypeauniquenamefortherouteandpressOK

4. Thoughthenamewon'tshowinthemainwindow,thenewnamewillappearintheBindings

5. Fromthebindingseditoryou'llnowbeabletocreatebindingsfortheroute

Allroutessupportbindingtotheenabled/disabledsetting.Audioroutesalsosupportbindingstotheroute'saudiogainlevel.

QuickController

Cantabile'sQuickControllerprovidesafastwaytoloadsongs,states,presetsandsendsimpleMIDIeventsbyenteringa

simplecommandsthatconsistofanumberfollowedbyasinglelettercommand.

Forexample,toloadthesongwithprogramnumber123youcansimplytype123andtheletter'S'.

UsingtheQuickController UsingtheQuickControllerissimple: 1. FromanywhereonCantabile'smainwindow,starttypinganumber 2.

UsingtheQuickController

UsingtheQuickControllerissimple:

1. FromanywhereonCantabile'smainwindow,starttypinganumber

2. Presstheletterforthecommandtobeinvoked,orpressSpace,EnterorTabtoinvokesomecommands(seeoptions

below)

Whenyoustarttypinganumber,itappearsinthestatuspanelonthemaintoolbarandamenuappearsshowingthe

availablecommandsandtheassociatedletter.

Options

ThereareafewsimpleoptionsthatdeterminehowtheQuickControllerbehaves.TheseoptionscanbefoundintheOptions

menuintheHotKeyscategory.

menuintheHotKeyscategory.

ThefirstthreeoptionsdeterminewhichcommandisinvokewhentheEnter,TabandSpacekeysarepressed.Thecheckbox

supportsdisablingthepopupmenu(onceyou'refamiliarwiththecommandsyouneed,youmightfindyoudon'tneedit).

Notethatevenwiththepopupmenudisabled,youcanstillaccessitviatheView|QuickControllermenuitem.

AvailableCommands

AssignCommand Assignstheenteredvaluetotheselectednumericfield.eg:Ifasonginthesetlistselected,it'sprogramnumberwillbe updated.Alsoworksonstates,pluginpresets,bindingsandtriggersettings. LoadSong Loadthesonginthesetlistwithamatchingprogramnumber LoadState Loadsthestatewiththematchingprogramnumber LoadPluginPreset Loadstheenteredpluginprogramtothecurrentlyselectedplugin InvokeTriggers Invokesallcustomtriggerswithmatchingcustomeventnumber SetMIDIChannel SetstheMIDIchannelnumberoftheon-screenkeyboardandquickcontroller. SendProgramChange SendsaMIDIprogramchangeevent.Tosendbankedprogramchangeenterthebanknumberandprogramnumber

separatedbyaperiod.eg:1001.23Pwillselectbank1001,program23.

SendCC(Push)

SimulatespushingaMIDICCbutton,sendingvalue127followedby0totheenteredCCnumber.

SendCC(Switch)

SimulatesswitchingMIDICCswitch,alternatelysending127and0betweeneachinvocation.

SetCCNumber SetstheCCnumbertobeusedfortheSendCCValuecommand(below) SendCCValue SendtheenteredCCvaluetotheCCnumberselectedbytheSetCCNumbercommand. SetNoteVelocity SetsthevelocitytobeusedwhenusingtheSendNoteOncommand SendNoteOn SendsaMIDInoteoneventfortheenterednotenumber(usingthevelocityselectedbySetNoteVelocitycommand) SendNoteOff SendsaMIDInoteoffeventfortheenterednotenumber SendPitchBend SendsMIDIpitchbendevent SendChannelPressure SendsaMIDIchannelpressureevent SetTempo Setsthemetronome'stempo SetTimeSignature

Setsthemetronome'stimesignature.Separateeachcomponentwithaslash.eg:entering"3/4I"willchoose3/4time

signature.

MonitorPanel

ThemonitorpaneldisplaysaudiolevelandMIDIactivityindicatorsforallofthecurrentlyactiveenvironmentports.Italso

displaysimportantperformancemetricsoftheaudioengine.

displaysimportantperformancemetricsoftheaudioengine.

Toshowthemonitorpanel,select"View"menu->"SidePanel"->"Monitor",orsimplyclickthemonitortabontheside

panel.

P

ortsDisplay

ThelistofdisplayedportsautomaticallyupdatestoincludeallportsenabledinOptions->AudioPortsandOptions->MIDI

ports.

Unlikeotheraudiolevelmeterswhicharelimitedinhowmanychannelstheycandisplay,thelevelmetersinthemonitor

panelexpandtoshowallchannels.

LoadandInfoDisplay

Thebottomhalfofthemonitorpaneldisplaysthefollowingperformancemetrics:

TimeLoad-maximumprocessingloadasapercentageoftheaudiocycletimeovertheprevious1second(thisisthe

mostimportantmetricandindicateshowclosetoaudiodropoutsandglitchesthecurrentloadis)

CPULoad(Cantabile)-CPULoadcausedbyCantabileandallloadedplugins

CPULoad(Sytem)-Thesystem-wideCPUload PageFaults-thenumberofhardpagefaultsintheprevious1second

CPULoad(Sytem)-Thesystem-wideCPUload

PageFaults-thenumberofhardpagefaultsintheprevious1second

Memory-totalreservedmemoryusedbytheprocess

WorkingSet-totalamountofmemoryactuallycommittedtophysicalRAM

Running/LoadedRacks-thenumberofcurrentlyrunningracksandthetotalnumberofloadedracks(maydifferwhen

Audiodrivertypeandname

Audiodriverbuffersizeandsamplerrate

Cantabileversionandbuildnumber

ControllerBar

TheControllerBarprovideslargebuttonsintendedforuseduringliveperformancetocontrolkeyaspectsofCantabileas

wellasanarrayofuserconfigurablebuttons.

wellasanarrayofuserconfigurablebuttons.

ToshowtheControllerBar,select"View"menu->"ControllerBar".

U

seConfigurableButtons

ThelefthalfoftheControllerBarcontainsasetofuser-configurablebuttons.Bydefaultthey'reconfiguredtosendMIDI

programchangeevents(fromtheon-screenkeyboarddevice)buttheycanbereconfiguredtoawiderangeofother

functions.

Tosetupabuttoneitherrightclickonanexistingbuttonandchoose"Customize",orchoose"AddButton"tocreateanew

button. Thefollowingsettingsareavailable:

button.

Thefollowingsettingsareavailable:

Tip-thetexttodisplayabovethebutton

Caption-thetexttodisplayonthebutton

Action-theactiontoinvokewhenthebuttonispressed.IncludesoptionstosendvariousMIDIeventsortoinvokea

builtinCantabilecommand.

InteractionStyle-Seebelow.

MIDIChannel-forMIDIactionsthechannelnumberoftheevent.

MIDIChannel-forMIDIactionsthechannelnumberoftheevent.

MIDIController/Program/Parameter-dependingontheselectedeventtypethecontrollerorparameternumbertobe

sentwiththeevent.

MIDIPressedandReleasedvalues-MIDIvaluesforbuttonswhenthey'repressedandreleased,orforsliderschangesto

MinimumandMaximumvalue.

Theinteractionstyledetermineshowthebuttonrespondswhenit'spressed:

Button-asimplecommandbutton-invokestheselectedactionwhenpressed.

MomentaryButton-abuttonthatsendsonevaluewhenpressedandanotherwhenreleased.

ToggleButton-abuttonthatsendsadifferentvalueeachtimeit'spressed.

PopupSlider-abuttonthatwhenpresseddisplaysapopupslider.

DynamicButtonLabels

TheTipandCaptionfieldsofcustombuttonscanusevariablestogeneratedynamictext.WhencombinedwithMIDI

co

ntrollervariablesthiscanbeusedtoreflectCCvaluesonthecontrollerbar.

B

uiltInButtons

TherighthalfoftheControllerBardisplays5standardcontrolsforcommonoperationsduringliveperformance.

EachofthesebuttonscanbeoptionallyhiddenifnotneededbyrightclickingontheControllerBarandclearingthecheck

marknexttotheselecteditem.

TransposeButton-displaysthecurrentsong'stransposesettingandincludesincrementanddecrementbuttonsto

changethetransposesetting.Clickingthemiddleofthisbuttondisplaysapopuptoselectatranspose.

TempoButton-displaysthecurrentsong'stempoandflashesintimewhenthemastertransportisplaying.Tappingthis

buttonsetsthetempoaccordingtohowfastit'stapped.

SongPicker-displaysthecurrentlyloadedsonginthesetlist.Arrowbuttonscanbeusedtoselectthenextorprevious

songandtappingthesongnamedisplaysapopuptoselectadifferentsong.

SongPartPicker-displaysthecurrentlyloadedpartinthecurrentsong.Arrowbuttonscanbeusedtoselectthenextor

previouspartandtappingthepartnamedisplaysapopuptoselectadifferentpart.

ContinueButton-movestothenextsongpart.Ifcurrentlyonthelastpartofasong,movestothefirstpartofthenext

song.

ResizingandRe-orderingButtons.

AllthebuttonsintheControllerBarcanberesizedbydraggingthedividersbetweenthebuttons.

Theuser-configurablebuttonscanbere-orderedbyrightclickingabuttonachoosing"MoveLeft"or"MoveRight".

Layouts

Thecontrollerbarsupportsswitchingbetweenvarioususerdefinedlayouts,whereeachlayoutstoresthecurrentsetof

custombuttonsandthevisibilityofthebuilt-inbuttons.Youcancreateasmanylayoutsasyoulike.

Toworkwithlayouts,rightclickonthecontrollerbarandusetheLayoutssub-menu:

Tip:LiveModestoreswhichcontrollerbarlayoutisactivesoyoucanhaveadifferentactivelayoutfornormalvslivemode.

MIDIClockSynchronization

MIDIclockallowsCantabiletosynchronizeit'stimingwithandexternalMIDIclocksource,ortoactsasamastertowhich

otherdevicescansynchronizetheirtiming.

SettingupMIDIClockSyncrhonization

BeforeMIDIclocksynchronizationwillworkyouneedtoselectwhichMIDIportsCantabileshoulduse:

SelectinganinputportallowsCantabiletosynchronizetoincomingMIDIclockevents.Selectinganoutputportcauses

CantabiletosendMIDIclockeventstothatport.

SynchronizingtoandExternalMIDIClock

TosynchronizetoanexternalMIDIclock,choose"Sync.toMIDIClock"fromthemastertransportdropdown:

Whenenabled,you'llnoticethattheoptionstoselecttempoaredisabled,asarethetransportcontrols(Play,pauseetc

sincethesefunctionsarenowcontrolledbytheexternalMIDIclockdevice.

)

IfyouenableMIDIclockeventsonmultipleMIDIinputdevices,Cantabilewillmonitorallselecteddevicesforclockevents

butonlyrespondtooneatatime.Whileonedevicehasanactivelyplayingtransport,otherdevice'sclockeventswillbe

ignored.

SynchronizingExternalDevicestoCantabile

TosynchronizeexternaldevicestoCantabile'sMIDIclockallyouneedtodoisselectoneormoredevicesinoptionsand

CantabilewillautomaticallysendMIDIclockevents.Refertothedocumentationofyouotherdeviceforinformationonhow

toconfigureittosynchronizetoanexternalMIDIclockdevice.

IfmultipleMIDIdevicesareselectedforMIDIclockoutput,clockeventswillbesenttoallselecteddevices.

MIDIClockPassthrough

WhenCantabileisconfiguredtosynchronizetoanexternalclocksourceandconfiguredtosendMIDIclockevents,the

incomingclockeventsarepasseddirectlytothetargetdevices(asopposedtoCantabilederivingMIDIclockeventsfrom

theincomingevents).

OnscreenKeyboard

Cantabileincludesanon-screenkeyboardthatcanbeusedtoeitherinjectMIDIeventsintoasong(eg:toplayan

instrument)ortoshowthenotescomingfromaMIDIsource.

instrument)ortoshowthenotescomingfromaMIDIsource. SettinguptheOnscreenKeyboard

SettinguptheOnscreenKeyboard

Theon-screenkeyboardworksjustlikeanyotherMIDIdeviceinthatitneedstobeconfiguredviaaMIDIport.Normally

Cantabilewillautomaticallycreateabothaninputandoutputportandmapittotheon-screenkeyboardhoweveryoucan

re-configureifnecessary:

re-configureifnecessary:

OncetheappropriateMIDIportsareconfiguredyoucancreateroutestoandfromitjustlikeyouwouldanyotherMIDI

device: S howingandHidingtheKeyboard

device:

S

howingandHidingtheKeyboard

Toshowtheonscreenkeyboard:

ChooseOn-screenKeyboardfromtheViewmenu,or

PressCtrl+K.

In

eithercaseifthekeyboardisalreadyvisibleitwillbeactivatedsoitcanbeplayedusingyourPC'skeyboard.

Tohidethekeyboard:

Resizeit(bydraggingit'stopboarder)untilitdisappears.

Whilethekeyboardisactive,pressShift+Escape.

Toleavethekeyboardvisible,butmovefocusbacktopluginlistpressEscape.

SendingMIDItotheOnscreenKeyboard

Althoughnormallyusedforplayingnotestheon-screenkeyboardcanalsobeusedtoshownotescomingfromotherMIDI

sources.Todothis,simplycreatearoutefromanexternaldevice,theoutputofapluginoranyotherMIDIsourceand

connectittotheOnscreenKeyboardport(asshowninthescreenshotabove).

P

layingtheKeyboard

Thehighlightedbarsbelowthekeyboardshowthecurrentlyactiveoctaves.Youcanplaynotesintheseoctavesusingthe

keysonyourPCkeyboard:

TheloweroctavecanbeplayedstartingwiththeZkey,inasimilarpatterntoastandardpianostylekeyboard.eg:Z Key=C,SKey=C#,XKey=Detc

TheotheroctavecanbeplayedstartingontheQkey.eg:Q,2,W,3,Eetc

(N

oteyoucanactuallygoalittlefurtherthanoneoctaveineachrange).

TochangetheactiveoctaveclicktheintheareabelowthekeyboardorusethePageUp/PageDownortheUp/Downkeys.

Youcanalsosplitthetwooctaves:holdtheCtrlkeytochangejusttheloweroctave,ortheShiftkeytochangetheupper

oc tave.

Playingthekeyboardwiththemouseisstraightforward-justclickthenotesyouwanttoplay,orclickanddragtoplay

gli ssandos.

MIDIChannel

ThechannelselectoratthebottomrightofthekeyboardallowsselectionoftheMIDIchannelthattheon-screenkeyboard

se ndson. Velocity

se ndson.

Velocity

Whenplayingwiththemouse,youcancontrolthevelocityoftheplayednotesbytheverticalpositiononthekeyboard

whereyouclick.Theareabelowtheblackkeysplaysatfullvelocity,butasyoumoveclosertothetopofthekeyboardthe

noteswillplaymoresoftly.

WhenplayingusingthePCkeyboard,thenotesareplayedusingthelastvelocityplayedusingthemouse.

S

ustain(Damper)Pedal

Thesustain/damperpedal(MIDICC64)canbesimulatedbypressingtheShiftkey.

ResizingandScrolling

Toresizethekeyboard:

Clicktheborderatthetopofthekeyboardanddragup/down.

Toscrollthekeyboard:

Clickanddragintheareabelowthekeys(ie:ontheactivebarindicators).

UsetheLeftandRightarrowkeys.

PCKeyboardCapture

Keyboardcaptureletsyouplaytheon-screenkeyboardusingyourPCkeyboardevenwhenitdoesn'thaveinputfocus.

TousethekeyboardcapturejusthittheF12key.YoucanthenmovefocusanywhereinCantabile'smainwindowand

playingthePCkeyboardwillcontinueplaytheon-screenkeyboard.Youcantellifcaptureisactivebythegreenindicatorin

thebottomrighthandcornernexttothechannelselector.

thebottomrighthandcornernexttothechannelselector.

IfyouwantthekeyboardcapturetoworkfromotherwindowsaswellasCantabile'smainwindow,therearesettingsin

Options->On-screenKeyboardthatcontrolthisbehaviour:

Options->On-screenKeyboardthatcontrolthisbehaviour:

Thelasttwooptionsbothallowyoutoplaytheon-screenkeyboardwhenanywindow(evennon-Cantabilewindows)are

active.Thedifferenceisthefirstoption,capturemustbeenabledwhileCantabileisactive.WiththesecondoptionstheF12

keycanbepressedwhileanotherapplicationisactiveanditwillenablethekeyboardcapture.

YoucanchangetheF12keytoadifferentkeyinOptions->HotKeys.

LoopbackPorts

LoopbackportsprovidetheabilitytosendMIDIandAudiosignalsfromwithinCantabilebacktoaninputport.ie:thesignal

isloopedbackfromanoutputporttoaninputport.

Bydefaultloopbackportsaredisabledbecausethey'renolongerthatuseful.(TheyusedtobeahandywaytosendMIDI

signalstoCantabile'sMIDIinputprocessingwheretheycouldbepickedupbyMIDIbindings).

ThefeaturestillexistshoweverandcanbeenabledinOptions->Advanced->ShowLoopbackPorts.

Whenenabled,you'llnoticethatforeveryconfiguredinputport,anoutputLoopbackportisavailableasaroutingtarget.

Intheaboveexample,anyMIDIsentfromthemediaplayerwouldberoutedbacktotheMainKeyboardinputportand

appearasiftheeventswerecomingfromtheMainKeyboard.

Careshouldbetakenwithloopbackportsnottocreatefeedbackloops.CreatingacircularloopofMIDIeventscancrashthe

programandcreatetypicalfeedbacksoundswithaudioloops.

SongandRackOptions

EverysongandrackfileinCantabilehasafewoptionsthatcontrolhowitbehaves.

Toadjustthesesettings,openthesongorrackfileandfromtheFilemenuchoose"SongOptions"or"RackOptions"

(dependingwhichtypeoffileiscurrentlyactive).

FullPath Displaysthefulllocationpathofthesavedfile LocateinExplorer OpensWindowsFileExplorerandselectsthesongorrackfile

FullPath

Displaysthefulllocationpathofthesavedfile

LocateinExplorer

OpensWindowsFileExplorerandselectsthesongorrackfile

PrompttoSave

Controlsthekindsofchangesinthefilethatcauseittobemarkedasmodified(Seebelow)

AlwaysSaveWhenSavingtheParentSong(RackOptionsOnly)

Forcesthisrackfiletobesavedwhentheparentsongissaved-evenifithasn'tbeenmarkedasmodified.

LetTheParentSongControlThisRacksSelectedStateandGain(RackOptionsOnly)

Normallyon,thisoptionletstheparentsongofrackcontrolit'sstateandgainsettings.Turnthisoptionoffforracks

thatareintendedasaglobaloutputcontrol.Byturningthisoptionoffsettingsintherackareisolatedfromtheparent

songandcanbeusedtocreateglobalchangesacrossallsongs.eg:youcouldputanEQinsucharack,androuteall

outputsthroughitandthentunetheEQforaparticularvenue.

PromptToSaveOptions

ThePromptToSaveoptionmentionedabovehasfollowchoices:

Never

Thefilewillneverbemarkedmodifiedandthereforeyou'llneverbepromptedtosaveit

OnlyOnSignificantChanges

Onlychangestothestructureofthefilecausethefiletobemarkedmodified.eg:insertingapluginwouldmarkitas

modifiedwhereastweakingapluginparameterwouldn't.Thisoptionishandyforworkingwithpluginsthatgenerate

excessivechangenotificationscausingthefiletoalwaysbemarkedasmodified.

OnAnyChangeExceptviaBindings

Anychangewillmarkthefileasmodified-unlessthechangeoccursastheresultofabinding.

OnAnyChange

Anychangewillmarkthefileasmodified.

MorphandRandomizeTools

CantabileincludestoolsforMorphingandRandomizingaplugin'sparameters.Thiswalkthroughexplainshowtousethese

features.

EnablingMorphandRandomize

Themorphandrandomizesettingsforapluginarestoredonaper-plugin-programbasis.Thatis,eachofaplugin's

programshasit'sownsetofmorphandrandomizesettings.

Toenablemorphandrandomizeforaparticularprogram:

1. Opentheplugin'seditororparametereditorbydoubleclicking(orAlt+doubleclicking)thepluginslotinCantabile's

mainwindow.

2. Fromthemenubuttoninthetoprighthandcorner,select"EnableMorphandRandomize"

3. You'llnoticeanewtoolbarappearwiththecontrolsformorphingandrandomizingtheprogram'sparameters. 4.

3. You'llnoticeanewtoolbarappearwiththecontrolsformorphingandrandomizingtheprogram'sparameters.

4.

4. Ifyouswitchbetweenprogramsyou'llnoticethatthemorphandrandomizetoolscanbeenabledonsomeprograms,

disabledonothersandforthoseprogramswhereit'senabledeachprogramhasitsownsetofmorph/randomize

settings.

Morphing

Morphingletsyouconfiguretwosetsofpluginparametersandgraduallymovebetweenthem.Supposeforexampleyou

havetoexistingprogramsbutyou'reafterasoundpartwayinbetweenyoucanloadthosetwoprogramsand"morph"

betweenthemtofindthesoundyou'reafter.

Thetwosetsofparametersusedformorphingarecalledthe"A"setandthe"B"set.Whenyoufirstturnonmorphing,the

bothsetsinitializedtothepluginscurrentparametersettingsandtheBsetisselected.

TomakechangestotheAandBsetssimplyclickthematchingbuttononthemorphtoolbarandedittheparameters.To

morphbetweentheparametersettingssimplymovethemorphbar.

Here'sasimpleexample

thisisthe"A"set:

Here'sasimpleexample thisisthe"A"set: andthisisthe"B"set: andthisis25%morphedfromAtoB:

andthisisthe"B"set:

Here'sasimpleexample thisisthe"A"set: andthisisthe"B"set: andthisis25%morphedfromAtoB:

andthisis25%morphedfromAtoB:

ThisexampleisusingCantabile'sbuilt-inparametereditorwhichshowsthemorphrangesforeachparameterashighlights

ThisexampleisusingCantabile'sbuilt-inparametereditorwhichshowsthemorphrangesforeachparameterashighlights

ontheslidertracks.Thesameoperationcanbedoneusingtheplugin'sGUIeditorhoweverthemorphrangesaren'tshown

in thatcase.

Alsonotethatthecolourofmorphrangesshownonthesliderchangesfromgreentoblue:

Green-indicatesyou'reeditingtheA/Bparametersets

Blue-indicatestheparametersarepartiallymorphed.Movingaslideronabluerangewillcancelmorphingthat

parameter(seeinactiveparametersbelow).

MorphingBetweenPluginPrograms

Tomorphbetweentwoofaplugin'sexistingprograms(akaPresets)youneedtoloadthesecondpresetintothe"B"

parameterset.Todothis,simplyrightclickonthe"B"buttonandchoose"LoadfromProgram":

You'llbepromptedforwhichprogramyouwanttoload.Youcanperformasimilaroperationbyrightclickingonthe"A"set.

DisablingorCancellingParameterMorphing

Aparametercanbeononeofthreestatesformorphing:

Active-differentvaluesintheAandBparametersets

Inactive-enabled,buthavingthesamevaluesintheAandBsets

Disabled-excludedfromallmorphingoperations.

InactiveanddisabledparameterbehavesimilarlyexceptthatifyoueditaninactiveparameterintheAorBsetsitwill

automaticallybecomeactive.

TodeactivateanactiveparametermovethemorphsliderbetweentheAandBpointsandedittheparameter.

ToactivateaninactiveparameteradjustittohavedifferentvaluesintheAandBsets

ToenableordisableaparameterusethecheckboxinCantabile'sparametereditor.

Youcanalsoenableall,disableallordisableallinactiveparametersbyrightclickingtheparametereditor:

(Onceyou'rehappywithamorphset,disablingallinactiveparameterscanreducethesizeofthesavedsong/rackfileby

notsavingredundantsetsofparameters).

RandomizingParameters

Therandomizetoolscanbefoundontherighthandsizeofthemorphrandomizetoolbarandconsistofthefollowing

settings:

TheRandomizebutton-randomizestheparametersaccordingtocurrentsettings

TheRandomizebutton-randomizestheparametersaccordingtocurrentsettings

ConstrainedRandomizesetting-limitsrandomizationtothecurrentA/Bparameterranges

RandomizeAmount-howmuchtorandomizesettingsby

Usingtherandomizetoolisfairlystraightforward-adjustsettingsandclicktheRandomizebutton.

U

singtheRandomizeandMorphToolsTogether

Youcanusethemorphandrandomizetoolstogethertocomeupwithuniquenewsounds.

Whentheconstrainrandomizationoptionisturnedoff,clickingtherandomizebuttonwhileeithertheAorBparamtersetis

se

lectedwilldirectlyupdatetheAandBparametersets.

Whentheconstrainoptionisturnedon-itdoesn'tmakesensetoautomaticallyupdatetheparametersetsandthiswill

affecttheconstrainedrange.Inthiscaseyoucan:

1. SetupyourrangeconstraintsontheAandBparametersets

2. Turnonconstrainoption

3. ClicktheRandomizebuttonasrequired

4. ToapplythecurrentrandomizesettingstotheAorBparametersets-rightclickthatbuttonandchoose"Loadfrom

CurrentSetting":

CurrentSetting": B indingSupport

B

indingSupport

CantabileSoloandPerformeryoucanmorphandrandomizeviaBindings.Thefollowingbindingpointsareavailableon

In

theplugin:

MorphPosition

RandomizeLimit

ConstrainedRandomization

Randomize

ForexamplethisbindingwilluseCC16ontheMainKeyboardporttocontrolthemorphsettingforthe"mdaPiano1"plugin:

NetworkServer

NetworkServer

Cantabileincludesabuilt-innetwork/web-serverthatallowsremotecontrolofCantabilefromothermachinesandsupports

buildingcustomintegrationsbetweenCantabileandothersystems.

Thisfeatureisstillunderdevelopmentandshouldbeconsideredexperimental

E

nablingtheNetworkServer

Bydefaultthenetworkserverisdisabled,toenableitgotoOptions->Miscellaneousandturnon"EnableNetworkServer":

Onceenabled,inanywebbrowseronthesamelocalnetwork,entertheIPaddressofthemachinerunningCantabileand

us

etheportnumber35007.

eg:supposeCantabileisrunningonamachinewithIPaddress10.1.1.20theninawebbroweronanyothermachineonthe

network,enterhttp://10.1.1.20:35007tobringuptheCantabilewebinterface.

S

ecurity

Thenetworkserverisn'tpasswordprotectednorauthenticated.Currentlytheonlywaytorestrictaccesstothenetwork

se

rverisviaWindowsFirewalland/orbyisolatingtoalocalnetwork.

F

irewallSettings

Cantabile'sinstallerprogramcreatestheappropriatefirewallrulesandURLpermmissionstoallowthewebservertorun.

Ifyouwanttorunthenetworkserveronadifferentport,you'llneedto:

1. OpentheappropriateportintheWindowsfirewall

2. SettheappropriateURLaccesspermissions

Fordetailsonhowtodothis,refertotheconfigureNetwork.batfileinCantabile'sinstallationdirectory.

DeveloperGuide

FordevelopersinterestedinworkingwithCantabile'snetworkserver,seetheNetworkDeveloperGuide.

SongandRackStates

Statesprovideawaytosavethestateofasongorrackandthenrecallthosestatestoquicklyswitchbetweendifferent

co

nfigurations.Statescanbeusedtocontrolmostroutesettings,pluginpresetsandparameters,metronomesettings,gain

andmixlevelsandmore.

Themainpurposeofstatesistoprovideafastmechanismforswitchingbetweentherequiredsoundsandsettingsfor

differentsongsorsongparts.

Thisvideowalkthroughalsodemonstrateshowtousestates.

CantabilePerformerOnly

Terminology

Theterm"state"referstothegeneralabilitytotakeasnapshotofasongorrackandsaveitwithasuppliedname.

Althoughsongsandrackbothsupportstates,thetypicalusecaseforeachisdifferent:

Forracks,statesaretypicallyusedlikepluginpresetswhereeachstaterepresentsadifferntsound.

Forsongs,statesaretypicallyusedtorepresentthedifferentpartsofthesong-intro,chorus,verseetc

Forthisreasonsongstatesareoftenreferredtoas"SongParts".SongPartsandRackStatesarefunctionallyidentical.

Ifyou'refamiliarwithCantabile2youshouldalsonotethat"States"isthenewnameforwhatusedtobecalled"Sub-

Sessions".

Walk-through

Theeasiestwaytounderstandstatesiswithasimplewalkthrough.Firstlet'ssetupasimplesongwithtwoinstruments:

Therestofthisguidewillsetupthestatessothattheonekeyboardcanbeusedplaybothinstrumentsbyquicklyswitching betweenthem.

Therestofthisguidewillsetupthestatessothattheonekeyboardcanbeusedplaybothinstrumentsbyquicklyswitching

betweenthem.

StatesPanel

StatesaremanagedintheStatespanelwhichcanbeactivatedusingtheView|Statesmenucommandorbypressing

Ctrl+T:

Ctrl+T:

Youcanhidethestatelistbyresizingitdownuntilitdisappears,orbyactivatingitandpressingShift+Escape.

(Notethatalthoughwe'reeditingthesong'sstates,thepanelislabelled"SongParts"tosuggesthowstatesonasongare

intendedtobeused)

CreatingandConfiguringStates

Wewillnowconfiguretwostatestoswitchbetweenthetwoinstruments.

TocreateastateselectInsert|Statefromthemainmenu,orclickthelittlecirclenextto"NewState"inthestatepanellist.

You'llbepromptedtoenteranameforthestateafterwhichthecurrentstatewillbecapturedandthestatewillbeadded

tothestatepanellist.Dothistwicetocreatetwostates:

tothestatepanellist.Dothistwicetocreatetwostates:

Nowswitchbacktothefirststate"Piano"byclickingthecirclenexttoit.Configurethestateby:

1. DeletethesecondinputMIDIroute-we'llbeusingtheonerouteforbothinstruments.

2. Switchthesynthplugintosuspendedmodesincewewewon'tbeusingitinthe"Piano"state.(clickthegreenactive

indicatortomakeitorange).

indicatortomakeitorange).

Repeatthesameprocess(butopposite)toconfigurethe"Synth"state:

1. ChangetheMIDIroute'stargettothesynthplugininsteadofthepiano.

2. Suspendthepianopluginandun-suspendthesynth.

SwitchingBetweenStates Onceyou'restatesaresetup,therearedifferentwaystoswitchbetweenthem: 1.

SwitchingBetweenStates

Onceyou'restatesaresetup,therearedifferentwaystoswitchbetweenthem:

1. clicktheradiobutton(circle)totheleftofthestatename

2. doubleclickthelistentry

3. selectthelistentryandpressEntertoloadit

4. usetheNextState/PreviousStatecommandsfromtheControlmenu

5. presstheTandShift+Tkeystomovetothenextorpreviousstate

6. usingtheSetList

7. usingBindings

Ifyouswitchbetweenthetwostatesandplaynotesfromanattachedkeyboardyoushouldhearadifferentsoundoneach

state.

ManualvsAutomaticStatesUpdates

NormallyCantabilewillautomaticallyre-savethecurrentstatewhenswitchingtoanotherstate.Thismakesiteasytosetup

yourstatesbyjustswitchingbetweenthemandconfiguringthingsasyouneedthem.

Onceyou'vegotthesongsetupcorrectlyhoweveryoumightlikemoreexplicitcontroloverwhenthestatesareupdated.In

theEditmenuturnofftheAutomaticallyUpdateStatesoption.Nowstateswillonlybere-savedwhenyouexplicitlyusethe

Edit|UpdateStatecommand.

Turningautomaticstatesavingoffcanalsomakestateswitchingfastersincethecurrentstatedoesn'tneedtobere-saved

eachtime.

StateBehaviors

Sometimestherewillbeattributesthatyoudon'twantcontrolledbystates.Forexample,youmighthaveaMIDIroutethat

shouldalwaysroutetoaparticulartargetandyoudon'twantitaccidentallychangedwhenswitchingstates.Thistypeof

controliscalledStateBehaviors.

StatebehaviorsareconfiguredintheStateBehaviorpanelwhichappearsbelowthestatelist.Ifhiddenyoucanshowitby

choosingStatesBehaviorfromtheViewmenu.

or

or Tochangethestatebehaviorofanitem,firstselectit(eg:selectaroute,plugin,metronomeetc

Tochangethestatebehaviorofanitem,firstselectit(eg:selectaroute,plugin,metronomeetc

unchecktheattributesyouwantcontrolledbystates.

)andthensimplycheck

ExportedSettings

Wheneditingstatebehavioursinarack,thepanelshowsanextracheckmarkoptionnexttoeachbehaviour.

Selectthefirstcheckmarktoindicatethatthesettingshouldbeexportedtotheparentsong.

Selectthesecondcheckmarktoindicatethatthesettingshouldbecontrolledbytherackstate.

Therearecoupleofnuancestothesesettings:

Ifonlythefirstoptionisselected,changingtheselectedstateintherackwillnotaffectthesetting,butswitchingparent

songs(orpossiblyparentsongstates)willupdatethesetting.

Ifonlythesecondoptionisselected,switchingsongsorsongstateswillnotaffectthesetting,butchangingtheselected

rackstatewill.

Ifbothoptionsareselected,thesettingwillbestoredinboththerackstateandtheparentsong.Changingtheselected

rackstatewillresettheparentsong'ssavedsettingstothesettingssavedintherack'sstate.

Ifneitheroptionisselected,thesettingisnotaffectedbysongorrackstatechanges.

Bydefault,theparentsongfilewillstoreacopyofeachexportedsettingforeachofitssongstates.ie:eachpartinthe

songcanindividuallycontroltheexportedsettings.

Youcanchangethisbehaviourwiththe"ExportedState"behaviourontheparentrackslot:

1. Exitfromeditingtherack

2. Selecttherackslotintheparentsongfile

3. OpentheStateBehaviourpanel

4. Removethecheckmarkfromthe"ExportedState"item

Selecttherackslotintheparentsongfile 3. OpentheStateBehaviourpanel 4. Removethecheckmarkfromthe"ExportedState"item

Nowallsettingsexportedfromtherackwillbestoredonaper-song,ratherthanaper-song-statebasis.

Exportedsettingsalloweachsongtoadjustthesettingandreducestheneedtocreatemultiplestatesintherack.Exported

settingscanofteneliminatetheneedforrackstatesentirely.

TogglingMultipleBehaviours

Sometimesyoumightliketoturnmanystatebehavioursonoroffanddoingsooneatatimewouldbetedious.

Totogglemultiplebehaviourson/offallatonce,firstselectthebehaviourstoupdated(usingShiftorControlClickorShift+

arrowkeys)andpressEnter.

TotoggletheexportedstateusingControl+Enter.

LinkedStates

Sometimesitcanbeusefultocreatetwoormoreidenticalstates.Forexampleifyoursonghasmultiplechorusesorverses

youmightliketocreateasetofstatestorepresentthesequenceofsongparts,buteachverseandeachchorusmightbe

thesame.

Tosupportthis,Cantabileprovides"linkedstates".Linkedstateseachhavetheirownnameandprogramnumber,butthe

underlyingsavedstateissharedbetweenthem.

Ifyoumakechangestoastate,anylinkedstatesarealsoupdated.

Tocreatealinkedstate,rightclickontheoriginalstateinthestatespanelandchoose"CreateLinkedClone".

Linkedstatesareindicatedbyasmalllinkiconeachstatethatislinkedtothecurrentlyloadedstate.

Inthisexample,"Verse2"isacloneof"Verse1"asshownbythelinkicons.The"Chorus2"stateisalsoacloneof"Chorus

1"andwouldbeindicatedwheneitherofthechorusstateswereselected.

ChangingtheDefaultStateBehaviours

Eachkindofstatecontrollableobjecthasadefaultsetofstatebehavioursthatareenabledfornewinstancesofthose

objects.

Forexample,eachtimeyouaddanewplugintoasongithasthefollowingstatebehavioursenabled:RunandBypass

Mode,SelectedProgram,GainLevel,Wet/DryMixandPanandFade.

Youcanchangewhichbehavioursareenabledonnewobjectsbyconfiguringanexistingobjectthewayyouwantthe

defaultsandthenrightclickinginthestatebehaviourpanelandchoosing"SetAsDefaultBehaviour".

theaboveexample,fromnowonallnewplugininstanceswillonlyhavetheRunandBypassModeandtheGainLevel In behavioursenabled.

theaboveexample,fromnowonallnewplugininstanceswillonlyhavetheRunandBypassModeandtheGainLevel

In

behavioursenabled.

Notethatforplugins,youcan'tconfigurethedefaultstatebehaviourforthepluginspecificparameters(sinceallplugins

havedifferentparameters).ie:Youcanonlycontrolthedefaultstateofthenon-numberedbehavioursatthetopofthelist.

Lotsmore

Thisquickwalk-throughhasonlyreallyskimmedthesurfaceofwhatcanbedonewithstates.Therearemanyattributes

thatcanbecontrolledbystates.Forexample:

Tryselectingdifferentpluginpresetsindifferentstates

ThetransposeandkeyboardsplitsettingsofaMIDIroutecanbecontrolledbystates

Statescancontrolthemetronome'stempoandtimesignature

Youcancompletelyunloadaplugininsomestatesifthey'renotneeded.(Rightclickthepluginslotandsetit'srunstate

tounloaded).

Themainthingthatstatescan'tcontrolistheexistanceofobjects.ie:allstateshavethesamesetofplugins,routesetc

eg:ifyouinsertordeleteaplugin,itaffectsallstates-notjusttheactiveone.

TocheckwhichattributesofanobjectcanbecontrolledbystatessimplyselecttheobjectandchecktheStateBehaviours

panel.

OtherEditingCommands

Otherusefulstateeditingcommandsinclude:

PressCtrl+Up/Downorusedrag/droptore-orderlistitems PressDeleteorusetheEdit|Deletemenucommandtodeletestates

PressF2orusetheEdit|EditStatemenucommandtorenameastate

UndoandRedocommandsalsoworkwithstateediting.

SetLists

Asetlistisasavedlistofsongfilesthatcanbequicklyswitchedbetween.You'lltypicallyuseasetlisttopre-configurethe

asetofsongsinthecorrectorderforagig.

Eachentryintheliststoresthenameofthesongfileandanoptionalprogramnumberthatcanbeusedtoloadthesongvia

CantabileSoloandCantabilePerformerOnly.

ShowingtheSetListPanel

ToworkwithsetlistsyouusetheSetListPanel.Toshowthispanel,eitherchooseView|SetListorpressCtrl+L.

Youcanhidethesetlistbyresizingitdownuntilitdisappears,orbyactivatingitandpressingShift+Esc. AddingSongstotheSetList

Youcanhidethesetlistbyresizingitdownuntilitdisappears,orbyactivatingitandpressingShift+Esc.

AddingSongstotheSetList

Toaddentriestothesetlist,fromtheFilemenu,chooseoneofthe"Add"menucommands.

AddCurrentSongtoSetList

AddCurrentSongtoSetList

Addsthecurrentlyloadedsongfilethesetlist.Disabledifthecurrentsonghasn'tbeensaved.

AddSongstoSetList

Bringsupalistofallknownsongfilessoyoucanquicklyaddasmanyasyoulikeinonehit.

AddBreaktoSetList

Abreakissimplyaheadingwithinthesetlisttohelpyouorganizethelist.eg:youmightbreakyoursetlistinto"Early

Session"and"LateSesssion"

ImportSongsfromAnotherSetList

Importsallthesongsfromanothersetlist,optionallykeepingtheassociatedprogramnumbers(sohardcodeprogram

number->songbindingswillcontinuetowork)

EditingSongs

YoucanmakechangestoasongbyrightclickingitandchoosingEditSongorbyselectingitandpressingF2.

Eachsonghasthefollowingsettings:

SongFile-thesongfiletoload

ProgramNumber-aMIDIprogramnumberthatcanbeusewithBindingstoloadspecificsongs.

Otherwaystoworkwithsongsinclude:

PressCtrl+Up/Downarrowsorusedrag/droptore-ordersongs(youcanselectmultiplesongsandmovethemallwith

thesecommands)

Clipboardcommandscanbeusedtoduplicate,re-orderandmovesongsbetweensetlists.

Setlistssupportundoandredo.

LoadingSongs

Onceyou'vecreatedasetlistyoucanloadsongsby:

Doubleclickingasonginthelist

Clickingthelittlecirclenexttothesong'sname

UsingBindings

P

re-loadedSetLists

CantabilePerformerOnly.

In

ordertoimprovesongswitchtimesyoucaninstructCantabiletopre-loadallsongsandracksusedinthesetlist:

FromtheToolsmenu,choose"Pre-loadSetList"totogglethisfeatureonoroff.

Thepre-loadsettingisstoredasapropertyofthesetlist,soyoucanhavesomesetlistspre-loadandsomeloadon

demand.

Dependingonthepluginsyou'reusing,pre-loadingasetlistmayrequireconsiderableRAM.Youcanmitigatethisby

sh

aringplugininstancesacrossmultiplesongsbyloadingthemintoracksandusingthesamerackineachsong.

F

ileManagement

Setlistsarestoredinfileswiththe.cantabileListfileextension.Workingwithsetlistsissimilartoworkingwithotherfile

typesandyou'llfindcommandstocreate,open,savesetlistsintheFile->SetListmenu.

NotethatCantabilestoresrelativepathsbetweenthesetlistfileandthesongfilesthatitrefersto.Ifyousaveyoursetlists

andsongfilesinthesamedirectory,youcanmovetheentiredirectoryandthesetlistwillstillbeabletolocatetherelevant

so ngfiles.

TickerBar

TheTickerBardisplaystwohorizontallyscrollinglistsshowingthecurrentlyloadedsongandsongpart.Upcomingsongs

andpartsaredisplayedtotherightofthecurrentlyloadeditemandprovideaclearviewofyourcurrentplaceintheshow.

ToshowtheTickerBar,select"View"menu->"TickerBar",orpresstheslash('/')key

Aswellasprovidingaclearviewonthecurrentlyloadedsongandsongpart,theTickerBarcanalsobeusedtoswitch

so ngsandparts:

Withthemouse,simplyclickonthenameofanitemtoloadit.

Withthekeyboard,usethearrowkeystonavigatetoasongorpartandpressEntertoloadit.

CustomizingtheTickerBar'sAppearance

YoucancontrolthesizeofthetextintheTickerBar:

1. Movekeyboardfocustoeitherthesongorsongpartrow

etc

(N

oteyoucanonlyadjustthesizeoftheloadeditem-theitemstotheleftandrightwillalwaysbedisplayedataslightly

smallersizethantheactiveitem)

Ifyoudon'tusesongparts,ordon'tneedthemdisplayedsoprominentlyyoucanhidethesecondrowoftheTickerBar:

1. RightclickanywhereontheTickerBar.

2. Choose"ShowSongStates"

ShowNotes