UXGLView

UXGLView is a UXView that can own a GL context instead of being painted by drawRect. The driver owns the surface, its size, its order and its swap. The app owns the renderer, which makes its GL calls through UXGL.xc, the same source on every backend, or finds an entry point itself with UXViewDriver.glProc.

#import "UXView.xc"

Overview

if (map.makeGL()) {
    // draw the frame
    map.presentGL();
}

Where the backend has no GL, or no surface could be made, makeGL answers false and the view is still a view: drawRect paints it.

Topics

The context · glKind · makeGL · glContext · presentGL · destroyGL The drawable · drawableSize · snapshot

glKind

i32 glKind(void)

Which GL the backend offers: UX_GL_GL33, UX_GL_GLES3, UX_GL_WEBGL2, or UX_GL_NONE.

makeGL

bool makeGL(void)

Binds a context to the view. It can be called again safely.

glContext

pointer glContext(void)

The backend’s opaque context, or 0. The renderer hands it back and never reads through it.

presentGL

void presentGL(void)

The frame is finished. Call it once per turn, after any 2-D view over this one has been damaged, so both land in one present.

destroyGL

void destroyGL(void)

Releases the context. The view also releases it when it leaves the tree or is freed.

drawableSize

bool drawableSize(i32* pw, i32* ph)

The drawable’s size in pixels, the size the renderer draws at: the bounds times the backing scale, or the driver’s framebuffer where the GPU cannot take the full size. False before the view has a surface.

snapshot

UXImage* snapshot(void)

The view’s last GL frame alone, without the 2-D views over it, at the drawable’s size. Every backend with GL reads it. It is null before the view has a surface, and where there is no GL (GEM). For the window as it shows, use UXWindow.snapshot.