Psychtoolbox>Screen.{mex*} subfunction

oldPreferenceValue = Screen(‘Preference’, preferenceName, [newPreferenceValue])

Get or set a Psychtoolbox preference.Preference settings are global - they
affect all operations of a module until changed.
oldBool = Screen(‘Preference’, ‘IgnoreCase’, [psych_bool]);
tick0Secs = Screen(‘Preference’, ‘Tick0Secs’, tick0Secs);
psychTableVersion = Screen(‘Preference’, ‘PsychTableVersion’);
mexFunctionName = Screen(‘Preference’, ‘PsychTableCreator’);
proc = Screen(‘Preference’, ‘Process’, signature);
proc = Screen(‘Preference’, ‘DebugMakeTexture’, enableDebugging);
oldEnableFlag = Screen(‘Preference’, ‘TextAlphaBlending’, [enableFlag]);
oldSize = Screen(‘Preference’, ‘DefaultFontSize’, [fontSize]);
oldStyleFlag = Screen(‘Preference’, ‘DefaultFontStyle’, [styleFlag]);
oldfontName = Screen(‘Preference’, ‘DefaultFontName’, [fontName]);
oldEnableFlag = Screen(‘Preference’, ‘DefaultTextYPositionIsBaseline’,
[enableFlag]);
oldEnableFlag = Screen(‘Preference’, ‘TextAntiAliasing’, [enableFlag=-1 (System
setting), 0 = Disable, 1 = Enable, 2 = EnableHighQuality]);
oldEnableFlag = Screen(‘Preference’, ‘TextRenderer’, [enableFlag=0 (Legacy
OS-specific), 1 = HighQ OS-specific (Default), 2 = Linux renderer plugin]);
oldLocaleNameString = Screen(‘Preference’, ‘TextEncodingLocale’,
[newLocalenNameString]);
oldEnableFlag = Screen(‘Preference’, ‘SkipSyncTests’, [enableFlag]);
[maxStddev, minSamples, maxDeviation, maxDuration] = Screen(‘Preference’,
‘SyncTestSettings’ [, maxStddev=0.001 secs][, minSamples=50][,
maxDeviation=0.1][, maxDuration=5 secs]);
oldEnableFlag = Screen(‘Preference’, ‘FrameRectCorrection’, [enableFlag=1]);
oldLevel = Screen(‘Preference’, ‘VisualDebugLevel’, level);

Workaround flags to work around all kind of deficient drivers and hardware:
See ‘help ConserveVRAMSettings’ for settings and their effect.

oldMode = Screen(‘Preference’, ‘ConserveVRAM’, mode);

Activate compatibility mode: Try to behave like the old MacOS-9 Psychtoolbox:
oldEnableFlag = Screen(‘Preference’, ‘EmulateOldPTB’, [enableFlag]);

oldEnableFlags = Screen(‘Preference’, ‘Enable3DGraphics’, [enableFlags]);
oldEnableFlag = Screen(‘Preference’, ‘SuppressAllWarnings’, [enableFlag]);
oldMode = Screen(‘Preference’, ‘VBLTimestampingMode’, [newmode]);
[oldVTOTAL, oldmaxVTOTALFactor] = Screen(‘Preference’, ‘VBLEndlineOverride’ [,
newVTOTAL=auto][, maxVTOTALFactor=1.25]);
oldMode = Screen(‘Preference’, ‘DefaultVideocaptureEngine’, [newmode
(0=Quicktime - unsupported, 1=LibDC1394-Firewire, 2=LibARVideo - unsupported,
3=[GStreamer](GStreamer))]);
oldMode = Screen(‘Preference’, ‘OverrideMultimediaEngine’, [newmode
(0=Legacy-Quicktime - unsupported, 1=[GStreamer](GStreamer))]);
oldLevel = Screen(‘Preference’, ‘WindowShieldingLevel’, [newLevel (0 = Behind
all other windows - 2000 = In front of all other windows, the default)]);
residuals = Screen(‘Preference’, ‘SynchronizeDisplays’, syncMethod [,
screenId]);
oldMappings = Screen(‘Preference’, ‘ScreenToHead’, screenId [, newHeadId,
newCrtcId][, rank=0]);
oldLevel = Screen(‘Preference’, ‘Verbosity’ [,level]);

###See also: