File: BasicSoundChannelHoppingDemo.m

package info (click to toggle)
psychtoolbox-3 3.0.19.14.dfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, trixie
  • size: 86,796 kB
  • sloc: ansic: 176,245; cpp: 20,103; objc: 5,393; sh: 2,753; python: 1,397; php: 384; makefile: 193; java: 113
file content (101 lines) | stat: -rw-r--r-- 3,624 bytes parent folder | download
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
function BasicSoundChannelHoppingDemo(nrChannels, device)
% BasicSoundChannelHoppingDemo([nrChannels][, device])
%
% Opens a multi-channel sound card for output, then uses audio slave devices to
% output a mono beep tone to each audio output channel in succession, "sweeping"
% or "hopping" over all speakers / output channels of the sound card.
%
% Press and hold a key to exit.
%
% Optional parameters:
%
% nrChannels = Number of channels to hop over. Tries to open first suitable audio
% device with nrChannels output channels if 'device' is omitted.
%
% device = Sound device index to choose. Will select 'device' by matching 'nrChannels'
% if omitted, or first audio device if both 'nrChannels' and 'device' are omitted.
%

% History:
% 02-Oct-22 mk  Written.

    if nargin < 1
        nrChannels = [];
    end

    if nargin < 2
        device = [];
    end

    % Initialize sound:
    InitializePsychSound;

    % Try to find suitable device for nrChannels, if specific count requested:
    if isempty(device) && ~isempty(nrChannels)
        devs = PsychPortAudio('GetDevices');
        for i=1:length(devs)
            if devs(i).NrOutputChannels == nrChannels
                device = devs(i).DeviceIndex;
                break;
            end
        end
    end

    % Open 'device' as playback master (1+8) with requested 'nrChannels' at default
    % frequency [], in high timing precision / low latency mode 1:
    pamaster = PsychPortAudio('Open', device, 1+8, 1, [], nrChannels);

    % Start it: This is a master, so won't playback any sound by itself, only
    % sound provided by potentially started slave devices:
    PsychPortAudio('Start', pamaster);

    % Query which device was chosen in the end:
    status = PsychPortAudio('GetStatus', pamaster);
    devinfo = PsychPortAudio('GetDevices', [], status.OutDeviceIndex);
    fprintf('\nWill use following output device:\n');
    disp(devinfo);

    % And the actual number of channels that device has, assuming nrChannels was
    % not already specified by the user:
    if isempty(nrChannels)
        nrChannels = devinfo.NrOutputChannels;
    end

    % Create a 1 second 400 Hz mono beep tone, usable by any [] open audio device via bufferHandle:
    bufferHandle = PsychPortAudio('CreateBuffer', [], 0.8 * MakeBeep(400, 1, status.SampleRate));

    fprintf('\nStarting infinite channel hopping loop over %i channels. Press and hold any key to exit.\n', nrChannels);

    % Ready to do the thing - "trial loop"
    KbReleaseWait;
    while ~KbCheck
        % Do a sweep over all output channels:
        for i=1:nrChannels
            % Open paout, for mono output attached to master channel i:
            % Note: This is fast, but one could also open nrChannels separate paout
            % devices, each attached to one master channel, prep them, and then inside
            % the trial loop just call 'Start' on the one one wants, instead of doing
            % a OpenSlave->FillBuffer->...->Close over and over again...
            paout = PsychPortAudio('OpenSlave', pamaster, 1, 1, i);
            PsychPortAudio('FillBuffer', paout, bufferHandle);

            % Start playback, wait for start:
            PsychPortAudio('Start', paout, 1, [], 1);

            % Wait until end of playback:
            PsychPortAudio('Stop', paout, 1);

            % Close device:
            PsychPortAudio('Close', paout);

            % Next speaker, unless key pressed:
            if KbCheck
                break;
            end
        end
    end

    % Close all audio devices:
    PsychPortAudio('Close');
    fprintf('Done. Bye!\n');
end