/usr/share/psychtoolbox-3/PsychOneliners/AssertOSX.m is in psychtoolbox-3-common 3.0.11.20131230.dfsg1-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | function AssertOSX
% AssertOSX
%
% OS X: ___________________________________________________________________
%
% Call AssertOSX at the head of scripts which use functions unique to the
% OS X Psychtoolbox. AssertOSX will exit with an error if called from
% MATLAB running on any OS other than OS X, providing an explanation to
% users for why the script failed. AssertOSX also serves to document your
% code clearly as being specific to OS X.
%
% Use of OSX-specific Psychtoolbox functions is discouraged, though
% sometimes necessary.
%
% Note that Psychtoolbox functions which are unique to OpenGL are a
% different category than those unique to OS X. Please use AssertOpenGL in
% place of AssertOSX if your script calls functions specific to OpenGL but
% none specific to OS X. OpenGL-specific Psychtoolbox functions are any
% of the following:
% Screen('MakeTexture');
% Screen('DrawTexture');
% Screen('Flip');
%
% Some Psychtoolbox functions are unique to OS X because they exploit
% features in OS X not present in other operating systems, for example,
% the MachPriority* functions underlying Priority in OS X. Generally, as
% with Priority, there is a platform-neutral function overlalying the
% platform-specific functions. Where available, you can use these to write
% platform-neutral scripts, unless for your purposes you must take
% advantage of features specific to the OS. PsychHID is another such
% example. It exists only for OS X but is overlayed by KbCheck and Gamepad
% (a.k.a. Joystick) which also exist on OS 9. If you have an unusual USB
% HID device, you can read from it in OSX using PsychHID, though compromising
% platform independence.
%
% Overview- New functions for OS X fall into one of these categories:
% ¥ OpenGL-specific functions which are a permanent departure from earlier
% Psychtoolboxes. Call IsOpenGL or AssertOpenGL if you use only these.
% ¥ Functions which take advantage of features unique to a specific
% operating system. When possible, avoid these by using platform-neutral
% overlay functions.
% ¥ Remaining differences are a temporary failure to keep the OS 9,
% Windows, and OS X Psychtoolboxes synchronized during the course of
% development. The AssertOSX script is itself an example of this; it has
% not been ported back to OS 9 and Windows Psychtoolboxes yet.
% Psychtoolbox help displays clear divisions denoting
% platform-specificity. In the case of not-yet-backported functions, these
% divisions denote the actual currrent state of the Psychtoolbox, not its
% intended design.
%
% You can make your scripts and functions platform-neutral by testing the
% OS version using MATLAB's "computer" command and conditionally executing
% platform-specific calls.
%
% OS9: ___________________________________________________________________
%
% AssertOSX does not yet exist in OS 9.
%
% WIN: ________________________________________________________________
%
% AssertOSX does not yet exist in Windows.
%
% _________________________________________________________________________
%
% see also: AssertOpenGL, IsOSX, computer
% HISTORY
%
% 7/15/04 awi Wrote it.
% 10/6/05 awi Note here cosmetic changes by dgp between 7/15/04 and 10/6/05.
if ~IsOSX
error('Use of an m file marked for execution only on OS X. See ''help AssertOSX'' for more information');
end
|