Max 5 API Reference

jit.gl.renderbuffer.c

/*
 * Copyright 2001-2005 - Cycling '74
 * Derek Gerstmann - derek@cycling74.com
 *
 * Struct and associated methods for maintaining an OpenGL 
 * renderbuffer object (RB) which can be attached to a framebuffer
 * object (FBO) for performing a direct readback via an offscreen 
 * framebuffer.
 *
 * Valid internal formats are any of the following:
 *
 *      - Any format starting with:
 *          RGB, RGBA, DEPTH_COMPONENT, (RGBA8, etc)
 *
 *      - Any of the following stencil buffer formats (not working on NV):
 *          STENCIL_INDEX1_EXT 
 *          STENCIL_INDEX4_EXT     
 *          STENCIL_INDEX8_EXT     
 *          STENCIL_INDEX16_EXT
 */

/****************************************************************************/

#include "jit.gl.renderbuffer.h"

/****************************************************************************/

t_jit_gl_renderbuffer *jit_gl_renderbuffer_new()
{
    t_jit_gl_renderbuffer *x = NULL;

    if(x = jit_getbytes(sizeof(t_jit_gl_renderbuffer)))
    {
        jit_gl_renderbuffer_reset(x);
    }

    return x;
}

void jit_gl_renderbuffer_free(t_jit_gl_renderbuffer *x)
{
    if(x)
    {
        jit_gl_renderbuffer_destroy(x);
        jit_freebytes(x, sizeof(t_jit_gl_renderbuffer));
    }
}

t_jit_err jit_gl_renderbuffer_create(t_jit_gl_renderbuffer *x, GLenum internal, GLint width, GLint height)
{
    GLuint id;
    GLint maxw, maxh;
    t_jit_err err;

    // get max renderbuffer size
    err = jit_gl_renderbuffer_query_max_size(x, &maxw, &maxh);
    if(err) return err;

    // verify requested size is within system limits
    if (width > maxw || height > maxh ) 
    {
        jit_object_error((t_object *)x,"jit.gl.rbo: unable to create renderbuffer, requested size exceeds system capabilites: [%d,%d] > [%d,%d]", width, height, maxw, maxh);
        return JIT_ERR_GENERIC;
    }

    // destroy existing renderbuffer
    err = jit_gl_renderbuffer_destroy(x);
    if(err) return err;

    // generate a new renderbuffer 
    glGenRenderbuffersEXT(1, &id);
    x->id = id;

    // bind renderbuffer
    err = jit_gl_renderbuffer_bind(x);
    if(err) return err;

    // allocate renderbuffer storage
    glRenderbufferStorageEXT(GL_RENDERBUFFER_EXT, internal, width, height );
    
    // unbind renderbuffer
    err = jit_gl_renderbuffer_unbind(x);
    if(err) return err;

    // save data members
    x->width = width;
    x->height = height;
    x->internal = internal;
    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_bind(t_jit_gl_renderbuffer *x)
{
    GLint id;

    if(!x)
        return JIT_ERR_INVALID_PTR;

    // bind the renderbuffer
    glGetIntegerv( GL_RENDERBUFFER_BINDING_EXT, &id );
    if(x->id != id)
    {
        glBindRenderbufferEXT(GL_RENDERBUFFER_EXT, x->id);
        jit_gl_report_error("jit.gl: error binding renderbuffer object!");
    }
    return JIT_ERR_NONE;      
}

t_jit_err jit_gl_renderbuffer_unbind(t_jit_gl_renderbuffer *x)
{
    if(!x)
        return JIT_ERR_INVALID_PTR;

    glBindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0);
    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_destroy(t_jit_gl_renderbuffer *x)
{
    GLuint id;

    if(!x)
        return JIT_ERR_INVALID_PTR;

    glBindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0);

    if(x->id)
    {
        id = x->id;
        glDeleteRenderbuffersEXT(1, &id);
        x->id = 0;
    }

    jit_gl_renderbuffer_reset(x);
    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_reset(t_jit_gl_renderbuffer *x)
{
    if(!x)
        return JIT_ERR_INVALID_PTR;

    x->id = 0;
    x->width = 0;
    x->height = 0;
    x->internal = -1;
    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_query_max_size(t_jit_gl_renderbuffer *x, GLint *width, GLint *height)
{
    GLint max = 0;
    glGetIntegerv( GL_MAX_RENDERBUFFER_SIZE_EXT, &max );

    *width = max;
    *height = max;

    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_query_width(t_jit_gl_renderbuffer *x, GLint *value)
{
    int width;
    t_jit_err err = JIT_ERR_NONE;
    
    // bind renderbuffer
    jit_gl_renderbuffer_bind(x);
    if(err) return err;
    
    //perform width query
    glGetRenderbufferParameterivEXT(GL_RENDERBUFFER_EXT, GL_RENDERBUFFER_WIDTH_EXT, (long *)&width);
    
    // unbind renderbuffer
    err = jit_gl_renderbuffer_unbind(x);
    if(err) return err;

    *value = width;
    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_query_height(t_jit_gl_renderbuffer *x, GLint *value)
{
    int height;
    t_jit_err err = JIT_ERR_NONE;
    
    // bind renderbuffer
    jit_gl_renderbuffer_bind(x);
    if(err) return err;
    
    //perform width query
    glGetRenderbufferParameterivEXT(GL_RENDERBUFFER_EXT, GL_RENDERBUFFER_HEIGHT_EXT, (long *)&height);
    
    // unbind renderbuffer
    err = jit_gl_renderbuffer_unbind(x);
    if(err) return err;

    *value = height;
    return JIT_ERR_NONE;
}

t_jit_err jit_gl_renderbuffer_query_internal_format(t_jit_gl_renderbuffer *x, GLint *value)
{
    int format;
    t_jit_err err = JIT_ERR_NONE;
    
    // bind renderbuffer
    jit_gl_renderbuffer_bind(x);
    if(err) return err;
    
    //perform width query
    glGetRenderbufferParameterivEXT(GL_RENDERBUFFER_EXT, GL_RENDERBUFFER_INTERNAL_FORMAT_EXT, (long *)&format);
    
    // unbind renderbuffer
    err = jit_gl_renderbuffer_unbind(x);
    if(err) return err;

    *value = format;
    return JIT_ERR_NONE;
}
/****************************************************************************/

Copyright © 2008, Cycling '74