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
154
155
156
157
158
159
160
161
162
163
|
/* BrightSideCore.cpp -- Source code of the BrightSideCore.dll
* Matlab MEX file.
*
* BrightSideCore.dll is the low-level interface to BrightSide Technologies
* core libraries. It is usually called by the high-level Psychtoolbox Matlab
* M-File BrightSideHDR.m
*
* Build instructions:
* 1. Change into the Psychtoolbox/PsychHardware/BrightSideDisplay folder.
* 2. mex -v -g -output BrightSideCore -IBSRuntimeLibs\outputlib\include BSRuntimeLibs\outputlib\lib\GL_OutputLibrary.lib BrightSideCore.cpp
*
* Requires:
* - A recent C++ compiler to handle the complex templates in the BrightSide libraries.
* - The BrightSide SDK and runtimes to be installed in the BSRuntimeLibs subfolder,
* see the Contents.m file in that folder for more info.
*
* Written 2006 by Mario Kleiner - MPI for Biological Cybernetics, Tuebingen, Germany
* and Oguz Ahmet Akyuz - Department of Computer Science, University of Central Florida.
*
* This file is licensed to you under the GNU General Public License. See the
* License.txt file in the Psychtoolbox root folder.
*/
// Matlab MEX-API definition:
#include "mex.h"
// Standard system includes:
#include <stdlib.h>
#include <stdio.h>
// Need windows.h for definition of wglGetProcAddress():
#include <windows.h>
// Include the BrightSide core library header:
#include "GLOutputLibrary.h"
// A simple shortcut:
#define DCGI DisplayController::GetInstance()
// Definition of function pointer to dynamically bound GL function glClampColorARB:
typedef void (*PROCglBSClampColorARB)(int, int);
PROCglBSClampColorARB glBSClampColorARB=NULL;
// Main entry point and interface to Matlab, our main() routine:
void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray*prhs[])
{
int cmd;
static int debuglevel = 0;
char basepath[FILENAME_MAX];
char configname[FILENAME_MAX];
GLboolean enabled;
// Child protection:
if (nlhs>0) mexErrMsgTxt("BrightSideCore: Superfluous return argument provided!\n");
if (nrhs<1) mexErrMsgTxt("BrightSideCore: Missing command code!\n");
if (!mxIsDouble(prhs[0])) mexErrMsgTxt("BrightSideCore: Invalid (non-int) command code!\n");
// Retrieve command code:
cmd = (int) mxGetScalar(prhs[0]);
// Dispatch:
switch(cmd) {
case -1: // Dummy init. Do nothing. This is just to force dynamic loading and linking of
// the MEX file, and to set the debuglevel, if provided.
if (nrhs>1 && mxIsDouble(prhs[1])) debuglevel = (int) mxGetScalar(prhs[1]);
if (debuglevel>0) mexPrintf("BrightSideCore: Loaded.\n");
break;
case 0: // Initialization of HDR core library.
if (debuglevel>0) mexPrintf("BrightSideCore: Starting up...\n");
if (nrhs<3 || !mxIsChar(prhs[1]) || !mxIsChar(prhs[2])) {
mexErrMsgTxt("BrightSideCore: Missing or invalid basepath or name for config file!\n");
}
// Retrieve path and config file name:
mxGetString(prhs[1], basepath, sizeof(basepath));
mxGetString(prhs[2], configname, sizeof(basepath));
// Initialize Brightside display controller and core library:
// BrightSide::DCGI.Initialize( "../", "DR-37P-beta.xml" );
BrightSide::DCGI.Initialize(basepath, configname);
if (debuglevel>0) mexPrintf("BrightSideCore: Initialize done...\n");
// Try to bind the glClampColorARB command, so we can disable color clamping in the GL pipeline:
glBSClampColorARB = (PROCglBSClampColorARB) wglGetProcAddress("glClampColorARB");
if (glBSClampColorARB) {
if (debuglevel>0) mexPrintf("BrightSideCore: glClampColorARB bound, color clamping in whole pipeline controllable.\n");
}
else {
// This is not good! The GL clamps colors to range 0-1 in various stages of the pipeline! One needs to explicitely
// use special fragment shaders to work around this :(
mexPrintf("BrightSideCore: WARNING! Could not bind glClampColorARB. Pipeline clamps colors to output range [0;1]!!\n");
}
// Ready!
break;
case 1: // Shutdown of HDR core library.
if (debuglevel>0) mexPrintf("BrightSideCore: Shutdown request...\n");
BrightSide::DCGI.Unload();
break;
case 2: // Convert & Blit request to library:
if (debuglevel>0) mexPrintf("BrightSideCore: Conversion blit request... %p", BrightSide::DCGI);
BrightSide::DCGI.Display();
if (debuglevel>0) mexPrintf("...Done.\n");
break;
case 3: // Change rendersource and target for conversion library:
if (nrhs<3 || !mxIsDouble(prhs[1]) || !mxIsDouble(prhs[2])) {
mexErrMsgTxt("BrightSideCore: Missing or invalid source texid or target fbo id!\n");
}
// When display is called, the texture in tex will be rendered to the given framebuffer:
if (debuglevel>0) mexPrintf("BrightSideCore: Change of render source to %i and target to %i...\n", (unsigned int) mxGetScalar(prhs[1]), (unsigned int) mxGetScalar(prhs[2]));
BrightSide::DCGI.SetInputOutput((unsigned int) mxGetScalar(prhs[1]), (unsigned int) mxGetScalar(prhs[2]));
if (debuglevel>0) mexPrintf("BrightSideCore: Change of render source and target done.\n");
break;
case 4: // Change LED intensity multiplier:
if (debuglevel>0) mexPrintf("BrightSideCore: Change of LED intensity...\n");
if (nrhs<2 || !mxIsDouble(prhs[1])) {
mexErrMsgTxt("BrightSideCore: Missing or invalid LED intensity!\n");
}
// When display is called, the texture in tex will be rendered to the given framebuffer:
BrightSide::DCGI.LEDIntensity((float) mxGetScalar(prhs[1]));
break;
case 5: // Enable or disable clamping in the OpenGL pipeline:
if (debuglevel>0) {
glGetBooleanv(GL_CLAMP_FRAGMENT_COLOR_ARB, &enabled);
mexPrintf("BrightSideCore: Changing OpenGL clamp mode. Previous was %s\n", (enabled) ? "TRUE":"FALSE");
}
if (nrhs<2 || !mxIsDouble(prhs[1])) {
mexErrMsgTxt("BrightSideCore: Missing or invalid clamp parameter!\n");
}
if (glBSClampColorARB) {
// Enable or Disable OpenGL color clamping in all parts of the pipeline: We can use the gl.h header
// constants because this mex file implicitely compiles against it (included somewhere in
// BrightSides header files). GLEW is also included, but not initialized, so we bind the one
// single gl call we need manually for now. Food for thought...
enabled = ((int) mxGetScalar(prhs[1]) > 0) ? GL_TRUE : GL_FALSE;
glBSClampColorARB(GL_CLAMP_VERTEX_COLOR_ARB, enabled);
glBSClampColorARB(GL_CLAMP_FRAGMENT_COLOR_ARB, enabled);
glBSClampColorARB(GL_CLAMP_READ_COLOR_ARB, enabled);
if (debuglevel>0) mexPrintf("BrightSideCore: glClampColorARB bound, color clamping in whole pipeline changed to %s.\n", (enabled) ? "TRUE":"FALSE");
}
break;
default:
mexErrMsgTxt("BrightSideCore: Unknown command code provided!\n");
}
// Done. Return control to Matlab:
return;
}
|
