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
|
/*
PsychToolbox2/Source/Common/WindowHelpers.c
AUTHORS:
Allen.Ingling@nyu.edu awi
PLATFORMS: This file is included for all targets.
PROJECTS:
12/20/02 awi Screen
HISTORY:
12/20/02 awi Wrote it.
04/22/05 mk Bugfix for PsychCheckIfWindowRecordIsValid: Screen('Close', w); Screen('Close', w) caused crash due to NULL-Ptr deref.
DESCRIPTION:
Convenience functions for extracting properties of windows from a window index or from a window record pointer.
Sometimes doing that is a hassle because the properties of the window are actually properties of the associeate screen
structure, hence we provide these conveience functions.
TO DO:
-fix Onscreen Windows so that the depth is valid and remove the conditional from
PsychGetWindowDepthValueFromWindowRecord()
*/
#include "Screen.h"
/*
PsychGetColorSizeFromWindowRecord()
Accepts a windows records and return the size in bits of a color plane. This assumes that all color planes have the same size.
We might have to augment this to account for situations when this is not true.
*/
int PsychGetColorSizeFromWindowRecord(PsychWindowRecordType *windowRecord)
{
PsychErrorExitMsg(PsychError_internal, "PsychGetColorSizeFromWindowRecord not implemented!!!");
}
int PsychGetWindowDepthValueFromWindowRecord(PsychWindowRecordType *windowRecord)
{
if(PsychIsOnscreenWindow(windowRecord))
return(PsychGetScreenDepthValue(windowRecord->screenNumber));
else if(PsychIsOffscreenWindow(windowRecord))
return(windowRecord->depth);
else{
PsychErrorExit(PsychError_internal);
return(0); //makes the compiler happy
}
}
void PsychGetRectFromWindowRecord(double *rect, PsychWindowRecordType *windowRecord)
{
PsychCopyRect(rect, windowRecord->clientrect);
}
int PsychGetNumPlanesFromWindowRecord(PsychWindowRecordType *windowRecord)
{
return(windowRecord->nrchannels);
}
int PsychGetNumBuffersFromWindowRecord(PsychWindowRecordType *windowRecord)
{
if(windowRecord->windowType==kPsychSingleBufferOnscreen)
return(1);
else if(windowRecord->windowType==kPsychDoubleBufferOnscreen)
return(2);
else if(windowRecord->windowType==kPsychVideoMemoryOffscreen)
return(1);
else if(windowRecord->windowType==kPsychSystemMemoryOffscreen)
return(1);
else{
PsychErrorExitMsg(PsychError_internal, "illegitimate buffer type");
return(0); //make the compiler happy
}
}
void PsychSetWindowRecordValid(PsychWindowRecordType *winRec)
{
winRec->isValid=TRUE;
}
void PsychCheckIfWindowRecordIsValid(PsychWindowRecordType *winRec)
{
// MK: Added check for winRec==NULL.
if(winRec==NULL || !winRec->isValid)
PsychErrorExit(PsychError_InvalidWindowRecord);
}
psych_bool PsychIsOnscreenWindow(PsychWindowRecordType *windowRecord)
{
return(windowRecord->windowType==kPsychSingleBufferOnscreen || windowRecord->windowType==kPsychDoubleBufferOnscreen);
}
/*
PsychIsMatlabOnscreenWindow()
stand-in for actual detection; No window records will are Matlab windows until we provide a way to
grab those, therefore return FALSE.
*/
psych_bool PsychIsMatlabOnscreenWindow(PsychWindowRecordType *windowRecord)
{
return(FALSE);
}
psych_bool PsychIsOffscreenWindow(PsychWindowRecordType *windowRecord)
{
return(windowRecord->windowType==kPsychVideoMemoryOffscreen || windowRecord->windowType==kPsychSystemMemoryOffscreen ||
windowRecord->windowType==kPsychTexture);
}
psych_bool PsychIsTexture(PsychWindowRecordType *windowRecord)
{
return(windowRecord->windowType==kPsychTexture);
}
void PsychSetTextColorInWindowRecord(PsychColorType *textColor, PsychWindowRecordType *winRec)
{
memcpy(&(winRec->textAttributes.textColor), textColor, sizeof(PsychColorType));
PsychCoerceColorMode(&(winRec->textAttributes.textColor));
}
void PsychSetTextBackgroundColorInWindowRecord(PsychColorType *textBackgroundColor, PsychWindowRecordType *winRec)
{
memcpy(&(winRec->textAttributes.textBackgroundColor), textBackgroundColor, sizeof(PsychColorType));
PsychCoerceColorMode(&(winRec->textAttributes.textBackgroundColor));
}
int PsychGetDepthFromWindowRecord(PsychWindowRecordType *winRec)
{
return(winRec->depth);
}
|
