estimate_visual_FOV/estimateFOV.m at master · cpp-lln-lab/estimate_visual_FOV · GitHub

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
111
112
113
114
115
116
117
118
119
120
121
% (C) Copyright 2020 CPP lab developpers

%% visual field of view estimator

% This script runs a simple routine that will display a red square on the screen
% that the user can move and rescale till it feels their whole field of view (FOV) on
% the screen.
%
% This can prove useful when the FOV is partly obstructed (like in an fMRI)
% experiment and hard to measure.

% Clear all the previous stuff
clc;
if ~ismac
    close all;
    clear Screen;
end

% make sure we got access to all the required functions and inputs
initEnv();

% set and load all the parameters to run the experiment
cfg = setParameters;

%% Experiment

% Safety loop: close the screen if code crashes
try

    %% Init the experiment
    [cfg] = initPTB(cfg);

    % step size to move and scale the field of view rectangle
    cfg.stepSize = floor(cfg.screen.winHeight * 0.05);

    unfold(cfg);

    % Show experiment instruction
    standByScreen(cfg);

    % prepare the KbQueue to collect responses
    getResponse('init', cfg.keyboard.responseBox, cfg);

    getResponse('start', cfg.keyboard.responseBox);

    % draw the field of view rectangle centered on the screen
    % after that it will not be centered anymore.
    centerOnScreen = true;
    fov = drawFieldOfVIew(cfg, centerOnScreen);
    cfg.screen.effectiveFieldOfView = fov;
    Screen('flip', cfg.screen.win);
    centerOnScreen = false;

    keepGoing = true;

    % we let the user update the position of the screen and we let the
    % exerimenter press space when they are done.
    while keepGoing

        % Check for experiment abortion from operator
        checkAbort(cfg, cfg.keyboard.keyboard);

        % draw rectangle on screen
        drawFieldOfVIew(cfg, centerOnScreen);
        Screen('flip', cfg.screen.win);

        % collect response and update FOV value
        responseEvents = getResponse('check', ...
                                     cfg.keyboard.responseBox, ...
                                     cfg);

        [cfg, keepGoing] = updateFov(cfg, responseEvents);

    end

    %% clean up and close
    getResponse('stop', cfg.keyboard.responseBox);
    getResponse('release', cfg.keyboard.responseBox);

    farewellScreen(cfg);

    cleanUp();

    %% Print output to screen

    % in pixels
    fov = cfg.screen.effectiveFieldOfView;
    printResults(fov, 'pixel');

    % in degrees of visual angles
    cfg.screen = pixToDeg('effectiveFieldOfView', cfg.screen, cfg);
    fovDegVA = cfg.screen.effectiveFieldOfViewDegVA;
    printResults(fovDegVA, 'degrees of visual angles');

    fprintf(1, ['\n\n' repmat('-', 1, 80) '\n']);
    fprintf(1, 'SET UP TO COPY \n\n');

    [displacement.x, displacement.y] = fovCenterRelativeCoord(cfg, fov);
    displacement = pixToDeg('x', displacement, cfg);
    displacement = pixToDeg('y', displacement, cfg);

    fprintf(1, ['%% fixation cross displacement in degrees of visual angles:\n\n' ...
                ' cfg.fixation.xDisplacement = %f;\n', ...
                ' cfg.fixation.yDisplacement = %f;\n\n'], ...
            displacement.xDegVA, ...
            displacement.yDegVA);

    fprintf(1, ['%% set up configuration:\n\n' ...
                ' cfg.testingDevice = ''%s'';\n', ...
                ' cfg.screen.monitorDistance = %f;\n', ...
                ' cfg.screen.monitorWidth = %f;\n\n'], ...
            cfg.testingDevice, ...
            cfg.screen.monitorDistance, ...
            cfg.screen.monitorWidth);

catch

    cleanUp();
    psychrethrow(psychlasterror);

end