[Graphics] Improved support for external OpenGL contexts

When combining OpenTK with a third-party OpenGL toolkit, it is now
possible to implement a suitable GetAddress() and GetCurrentContext()
implementation in terms of the third-party toolkit. If no
implementation is specified, then OpenTK will try to guess the most
suitable implementation within its own platform backends.

If no custom implementation is defined, and if no suitable
implementation can be found, then OpenTK will throw a
PlatformNotSupportedException. If a suitable implementation is found or
defined, then OpenTK will attempt to load OpenGL entry points using
that implementation.

In this case third-party toolkit remains solely responsible for
managing its context via its MakeCurrent(), SwapBuffers(), etc
implementations.

[Dummy] Improved thread-safety; added entry-point loader

DummyGLContext will now attempt to load OpenGL and OpenGL ES entry
points when a suitable OpenGL context is current on the calling thread.
This allows OpenTK to be used on contexts created through third-party
toolkits.

[Platform] Added internal CreateGetAddress() function

CreateGetAddress() constructs a GraphicsContext.GetAddressDelegate that
is suitable for the current platform. This can be used when combining
OpenTK with an OpenGL context created through a third-party toolkit.

[Mac] Moved GetAddress implementation to its own class

The functions defined in libdl.dylib are useful in more places than
just AglContext. Moving them to their own class ensures we can access
these from wherever we might need them.

[SDL2] Added missing [SuppressUnamangedCodeSecurity] attribute

[Mac] Use Cgl.GetCurrentContext instead of Agl

CGL appears to work with both AGL and NSOpenGL contexts, whereas AGL is
limited to AGL contexts. This allows us to be more flexible in terms of
implementation (i.e. we can use Cgl.GetCurrentContext to retrieve a
handle to a context created through SDL, which uses NSOpenGL
internally.)

[X11] Improve GraphicsMode fallback (fixes issue #23)

When the user requests a GraphicsMode that is not directly supported
by the GPU/drivers, we should relax the requested parameters until
we find a supported mode. An exception should only be thrown when
there is no usable mode.

This makes the X11 backend match the behavior of Windows. The SDL/X11
backend works a little bit differently, in that it falls back to the
a default mode directly if the requested mode is not available. There
is nothing we can do about that.

[X11] Fixed border size on Gnome 3

The _NET_FRAME_EXTENTS atom is implemented differently by
different window managers, when window decorations are hidden
with Motif. Unity returns a 0 size, while Gnome 3 returns the
previous size.

This patch removes that ambiguity: when decorations are hidden,
border size becomes zero. This should work everywhere, unless
some window manager decides to troll us by decorating the window
when we explicitly request no decorations. Sigh...

[Input] Do not crash with scancodes > 255

[X11] Allow resizing with fixed borders

Windows can now be resized programmatically, even when they have
WindowBorder.Fixed. All resizing logic is now consolidated in the
Bounds property, and ConfigureNotify messages are now handled
correctly depending on their source (StructureNotify or
SubStructureNotify.)

Implemented X11 KeyDown/KeyUp events and reduced code duplication

Do not raise KeyPress for control characters

Ignore *.pidb files from MonoDevelop 2.x

Removed unused constructors

Added Compositing and FrameworkScaled flags

Fixed OpenTK/Carbon key repeat behavior to match the other backends

Fixed GameWindow.{Bounds, Location, Size, X, Y} setters on OpenTK/Carbon

Implemented KeyDown & KeyUp events on OpenTK/Carbon

Remove bogus GraphicsMode.Index check. Fixes #22

GraphicsMode.Index is set by the platform-specific context constructor,
which is invoked after the X11GLControl constructor. It does not make
sense to check GraphicsMode.Index in the X11GLControl constructor, as it
is never set at that point.

Merge branch 'wgl_issue21'. Fixes issue #21

Fixed crash in MakeCurrent(null)

MakeCurrent(null) should set the bound device context to zero.

Added WGL_DRAW_TO_WINDOW_ARB flag

Without this flag, OpenGL rendering does not work as expected.

Additionally, all WGL_ARB_pixel_format attributes are expected to be
specified in key-value pairs. Fixed double-buffering and stereoscoping
rendering attributes.

Improved WGL mode selection

Fixed WGL_ARB_pixel_format attribute selection for doublebuffering,
stereoscopic rendering and hardware acceleration. Implemented
minimization strategy to select the optimal PixelFormatDescriptor in the
fallback path.

Fixed DescribePixelFormatPFD

When using the PFD codepath, we now call DescribePixelFormat to retrieve
an exact interpretation of the pixel format selected by the driver.

Prioritize accelerated formats first

Instead of creating a list of all available formats and iterating
through that, we let the driver decide which is the best accelerated
format to use for the user parameters. If no such format exists, we fall
back to generic acceleration or software acceleration, in turn.

This affects issue #21

Turn 1-element array to ref/out param

Display renderer information

Implemented KeyDown and KeyUp messages

Clean fix issue #19

Isolate and commit fix for issue #19 without potential for regressions.

Revert "Fix issue #19"

This reverts commit 2c14ec5f800b8ef6527f05ba26d6c6cca4b417d8.

Fix issue #19

Don't filter window messages passed to our window (see
http://blogs.msdn.com/b/oldnewthing/archive/2005/02/09/369804.aspx).
Additionally, return the correct values for all messages we are actually
handling and clean up unmanaged memory after we are done with the
window.

Explicitly set WindowProcedure calling convention

Simplify ProcessEvents implementation

Instead of combining PeekMessage+GetMessage, we can simply call
PeekMessage(Remove) to achieve the same effect. This also allows us to
remove the IsIdle property, which is no longer used anywhere.

Threads with message pump require STA comparment

May affect issue #19

Replace Wgl.GetCurrentDC with cached dc
 with

No point in using 16bpp color

Cleaned up temporary context construction

The temporary context is now retained until the actual context has been
constructed. If we don't do this, then WGL_ARB_create_context may fail
to work correctly on specific GPUs (e.g. Intel). This may affect issue
#19.

Fixed GetModesARB implementation

The correct way to query number of available pixel formats is to use
Wgl.Arb.GetPixelFormatAttrib(NumberPixelFormatsArb), not
Wgl.Arb.ChoosePixelFormats. This fixes an issue where Intel drivers
would fail to report any pixel formats in GetModesARB, even when
WGL_ARB_pixel_format is supported.

Minor code cleanup

Use gdi32 implementations of functions

Several functions are defined in both gdi32 and opengl32. Using the
opengl32/wgl versions did not appear to help with issue #19. Let's use
the gdi32 version instead, as suggested here:
https://www.opengl.org/wiki/Platform_specifics:_Windows#The_WGL_functions

Load opengl32.dll before gdi32.dll

According to
http://stackoverflow.com/questions/199016/wglcreatecontext-in-c-sharp-failing-but-not-in-managed-c,
opengl32.dll must be loaded before gdi32.dll. Affect issue #19.

Minor code cleanup

No need to wrap Wgl.DescribePixelFormat, just call it directly.

Use opengl32 instead of gdi32 throughout

Since we are dynamically loading opengl32.dll, we are supposed to use
the wgl version of functions that exist in both opengl32 and gdi32 dlls.

Corrected the entrypoint for wglChoosePixelFormat

Clean up shader error detection

Updated author information (2/2)

Updated author information

Use 16bit depth in GraphicsMode.Default

16bits appear to be better supported than 24bits on virtual machines.

GraphicsContext cannot be released by finalizer

On many/most platforms, GraphicsContexts can only be released by the
thread where they are current. This means that the user must call
GraphicsContext.Dispose() or risk a resource leak.

Since we cannot release contexts on the finalizer thread, we should keep
strong references, instead of weak references, until the user explicitly
calls Dispose().

This patch fixes issues with SDL2 crashing when running the MonoGame
WindowsGL test suite.

Improved diagnostics

This helps when tracking down GraphicsContext-related issues in SDL2.

Added hack for MonoGame compatibility

MonoGame uses reflection to access internal APIs. We need to keep these
available until this is fixed downstream.

Protect against recursion in Closing event

Misbehaving clients that shall not be named here may call
GameWindow.Close() inside the GameWindow.Closing event. This causes
recursion in SDL2, crashing the application.

This patch adds a guard to protect against recursion when calling
GameWindow.Close().

Added overloads for compatibility with svn r3127

Several projects are still using the last svn revision from the
sourceforge repository (r3127). These overloads provide an upgrade path
from r3127 to OpenTK 1.1.

Normalized xml doc file paths

Removed lib/ and *.nupkg from zip archive

Fixed build order in Nsis configuration

Added Dependencies folder to Nsis installer

Fixed build in Nsis configuration

Updated OpenGL documentation to Khronos r24522

Fixed deprecation warning

Eliminated cls-compliance warnings in BlittableValueType

Eliminated cls-compliance warnings in the math library

Eliminated CLS-compliance warnings in the bindings

Fixed memory corruption on string return type marshaling

Merge branch 'no-reflect' of https://github.com/opentk/opentk

Conflicts:
OpenTK.sln

Compatibility fixes for Mono 2.10

The Mono 2.10 compiler fails when compiling extern methods that are not
marked as DllImport. We fix that by adding a method body that throws a
NotImplementedException instead.

Additionally, MonoDevelop 2.8 cannot open sln files with ToolsVersion 12.
The fix is to change ToolsVersion to 11.

Merge branch 'no-reflect'

Conflicts:
OpenTK.sln
Source/Bind/FuncProcessor.cs
Source/OpenTK/Graphics/ES11/ES11.cs
Source/OpenTK/Graphics/ES11/ES11Core.cs
Source/OpenTK/Graphics/ES11/ES11Delegates.cs
Source/OpenTK/Graphics/ES20/ES20.cs
Source/OpenTK/Graphics/OpenGL/GL.cs
Source/OpenTK/Graphics/OpenGL/GLCore.cs
Source/OpenTK/Graphics/OpenGL/GLDelegates.cs
Source/OpenTK/Graphics/OpenGL/GLObsolete.cs

Maintain backwards compatibility with 1.1

Merge master into no-reflect

Build UpdateVersion before OpenTK

Generate debug symbols in release builds

Improved WindowState changes on SDL2 backend

SDL2 fails to report several different WindowState changes. OpenTK uses
a number of hacks to make it work to some extent, however real fixes
will have to be implemented upstream.

Merge branch 'sdlres'

Updated solution to VS2013 format.

Added nuget.exe to project items

Committed nuget cmdline tool to source control

This appears to be the simplest (only?) way to use nuget in a
cross-platform manner.

Merge branch 'nuget'

Add OpenTK.dll.config as content

MonoDevelop insists on making these changes

Updated description

Generate nuget package for OpenTK.GLControl

Generate xml documentation for OpenTK.GLControl

Improved nuget version information

Do not commit build timestamp to repository

Generate both build timestamp and version information

Delay VisualInfo construction (fixes #17)

In OpenTK 1.1, GraphicsMode queries the platform for a mode id lazily.
By delaying VisualInfo selection until the GraphicsContext is constructed
we ensure that a concrete GraphicsMode is selected and ready for use.

Copy build artifact to root directory regardless of artifact name

Added release notes for OpenTK

Added nuget lib directory to gitignore

Added nuget build target to OpenTK.sln

Added nuget build target

This will create a nupkg file for OpenTK and copy it to the base
directory. Version information is currently hardcoded to 1.1 (this
should be fixed.)

Implemented resolution change workaround on SDL2

SDL2 does not support changing display resolutions independently of an
SDL window. As a workaround, if the user uses ChangeResolution and then
makes a GameWindow fullscreen, we use old-style SDL fullscreen which
changes the resolution. If the user makes a GameWindow fullscreen
without calling ChangeResolution first, we use the new
fullscreen-desktop mode to match the other OpenTK backends.

Cache size of char

BlittableValueType<char> caches the size of the type parameter. This
way, we avoid calling Marshal.SizeOf repeatedly for every keyboard
event.

Eliminated memory allocations in Keyboard events

Do not generate KeyPress events for non-printable characters

Merge branch 'enumfix'

Regenerated bindings

Added overloads for compatibility with 1.0 and 1.1 APIs

Maintain Obsolete property when cloning a function

Create convenience overloads based on wrappers, not entry points

It makes sense to generate convenience overloads for each relevant
wrapper function, instead of each entry point. This way, we generate
convenience overloads for every wrapper in overrides.xml (even wrappers
for background compatibility), which would otherwise be ignored.