~ubuntu-branches/ubuntu/trusty/psychtoolbox-3/trusty-proposed

%

% Tests syncing of PTB-OSX to the vertical retrace (VBL) and demonstrates

% how to implement the old Screen('WaitBlanking') behaviour with

% compatible stereo display hardware, e.g., CrystalEyes shutter glasses.

%

%

% flushpipe = Mark end of drawing commands to improve presentation timing.

% PTB knows a new command Screen('DrawingFinished') which, when properly used,

% will give PTB hints on how to optimize drawing of stimuli: This allows to draw

% but degrades performance significantly in real experiments.

%

%

% EXAMPLES:

%

% VBLSyncTest(1000, 0, 0.6, 0, 0, 1, 0) -- Render 1000 consecutive frames,

 

%%% VBLSyncTest(1000, 0, 0.6, 0, 0, 1, 0)

 

    n = 600;

end

 

    numifis = 1;

end

 

    loadjitter = 0;

end

 

    clearmode = 0;

end

 

    stereo = 0;

end

 

    flushpipe = 0;

end

 

    synchronous = 0;

end

 

try

        % This script calls Psychtoolbox commands available only in OpenGL-based 

        % versions of the Psychtoolbox. (So far, the OS X Psychtoolbox is the

        % an error message if someone tries to execute this script on a computer without

        % an OpenGL Psychtoolbox

        AssertOpenGL;

        % Get the list of Screens and choose the one with the highest screen number.

        % Screen 0 is, by definition, the display with the menu bar. Often when 

        % two monitors are connected the one without the menu bar is used as 

        % a best guess about where you want the stimulus displayed.  

        screens=Screen('Screens');

        screenNumber=max(screens);

 

    % Open double-buffered window: Optionally enable stereo output if

    % stereo == 1.

    

    % Query effective stereo mode, as Screen() could have changed it behind our

    % back, e.g., if we asked for mode 1 but Screen() had to fallback to

    td=ts;

    so=ts;

    tSecondary = ts;

    

    % Compute random load distribution for provided loadjitter value:

    wt=rand(1,n)*(loadjitter*ifi);

            tdeadline=0;

        end;

        

        % Flip: The clearmode argument specifies if flip should clear the

        % drawing buffer after flip (=0 - default), keep it "as is"

        % for incremental drawing/updating of stims (=1) or don't do

        % beampos > screen height means that flip returned during the VBL

        % interval. Small values << screen height are also ok,

        % they just indicate either a slower machine or some types of flat-panels...

 

        % mortals!

                        while 1

 

                        end

        end

        

        % Record timestamp for later use:

    % Close display: If we skipped/missed any presentation deadline during

    % Flip, Psychtoolbox will automatically display some warning message on the Matlab

    % console:

    

    % Plot all our measurement results:

 

                fprintf('Average discrepancy between DWM and beamposition timestamping is %f msecs, stddev = %f msecs.\n', mean((tSecondary - so) * 1000), std((tSecondary - so) * 1000));

    end

    

    % Count and output number of missed flip on VBL deadlines:

    numbermisses=0;

    if numifis > 0

        if (stereo == 11) && (numifis == 1)

            % Special case: Stereomode 11 can't do better than one swap

        for i=2:n

            if (ts(i)-ts(i-1) > ifi*(numifis+0.5))

                numbermisses=numbermisses+1;

    else

        if stereo == 11

            % Special case: Stereomode 11 can't do better than one swap

        for i=2:n

            if (ts(i)-ts(i-1) > ifi*1.5)

                numbermisses=numbermisses+1;

 

    % Output some summary and say goodbye...

    fprintf('PTB missed %i out of %i stimulus presentation deadlines.\n', numbermisses, n);

    fprintf('One missed deadline is ok and an artifact of the measurement.\n');

    fprintf('Have a look at the plots for more details...\n');

    

    % Done.

    % This "catch" section executes in case of an error in the "try" section

    % above. Importantly, it closes the onscreen window if its open and

    % shuts down realtime-scheduling of Matlab:

    % Disable realtime-priority in case of errors.

    Priority(0);

    psychrethrow(psychlasterror);