1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
function InitializePsychSound(reallyneedlowlatency)
% InitializePsychSound([reallyneedlowlatency=0])
%
% This routine loads the PsychPortAudio sound driver for high-precision,
% low-latency, multi-channel sound playback and recording.
%
% Call it at the beginning of your experiment script, optionally providing
% the 'reallyneedlowlatency' flag set to one to push really hard for low
% latency.
%
% On MacOS/X and GNU/Linux, the PsychPortAudio driver will just work with
% low latency and highest timing precision after this initialization.
%
% On Microsoft Windows, things are a bit more complicated:
%
% PsychPortAudio on Windows supports three different Windows sound systems,
% MME, WDM/KS and WASAPI. Only WDM/KS and WASAPI are suitable for research grade
% auditory stimulation with support for multi-channel sound cards and for
% high-precision and low-latency sound timing and time-stamping. If you
% want reliable timing and time-stamping with latencies and accuracy better
% than 500 msecs, you *must* use one of these. By default, in low latency mode,
% WASAPI is used on Windows Vista and later, whereas WDM/KS would be used on
% older Windows versions. WDM/KS is completely untested so far, and WASAPI has
% only been tested on Windows 7 and Windows 10. For best results, use of Windows 10
% is recommended.
%
% The Windows MME (MultiMediaExtensions) sound system has typical latencies
% and inaccuracies as high as 500 msecs. WASAPI can achieve latencies as low
% as 10 msecs with onboard sound chips on Windows-10, and maybe even on Windows 8.1.
% On Windows 7 latencies around 20 msecs are possible. Timing should be generally
% accurate to millisecond level with WASAPI.
%
% Using OSX or Linux will usually get you at least as good, or usually better,
% results with most standard sound hardware, due to the technically superior
% sound systems of these operating systems.
%
% History:
% 6/6/2007 Written (MK).
% 10/20/2011 Update: We always use ASIO enabled plugin on Windows by
% default, as the PTB V3.0.9 MIT style license allows bundling
% of an ASIO enabled proprietary dll with Psychtoolbox. (MK)
% 09/11/2012 Add support for 64-Bit portaudio_x64.dll for Windows. (MK)
% 10/16/2015 Disable use of our own portaudio_x64 dll On Windows + Octave. (MK)
% 11/08/2018 No ASIO anymore, starting with v3.0.15. (MK)
if nargin < 1
reallyneedlowlatency = [];
end
if isempty(reallyneedlowlatency)
reallyneedlowlatency = 0; %#ok<NASGU> % Default: Don't push too hard for low latency.
end
% The usual tricks for MS-Windows:
if IsWin
% Override driver installed?
if exist([PsychtoolboxRoot 'portaudio_x86.dll'], 'file') || exist([PsychtoolboxRoot 'portaudio_x64.dll'], 'file')
% Yes! Use override driver:
fprintf('Detected optional PortAudio override driver plugin in Psychtoolbox root folder. Will use that.\n');
driverloadpath = PsychtoolboxRoot;
else
% No - We use our standard driver:
driverloadpath = [PsychtoolboxRoot 'PsychSound'];
end
% Standard path trick: Change working directory to driver load path,
% preinit PsychPortAudio so it gets linked against the proper DLL, change
% path back to old current directory:
try
olddir = pwd;
cd(driverloadpath);
% We force loading+linking+init of the driver:
d = PsychPortAudio('GetDevices');
cd(olddir);
catch %#ok<*CTCH>
cd(olddir);
error('Failed to load PsychPortAudio driver for unknown reason! Dependency problem?!?');
end
end
% Maybe some tricks (in the future) for OS/X? None yet.
if IsOSX
try
% We force loading+linking+init of the driver here, so in case
% something goes wrong we can catch this and output useful
% troubleshooting tips to the user:
d = PsychPortAudio('GetDevices'); %#ok<NASGU>
fprintf('PsychPortAudio initialized. Will use CoreAudio for audio.\n');
catch
fprintf('Failed to load PsychPortAudio driver!\n\n');
% fprintf('The most likely cause is that the helper library libportaudio.0.0.19.dylib is not\n');
% fprintf('stored in one of the library directories. This is the case at first use of the new\n');
% fprintf('sound driver.\n\n');
% fprintf('A copy of this file can be found in %s \n', [PsychtoolboxRoot 'PsychSound/libportaudio.0.0.19.dylib']);
% fprintf('You need to copy that file into one of the following directories, then retry:\n');
% fprintf('If you have administrator permissions, copy it to (at your option): /usr/local/lib\n');
% fprintf('or /usr/lib -- you may need to create that directories first.\n\n');
% fprintf('If you are a normal user, you can also create a subdirectory lib/ in your home folder\n');
% fprintf('then copy the file there. E.g., your user name is lisa, then copy the file into\n');
% fprintf('/Users/lisa/lib/ \n\n');
% fprintf('Please try this steps, then restart your script.\n\n');
em = psychlasterror;
fprintf('The exact error message of the linker was: %s\n', em.message);
fprintf('\n\n');
error('Failed to load PsychPortAudio driver.');
end
end
return;
|
