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
|
/****************************************************************************
*
* MegaGraph Graphics Library
*
* Copyright (C) 1996 SciTech Software.
* All rights reserved.
*
* Filename: $Workfile: mglwin.h $
* Version: $Revision: 1.14 $
*
* Language: ANSI C
* Environment: IBM PC (MS DOS)
*
* Description: Header file for the MGLWIN bindings for MS Windows using
* WinG in a window and WinDirect for full screen. The MGLWIN
* binding only targets Win32 applications, so cannot be used
* for 16 bit Windows development.
*
* $Date: 14 Mar 1997 16:09:34 $ $Author: KendallB $
*
****************************************************************************/
#ifndef __MGLWIN_H
#define __MGLWIN_H
#ifndef MGLWIN
#define MGLWIN
#endif
/*---------------------- Macros and type definitions ----------------------*/
typedef HWND MGL_HWND;
typedef HDC MGL_HDC;
typedef HINSTANCE MGL_HINSTANCE;
/*------------------------- Function Prototypes ---------------------------*/
#ifdef __cplusplus
extern "C" { /* Use "C" linkage when in C++ mode */
#endif
/* Initialise the MGL for fullscreen output */
bool MGLAPI MGL_init(m_int *driver,m_int *mode,const char *mglpath);
/* Initialise the MGL just for Windowed output, not full screen */
bool MGLAPI MGL_initWindowed(const char *mglpath);
/* Function to register a fullscreen window with the MGL. If you wish
* for the MGL to use your own window for fullscreen modes, you can
* register it with this function. Note that when the MGL goes into
* fullscreen modes, the attributes, size and position of the window are
* modified to make it into a fullscreen Window necessary to cover the
* entire desktop, and the state of the window will be restore to the original
* format on return to normal GDI mode.
*
* Note that if you are using a common window for Windowed mode and fullscreen
* modes of your application, you will need to ensure that certain messages
* that you window normally handles in windowed modes are ignored when in
* fullscreen modes.
*/
void MGLAPI MGL_registerFullScreenWindow(HWND hwndFullScreen);
/* Function to register a fullscreen event handling window procedure.
* If you wish to do your own event handling, you can register your window
* procedure with the MGL using this function and it will be called
* when there are messages to be handled. You can still call the MGL_event()
* functions even if you have registered an event handling procedure.
*/
void MGLAPI MGL_registerEventProc(WNDPROC userWndProc);
/* Change the active display mode. You must destroy all display device
* contexts before calling this function, and re-create them again with
* the new display mode. Does not affect any event handling hooks.
*/
bool MGLAPI MGL_changeDisplayMode(m_int mode);
/* Obtain the handle to the MGL fullscreen window when in fullscreen modes */
MGL_HWND MGLAPI MGL_getFullScreenWindow(void);
/* Tell the MGL what your applications main window is */
void MGLAPI MGL_setMainWindow(MGL_HWND hwnd);
/* Tell the MGL your applications instance handle (call before all funcs!) */
void MGLAPI MGL_setAppInstance(MGL_HINSTANCE hInstApp);
/* Device context management */
MGLDC * MGLAPI MGL_createDisplayDC(m_int numBuffers);
MGLDC * MGLAPI MGL_createSrollingDC(m_int virtualX,m_int virtualY,m_int numBuffers);
MGLDC * MGLAPI MGL_createOffscreenDC(void);
MGLDC * MGLAPI MGL_createLinearOffscreenDC(void);
MGLDC * MGLAPI MGL_createWindowedDC(MGL_HWND hwnd);
MGLDC * MGLAPI MGL_createMemoryDC(m_int xSize,m_int ySize,m_int bitsPerPixel,pixel_format_t *pf);
bool MGLAPI MGL_destroyDC(MGLDC *dc);
/* Get a Windows HDC for the MGL device context. You can use this returned
* HDC to get GDI to draw to the device context surface, such as rendering
* and using TrueType fonts with the MGL. If a Windows compatible HDC is not
* available, this function will return NULL.
*/
HDC MGLAPI MGL_getWinDC(MGLDC *dc);
/* Associate a Window manager DC with the MGLDC for painting */
bool MGLAPI MGL_setWinDC(MGLDC *dc,MGL_HDC hdc);
/* Activate the WindowDC's palette */
bool MGLAPI MGL_activatePalette(MGLDC *dc,bool unrealize);
/* Let the MGL know when your application is being activated or deactivated.
* This function only needs to be called when running in Windowed modes and
* you have set the system palette to SYSPAL_NOSTATIC mode, to ensure
* that the MGL can properly re-map your application palette when your
* app is not active and allow Windows to re-map your bitmap colors on the
* fly. This function should be passed a pointer to the currently active
* MGL Windowed DC and a flag to indicate whether the app is in the background
* or not.
*/
void MGLAPI MGL_appActivate(MGLDC *winDC,bool active);
/* Generic helper functions */
ulong MGLAPI MGL_getTicks(void);
ulong MGLAPI MGL_getTickResolution(void);
void MGLAPI MGL_delay(m_int millseconds);
void MGLAPI MGL_beep(m_int freq,m_int milliseconds);
/* Fullscreen specific routines */
void MGLAPI MGL_setPaletteSnowLevel(MGLDC *dc,m_int level);
m_int MGLAPI MGL_getPaletteSnowLevel(MGLDC *dc);
/* Determine if a specific scancode'ed key is held down (PC specific) */
bool MGLAPI EVT_isKeyDown(uchar scanCode);
#ifdef __cplusplus
} /* End of "C" linkage for C++ */
#endif
#endif /* __MGLWIN_H */
|
