Method asyncDebugDownloadRGB8

src/main/java/field/graphics/FBO.java:675–706

this operates asynchronously if we are not currently inside the draw loop (that is, if there is no valid context for our thread). only one debug download can be pending at a time. You can pass in null to this routine and you'll get a correctly sized ByteByffer back that you can reuse for subsequent

(ByteBuffer to)

        if (to == null || !to.isDirect() || to.limit() < sz) {
            ato = ByteBuffer.allocateDirect(sz);
        } else ato = to;

        CompletableFuture<ByteBuffer> c = new CompletableFuture<ByteBuffer>() {
            @Override
            public ByteBuffer get() throws InterruptedException, ExecutionException {
                if (!isDone()) return ato;
                return super.get();
            }
        };
        Runnable r = () -> {
            int[] a = {0};
            a[0] = glGetInteger(GL_FRAMEBUFFER_BINDING);
            glBindFramebuffer(GL_FRAMEBUFFER, getOpenGLFrameBufferNameInCurrentContext());
            glReadPixels(0, 0, specification.width, specification.height, GL11.GL_RGB, GL_UNSIGNED_BYTE, ato);
            glBindFramebuffer(GL_FRAMEBUFFER, a[0]);
            c.complete(ato);
        };

        if (GraphicsContext.getContext() == null) {
            postDrawQueue.set(r);
        } else {
            r.run();
        }

        return c;
    }

    /**
     * this operates asynchronously if we are not currently inside the draw loop (that is, if there is no valid context for our thread). only one debug download can be pending at a time. You can
     * pass in null to this routine and you'll get a correctly sized ByteBuffer back that you can reuse for subsequent calls. Regardless of the original format of the FBO this always returns
     * something that's RGBA / float,.
     */
    public Future<FloatBuffer> asyncDebugDownloadRGBAFloat(FloatBuffer to) {
        FloatBuffer ato;