Docs @ Psychtoolbox Wiki: Preference

Revision [14388]

Last edited on 2011-12-18 16:12:11 by DocBot

Additions:

oldMappings = [[Screen]]('[[Preference]]', 'ScreenToHead', screenId [, newHeadId,
newCrtcId][, rank=0]);

Deletions:

oldHeadIds = [[Screen]]('[[Preference]]', 'ScreenToHead', screenId [, newHeadId][,
rank]);

Revision [14312]

Edited on 2011-10-24 16:20:15 by DocBot

Additions:

residuals = [[Screen]]('[[Preference]]', 'SynchronizeDisplays', syncMethod [,
screenId]);
oldHeadIds = [[Screen]]('[[Preference]]', 'ScreenToHead', screenId [, newHeadId][,
rank]);

Deletions:

residuals = [[Screen]]('[[Preference]]', 'SynchronizeDisplays', syncMethod);
oldHeadId = [[Screen]]('[[Preference]]', 'ScreenToHead', screenId [, newHeadId]);

Revision [14008]

Edited on 2011-07-05 05:21:37 by DocBot

Additions:

(0=Quicktime-SequenceGrabbers, 1=LibDC1394-Firewire, 2=LibARVideo,
3=GStreamer)]);
oldMode = [[Screen]]('[[Preference]]', 'OverrideMultimediaEngine', [newmode (0=System
default, 1=GStreamer)]);
oldHeadId = [[Screen]]('[[Preference]]', 'ScreenToHead', screenId [, newHeadId]);

Deletions:

~~(0=Quicktime-SequenceGrabbers, 1=LibDC1394-Firewire, 2=LibARVideo)]);~~

Revision [9788]

Edited on 2010-01-11 08:40:16 by DocBot

Additions:

oldSize = [[Screen]]('[[Preference]]', 'DefaultFontSize', [fontSize]);
oldStyleFlag = [[Screen]]('[[Preference]]', 'DefaultFontStyle', [styleFlag]);
oldfontName = [[Screen]]('[[Preference]]', 'DefaultFontName', [fontName]);
oldLocaleNameString = [[Screen]]('[[Preference]]', 'TextEncodingLocale',
[newLocalenNameString]);

Revision [9668]

Edited on 2009-10-27 09:29:19 by DocBot

Additions:

[maxStddev, minSamples, maxDeviation, maxDuration] = [[Screen]]('[[Preference]]',
'SyncTestSettings' [, maxStddev=0.001 secs][, minSamples=50][,
maxDeviation=0.1][, maxDuration=5 secs]);

Revision [9633]

Edited on 2009-07-02 12:01:29 by DocBot

Additions:

oldBool = [[Screen]]('[[Preference]]', 'IgnoreCase', [psych_bool]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'FrameRectCorrection', [enableFlag=1]);
oldEnableFlags = [[Screen]]('[[Preference]]', 'Enable3DGraphics', [enableFlags]);
(0=Quicktime-SequenceGrabbers, 1=LibDC1394-Firewire, 2=LibARVideo)]);
oldLevel = [[Screen]]('[[Preference]]', 'WindowShieldingLevel', [newLevel (0 = Behind
all other windows - 2000 = In front of all other windows, the default)]);

Deletions:

oldBool = [[Screen]]('[[Preference]]', 'IgnoreCase', [bool]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'Enable3DGraphics', [enableFlag]);
(0=Quicktime-SequenceGrabbers, 1=LibDC1394-Firewire)]);

Revision [9228]

Edited on 2008-11-05 06:34:54 by DocBot

Additions:

""<div class="subfct" id="Screen">""===[[Preference Screen('Preference')]]===

Deletions:

""<div class="subfct" id="Screen" style="background-color:#eee; padding:1em; border-width:1px; border-style:solid; border-color:#ddd; margin-bottom: 2em;border-top: 5px solid #999999;">""===[[Preference Screen('Preference')]]===

Revision [7114]

Edited on 2008-07-10 16:14:37 by DocBot

Additions:

Deletions:

~~===[[Preference Screen('Preference')]]===~~

Revision [5055]

Edited on 2008-04-26 21:40:12 by DocBot

Additions:

===[[Preference Screen('Preference')]]===
==[[Psychtoolbox]] › [[Screen]].{mex*,dll} subfunction==
%%(matlab;Usage)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', [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]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'DefaultTextYPositionIsBaseline',
oldEnableFlag = [[Screen]]('[[Preference]]', 'TextAntiAliasing', [enableFlag=-1 (System
setting), 0 = Disable, 1 = Enable, 2 = EnableHighQuality]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'TextRenderer', [enableFlag=0 (Default
OS-specific [fast]), 1 = HighQ OS-specific]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'SkipSyncTests', [enableFlag]);
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]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'Enable3DGraphics', [enableFlag]);
oldEnableFlag = [[Screen]]('[[Preference]]', 'SuppressAllWarnings', [enableFlag]);
oldMode = [[Screen]]('[[Preference]]', 'VBLTimestampingMode', [newmode]);
oldMode = [[Screen]]('[[Preference]]', 'DefaultVideocaptureEngine', [newmode
residuals = [[Screen]]('[[Preference]]', 'SynchronizeDisplays', syncMethod);
oldLevel = [[Screen]]('[[Preference]]', 'Verbosity' [,level]);

Deletions:

===[[Preference Screen Preferences]]===
==PtbReference › PsychBasic › [[Screen]]==
=== See [[Screen]] for technical background===
==ScreenFunctions==
%%(matlab)
Usage:
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', [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]);
oldEnableFlag = Screen('Preference', 'DefaultTextYPositionIsBaseline',
oldEnableFlag = Screen('Preference', 'TextAntiAliasing', [enableFlag=-1 (System setting), 0 = Disable, 1 = Enable, 2 = EnableHighQuality]);
oldEnableFlag = Screen('Preference', 'TextRenderer', [enableFlag=0 (Default OS-specific [fast]), 1 = HighQ OS-specific]);
oldEnableFlag = Screen('Preference', 'SkipSyncTests', [enableFlag]);
oldLevel = Screen('Preference', 'VisualDebugLevel', level);
% Workaround flags to work around all kind of deficient drivers and hardware:
See 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]);
oldEnableFlag = Screen('Preference', 'Enable3DGraphics', [enableFlag]);
oldEnableFlag = Screen('Preference', 'SuppressAllWarnings', [enableFlag]);
oldMode = Screen('Preference', 'VBLTimestampingMode', [newmode]);
oldMode = Screen('Preference', 'DefaultVideocaptureEngine', [newmode
residuals = Screen('Preference', 'SynchronizeDisplays', syncMethod);
oldLevel = Screen('Preference', 'Verbosity' [,level]);
%%
[[PtbReference]] [[Screen]]

Revision [2621]

Edited on 2008-03-18 00:55:06 by ZweiWolf

Deletions:

~~{{category}}~~

Revision [2620]

Edited on 2008-03-18 00:53:54 by ZweiWolf

Additions:

See ConserveVRAMSettings for settings and their effect.
oldMode = Screen('Preference', ' ConserveVRAM ', mode);

Deletions:

% See ConserveVRAMSettings for settings and their effect.
oldMode = Screen('Preference', 'ConserveVRAM', mode);

Revision [2619]

Edited on 2008-03-18 00:52:34 by ZweiWolf

Additions:

===[[Preference Screen Preferences]]===
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', [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]);
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 (Default OS-specific [fast]), 1 = HighQ OS-specific]);
oldEnableFlag = Screen('Preference', 'SkipSyncTests', [enableFlag]);
oldLevel = Screen('Preference', 'VisualDebugLevel', level);
% Workaround flags to work around all kind of deficient drivers and hardware:
% See ConserveVRAMSettings for settings and their effect.
oldMode = Screen('Preference', 'ConserveVRAM', mode);
oldEnableFlag = Screen('Preference', 'EmulateOldPTB', [enableFlag]);
oldEnableFlag = Screen('Preference', 'Enable3DGraphics', [enableFlag]);
oldEnableFlag = Screen('Preference', 'SuppressAllWarnings', [enableFlag]);
oldMode = Screen('Preference', 'VBLTimestampingMode', [newmode]);
oldMode = Screen('Preference', 'DefaultVideocaptureEngine', [newmode
(0=Quicktime-SequenceGrabbers, 1=LibDC1394-Firewire)]);
residuals = Screen('Preference', 'SynchronizeDisplays', syncMethod);
oldLevel = Screen('Preference', 'Verbosity' [,level]);

Deletions:

===ScreenFunctions===
oldEnableFlag=Screen(' Preference ', 'EmulateOldPTB ', [enableFlag]);
% Open or close a window or texture:
[windowPtr,rect]=Screen(' OpenWindow ',windowPtrOrScreenNumber [,color] [,rect] [,pixelSize] [,numberOfBuffers] [,stereomode] [,multisample][,imagingmode]);
[windowPtr,rect]=Screen(' OpenOffscreenWindow ',windowPtrOrScreenNumber [,color] [,rect] [,pixelSize]);
textureIndex=Screen(' MakeTexture ', WindowIndex, imageMatrix [, optimizeForDrawAngle=0] [, specialFlags=0] [, floatprecision=0] [, textureOrientation=0] [, textureShader=0]);
Screen(' Close ', [windowOrTextureIndex or list of textureIndices/offscreenWindowIndices]);
Screen(' CloseAll ');
% Draw lines and solids like QuickDraw and DirectX (OS 9 and Windows):
currentbuffer = Screen(' SelectStereoDrawBuffer ', windowPtr [, bufferid] [, param1]);
Screen(' DrawLine ', windowPtr [,color], fromH, fromV, toH, toV [,penWidth]);
Screen(' DrawArc ',windowPtr,[color],[rect],startAngle,arcAngle)
Screen(' FrameArc ',windowPtr,[color],[rect],startAngle,arcAngle[,penWidth] [,penHeight] [,penMode])
Screen(' FillArc ',windowPtr,[color],[rect],startAngle,arcAngle)
Screen(' FillRect ', windowPtr [,color] [,rect] );
Screen(' FrameRect ', windowPtr [,color] [,rect] [,penWidth]);
Screen(' FillOval ', windowPtr [,color] [,rect]);
Screen(' FrameOval ', windowPtr [,color] [,rect] [,penWidth] [,penHeight] [,penMode]);
Screen(' FillPoly ', windowPtr [,color], pointList);
% New OpenGL functions for OS X:
Screen(' glPoint ', windowPtr, color, x, y [,size]);
Screen(' gluDisk ', windowPtr, color, x, y [,size]);
Screen(' DrawDots ', windowPtr, xy [,size] [,color] [,center] [,dot_type]);
Screen(' DrawLines ', windowPtr, xy [,width] [,colors] [,center] [,smooth]);
[sourceFactorOld, destinationFactorOld]=(' BlendFunction ', windowIndex, [sourceFactorNew], [destinationFactorNew]);
% Draw Text in windows
textModes = Screen(' TextModes ');
oldCopyMode=Screen(' TextMode ', windowPtr [,textMode]);
oldTextSize=Screen(' TextSize ', windowPtr [,textSize]);
oldStyle=Screen(' TextStyle ', windowPtr [,style]);
[oldFontName,oldFontNumber]=Screen(windowPtr,' TextFont ' [,fontNameOrNumber]);
[normBoundsRect, offsetBoundsRect]=Screen(' TextBounds ', windowPtr, text);
[newX,newY]=Screen(' DrawText ', windowPtr, text [,x] [,y] [,color] [,backgroundColor] [,yPositionIsBaseline]);
oldTextColor=Screen(' TextColor ', windowPtr [,colorVector]);
oldTextBackgroundColor=Screen(' TextBackgroundColor ', windowPtr [,colorVector]);
% Copy an image, very quickly, between textures, offscreen windows and onscreen windows.
[resident [texidresident]] = Screen(' PreloadTextures ', windowPtr [, texids]);
Screen(' DrawTexture ', windowPointer, texturePointer [,sourceRect] [,destinationRect] [,rotationAngle] [, filterMode] [, globalAlpha] [, modulateColor] [, textureShader] [, specialFlags] [, auxParameters]);
Screen(' DrawTextures ', windowPointer, texturePointer(s) [, sourceRect(s)] [, destinationRect(s)] [, rotationAngle(s)] [, filterMode(s)] [, globalAlpha(s)] [, modulateColor(s)] [, textureShader] [, specialFlags] [, auxParameters]);
Screen(' CopyWindow ', srcWindowPtr, dstWindowPtr, [srcRect], [dstRect], [copyMode])
% Copy an image, slowly, between matrices and windows :
imageArray=Screen(' GetImage ', windowPtr [,rect] [,bufferName] [,floatprecision=0] [,nrchannels=3])
Screen(' PutImage ', windowPtr, imageArray [,rect]);
% Synchronize with the window's screen (on-screen only):
[VBLTimestamp StimulusOnsetTime FlipTimestamp Missed Beampos] = Screen(' Flip ', windowPtr [, when] [, dontclear] [, dontsync] [, multiflip]);
Screen(' AsyncFlipBegin ', windowPtr [, when] [, dontclear] [, dontsync] [, multiflip]);
[VBLTimestamp StimulusOnsetTime FlipTimestamp Missed Beampos] = Screen(' AsyncFlipEnd ', windowPtr);
[VBLTimestamp StimulusOnsetTime FlipTimestamp Missed Beampos] = Screen(' AsyncFlipCheckEnd ', windowPtr);
[telapsed] = Screen(' DrawingFinished ', windowPtr [, dontclear] [, sync]);
framesSinceLastWait = Screen(' WaitBlanking ', windowPtr [, waitFrames]);
% Load color lookup table of the window's screen (on-screen only):
[gammatable, dacbits, reallutsize] = Screen(' ReadNormalizedGammaTable ', windowPtrOrScreenNumber);
Screen(' LoadNormalizedGammaTable ', windowPtrOrScreenNumber, table [, loadOnNextFlip]);
oldclut = Screen(' LoadCLUT ', windowPtrOrScreenNumber [, clut] [, startEntry=0] [, bits=8]);
% Get (and set) information about a window or screen:
screenNumbers=Screen(' Screens ');
windowPtrs=Screen(' Windows ');
kind=Screen(windowPtr, ' WindowKind ' );
isOffscreen=Screen(windowPtr,' IsOffscreen ');
hz=Screen(' FrameRate ', windowPtrOrScreenNumber [, mode] [, reqFrameRate]);
hz=Screen(' NominalFrameRate ', windowPtrOrScreenNumber [, mode] [, reqFrameRate]);
[ monitorFlipInterval nrValidSamples stddev ]=Screen(' GetFlipInterval ', windowPtr [, nrSamples] [, stddev] [, timeout]);
screenNumber=Screen(' WindowScreenNumber ', windowPtr);
rect=Screen(' Rect ', windowPtrOrScreenNumber);
pixelSize=Screen(' PixelSize ', windowPtrOrScreenNumber);
pixelSizes=Screen(' PixelSizes ', windowPtrOrScreenNumber);
[width, height]=Screen(' WindowSize ', windowPointerOrScreenNumber);
[width, height]=Screen(' DisplaySize ', ScreenNumber);
[oldmaximumvalue oldclampcolors] = Screen(' ColorRange ', windowPtr [, maximumvalue][, clampcolors=1]);
info = Screen(' GetWindowInfo ', windowPtr [, beamposOnly=0]);
resolutions=Screen(' Resolutions ', screenNumber);
oldResolution=Screen(' Resolution ', screenNumber [, newwidth] [, newheight] [, newHz] [, newPixelSize] [, specialMode]);
% Get/set details of environment, computer, and video card (i.e. screen):
struct=Screen(' Version ');
comp=Screen(' Computer ');
oldBool=Screen(' Preference ', 'IgnoreCase' [,bool]);
tick0Secs=Screen(' Preference ', 'Tick0Secs ', tick0Secs);
psychTableVersion=Screen(' Preference ', ' PsychTableVersion ');
mexFunctionName=Screen(' Preference ', ' PsychTableCreator ');
proc=Screen(' Preference ', 'Process ');
Screen(' Preference ','SkipSyncTests ', skipTest);
Screen(' Preference ','VisualDebugLevel ', level (valid values between 0 and 5));
Screen(' Preference ', 'ConserveVRAM ', mode (valid values between 0 and 3));
Screen(' Preference ', 'Enable3DGraphics ', [enableFlag]);
% Helper functions. Don't call these directly, use eponymous wrappers:
[x, y, buttonVector]= Screen(' GetMouseHelper ', numButtons);
Screen(' HideCursorHelper ', windowPntr);
Screen(' ShowCursorHelper ', windowPntr);
Screen(' SetMouseHelper ', windowPntrOrScreenNumber, x, y);
% Internal testing of Screen
timeList= Screen(' GetTimelist ');
Screen(' ClearTimelist ');
Screen(' Preference ','DebugMakeTexture ', enableDebugging);
% Movie and multimedia playback functions:
[ moviePtr [duration] [fps] [width] [height] [count]]=Screen(' OpenMovie ', windowPtr, moviefile [, async=0]);
Screen(' CloseMovie ', moviePtr);
[ texturePtr [timeindex]]=Screen(' GetMovieImage ', windowPtr, moviePtr, [waitForImage], [fortimeindex]);
[droppedframes] = Screen(' PlayMovie ', moviePtr, rate, [loop], [soundvolume]);
timeindex = Screen(' GetMovieTimeIndex ', moviePtr);
[oldtimeindex] = Screen(' SetMovieTimeIndex ', moviePtr, timeindex);
% Video capture functions:
videoPtr =Screen(' OpenVideoCapture ', windowPtr [, deviceIndex] [,roirectangle] [, pixeldepth] [, numbuffers] [, allowfallback] [, targetmoviename] [, recordingflags] [, captureEngineType]);
Screen(' CloseVideoCapture ', capturePtr);
[fps starttime] = Screen(' StartVideoCapture ', capturePtr [, captureRateFPS] [, dropframes=0] [, startAt]);
droppedframes = Screen(' StopVideoCapture ', capturePtr);
[ texturePtr [capturetimestamp] [droppedcount] [summed_intensityOrRawImageMatrix]]=Screen(' GetCapturedImage ', windowPtr, capturePtr [, waitForImage=1] [,oldTexture] [,specialmode] [,targetmemptr]);
oldvalue = Screen(' SetVideoCaptureParameter ', capturePtr, 'parameterName' [, value]);
% Low level direct access to OpenGL-API functions:
% Online info for each function available by opening a terminal window
% and typing 'man Functionname' + Enter.
Screen(' glPushMatrix ', windowPtr);
Screen(' glPopMatrix ', windowPtr);
Screen(' glLoadIdentity ', windowPtr);
Screen(' glTranslate ', windowPtr, tx, ty [, tz]);
Screen(' glScale ', windowPtr, sx, sy [, sz]);
Screen(' glRotate ', windowPtr, angle, [rx = 0], [ry = 0] ,[rz = 1]);
% Support for 3D graphics rendering and for interfacing with external OpenGL code:
Screen(' Preference ', 'Enable3DGraphics ', [enableFlag]); % Enable 3D gfx support.
Screen(' BeginOpenGL ', windowPtr [, sharecontext]); % Prepare window for external OpenGL drawing.
Screen(' EndOpenGL ', windowPtr); % Finish external OpenGL drawing.
[targetwindow, IsOpenGLRendering] = Screen(' GetOpenGLDrawMode');
[textureHandle rect] = Screen(' SetOpenGLTextureFromMemPointer ', windowPtr, textureHandle, imagePtr, width, height, depth [, upsidedown][, target][, glinternalformat][, gltype][, extdataformat]);
[textureHandle rect] = Screen(' SetOpenGLTexture ', windowPtr, textureHandle, glTexid, target [, glWidth] [, glHeight] [, glDepth] [, textureShader]);
[ gltexid gltextarget texcoord_u texcoord_v ] =Screen(' GetOpenGLTexture ', windowPtr, textureHandle [, x][, y]);
% Support for plugins and for builtin high performance image processing pipeline:
[ret1, ret2, ...] = Screen(' HookFunction ', windowPtr, 'Subcommand ', 'HookName ', arg1, arg2, ...);
proxyPtr = Screen(' OpenProxy ', windowPtr [, imagingmode]);
transtexid = Screen(' TransformTexture ', sourceTexture, transformProxyPtr [, sourceTexture2][, targetTexture][, specialFlags]);

Revision [2618]

The oldest known version of this page was created on 2008-03-18 00:50:19 by ZweiWolf