#region License
//
// The Open Toolkit Library License
//
// Copyright (c) 2006 - 2009 the Open Toolkit library.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights to
// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
// the Software, and to permit persons to whom the Software is furnished to do
// so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
// OTHER DEALINGS IN THE SOFTWARE.
//
#endregion
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Diagnostics;
using System.Threading;
using OpenTK.Graphics;
using OpenTK.Input;
using OpenTK.Platform;
using System.Drawing;
namespace OpenTK
{
///
/// The GameWindow class contains cross-platform methods to create and render on an OpenGL
/// window, handle input and load resources.
///
///
/// GameWindow contains several events you can hook or override to add your custom logic:
///
/// -
/// OnLoad: Occurs after creating the OpenGL context, but before entering the main loop.
/// Override to load resources.
///
/// -
/// OnUnload: Occurs after exiting the main loop, but before deleting the OpenGL context.
/// Override to unload resources.
///
/// -
/// OnResize: Occurs whenever GameWindow is resized. You should update the OpenGL Viewport
/// and Projection Matrix here.
///
/// -
/// OnUpdateFrame: Occurs at the specified logic update rate. Override to add your game
/// logic.
///
/// -
/// OnRenderFrame: Occurs at the specified frame render rate. Override to add your
/// rendering code.
///
///
/// Call the Run() method to start the application's main loop. Run(double, double) takes two
/// parameters that
/// specify the logic update rate, and the render update rate.
///
public class GameWindow : IGameWindow
{
#region --- Fields ---
INativeWindow glWindow;
//DisplayMode mode;
bool isExiting = false;
bool hasMainLoop;
bool disposed;
double update_period, render_period;
double target_update_period, target_render_period;
// TODO: Implement these:
double update_time, render_time;//, event_time;
//bool allow_sleep = true; // If true, GameWindow will call Timer.Sleep() if there is enough time.
VSyncMode vsync;
//InputDriver input_driver;
IGraphicsContext glContext;
int main_loop_thread_id;
object exit_lock = new object();
#endregion
#region --- Contructors ---
#region public GameWindow()
/// Constructs a new GameWindow with sensible default attributes..
public GameWindow()
: this(640, 480, GraphicsMode.Default, "OpenTK Game Window", 0, DisplayDevice.Default) { }
#endregion
#region public GameWindow(int width, int height)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
public GameWindow(int width, int height)
: this(width, height, GraphicsMode.Default, "OpenTK Game Window", 0, DisplayDevice.Default) { }
#endregion
#region public GameWindow(int width, int height, GraphicsMode mode)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
/// The OpenTK.Graphics.GraphicsMode of the GameWindow.
public GameWindow(int width, int height, GraphicsMode mode)
: this(width, height, mode, "OpenTK Game Window", 0, DisplayDevice.Default) { }
#endregion
#region public GameWindow(int width, int height, GraphicsMode mode, string title)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
/// The OpenTK.Graphics.GraphicsMode of the GameWindow.
/// The title of the GameWindow.
public GameWindow(int width, int height, GraphicsMode mode, string title)
: this(width, height, mode, title, 0, DisplayDevice.Default) { }
#endregion
#region public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
/// The OpenTK.Graphics.GraphicsMode of the GameWindow.
/// The title of the GameWindow.
/// GameWindow options regarding window appearance and behavior.
public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options)
: this(width, height, mode, title, options, DisplayDevice.Default) { }
#endregion
#region public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options, DisplayDevice device)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
/// The OpenTK.Graphics.GraphicsMode of the GameWindow.
/// The title of the GameWindow.
/// GameWindow options regarding window appearance and behavior.
/// The OpenTK.Graphics.DisplayDevice to construct the GameWindow in.
public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options, DisplayDevice device)
: this(width, height, mode, title, options, device, 1, 0, GraphicsContextFlags.Default)
{ }
#endregion
#region public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options, DisplayDevice device, int major, int minor, GraphicsContextFlags flags)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
/// The OpenTK.Graphics.GraphicsMode of the GameWindow.
/// The title of the GameWindow.
/// GameWindow options regarding window appearance and behavior.
/// The OpenTK.Graphics.DisplayDevice to construct the GameWindow in.
/// The major version for the OpenGL GraphicsContext.
/// The minor version for the OpenGL GraphicsContext.
/// The GraphicsContextFlags version for the OpenGL GraphicsContext.
public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options, DisplayDevice device,
int major, int minor, GraphicsContextFlags flags)
: this(width, height, mode, title, options, device, major, minor, flags, null)
{ }
#endregion
#region public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options, DisplayDevice device, int major, int minor, GraphicsContextFlags flags, IGraphicsContext sharedContext)
/// Constructs a new GameWindow with the specified attributes.
/// The width of the GameWindow in pixels.
/// The height of the GameWindow in pixels.
/// The OpenTK.Graphics.GraphicsMode of the GameWindow.
/// The title of the GameWindow.
/// GameWindow options regarding window appearance and behavior.
/// The OpenTK.Graphics.DisplayDevice to construct the GameWindow in.
/// The major version for the OpenGL GraphicsContext.
/// The minor version for the OpenGL GraphicsContext.
/// The GraphicsContextFlags version for the OpenGL GraphicsContext.
/// An IGraphicsContext to share resources with.
public GameWindow(int width, int height, GraphicsMode mode, string title, GameWindowFlags options, DisplayDevice device,
int major, int minor, GraphicsContextFlags flags, IGraphicsContext sharedContext)
{
if (width <= 0)
throw new ArgumentOutOfRangeException("width", "Must be greater than zero.");
if (height <= 0)
throw new ArgumentOutOfRangeException("height", "Must be greater than zero.");
if (mode == null)
mode = GraphicsMode.Default;
if (device == null)
device = DisplayDevice.Default;
try
{
Rectangle window_bounds = new Rectangle();
window_bounds.X = device.Bounds.Left + (device.Bounds.Width - width) / 2;
window_bounds.Y = device.Bounds.Top + (device.Bounds.Height - height) / 2;
window_bounds.Width = width;
window_bounds.Height = height;
glWindow = Platform.Factory.Default.CreateNativeWindow(
window_bounds.X, window_bounds.Y,
window_bounds.Width, window_bounds.Height,
title, mode, options, device);
glContext = new GraphicsContext(mode, glWindow.WindowInfo, major, minor, flags);
glContext.MakeCurrent(this.WindowInfo);
(glContext as IGraphicsContextInternal).LoadAll();
if ((options & GameWindowFlags.Fullscreen) != 0)
{
device.ChangeResolution(width, height, mode.ColorFormat.BitsPerPixel, 0);
this.WindowState = WindowState.Fullscreen;
}
this.VSync = VSyncMode.On;
glWindow.Move += delegate(object sender, EventArgs e) { OnMoveInternal(e); };
glWindow.Resize += delegate(object sender, EventArgs e) { OnResizeInternal(e); };
glWindow.Closing += delegate(object sender, CancelEventArgs e) { OnClosingInternal(e); };
glWindow.Closed += delegate(object sender, EventArgs e) { OnClosedInternal(e); };
//glWindow.WindowInfoChanged += delegate(object sender, EventArgs e) { OnWindowInfoChangedInternal(e); };
}
catch (Exception e)
{
Debug.Print(e.ToString());
if (glWindow != null)
glWindow.Dispose();
throw;
}
}
#endregion
#endregion
#region --- Private Methods ---
#region void ExitInternal()
// Stops the main loop, if one exists.
void ExitInternal()
{
if (HasMainLoop)
{
throw new GameWindowExitException();
}
}
#region void ExitAsync()
// Gracefully exits the GameWindow. May be called from any thread.
void ExitAsync()
{
HasMainLoop = false;
isExiting = true;
//UpdateFrame += delegate
//{
// ExitInternal();
//};
}
#endregion
#endregion
#region bool MustResize
bool MustResize
{
get { return glWindow.Width != this.Width || glWindow.Height != this.Height; }
}
#endregion
#region bool HasMainLoop
bool HasMainLoop
{
get { return hasMainLoop; }
set { hasMainLoop = value; }
}
#endregion
#region OnMoveInternal
// Calls OnMove and raises the Move event.
void OnMoveInternal(EventArgs e)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
if (!this.Exists || this.IsExiting)
return;
OnMove(e);
if (Move != null)
Move(this, e);
}
#endregion
#region OnResizeInternal
// Calls OnResize and raises the Resize event.
void OnResizeInternal(EventArgs e)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
if (!this.Exists || this.IsExiting)
return;
OnResize(e);
if (Resize != null)
Resize(this, e);
}
#endregion
#region OnClosingInternal
void OnClosingInternal(CancelEventArgs e)
{
OnClosing(e);
if (Closing != null)
Closing(this, e);
if (!e.Cancel)
ExitAsync();
}
#endregion
#region OnClosedInternal
void OnClosedInternal(EventArgs e)
{
OnClosed(e);
if (Closed != null)
Closed(this, e);
}
#endregion
#region OnWindowInfoChangedInternal
void OnWindowInfoChangedInternal(EventArgs e)
{
glContext.MakeCurrent(WindowInfo);
OnWindowInfoChanged(e);
}
#endregion
#region OnUpdateFrameInternal
private void OnUpdateFrameInternal(FrameEventArgs e)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
if (!this.Exists || this.IsExiting)
return;
if (UpdateFrame != null)
UpdateFrame(this, e);
OnUpdateFrame(e);
}
#endregion
#region OnRenderFrameInternal
private void OnRenderFrameInternal(FrameEventArgs e)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
if (!this.Exists || this.IsExiting)
return;
if (RenderFrame != null)
RenderFrame(this, e);
OnRenderFrame(e);
}
#endregion
#endregion
#region --- Protected Members ---
///
/// Called when the GameWindow is moved.
///
/// Not used.
protected virtual void OnMove(EventArgs e)
{ }
///
/// Called when the GameWindow is resized.
///
/// Not used.
protected virtual void OnResize(EventArgs e)
{ }
///
/// Called when the GameWindow is about to close.
///
///
/// The for this event.
/// Set e.Cancel to true in order to stop the GameWindow from closing.
protected virtual void OnClosing(CancelEventArgs e)
{ }
///
/// Called when the GameWindow has closed.
///
/// Not used.
protected virtual void OnClosed(EventArgs e)
{ }
///
/// Called when the WindowInfo for this GameWindow has changed.
///
/// Not used.
protected virtual void OnWindowInfoChanged(EventArgs e)
{ }
#endregion
#region --- Public Members ---
#region public virtual void Exit()
///
/// Gracefully exits the GameWindow. May be called from any thread.
///
///
/// Override if you are not using .
/// If you override this method, place a call to base.Exit(), to ensure proper OpenTK shutdown.
///
public virtual void Exit()
{
lock (exit_lock)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
if (!IsExiting && Exists)
{
CancelEventArgs e = new CancelEventArgs();
OnClosingInternal(e);
if (e.Cancel)
return;
isExiting = true;
if (HasMainLoop)
{
if (main_loop_thread_id == Thread.CurrentThread.ManagedThreadId)
ExitInternal();
else
ExitAsync();
}
}
}
}
#endregion
#region public IGraphicsContext Context
///
/// Returns the opengl IGraphicsContext associated with the current GameWindow.
///
public IGraphicsContext Context
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glContext;
}
}
#endregion
#region public bool Exists
///
/// Gets a value indicating whether a render window exists.
///
public bool Exists
{
get { return glWindow == null ? false : glWindow.Exists; }
}
#endregion
#region public string Text
///
/// Gets or sets the GameWindow title.
///
public string Title
{
get
{
if (disposed) throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Title;
}
set
{
if (disposed) throw new ObjectDisposedException(this.GetType().Name);
glWindow.Title = value;
}
}
#endregion
#region public bool Visible
#if false
///
/// TODO: This property is not implemented
/// Gets or sets a value indicating whether the GameWindow is visible.
///
public bool Visible
{
get
{
throw new NotImplementedException();
//return glWindow.Visible;
}
set
{
throw new NotImplementedException();
//glWindow.Visible = value;
}
}
#endif
#endregion
#region public IWindowInfo WindowInfo
public IWindowInfo WindowInfo
{
get { if (disposed) throw new ObjectDisposedException("GameWindow"); return glWindow.WindowInfo; }
}
#endregion
#region public void Run()
///
/// Enters the game loop of the GameWindow using the maximum update rate.
///
///
public void Run()
{
if (disposed) throw new ObjectDisposedException(this.GetType().Name);
Run(0.0, 0.0);
}
#endregion
#region public void Run(double updateFrequency)
///
/// Enters the game loop of the GameWindow using the specified update rate.
/// maximum possible render frequency.
///
public void Run(double updateRate)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
Run(updateRate, 0.0);
}
#endregion
#region public void Run(double updates_per_second, double frames_per_second)
///
/// Enters the game loop of the GameWindow updating and rendering at the specified frequency.
///
/// The frequency of UpdateFrame events.
/// The frequency of RenderFrame events.
public void Run(double updates_per_second, double frames_per_second)
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
try
{
// Necessary to be here, otherwise Exit() wouldn't work correctly when called inside OnLoad().
hasMainLoop = true;
main_loop_thread_id = Thread.CurrentThread.ManagedThreadId;
if (updates_per_second < 0.0 || updates_per_second > 200.0)
throw new ArgumentOutOfRangeException("updates_per_second", updates_per_second,
"Parameter should be inside the range [0.0, 200.0]");
if (frames_per_second < 0.0 || frames_per_second > 200.0)
throw new ArgumentOutOfRangeException("frames_per_second", frames_per_second,
"Parameter should be inside the range [0.0, 200.0]");
TargetUpdateFrequency = updates_per_second;
TargetRenderFrequency = frames_per_second;
Stopwatch update_watch = new Stopwatch(), render_watch = new Stopwatch();
double time, next_render = 0.0, next_update = 0.0, update_time_counter = 0.0;
int num_updates = 0;
FrameEventArgs update_args = new FrameEventArgs();
FrameEventArgs render_args = new FrameEventArgs();
update_watch.Reset();
render_watch.Reset();
OnLoadInternal(EventArgs.Empty);
OnResizeInternal(EventArgs.Empty);
Debug.Print("Entering main loop.");
while (!IsExiting && HasMainLoop)
{
ProcessEvents();
// Raise UpdateFrame events
time = update_watch.Elapsed.TotalSeconds;
if (time > 1.0)
time = 1.0;
while (next_update - time <= 0.0)
{
next_update = next_update - time + TargetUpdatePeriod;
if (next_update < -1.0) // Cap the maximum time drift, to avoid lengthy catch-up games.
next_update = -1.0;
update_time_counter += time;
++num_updates;
update_watch.Reset();
update_watch.Start();
if (time > 0)
{
update_args.Time = time;
OnUpdateFrameInternal(update_args);
update_time = update_watch.Elapsed.TotalSeconds;
}
if (TargetUpdateFrequency == 0.0)
break;
time = update_watch.Elapsed.TotalSeconds;
next_update -= time;
update_time_counter += time;
// Allow up to 10 frames to be dropped. Prevents the application from hanging
// with very high update frequencies.
if (num_updates >= 10)
break;
}
if (num_updates > 0)
{
update_period = update_time_counter / (double)num_updates;
num_updates = 0;
update_time_counter = 0.0;
}
// Raise RenderFrame event
time = render_watch.Elapsed.TotalSeconds;
if (time > 1.0)
time = 1.0;
double time_left = next_render - time;
if (VSync == VSyncMode.Adaptive)
{
// Check if we have enough time for a vsync
if (TargetRenderPeriod != 0 && RenderTime > 2.0 * TargetRenderPeriod)
Context.VSync = false;
else
Context.VSync = true;
}
if (time_left <= 0.0)
{
next_render = time_left + TargetRenderPeriod;
if (next_render < -1.0) // Cap the maximum time drift, to avoid lengthy catch-up games.
next_render = -1.0;
render_watch.Reset();
render_watch.Start();
if (time > 0)
{
render_period = render_args.Time = time;
OnRenderFrameInternal(render_args);
render_time = render_watch.Elapsed.TotalSeconds;
}
}
}
}
catch (GameWindowExitException)
{
Debug.WriteLine("GameWindowExitException caught - exiting main loop.");
}
finally
{
Debug.Print("Restoring priority.");
Thread.CurrentThread.Priority = ThreadPriority.Normal;
OnUnloadInternal(EventArgs.Empty);
if (Exists)
{
glContext.Dispose();
glContext = null;
glWindow.Dispose();
while (this.Exists)
this.ProcessEvents();
glWindow = null;
}
}
}
#endregion
#region public void ProcessEvents()
///
/// Processes operating system events until the GameWindow becomes idle.
///
///
/// When overriding the default GameWindow game loop (provided by the Run() function)
/// you should call ProcessEvents() to ensure that your GameWindow responds to
/// operating system events.
///
/// Once ProcessEvents() returns, it is time to call update and render the next frame.
///
///
public void ProcessEvents()
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.ProcessEvents();
}
#endregion
#region OnRenderFrame
///
/// Override in derived classes to render a frame.
///
/// Contains information necessary for frame rendering.
///
/// The base implementation (base.OnRenderFrame) is empty, there is no need to call it.
///
protected virtual void OnRenderFrame(FrameEventArgs e)
{
}
///
/// Occurs when it is time to render a frame.
///
public event EventHandler RenderFrame;
#endregion
#region OnUpdateFrame
///
/// Override in derived classes to update a frame.
///
/// Contains information necessary for frame updating.
///
/// The base implementation (base.OnUpdateFrame) is empty, there is no need to call it.
///
protected virtual void OnUpdateFrame(FrameEventArgs e)
{
}
///
/// Occurs when it is time to update a frame.
///
public event EventHandler UpdateFrame;
#endregion
#region OnLoad
///
/// Raises the Load event, and calls the user's OnLoad override.
///
///
private void OnLoadInternal(EventArgs e)
{
Debug.Print("{0}.Load", this.GetType().Name);
Debug.WriteLine(String.Format("OpenGL driver information: {0}, {1}, {2}",
GL.GetString(StringName.Renderer),
GL.GetString(StringName.Vendor),
GL.GetString(StringName.Version)));
OnResizeInternal(EventArgs.Empty);
Load(this, e);
OnLoad(e);
}
///
/// Occurs after establishing an OpenGL context, but before entering the main loop.
/// Override to load resources that should be maintained for the lifetime of the application.
///
/// Not used.
public virtual void OnLoad(EventArgs e)
{
if (disposed) throw new ObjectDisposedException("GameWindow");
}
#endregion
#region OnUnload
///
/// Raises the Unload event, and calls the user's OnUnload override.
///
///
private void OnUnloadInternal(EventArgs e)
{
if (this.Unload != null)
{
this.Unload(this, e);
}
OnUnload(e);
}
///
/// Occurs after after calling GameWindow.Exit, but before destroying the OpenGL context.
/// Override to unload application resources.
///
/// Not used.
public virtual void OnUnload(EventArgs e)
{
if (disposed) throw new ObjectDisposedException("GameWindow");
}
#endregion
#region public bool IsExiting
///
/// Gets a value indicating whether the shutdown sequence has been initiated
/// for this window, by calling GameWindow.Exit() or hitting the 'close' button.
/// If this property is true, it is no longer safe to use any OpenTK.Input or
/// OpenTK.Graphics.OpenGL functions or properties.
///
public bool IsExiting
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return isExiting;
}
}
#endregion
#region public Keyboard Keyboard
///
/// Gets the primary Keyboard device, or null if no Keyboard exists.
///
[Obsolete]
public KeyboardDevice Keyboard
{
get
{
if (InputDriver.Keyboard.Count > 0)
return InputDriver.Keyboard[0];
else
return null;
}
}
#endregion
#region public Mouse Mouse
///
/// Gets the primary Mouse device, or null if no Mouse exists.
///
[Obsolete]
public MouseDevice Mouse
{
get
{
if (InputDriver.Mouse.Count > 0)
return InputDriver.Mouse[0];
else
return null;
}
}
#endregion
#region public IList Joysticks
///
/// Gets a readonly IList containing all available OpenTK.Input.JoystickDevices.
///
[Obsolete]
public IList Joysticks
{
get { return InputDriver.Joysticks; }
}
#endregion
#region public VSyncMode VSync
///
/// Gets or sets the VSyncMode.
///
public VSyncMode VSync
{
get
{
if (disposed)
throw new ObjectDisposedException("GameWindow");
GraphicsContext.Assert();
return vsync;
}
set
{
if (disposed)
throw new ObjectDisposedException("GameWindow");
GraphicsContext.Assert();
if (value == VSyncMode.Off)
Context.VSync = false;
else
Context.VSync = true;
vsync = value;
}
}
#endregion
#region MakeCurrent
///
/// Makes the GraphicsContext current on the calling thread.
///
public void MakeCurrent()
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
Context.MakeCurrent(WindowInfo);
}
#endregion
#region public void SwapBuffers()
///
/// Swaps the front and back buffer, presenting the rendered scene to the user.
///
public void SwapBuffers()
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
this.Context.SwapBuffers();
}
#endregion
#region public WindowState WindowState
///
/// Gets or states the state of the GameWindow.
///
public WindowState WindowState
{
get
{
return glWindow.WindowState;
}
set
{
glWindow.WindowState = value;
}
}
#endregion
#region public WindowBorder WindowBorder
///
/// Gets or states the border of the GameWindow.
///
public WindowBorder WindowBorder
{
get
{
return glWindow.WindowBorder;
}
set
{
glWindow.WindowBorder = value;
}
}
#endregion
#endregion
#region --- INativeWindow Members ---
#region Icon
///
/// Gets or sets the System.Drawing.Icon for this GameWindow.
///
public Icon Icon
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Icon;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Icon = value;
}
}
#endregion
#region Focused
///
/// Gets a System.Boolean that indicates whether this GameWindow has input focus.
///
public bool Focused
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Focused;
}
}
#endregion
#region Visible
///
/// Gets or sets a System.Boolean that indicates whether this GameWindow is visible.
///
public bool Visible
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Visible;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Visible = value;
}
}
#endregion
#region Bounds
///
/// Gets or sets a structure the contains the external bounds of this window, in screen coordinates.
/// External bounds include the title bar, borders and drawing area of the window.
///
public Rectangle Bounds
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Bounds;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Bounds = value;
}
}
#endregion
#region Location
///
/// Gets or sets a structure that contains the location of this window on the desktop.
///
public Point Location
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Location;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Location = value;
}
}
#endregion
#region Size
///
/// Gets or sets a structure that contains the external size of this window.
///
public Size Size
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Size;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Size = value;
}
}
#endregion
#region X
///
/// Gets or sets the horizontal location of this window on the desktop.
///
public int X
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.X;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.X = value;
}
}
#endregion
#region Y
///
/// Gets or sets the vertical location of this window on the desktop.
///
public int Y
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Y;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Y = value;
}
}
#endregion
#region Width
///
/// Gets or sets the external width of this window.
///
public int Width
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Width;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Width = value;
}
}
#endregion
#region Height
///
/// Gets or sets the external height of this window.
///
public int Height
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.Height;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.Height = value;
}
}
#endregion
#region ClientRectangle
///
/// Gets or sets a structure that contains the internal bounds of this window, in client coordinates.
/// The internal bounds include the drawing area of the window, but exclude the titlebar and window borders.
///
public Rectangle ClientRectangle
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.ClientRectangle;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.ClientRectangle = value;
}
}
#endregion
#region ClientSize
///
/// Gets or sets a structure that contains the internal size this window.
///
public Size ClientSize
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.ClientSize;
}
set
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
glWindow.ClientSize = value;
}
}
#endregion
#region InputDriver
[Obsolete]
public IInputDriver InputDriver
{
get
{
if (disposed)
throw new ObjectDisposedException(this.GetType().Name);
return glWindow.InputDriver;
}
}
#endregion
#region Close
public void Close()
{
Exit();
}
#endregion
#region PointToClient
///
/// Transforms the specified point from screen to client coordinates.
///
///
/// A to transform.
///
///
/// The point transformed to client coordinates.
///
public System.Drawing.Point PointToClient(System.Drawing.Point point)
{
return glWindow.PointToClient(point);
}
#endregion
#region PointToScreen
///
/// Transforms the specified point from client to screen coordinates.
///
///
/// A to transform.
///
///
/// The point transformed to screen coordinates.
///
public System.Drawing.Point PointToScreen(System.Drawing.Point p)
{
// Here we use the fact that PointToClient just translates the point, and PointToScreen
// should perform the inverse operation.
System.Drawing.Point trans = PointToClient(System.Drawing.Point.Empty);
p.X -= trans.X;
p.Y -= trans.Y;
return p;
}
#endregion
#region Events
///
/// Occurs before the window is displayed for the first time.
///
public event EventHandler Load = delegate { };
///
/// Occurs before the window is destroyed.
///
public event EventHandler Unload = delegate { };
///
/// Occurs whenever the window is moved.
///
public event EventHandler Move = delegate { };
///
/// Occurs whenever the window is resized.
///
public event EventHandler Resize = delegate { };
///
/// Occurs when the window is about to close.
///
public event EventHandler Closing = delegate { };
///
/// Occurs after the window has closed.
///
public event EventHandler Closed = delegate { };
///
/// Occurs when the window is disposed.
///
public event EventHandler Disposed = delegate { };
///
/// Occurs when the property of the window changes.
///
public event EventHandler IconChanged = delegate { };
///
/// Occurs when the property of the window changes.
///
public event EventHandler TitleChanged = delegate { };
///
/// Occurs when the property of the window changes.
///
public event EventHandler VisibleChanged = delegate { };
///
/// Occurs when the property of the window changes.
///
public event EventHandler FocusedChanged = delegate { };
#endregion
#endregion
#region --- GameWindow Timing ---
// TODO: Disabled because it is not reliable enough. Use vsync as a workaround.
//#region public bool AllowSleep
//public bool AllowSleep
//{
// get { return allow_sleep; }
// set { allow_sleep = value; }
//}
//#endregion
#region public double TargetRenderPeriod
///
/// Gets or sets a double representing the target render period, in seconds.
///
///
/// A value of 0.0 indicates that RenderFrame events are generated at the maximum possible frequency (i.e. only limited by the hardware's capabilities).
/// Values lower than 0.005 seconds (200Hz) are clamped to 0.0. Values higher than 1.0 seconds (1Hz) are clamped to 1.0.
///
public double TargetRenderPeriod
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
return target_render_period;
}
set
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (value <= 0.005)
{
target_render_period = 0.0;
}
else if (value <= 1.0)
{
target_render_period = value;
}
else Debug.Print("Target render period clamped to 1.0 seconds.");
}
}
#endregion
#region public double TargetRenderFrequency
///
/// Gets or sets a double representing the target render frequency, in Herz.
///
///
/// A value of 0.0 indicates that RenderFrame events are generated at the maximum possible frequency (i.e. only limited by the hardware's capabilities).
/// Values lower than 1.0Hz are clamped to 1.0Hz. Values higher than 200.0Hz are clamped to 200.0Hz.
///
public double TargetRenderFrequency
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (TargetRenderPeriod == 0.0)
return 0.0;
return 1.0 / TargetRenderPeriod;
}
set
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (value < 1.0)
{
TargetRenderPeriod = 0.0;
}
else if (value <= 200.0)
{
TargetRenderPeriod = 1.0 / value;
}
else Debug.Print("Target render frequency clamped to 200.0Hz.");
}
}
#endregion
#region public double TargetUpdatePeriod
///
/// Gets or sets a double representing the target update period, in seconds.
///
///
/// A value of 0.0 indicates that UpdateFrame events are generated at the maximum possible frequency (i.e. only limited by the hardware's capabilities).
/// Values lower than 0.005 seconds (200Hz) are clamped to 0.0. Values higher than 1.0 seconds (1Hz) are clamped to 1.0.
///
public double TargetUpdatePeriod
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
return target_update_period;
}
set
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (value <= 0.005)
{
target_update_period = 0.0;
}
else if (value <= 1.0)
{
target_update_period = value;
}
else Debug.Print("Target update period clamped to 1.0 seconds.");
}
}
#endregion
#region public double TargetUpdateFrequency
///
/// Gets or sets a double representing the target update frequency, in Herz.
///
///
/// A value of 0.0 indicates that UpdateFrame events are generated at the maximum possible frequency (i.e. only limited by the hardware's capabilities).
/// Values lower than 1.0Hz are clamped to 1.0Hz. Values higher than 200.0Hz are clamped to 200.0Hz.
///
public double TargetUpdateFrequency
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (TargetUpdatePeriod == 0.0)
return 0.0;
return 1.0 / TargetUpdatePeriod;
}
set
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (value < 1.0)
{
TargetUpdatePeriod = 0.0;
}
else if (value <= 200.0)
{
TargetUpdatePeriod = 1.0 / value;
}
else Debug.Print("Target update frequency clamped to 200.0Hz.");
}
}
#endregion
#region public double RenderFrequency
///
/// Gets a double representing the actual frequency of RenderFrame events, in Herz (i.e. FPS or Frames Per Second).
///
public double RenderFrequency
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (render_period == 0.0)
return 1.0;
return 1.0 / render_period;
}
}
#endregion
#region public double RenderPeriod
///
/// Gets a double representing the period of RenderFrame events, in seconds.
///
public double RenderPeriod
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
return render_period;
}
}
#endregion
#region public double UpdateFrequency
///
/// Gets a double representing the frequency of UpdateFrame events, in Herz.
///
public double UpdateFrequency
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
if (update_period == 0.0)
return 1.0;
return 1.0 / update_period;
}
}
#endregion
#region public double UpdatePeriod
///
/// Gets a double representing the period of UpdateFrame events, in seconds.
///
public double UpdatePeriod
{
get
{
if (disposed) throw new ObjectDisposedException("GameWindow");
return update_period;
}
}
#endregion
#region public double RenderTime
///
/// Gets a double representing the time spent in the RenderFrame function, in seconds.
///
public double RenderTime
{
get { if (disposed) throw new ObjectDisposedException("GameWindow"); return render_time; }
protected set { if (disposed) throw new ObjectDisposedException("GameWindow"); render_time = value; }
}
#endregion
#region public double RenderTime
///
/// Gets a double representing the time spent in the UpdateFrame function, in seconds.
///
public double UpdateTime
{
get { if (disposed) throw new ObjectDisposedException("GameWindow"); return update_time; }
}
#endregion
#endregion
#region --- IDisposable Members ---
///
/// Disposes of the GameWindow, releasing all resources consumed by it.
///
public void Dispose()
{
try
{
Dispose(true);
}
finally
{
DisposeInternal(true);
}
GC.SuppressFinalize(this);
}
private void DisposeInternal(bool manual)
{
if (!disposed)
{
if (manual)
{
if (glContext != null)
{
glContext.Dispose();
glContext = null;
}
if (glWindow != null)
{
glWindow.Dispose();
glWindow = null;
}
}
disposed = true;
}
}
///
/// Override to add custom cleanup logic.
///
/// True, if this method was called by the application; false if this was called by the finalizer thread.
protected virtual void Dispose(bool manual)
{
}
///// Finalizes unmanaged resources consumed by the GameWindow.
//~GameWindow()
//{
// Dispose(false);
// DisposeInternal(false);
//}
#endregion
}
#region public enum VSyncMode
///
/// Enumerates available VSync modes.
///
public enum VSyncMode
{
///
/// Vsync disabled.
///
Off = 0,
///
/// VSync enabled.
///
On,
///
/// VSync enabled, but automatically disabled if framerate falls below a specified limit.
///
Adaptive,
}
#endregion
#region --- GameWindow Exceptions ---
[DebuggerNonUserCode]
class GameWindowExitException : ApplicationException
{
public override string Message
{
get
{
return
@"This exception is a normal part of the GameWindow shutdown process and is completely harmless. While this warning will never be seen by end-users, Visual Studio reminds you that an exception is leaving your code unhandled, which can sometimes be a security breach.
You can disable this warning for this specific exception: select Debug->Exceptions from the menu bar and click ""Add"". Choose ""Common Language Runtime Exceptions"", type ""OpenTK.GameWindowExitException"" in the box below and click ""Ok"". Deselecting the ""User-unhandled"" checkbox from the newly created exception will disable this warning.
Alternatively, you can disable the ""Just my code"" debugging mode (""Tools->Options->Debugging->General"" and untick ""Enable Just my code (Managed only)"". This has the sideffect that it will allow you to step into OpenTK code if an error happens. Please, do this only if you are confident in your debugging skills.";
}
}
}
#endregion
#region public enum GameWindowFlags
/// Enumerates available GameWindow construction options.
[Flags]
public enum GameWindowFlags
{
/// Indicates that the GameWindow should cover the whole screen.
Fullscreen = 1,
}
#endregion
}