|
G3D::Win32Window Class Reference#include <Win32Window.h>
Inherits G3D::GWindow.
Constructor & Destructor Documentation
Finds the closest match to the desired GWindowSettings. The width and height fields always refer to full-screen resolution. Only width, height, rgbBits, alphaBits, depthBits, stencilBits, fsaaSamples, stereo and refreshRate are valid.
Member Function Documentation
The HDC should be a private CS_OWNDC device context because it is assumed to be perisistant.
Different subclasses will be returned depending on whether DirectInput8 is available. You must delete the window returned when you are done with it.
Subclasses should call from their idle function.
Inserts an event into the queue.
Description of the windowing API for logging purposes (e.g. "1.2.7" for SDL 1.2.7). Implements G3D::GWindow.
Clears the files array and then sets it to a list of all files that were dropped in the last GEventType::FILE_DROP event.
Implements G3D::GWindow.
Returns the state of the given joystick. Not all sticks support all buttons and axes and frequently the state of one stick overlaps the state of another. An asserition fails if stickNum > numJoysticks(). Joystick axes are normalized to the range [-1, 1] (but might not be calibrated...). Joystick axes should be in the starting order: X, Y, Z, Slider1, Slider2, rX, rY, rZ Implements G3D::GWindow.
Implements G3D::GWindow.
Implements G3D::GWindow.
Returns the current mouse position and the state of the mouse buttons. It is essential to sample both simultaneously so that the mouse has not moved from the location where a click occurred.
Implements G3D::GWindow.
Return the actual properties of this window (as opposed to the desired settings from which it was initialized).
Implements G3D::GWindow.
Returns true if this window currently has [keyboard] focus (i.e. is in the foreground, not minimized, recieves keystrokes.) Implements G3D::GWindow.
Implements G3D::GWindow.
If the count is 1 or greater, then the keyboard and mouse focus is captured, locking the mouse to the client area of this window. The use of a count instead of an explicit capture/release API allows multiple parts of a program to capture input without accidentally releasing and enclosing capture.
Makes the OpenGL context of this window current. If you have multiple windows, call this before rendering to one of them. beta
If the count is 1 or greater, then the keyboard and mouse focus is captured, locking the mouse to the client area of this window. The use of a count instead of an explicit capture/release API allows multiple parts of a program to capture input without accidentally releasing and enclosing capture.
Notifies the window that it has been resized (called by RenderDevice::notifyResize). Some window systems (e.g. SDL) need explicit notification in this form when a resize event comes in. Must not destroy the underlying OpenGL context (i.e. textures, vertex buffers, and GPU programs must be preserved across calls). Implements G3D::GWindow.
Checks to see if any events are waiting. If there is an event, returns true and fills out the GEvent structure. Otherwise returns false. The caller is responsible for invoking GWindow::notifyResize with any resize events; the GWindow does not notify itself.
Pops a loop body off the stack. If the loop body was a GApplet, invokes GApplet::endRun on it. If the loop body was a GApp2, invokes GApp2::endRun on it.
Invokes GApplet::beginRun after the applet is on the stack.
Pushes a function onto the stack of functions called by runMainLoop.
Override this with the glMakeCurrent call appropriate for your window.
Reimplemented from G3D::GWindow.
If a RenderDevice has been created and initialized for this window, returns that renderDevice. Otherwise returns NULL.
Windows for which this is true require a program to hand control of the main loop to GWindow::startMainLoop. The program's functionality may then be implemented through the "loop body" function. That is, if requiresMainLoop returns true, you must use the following structure:
void doEvents() {
GEvent e;
while (window->pollEvent(e)) {
... // Event handling
}
}
void doGraphics() {
renderDevice->beginFrame();
renderDevice->clear(true, true, true);
... // draw stuff
renderDevice->endFrame();
}
void loopBody(void*) {
all per-frame code; event-handling, physics, networking, AI, etc.
doEvents();
doLogic();
doNetwork();
doAI();
doGraphics();
To end the program, invoke window->popLoopBody
}
window->pushLoopBody(callback, NULL);
window->runMainLoop(); // doesn't return
When requiresMainLoop returns false, you may use either the above structure or the following one (which puts you in more control of when graphics vs. other code is executed):
while (true) {
doEvents();
doLogic();
doNetwork();
doAI();
doGraphics();
}
This design is necessary because some underlying Window APIs (e.g. ActiveX, GLUT) enforce an event-driven structure. Reimplemented from G3D::GWindow.
Executes an event loop, invoking callback repeatedly. Put everything that you want to execute once per frame into the callback function. It is guaranteed safe to call pollEvents and all other GWindow methods from the callback function. The default implementation (for requiresMainLoop() == false GWindows) just calls the callback continuously. Subclasses should use the notDone() and executeLoopBody() functions.
Implements G3D::GWindow.
Fails silently if unable to change the dimensions. The value returned by getSettings will not change immediately-- it waits for a notifyResize call. Implements G3D::GWindow.
Set the icon (if supported). Fails silently if not supported or the window has no frame. May also fail if the GWindow implementation's underlying GUI library is too limited.
Reimplemented from G3D::GWindow.
Capture the keyboard and mouse focus, locking the mouse to the client area of this window. Sets the inputCaptureCount to 1 if c is true and 0 if c is false
Implements G3D::GWindow.
Fails silently if unable to change the position. Sets the window (not client) position. Implements G3D::GWindow.
Implements G3D::GWindow.
Measured in pixels, this is the client area of the window. Returns the same width as getSettings and dimensions(). Convenience method for users. Implements G3D::GWindow.
Friends And Related Function Documentation
Member Data Documentation
The documentation for this class was generated from the following file: Generated on Thu Aug 2 11:40:48 2007 for G3D by 
1.5.2
Hosted by | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||