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
|
/*
PsychToolbox3/Source/Linux/Screen/PsychScreenGlue.h
PLATFORMS:
This is the Linux/X11 version only.
AUTHORS:
Mario Kleiner mk mario.kleiner.de@gmail.com
HISTORY:
2/20/06 mk Wrote it. Derived from Windows version.
DESCRIPTION:
Functions in this file comprise an abstraction layer for probing and controlling screen state.
Each C function which implements a particular Screen subcommand should be platform neutral. For example, the source to SCREENPixelSizes()
should be platform-neutral, despite that the calls in OS X and Linux to detect available pixel sizes are
different. The platform specificity is abstracted out in C files which end it "Glue", for example PsychScreenGlue, PsychWindowGlue,
PsychWindowTextClue.
In addition to glue functions for windows and screen there are functions which implement shared functionality between between Screen commands,
such as ScreenTypes.c and WindowBank.c.
*/
//include once
#ifndef PSYCH_IS_INCLUDED_PsychScreenGlue
#define PSYCH_IS_INCLUDED_PsychScreenGlue
#include "Screen.h"
#include <X11/extensions/XInput.h>
#include <X11/extensions/XInput2.h>
#include <X11/extensions/Xrandr.h>
#include <X11/extensions/Xfixes.h>
#include <X11/extensions/shapeconst.h>
#include <X11/Xatom.h>
//functions from PsychScreenGlue
void InitializePsychDisplayGlue(void);
void PsychCleanupDisplayGlue(void);
void PsychGetCGDisplayIDFromScreenNumber(CGDirectDisplayID *displayID, int screenNumber);
XIDeviceInfo* PsychGetInputDevicesForScreen(int screenNumber, int* nDevices);
void PsychCaptureScreen(int screenNumber);
void PsychReleaseScreen(int screenNumber);
psych_bool PsychIsScreenCaptured(int screenNumber);
int PsychGetNumDisplays(void);
void PsychGetScreenDepths(int screenNumber, PsychDepthType *depths);
int PsychGetAllSupportedScreenSettings(int screenNumber, int outputId, long** widths, long** heights, long** hz, long** bpp);
psych_bool PsychCheckVideoSettings(PsychScreenSettingsType *setting);
void PsychGetScreenDepth(int screenNumber, PsychDepthType *depth); //dont' use this and get rid of it.
int PsychGetScreenDepthValue(int screenNumber);
float PsychGetNominalFramerate(int screenNumber);
float PsychSetNominalFramerate(int screenNumber, float requestedHz);
void PsychGetScreenPixelSize(int screenNumber, long *width, long *height);
void PsychGetScreenSize(int screenNumber, long *width, long *height);
void PsychGetGlobalScreenRect(int screenNumber, double *rect);
void PsychGetScreenRect(int screenNumber, double *rect);
void PsychGetDisplaySize(int screenNumber, int *width, int *height);
PsychColorModeType PsychGetScreenMode(int screenNumber);
int PsychGetDacBitsFromDisplay(int screenNumber);
void PsychGetScreenSettings(int screenNumber, PsychScreenSettingsType *settings);
psych_bool PsychSetScreenSettings(psych_bool cacheSettings, PsychScreenSettingsType *settings);
psych_bool PsychRestoreScreenSettings(int screenNumber);
void PsychHideCursor(int screenNumber, int deviceIdx);
void PsychShowCursor(int screenNumber, int deviceIdx);
void PsychPositionCursor(int screenNumber, int x, int y, int deviceIdx);
void PsychReadNormalizedGammaTable(int screenNumber, int outputId, int *numEntries, float **redTable, float **greenTable, float **blueTable);
unsigned int PsychLoadNormalizedGammaTable(int screenNumber, int outputId, int numEntries, float *redTable, float *greenTable, float *blueTable);
int PsychGetDisplayBeamPosition(CGDirectDisplayID cgDisplayId, int screenNumber);
PsychError PsychOSSynchronizeDisplayScreens(int *numScreens, int* screenIds, int* residuals, unsigned int syncMethod, double syncTimeOut, int allowedResidual);
void PsychOSShutdownPsychtoolboxKernelDriverInterface(void);
unsigned int PsychOSKDReadRegister(int screenId, unsigned int offset, unsigned int* status);
unsigned int PsychOSKDWriteRegister(int screenId, unsigned int offset, unsigned int value, unsigned int* status);
int PsychOSKDGetBeamposition(int screenId);
psych_bool PsychOSIsKernelDriverAvailable(int screenId);
void PsychOSKDSetDitherMode(int screenId, unsigned int ditherOn);
unsigned int PsychOSKDLoadIdentityLUT(int screenId, unsigned int headId);
unsigned int PsychOSKDGetLUTState(int screenId, unsigned int headId, unsigned int debug);
int PsychOSIsDWMEnabled(int screenNumber);
// Internal helper routines for memory mapped gfx-hardware register low level access: Called
// from PsychWindowGlue.c PsychOSOpenOnscreenWindow() and PsychOSCloseOnscreenWindow() routines
// to setup and tear-down memory mappings...
psych_bool PsychScreenMapRadeonCntlMemory(void);
void PsychScreenUnmapDeviceMemory(void);
// Locking of XLib calls et al.:
void PsychLockDisplay(void);
void PsychUnlockDisplay(void);
// Linux only: Retrieve modeline and crtc_info for a specific output on a specific screen:
XRRModeInfo* PsychOSGetModeLine(int screenId, int outputIdx, XRRCrtcInfo **crtc);
double PsychOSVRefreshFromMode(XRRModeInfo *mode);
int PsychOSSetOutputConfig(int screenNumber, int outputId, int newWidth, int newHeight, int newHz, int newX, int newY);
const char* PsychOSGetOutputProps(int screenId, int outputIdx, psych_bool returnDisabledOutputs, unsigned long *mm_width, unsigned long *mm_height, unsigned long *rrOutputPrimary);
// Calls XDefineCursor() or XIDefineCursor(..., deviceId, ...), setting cursor of all onscreen windows to 'cursor':
void PsychOSDefineX11Cursor(int screenNumber, int deviceId, Cursor cursor);
void PsychOSDefineWaylandCursor(int screenNumber, int deviceId, const char* cursorName);
// Is X-Screen primary gpu driver the modesetting ddx?
psych_bool PsychOSX11ScreenUsesModesettingDDX(int screenId);
// Return identifying information about GPU for a given screen screenNumber:
psych_bool PsychGetGPUSpecs(int screenNumber, int* gpuMaintype, int* gpuMinortype, int* pciDeviceId, int* numDisplayHeads);
// Wayland backend specific stuff:
psych_bool PsychWaylandGetKeyboardState(int deviceId, int numKeys, PsychNativeBooleanType *buttonStates, double *timeStamp);
psych_bool PsychWaylandGetMouseState(int deviceId, int *mouseX, int *mouseY, int numButtons, double *buttonArray, void** focusWindow);
psych_bool PsychWaylandGetKbNames(PsychGenericScriptType *kbNames);
psych_bool PsychWaylandProfilingInhibit(int screenNumber, psych_bool enableInhibit);
//end include once
#endif
|
