vbBlock_setParameters.m

% (C) Copyright 2020 CPP visual motion localizer developpers

function [cfg] = vbBlock_setParameters()

    % VISUAL LOCALIZER

    % Initialize the parameters and general configuration variables
    cfg = struct();

    % by default the data will be stored in an output folder created where the
    % setParamters.m file is
    % change that if you want the data to be saved somewhere else
    cfg.dir.output = fullfile(fileparts(mfilename('fullpath')), 'output');

    %% Debug mode settings

    cfg.debug.do = false; % To test the script out of the scanner, skip PTB sync
    cfg.debug.smallWin = false; % To test on a part of the screen, change to 1
    cfg.debug.transpWin = false; % To test with trasparent full size screen
    cfg.debug.showMouse = false;

    cfg.skipSyncTests = 1;

    cfg.verbose = 1;

    %% Engine parameters

    cfg.testingDevice = 'mri';
    cfg.eyeTracker.do = false;
    cfg.audio.do = false;

    cfg = setMonitor(cfg);

    % Keyboards
    cfg = setKeyboards(cfg);

    % MRI settings
    cfg = setMRI(cfg);
    cfg.pacedByTriggers.do = false;

    %% Experiment Design

    cfg.design.localizer = 'VWFA';
    
    % french (f) and braille (b): real word (rw), pseudo-word (pw),
    % non-word (nw), fake-script (fs)
    cfg.design.names = {'frw','fpw','fnw','ffs','brw','bpw','bnw','bfs'};

    cfg.design.nbRepetitions = 3;
    cfg.design.nbEventsPerBlock = 4; 

    %% Timing

    % CHANGE MANUALLY, REMOVING FRAMES IF NEEDED
    % SCANNER MONITOR IS NOT ACCURATE
    % mac is worse than windows
    % different lines of code

    % win
    cfg.timing.eventDuration = 3.5 - (1/60)*29; % second

    % mac - half. Is it weird? Huge variations whether plugged or on
    % battery
%     cfg.timing.eventDuration = 3.06;

    % Time between blocs in secs
    cfg.timing.IBI = 6;
    % Time between events in secs
    cfg.timing.ISI = [0.8 1 1.2];
    % Number of seconds before the motion stimuli are presented
    cfg.timing.onsetDelay = 0;
    % Number of seconds after the end all the stimuli before ending the run
    cfg.timing.endDelay = 3;


    %% Task(s)
    cfg.task.name = 'words decoding';

    % Instruction
    cfg.task.instruction = 'Détecte le stimulus répété';

    % Fixation cross (in pixels)
    cfg.fixation.type = 'cross';
    cfg.fixation.color = cfg.color.red;
    cfg.fixation.width = .2;
    cfg.fixation.lineWidthPix = 3;
    cfg.fixation.xDisplacement = 0;
    cfg.fixation.yDisplacement = 0;

    % target (referring to the words)
    cfg.target.maxNbPerBlock = 1; % 0 or 1, otherwise too crowded
    cfg.target.duration = 0.1; % In secs
    cfg.target.type = 'repetition';
    
    cfg.extraColumns = {'image', 'target', 'event', 'block', 'isi', 'keyName'};    

end

function cfg = setKeyboards(cfg)
    cfg.keyboard.escapeKey = 'ESCAPE';
    cfg.keyboard.responseKey = {'c','b','a','d','t'};
    cfg.keyboard.keyboard = [];
    cfg.keyboard.responseBox = [];

    if strcmpi(cfg.testingDevice, 'mri')
        cfg.keyboard.keyboard = [];
        cfg.keyboard.responseBox = [];
    end
end

function cfg = setMRI(cfg)
    % letter sent by the trigger to sync stimulation and volume acquisition
    cfg.mri.triggerKey = 's';
    cfg.mri.triggerNb = 1;

    cfg.mri.repetitionTime = 1.75;

    cfg.bids.MRI.Instructions = 'Detect the repeated stimulus';
    cfg.bids.MRI.TaskDescription = [];

end

function cfg = setMonitor(cfg)

    % Monitor parameters for PTB
    cfg.color.white = [255 255 255];
    cfg.color.black = [0 0 0];
    cfg.color.red = [255 0 0];
    cfg.color.grey = mean([cfg.color.black; cfg.color.white]);
    cfg.color.background = cfg.color.black;
    cfg.text.color = cfg.color.white;

    % Monitor parameters
    cfg.screen.monitorWidth = 50; % in cm
    cfg.screen.monitorDistance = 40; % distance from the screen in cm

    if strcmpi(cfg.testingDevice, 'mri')
        cfg.screen.monitorWidth = 25;
        cfg.screen.monitorDistance = 95;
    end

end