JACK4U Manual

42 Pages·2015·0.62 MB·English

JACK4U Manual
vers. 1.1

Contents
1 Introduction 1
2 SystemRequirements 3
3 SystemOverview 5
3.1 JACKAudioComponents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2 ASIODriver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.3 UnitywithPortAudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4 Installation&Settings 7
4.1 InstallationviatheJACK4UEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.1.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.1.2 Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5 JACKAudioSetupwithQjackctl 11
5.1 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2 Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.3 Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.4 Patchbay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6 UnitySetup 17
6.1 SettheAudioSettings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.2 JACK4UEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.3 JACK4UConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.4 CheckyourAudioListenerinthescene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7 Runthesystem 21
7.1 StarttheJACKAudioServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
7.2 StartyourDAW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.3 StartJACK4UConnection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
8 KnownIssues 27
9 FAQ 29
iv CONTENTS
10 History 31
11 Credits 33
12 Links 35
13 Support 37
GeneratedformonoflowbyDoxygen
Chapter 1
Introduction
• JACK4UisatooltocreateUnityapplicationsthatcanreceiveaudiostreamdatafromtheJACKAudiosystem
onWindows. WithJACKAudioitispossibletorouteyouraudiofromaDAW(DigitalAudioWorkstation)like
AbletonLivetootherapplicationswiththelowestlatency.
• JACK4UprovidesthisaudiodatatoUnityforfurtherprocessing. Italsomakestheprocessofinstallingand
setup a JACK Audio system very easy. With just a few clicks you are ready to use Unity as a VJ audio
visualizationengine.
2 Introduction
GeneratedformonoflowbyDoxygen
Chapter 2
System Requirements
• 32Bit/64BitWindows7+
• Unity5.x: worksinFreeversion
• Unity4.x: youneedProversion
• ASIOdrivermustbeinstalledonthemachine(ASIO4ALLdrivercomeswiththepackage)
• JACKAudioConnectionKitmustbeinstalledonthemachine(Installercomeswiththepackage)
4 SystemRequirements
GeneratedformonoflowbyDoxygen
Chapter 3
System Overview
3.1 JACKAudioComponents
JACKAudioisasystemforroutingaudiobetweenapplicationsjustasonewouldplugaudiocablesinandoutfrom
amixingsounddesk. ItusesaServer<->Clientarchitecturetosupplytheaudioconnectionbetweenyoursound
deviceandtheASIOapplication(s).
• JACKAudioServer(Serverprocess‘jackd’)isthemaincomponentthatprovidesalltheresourcestoroute
theaudio.
• JackRouterOncetheJACKAudioServerisrunning,theJackRouterdriveristhenabletocreateconnections
betweenclients(ASIOapplications)andtheJACKAudioServer. AfterinstallingJACKAudiothenewdevice
“JackRouter”willbeavailableinyourDAW/UnitywhenyouusetheASIOdriver. Wehavetousethisdevice
torouteouraudiodatatotheJACKsystemviaASIO.
• Qjackctl ThegraphicaladministrationtoolQjackctlmakestheadministrationoftheJACKAudioServereasy
andprovidesapatchbaywhereyoucanrouteyouraudiostreams(inandout)ofyourapplications.
• JACKAudiousesthePortAudiolibonWindowstoconnecttoseveralaudiointerfaceAPIs.
• PortAudio is an abstraction layer that bundles several Audio Interfaces behind one API. (ASIO, Windows
DirectSound,MME)
• ToroutetheaudiofromaDAWprogramlikeAbletonLive, NITraktoror PureDatawehavetouseASIOas
audioAPI.
3.2 ASIODriver
To use ASIO we need to install a driver. If you have installed an ASIO device you probably have already a driver
thatyoucoulduse. Forallothersthereisafreealternative:
• ASIO4AllfreeASIOdriver
• WhentheASIOdriverisinstalledyoucoulduseASIOasdrivertypeinyourapplication. Normallyyounow
couldchoosethe“ASIO4All”audiodeviceinyourDAWforaudiooutput,butthisisnotthedevicewewantto
use(seeJackRouter).
3.3 UnitywithPortAudio
• ToconnectUnitytotheJACKAudioSystemwealsousePortAudio
6 SystemOverview
• If we have configured it with the right parameters (ASIO as audio API for example) we could join the party
withourUnityapp.
• PortAudioprovidesacallbackmethodwheretheaudiodatacomesinandwecouldinjectthisdataintothe
Unityaudiosystem.
• (JACK4Uwilldoallthisstepsforyou)
GeneratedformonoflowbyDoxygen