| commit | e7f69038da3b3e6788f54b19b9c10e4f1df8370a | [log] [tgz] |
|---|---|---|
| author | Eric Anholt <eric@anholt.net> | Thu Mar 27 10:53:33 2014 -0700 |
| committer | Eric Anholt <eric@anholt.net> | Thu Mar 27 10:53:33 2014 -0700 |
| tree | 7a26f71dde49108774993d5ab53e4078830bace5 | |
| parent | d74355fc96aceb6d0856ccb39476239155f65839 [diff] |
Add EGL_NOK_swap_region definition.
I couldn't find a spec for this one on the internet, but this matches
the prototype in eglmesaext.h. The note in swap_region2 says:
4) How is this extension an improvement over EGL_NOK_swap_region?
RESOLVED: This extension builds on the previous
EGL_NOK_swap_region extension by requiring that the implementation
considers the update region provided by the application as a
mandate rather than a hint. This allows for region-restricted
rendering without requiring the use of preserved buffer swaps
which may be relatively expensive for the implementation.
Furthermore, whilst preserved swap behaviour is necessary for
incremental rendering, many applications fully re-render modified
surface regions and so don't require preserved swap
behaviour. This extension provides a lighter weight surface update
mechanism for such applications.
Epoxy is a library for handling OpenGL function pointer management for you.
It hides the complexity of dlopen(), dlsym(), glXGetProcAddress(), eglGetProcAddress(), etc. from the app developer, with very little knowledge needed on their part. They get to read GL specs and write code using undecorated function names like glCompileShader().
Don't forget to check for your extensions or versions being present before you use them, just like before! We'll tell you what you forgot to check for instead of just segfaulting, though.
glBufferData() can be used with GL_ARB_vertex_buffer_object implementations, along with GL 1.5+ implementations../autogen.sh make sudo make install
Dependencies for debian:
Dependencies for OS X (macports):
Other dependencies for OS X:
The test suite has additional dependencies depending on the platform. (X11, EGL, a running X Server).
It should be as easy as replacing:
#include <GL/gl.h> #include <GL/glx.h> #include <GL/glext.h>
with:
#include <epoxy/gl.h> #include <epoxy/glx.h>
As long as epoxy's headers appear first, you should be ready to go. Additionally, some new helpers become available, so you don't have to write them:
int epoxy_gl_version() returns the GL version:
bool epoxy_has_gl_extension() returns whether a GL extension is available (GL_ARB_texture_buffer_object, for example).
Note that this is not terribly fast, so keep it out of your hot paths, ok?
GLEW has several issues:
glewInit() autodetects the world.The motivation for this project came out of previous use of libGLEW in piglit. Other GL dispatch code generation projects had similar failures. Ideally, piglit wants to be able to build a single binary for a test that can run on whatever context or window system it chooses, not based on link time choices.
We had to solve some of GLEW's problems for piglit and solving them meant replacing every single piece of GLEW, so we built piglit-dispatch from scratch. And since we wanted to reuse it in other GL-related projects, this is the result.
The automatic per-context symbol resolution for win32 requires that epoxy knows when wglMakeCurrent() is called, because wglGetProcAddress() return values depend on the context's device and pixel format. If wglMakeCurrent() is called from outside of epoxy (in a way that might change the device or pixel format), then epoxy needs to be notified of the change using the epoxy_handle_external_wglMakeCurrent() function.
The win32 dispatch layer is currently slower than it should be in the single-context (or multi-context, but same device and pixel format) case. We need to switch to using the linux-like function pointer stubs, and detect when transitioning to multi-device/format and hook in the per-thread dispatch table at that point.
The win32 wglMakeCurrent () variants are slower than they should be, because they should be caching the resolved dispatch tables instead of resetting an entire thread-local dispatch table every time.