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 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343
|
function SetupPsychtoolbox(tryNonInteractiveSetup)
% SetupPsychtoolbox - In-place setup of PTB without network access.
%
% SetupPsychtoolbox([tryNonInteractiveSetup=0])
%
% This script prepares an already downloaded working copy of Psychtoolbox
% for use with Matlab or Octave. It sets proper paths and takes care of
% special setup operations for various things.
%
% The optional parameter 'tryNonInteractiveSetup' if provided as 1 (true), will
% try a setup without user interaction, not asking users for input in certain
% situations, but assuming an answer that keeps the setup progressing. Note that
% this is not guaranteed to work in all cases, and may end in data loss, e.g.,
% overwriting an old and potentially user-modified Psychtoolbox installation.
% This non-interactice setup mode is highly experimental, not well tested, not
% supported in case of any trouble!
%
% This setup routine is meant for people who want to install Psychtoolbox
% but don't have direct access to the internet. Installation in that case
% is a three step procedure:
%
% 1. Download and unpack a full working copy of PTB into your target
% folder. Obviously you need to somehow get a copy, either via conventional
% download from a computer with network connection (See 'help
% DownloadPsychtoolbox' or 'help UpdatePsychtoolbox') or from a helpful
% colleague.
%
% 2. Change your Matlab/Octave working directory to the Psychtoolbox installation
% folder, e.g., 'cd /Applications/Psychtoolbox'.
%
% 3. Type 'SetupPsychtoolbox' to run this script.
%
% Please be aware that the recommended method of installation is via the
% online Subversion system, i.e., DownloadPsychtoolbox and
% UpdatePsychtoolbox. Some functionality may not work with a copy that is
% set up via this script, e.g., PsychtoolboxVersion may provide incomplete
% version information. Convenient upgrades via UpdatePsychtoolbox may be
% impossible. Download size with this method is much higher as well.
%
% If you get stuck, post your question to the forum:
%
% https://psychtoolbox.discourse.group
%
% Please specify your full name and the version of your operating system,
% MATLAB or Octave and Psychtoolbox.
%
% History:
%
% 01/25/07 mk Created. Derived from DownloadPsychtoolbox. Basically a
% stripped down version of it.
%
% 05/31/09 mk Add support for Octave-3.
% 06/07/09 mk Apply smallish fix to fix counting, contributed by Chuan Zeng.
% 05/27/12 mk Strip backwards compatibility support to pre-R2007a.
% Remove PowerPC support.
%
% 09/14/12 mk Drop support for Octave on MS-Windows.
% 09/14/12 mk Drop support for 32-Bit Octave on OSX.
% 07/02/13 mk Drop support for 32-Bit Matlab on OSX, and thereby for 32-Bit OSX.
% 05/18/14 mk No support for 32-Bit Matlab on Linux and Windows anymore for 3.0.12.
% 10/28/15 mk 32-Bit Octave-4 support for MS-Windows reestablished.
% 04/01/16 mk 64-Bit Octave-4 support for MS-Windows established.
% 06/01/16 mk 32-Bit Octave-4 support for MS-Windows removed.
% Flush all MEX files: This is needed at least on M$-Windows to
% work if Screen et al. are still loaded.
clear mex
if nargin < 1 || isempty(tryNonInteractiveSetup)
tryNonInteractiveSetup = 0;
end
oldpause = pause('query');
if tryNonInteractiveSetup
pause('off');
end
% Check if this is 32-Bit Octave-4 on Windows, which we don't support at all:
if isempty(strfind(computer, 'x86_64')) && ~isempty(strfind(computer, 'mingw32'))
fprintf('Psychtoolbox 3.0.13 and later do no longer work with 32-Bit GNU/Octave-4 on MS-Windows.\n');
fprintf('You need to use 64-Bit Octave-4 if you want to use Psychtoolbox with Octave on Windows.\n');
fprintf('DownloadPsychtoolbox() with flavor ''Psychtoolbox-3.0.12'', does support 32-Bit Octave-4 on Windows.\n');
error('Tried to setup on 32-Bit Octave, which is no longer supported on Windows.');
end
% Check if this is 32-Bit Matlab on Windows or Linux, which we don't support anymore:
if (strcmp(computer, 'PCWIN') || strcmp(computer, 'GLNX86'))
fprintf('Psychtoolbox 3.0.12 and later do no longer work with 32-Bit versions of Matlab.\n');
fprintf('You need to upgrade to a supported 64-Bit version of Octave or Matlab. 32-Bit Octave is still\n');
fprintf('supported on GNU/Linux.\n');
fprintf('If you must use a legacy 32-Bit Matlab environment, you can call this function\n');
fprintf('DownloadPsychtoolbox() with flavor ''Psychtoolbox-3.0.11'', which does support 32-Bit Matlab on Linux and Windows.\n');
error('Tried to setup on 32-Bit Matlab, which is no longer supported.');
end
% Check if this is 32-Bit Octave or 32-Bit Matlab on OSX, which we don't support anymore:
if (~isempty(strfind(computer, 'apple-darwin')) || strcmp(computer,'MACI')) && isempty(strfind(computer, '64'))
fprintf('Psychtoolbox 3.0.11 and later do no longer work with 32-Bit versions of Octave or Matlab on OSX.\n');
fprintf('You need to upgrade to a 64-Bit version of Octave or Matlab on OSX, which is fully supported.\n');
fprintf('You can also use the alternate download function DownloadLegacyPsychtoolbox() to download\n');
fprintf('an old legacy copy of Psychtoolbox-3.0.9, which did support 32-Bit Octave 3.2 on OSX, or use\n');
fprintf('DownloadPsychtoolbox() with flavor ''Psychtoolbox-3.0.10'', which does support 32-Bit Matlab on OSX.\n');
error('Tried to setup on 32-Bit Octave or 32-Bit Matlab, which are no longer supported on OSX.');
end
% Check if this is Octave-3 on Windows, which we don't support at all:
if strcmp(computer, 'i686-pc-mingw32')
fprintf('Psychtoolbox 3.0.10 and later does no longer work with GNU/Octave-3 on MS-Windows.\n');
fprintf('You need to use 32-Bit Octave-4 if you want to use Psychtoolbox with Octave on Windows.\n');
fprintf('You can also use the alternate download function DownloadLegacyPsychtoolbox() to download\n');
fprintf('an old legacy copy of Psychtoolbox-3.0.9 which did support 32-Bit Octave 3.2 on Windows.\n');
error('Tried to setup on Octave, which is no longer supported on MS-Windows.');
end
if strcmp(computer,'MAC')
fprintf('This version of Psychtoolbox is no longer supported under MacOSX on the Apple PowerPC hardware platform.\n');
fprintf('You can get modern versions of Psychtoolbox-3 for Linux if you choose to install GNU/Linux on your PowerPC\n');
fprintf('machine. These are available from the GNU/Debian project and a future Ubuntu 12.10 release\n.');
fprintf('Alternatively you can download old - totally unsupported - releases of Psychtoolbox version 3.0.9\n');
fprintf('from GoogleCode by use of the alternate download function DownloadLegacyPsychtoolbox().\n\n');
error('Apple MacOSX on Apple PowerPC computers is no longer supported by this Psychtoolbox version.');
end
% Check OS
IsWin = ~isempty(strfind(computer, 'PCWIN')) || ~isempty(strfind(computer, '-w64-mingw32'));
IsOSX = ~isempty(strfind(computer, 'MAC')) || ~isempty(strfind(computer, 'apple-darwin'));
IsLinux = strcmp(computer,'GLNX86') || strcmp(computer,'GLNXA64') || ~isempty(strfind(computer, 'linux-gnu'));
if ~IsWin && ~IsOSX && ~IsLinux
os = computer;
if strcmp(os,'MAC2')
os = 'Mac OS9';
end
fprintf('Sorry, this updater doesn''t support your operating system: %s.\n', os);
fprintf([mfilename ' can only install the new (OSX, Linux and Windows) \n'...
'OpenGL-based versions of the Psychtoolbox-3. To install the older (OS9 and Windows) \n'...
'versions (not based on OpenGL, aka PTB-2) please go to the legacy Psychtoolbox website: \n'...
'web http://psychtoolbox.org/PTB-2/index.html\n']);
error(['Your operating system is not supported by ' mfilename '.']);
end
% Locate ourselves:
targetdirectory=fileparts(mfilename('fullpath'));
if ~strcmpi(targetdirectory, pwd)
error('You need to change your working directory to the Psychtoolbox folder before running this routine!');
end
fprintf('Will setup working copy of the Psychtoolbox folder inside: %s\n',targetdirectory);
fprintf('\n');
% Does SAVEPATH work?
if exist('savepath') %#ok<EXIST>
err=savepath;
else
err=path2rc;
end
if err
try
% If this works then we're likely on Matlab:
p=fullfile(matlabroot,'toolbox','local','pathdef.m');
fprintf(['Sorry, SAVEPATH failed. Probably the pathdef.m file lacks write permission. \n'...
'Please ask a user with administrator privileges to enable \n'...
'write by everyone for the file:\n\n''%s''\n\n'],p);
catch %#ok<CTCH>
% Probably on Octave:
fprintf(['Sorry, SAVEPATH failed. Probably your ~/.octaverc file lacks write permission. \n'...
'Please ask a user with administrator privileges to enable \n'...
'write by everyone for that file.\n\n']);
end
fprintf(['Once "savepath" works (no error message), run ' mfilename ' again.\n']);
fprintf('Alternatively you can choose to continue with installation, but then you will have\n');
fprintf('to resolve this permission isssue later and add the path to the Psychtoolbox manually.\n\n');
if ~tryNonInteractiveSetup
answer=input('Do you want to continue the installation despite the failure of SAVEPATH (yes or no)? ','s');
else
answer='no';
end
if ~strcmpi(answer,'yes') && ~strcmpi(answer,'y')
fprintf('\n\n');
error('SAVEPATH failed. Please get an administrator to allow everyone to write pathdef.m.');
end
end
% Handle Windows ambiguity of \ symbol being the fileseparator and a
% parameter marker:
if IsWin
searchpattern = [filesep filesep 'Psychtoolbox[' filesep pathsep ']'];
searchpattern2 = [filesep filesep 'Psychtoolbox'];
else
searchpattern = [filesep 'Psychtoolbox[' filesep pathsep ']'];
searchpattern2 = [filesep 'Psychtoolbox'];
end
% Remove "Psychtoolbox" from path:
while any(regexp(path, searchpattern))
fprintf('Your old Psychtoolbox appears in the MATLAB/OCTAVE path:\n');
paths=regexp(path,['[^' pathsep ']+'],'match');
fprintf('Your old Psychtoolbox appears %d times in the MATLAB/OCTAVE path.\n',length(paths));
if tryNonInteractiveSetup
answer = 'no';
else
answer=input('Before you decide to delete the paths, do you want to see them (yes or no)? ','s');
end
if ~strcmpi(answer,'yes') && ~strcmpi(answer,'y')
fprintf('You didn''t say "yes", so I''m taking it as no.\n');
else
for p=paths
s=char(p);
if any(regexp(s,searchpattern2))
fprintf('%s\n',s);
end
end
end
if tryNonInteractiveSetup
answer = 'yes';
else
answer=input('Shall I delete all those instances from the MATLAB/OCTAVE path (yes or no)? ','s');
end
if ~strcmpi(answer,'yes') && ~strcmpi(answer,'y')
fprintf('You didn''t say yes, so I cannot proceed.\n');
fprintf('Please use the MATLAB "File:Set Path" command or its Octave equivalent to remove all instances of "Psychtoolbox" from the path.\n');
error('Please remove Psychtoolbox from MATLAB/OCTAVE path.');
end
for p=paths
s=char(p);
if any(regexp(s,searchpattern2))
% fprintf('rmpath(''%s'')\n',s);
if strcmpi(s, pwd)
% Octave 6.4+: rmpath can not remove current working directory from path, so switch it:
cd('..');
end
rmpath(s);
end
end
if exist('savepath') %#ok<EXIST>
savepath;
else
path2rc;
end
fprintf('Success.\n\n');
end
% Add Psychtoolbox to MATLAB/OCTAVE path
fprintf('Now adding the new Psychtoolbox folder (and all its subfolders) to your MATLAB/OCTAVE path.\n');
p=targetdirectory;
pp=genpath(p);
addpath(pp);
if exist('savepath') %#ok<EXIST>
err=savepath;
else
err=path2rc;
end
if err
fprintf('SAVEPATH failed. Psychtoolbox is now already installed and configured for use on your Computer,\n');
fprintf('but i could not save the updated Matlab/Octave path, probably due to insufficient permissions.\n');
fprintf('You will either need to fix this manually via use of the path-browser (Menu: File -> Set Path),\n');
fprintf('or by manual invocation of the savepath command (See help savepath). The third option is, of course,\n');
fprintf('to add the path to the Psychtoolbox folder and all of its subfolders whenever you restart Matlab.\n\n\n');
else
fprintf('Success.\n\n');
end
% fprintf(['Now setting permissions to allow everyone to write to the Psychtoolbox folder. This will \n'...
% 'allow future updates by every user on this machine without requiring administrator privileges.\n']);
%
% try
% if IsOSX || IsLinux
% [s,m]=fileattrib(p,'+w','a','s'); % recursively add write privileges for all users.
% else
% [s,m]=fileattrib(p,'+w','','s'); % recursively add write privileges for all users.
% end
% catch %#ok<CTCH>
% s = 0;
% m = 'Setting file attributes is not supported under Octave.';
% end
%
% if s
% fprintf('Success.\n\n');
% else
% fprintf('\nFILEATTRIB failed. Psychtoolbox will still work properly for you and other users, but only you\n');
% fprintf('or the system administrator will be able to run the UpdatePsychtoolbox script to update Psychtoolbox,\n');
% fprintf('unless you or the system administrator manually set proper write permissions on the Psychtoolbox folder.\n');
% fprintf('The error message of FILEATTRIB was: %s\n\n', m);
% end
if IsOSX
% Apples trainwreck needs special treatment. If Psychtoolbox has been
% downloaded via a webbrowser as a zip file or tgz file and then
% extracted, then all binary executable files like .dylib's and
% .mexmaci64 mex files will have the com.apple.quarantine attribute set
% to prevent them from working in any meaningfully user fixable way -
% Thanks Apple! Use the xattr command to remove the quarantine flag.
fprintf('Trying to fixup Apple macOS broken security workflow by removing the quarantine flag from our mex files...\n\n');
if IsOctave
% Fix the Octave mex files:
[rc, msg] = system(['xattr -d com.apple.quarantine ' p filesep 'PsychBasic/Octave6OSXFiles64/*.mex 2>&1']);
else
% Fix the Matlab mex files:
[rc, msg] = system(['xattr -d com.apple.quarantine ' p filesep 'PsychBasic/*.mexmaci64']);
end
% Fix the DrawText plugin and other plugins:
if rc == 0 || ~isempty(strfind(msg, 'xattr: com.apple.quarantine')) %#ok<STREMP>
if IsOctave
[rc, msg] = system(['xattr -d com.apple.quarantine ' p filesep 'PsychBasic/PsychPlugins/*.dylib 2>&1']);
else
[rc, msg] = system(['xattr -d com.apple.quarantine ' p filesep 'PsychBasic/PsychPlugins/*.dylib']);
end
end
% Worked?
if rc ~= 0
if isempty(strfind(msg, 'xattr: com.apple.quarantine')) %#ok<STREMP>
fprintf('FAILED! Psychtoolbox will likely not work correctly!\n');
PsychPaidSupportAndServices(2);
error(['Removing the quarantine flag from our mex files to workaround macOS brokeness failed! Error was: ' msg]);
end
end
end
if exist('PsychtoolboxPostInstallRoutine.m', 'file')
% Notify the post-install routine of the "pseudo-update" It will
% determine the proper flavor by itself.
PsychtoolboxPostInstallRoutine(1);
end
pause(oldpause);
% Puuh, we are done :)
return
|