This file is indexed.

/usr/share/psychtoolbox-3/PsychGLImageProcessing/kPsychNeedRetinaResolution.m is in psychtoolbox-3-common 3.0.14.20170103+git6-g605ff5c.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
function rval = kPsychNeedRetinaResolution
% rval = kPsychNeedRetinaResolution
%
% Return a flag that you can pass to the 'imagingmode' parameter of
% Screen('OpenWindow') in order to allow driving a HiDPI display, aka
% Retina-Display at its full native resolution.
%
% Without this flag, Screen() will automatically enable its builtin
% panelfitter if it detects the onscreen window being displayed on a Retina
% style display, ie., with a scaled HiDPI display mode. The panelfitter
% will expose only a smaller, lower resolution framebuffer to the user and
% upscale user drawn stimuli to full panel resolution at Screen('Flip').
% This is the same behaviour as what OSX normally exposes on a Retina
% panel, because it doesn't cause headaches with various coordinate
% transforms, e.g., mouse or touch input coordinates to display coordinates
% and vice versa and it puts less load on the GPU, therefore performance
% impact is minimized. The downside of this default behaviour is that one
% can't take full advantage of the displays high resolution, apart from
% anti-aliasing.
%
% By default Screen() will use the low-level compatibility mode via panel
% fitting. If usercode explicitely requests use of the panelfitter via
% PsychImaging() tasks, then those requests override Screen's default
% behaviour.
%
% If usercode doesn't want panelfitting or low-res modes, but the full
% native Retina resolution, it can pass this flag to express its wish.
% Normally the flag is passed by PsychImaging as part of a more convenient
% setup procedure.
%
rval = 2^18;
return