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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
|
/****************************************************************************
*
* SciTech Nucleus Graphics Architecture
*
* Copyright (C) 1991-1998 SciTech Software, Inc.
* All rights reserved.
*
* ======================================================================
* |REMOVAL OR MODIFICATION OF THIS HEADER IS STRICTLY PROHIBITED BY LAW|
* | |
* |This copyrighted computer code contains proprietary technology |
* |owned by SciTech Software, Inc., located at 505 Wall Street, |
* |Chico, CA 95928 USA (http://www.scitechsoft.com). |
* | |
* |The contents of this file are subject to the SciTech Nucleus |
* |License; you may *not* use this file or related software except in |
* |compliance with the License. You may obtain a copy of the License |
* |at http://www.scitechsoft.com/nucleus-license.txt |
* | |
* |Software distributed under the License is distributed on an |
* |"AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or |
* |implied. See the License for the specific language governing |
* |rights and limitations under the License. |
* | |
* |REMOVAL OR MODIFICATION OF THIS HEADER IS STRICTLY PROHIBITED BY LAW|
* ======================================================================
*
* Language: ANSI C
* Environment: Any 32-bit protected mode environment
*
* Description: C module for the Graphics Accelerator Driver API. Uses
* the SciTech PM library for interfacing with DOS
* extender specific functions.
*
****************************************************************************/
#include "nucleus/graphics.h"
#if defined(__WIN32_VXD__) || defined(__NT_DRIVER__)
#include "sdd/sddhelp.h"
#else
#include <stdio.h>
#include <stdlib.h>
#endif
/*---------------------------- Global Variables ---------------------------*/
#ifndef TEST_HARNESS
GA_exports _VARAPI __GA_exports;
static int loaded = false;
static PE_MODULE *hModBPD = NULL;
static N_imports _N_imports = {
sizeof(N_imports),
_OS_delay,
};
static GA_imports _GA_imports = {
sizeof(GA_imports),
GA_getSharedInfo,
GA_TimerInit,
GA_TimerRead,
GA_TimerDifference,
};
#endif
/*----------------------------- Implementation ----------------------------*/
#define DLL_NAME "graphics.bpd"
/****************************************************************************
REMARKS:
This function is no longer used but we must implement it and return NULL
for compatibility with older binary drivers.
****************************************************************************/
GA_sharedInfo * NAPI GA_getSharedInfo(
int device)
{
return NULL;
}
#ifndef TEST_HARNESS
/****************************************************************************
REMARKS:
Fatal error handler for non-exported GA_exports.
****************************************************************************/
static void _GA_fatalErrorHandler(void)
{
PM_fatalError("Unsupported Nucleus export function called! Please upgrade your copy of Nucleus!\n");
}
/****************************************************************************
PARAMETERS:
shared - True to load the driver into shared memory.
REMARKS:
Loads the Nucleus binary portable DLL into memory and initilises it.
****************************************************************************/
static ibool LoadDriver(
ibool shared)
{
GA_initLibrary_t GA_initLibrary;
GA_exports *gaExp;
char filename[PM_MAX_PATH];
char bpdpath[PM_MAX_PATH];
int i,max;
ulong *p;
/* Check if we have already loaded the driver */
if (loaded)
return true;
PM_init();
/* First try to see if we can find the system wide shared exports
* if they are available. Under OS/2 this connects to our global
* shared Nucleus loader in SDDPMI.DLL.
*/
__GA_exports.dwSize = sizeof(__GA_exports);
if (GA_getSharedExports(&__GA_exports,shared))
return loaded = true;
/* Open the BPD file */
if (!PM_findBPD(DLL_NAME,bpdpath))
return false;
strcpy(filename,bpdpath);
strcat(filename,DLL_NAME);
if ((hModBPD = PE_loadLibrary(filename,shared)) == NULL)
return false;
if ((GA_initLibrary = (GA_initLibrary_t)PE_getProcAddress(hModBPD,"_GA_initLibrary")) == NULL)
return false;
bpdpath[strlen(bpdpath)-1] = 0;
if (strcmp(bpdpath,PM_getNucleusPath()) == 0)
strcpy(bpdpath,PM_getNucleusConfigPath());
else {
PM_backslash(bpdpath);
strcat(bpdpath,"config");
}
if ((gaExp = GA_initLibrary(shared,bpdpath,filename,GA_getSystemPMImports(),&_N_imports,&_GA_imports)) == NULL)
PM_fatalError("GA_initLibrary failed!\n");
/* Initialize all default imports to point to fatal error handler
* for upwards compatibility, and copy the exported functions.
*/
max = sizeof(__GA_exports)/sizeof(GA_initLibrary_t);
for (i = 0,p = (ulong*)&__GA_exports; i < max; i++)
*p++ = (ulong)_GA_fatalErrorHandler;
memcpy(&__GA_exports,gaExp,MIN(sizeof(__GA_exports),gaExp->dwSize));
loaded = true;
return true;
}
/* The following are stub entry points that the application calls to
* initialise the Nucleus loader library, and we use this to load our
* driver DLL from disk and initialise the library using it.
*/
/* {secret} */
int NAPI GA_status(void)
{
if (!loaded)
return nDriverNotFound;
return __GA_exports.GA_status();
}
/* {secret} */
const char * NAPI GA_errorMsg(
N_int32 status)
{
if (!loaded)
return "Unable to load Nucleus device driver!";
return __GA_exports.GA_errorMsg(status);
}
/* {secret} */
int NAPI GA_getDaysLeft(N_int32 shared)
{
if (!LoadDriver(shared))
return -1;
return __GA_exports.GA_getDaysLeft(shared);
}
/* {secret} */
int NAPI GA_registerLicense(uchar *license,N_int32 shared)
{
if (!LoadDriver(shared))
return 0;
return __GA_exports.GA_registerLicense(license,shared);
}
/* {secret} */
ibool NAPI GA_loadInGUI(N_int32 shared)
{
if (!LoadDriver(shared))
return false;
return __GA_exports.GA_loadInGUI(shared);
}
/* {secret} */
int NAPI GA_enumerateDevices(N_int32 shared)
{
if (!LoadDriver(shared))
return 0;
return __GA_exports.GA_enumerateDevices(shared);
}
/* {secret} */
GA_devCtx * NAPI GA_loadDriver(N_int32 deviceIndex,N_int32 shared)
{
if (!LoadDriver(shared))
return NULL;
return __GA_exports.GA_loadDriver(deviceIndex,shared);
}
/* {secret} */
void NAPI GA_getGlobalOptions(
GA_globalOptions *options,
ibool shared)
{
if (LoadDriver(shared))
__GA_exports.GA_getGlobalOptions(options,shared);
}
/* {secret} */
PE_MODULE * NAPI GA_loadLibrary(
const char *szBPDName,
ulong *size,
ibool shared)
{
if (!LoadDriver(shared))
return NULL;
return __GA_exports.GA_loadLibrary(szBPDName,size,shared);
}
/* {secret} */
GA_devCtx * NAPI GA_getCurrentDriver(
N_int32 deviceIndex)
{
/* Bail for older drivers that didn't export this function! */
if (!__GA_exports.GA_getCurrentDriver)
return NULL;
return __GA_exports.GA_getCurrentDriver(deviceIndex);
}
/* {secret} */
REF2D_driver * NAPI GA_getCurrentRef2d(
N_int32 deviceIndex)
{
/* Bail for older drivers that didn't export this function! */
if (!__GA_exports.GA_getCurrentRef2d)
return NULL;
return __GA_exports.GA_getCurrentRef2d(deviceIndex);
}
/* {secret} */
int NAPI GA_isOEMVersion(ibool shared)
{
if (!LoadDriver(shared))
return 0;
return __GA_exports.GA_isOEMVersion(shared);
}
/* {secret} */
N_uint32 * NAPI GA_getLicensedDevices(ibool shared)
{
if (!LoadDriver(shared))
return 0;
return __GA_exports.GA_getLicensedDevices(shared);
}
#endif
|