public class ARBFramebufferNoAttachments
extends java.lang.Object
Framebuffer objects as introduced by ARB_framebuffer_object and OpenGL 3.0 provide a generalized mechanism for rendering to off-screen surfaces.
Each framebuffer object may have depth, stencil and zero or more color attachments that can be written to by the GL. The size of the framebuffer (width,
height, layer count, sample count) is derived from the attachments of that framebuffer. In unextended OpenGL 4.2, it is not legal to render into a
framebuffer object that has no attachments. Such a framebuffer would be considered incomplete with the FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT
status.
With OpenGL 4.2 and ARB_shader_image_load_store, fragment shaders are capable of doing random access writes to buffer and texture memory via
image loads, stores, and atomics. This ability enables algorithms using the conventional rasterizer to generate a collection of fragments, where each
fragment shader invocation will write its outputs to buffer or texture memory using image stores or atomics. Such algorithms may have no need to write
color or depth values to a conventional framebuffer. However, a framebuffer with no attachments will be considered incomplete and no rasterization or
fragment shader exectuion will occur. To avoid such errors, an application may be required to create an otherwise unnecessary "dummy" texture and attach
it to the framebuffer (possibly with color writes masked off). If the algorithm requires the rasterizer to operate over a large number of pixels, this
dummy texture will needlessly consume a significant amount of memory.
This extension enables the algorithms described above to work even with a framebuffer with no attachments. Applications can specify default width, height, layer count, and sample count parameters for a framebuffer object. When a framebuffer with no attachments is bound, it will be considered complete as long as the application has specified non-zero default width and height parameters. For the purposes of rasterization, the framebuffer will be considered to have a width, height, layer count, and sample count derived from its default parameters. Framebuffers with one or more attachments are not affected by these default parameters; the size of the framebuffer will still be derived from the sizes of the attachments in that case.
Additionally, this extension provides queryable implementation-dependent maximums for framebuffer width, height, layer count, and sample count, which may differ from similar limits on textures and renderbuffers. These maximums will be used to error-check the default framebuffer parameters and also permit implementations to expose the ability to rasterize to an attachment-less framebuffer larger than the maximum supported texture size.
Requires OpenGL 3.0 or ARB_framebuffer_object. Promoted to core in OpenGL 4.3.
| Modifier and Type | Field and Description |
|---|---|
static int |
GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS
Accepted by the
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT. |
static int |
GL_FRAMEBUFFER_DEFAULT_HEIGHT
Accepted by the
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT. |
static int |
GL_FRAMEBUFFER_DEFAULT_LAYERS
Accepted by the
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT. |
static int |
GL_FRAMEBUFFER_DEFAULT_SAMPLES
Accepted by the
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT. |
static int |
GL_FRAMEBUFFER_DEFAULT_WIDTH
Accepted by the
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT. |
static int |
GL_MAX_FRAMEBUFFER_HEIGHT
Accepted by the
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev. |
static int |
GL_MAX_FRAMEBUFFER_LAYERS
Accepted by the
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev. |
static int |
GL_MAX_FRAMEBUFFER_SAMPLES
Accepted by the
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev. |
static int |
GL_MAX_FRAMEBUFFER_WIDTH
Accepted by the
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev. |
| Modifier and Type | Method and Description |
|---|---|
static void |
glFramebufferParameteri(int target,
int pname,
int param)
Sets a named parameter of a framebuffer.
|
static int |
glGetFramebufferParameteri(int target,
int pname)
Retrieves a named parameter from a framebuffer.
|
static void |
glGetFramebufferParameteriv(int target,
int pname,
int[] params)
Array version of:
GetFramebufferParameteriv |
static void |
glGetFramebufferParameteriv(int target,
int pname,
java.nio.IntBuffer params)
Retrieves a named parameter from a framebuffer.
|
static int |
glGetNamedFramebufferParameteriEXT(int framebuffer,
int pname)
DSA version of
GetFramebufferParameteriv. |
static void |
glGetNamedFramebufferParameterivEXT(int framebuffer,
int pname,
int[] params)
Array version of:
GetNamedFramebufferParameterivEXT |
static void |
glGetNamedFramebufferParameterivEXT(int framebuffer,
int pname,
java.nio.IntBuffer params)
DSA version of
GetFramebufferParameteriv. |
static void |
glNamedFramebufferParameteriEXT(int framebuffer,
int pname,
int param)
DSA version of
FramebufferParameteri. |
static void |
nglGetFramebufferParameteriv(int target,
int pname,
long params)
Unsafe version of:
GetFramebufferParameteriv |
static void |
nglGetNamedFramebufferParameterivEXT(int framebuffer,
int pname,
long params)
Unsafe version of:
GetNamedFramebufferParameterivEXT |
public static final int GL_FRAMEBUFFER_DEFAULT_WIDTH
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT.public static final int GL_FRAMEBUFFER_DEFAULT_HEIGHT
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT.public static final int GL_FRAMEBUFFER_DEFAULT_LAYERS
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT.public static final int GL_FRAMEBUFFER_DEFAULT_SAMPLES
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT.public static final int GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS
pname parameter of FramebufferParameteri, GetFramebufferParameteriv, NamedFramebufferParameteriEXT, and
GetNamedFramebufferParameterivEXT.public static final int GL_MAX_FRAMEBUFFER_WIDTH
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.public static final int GL_MAX_FRAMEBUFFER_HEIGHT
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.public static final int GL_MAX_FRAMEBUFFER_LAYERS
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.public static final int GL_MAX_FRAMEBUFFER_SAMPLES
pname parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.public static void glFramebufferParameteri(int target,
int pname,
int param)
target - target of the operation. One of:READ_FRAMEBUFFER | DRAW_FRAMEBUFFER | FRAMEBUFFER |
pname - a token indicating the parameter to be modified. One of:FRAMEBUFFER_DEFAULT_WIDTH | FRAMEBUFFER_DEFAULT_HEIGHT |
FRAMEBUFFER_DEFAULT_LAYERS | FRAMEBUFFER_DEFAULT_SAMPLES |
FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS |
param - the new value for the parameter named pnamepublic static void nglGetFramebufferParameteriv(int target,
int pname,
long params)
GetFramebufferParameterivpublic static void glGetFramebufferParameteriv(int target,
int pname,
java.nio.IntBuffer params)
target - target of the operation. One of:READ_FRAMEBUFFER | DRAW_FRAMEBUFFER | FRAMEBUFFER |
pname - a token indicating the parameter to be retrieved. One of:FRAMEBUFFER_DEFAULT_WIDTH | FRAMEBUFFER_DEFAULT_HEIGHT |
FRAMEBUFFER_DEFAULT_LAYERS | FRAMEBUFFER_DEFAULT_SAMPLES |
FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS |
params - a variable to receive the value of the parameter named pnamepublic static int glGetFramebufferParameteri(int target,
int pname)
target - target of the operation. One of:READ_FRAMEBUFFER | DRAW_FRAMEBUFFER | FRAMEBUFFER |
pname - a token indicating the parameter to be retrieved. One of:FRAMEBUFFER_DEFAULT_WIDTH | FRAMEBUFFER_DEFAULT_HEIGHT |
FRAMEBUFFER_DEFAULT_LAYERS | FRAMEBUFFER_DEFAULT_SAMPLES |
FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS |
public static void glNamedFramebufferParameteriEXT(int framebuffer,
int pname,
int param)
FramebufferParameteri.framebuffer - the framebuffer objectpname - a token indicating the parameter to be modified. One of:FRAMEBUFFER_DEFAULT_WIDTH | FRAMEBUFFER_DEFAULT_HEIGHT |
FRAMEBUFFER_DEFAULT_LAYERS | FRAMEBUFFER_DEFAULT_SAMPLES |
FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS |
param - the new value for the parameter named pnamepublic static void nglGetNamedFramebufferParameterivEXT(int framebuffer,
int pname,
long params)
GetNamedFramebufferParameterivEXTpublic static void glGetNamedFramebufferParameterivEXT(int framebuffer,
int pname,
java.nio.IntBuffer params)
GetFramebufferParameteriv.framebuffer - the framebuffer objectpname - a token indicating the parameter to be retrieved. One of:FRAMEBUFFER_DEFAULT_WIDTH | FRAMEBUFFER_DEFAULT_HEIGHT |
FRAMEBUFFER_DEFAULT_LAYERS | FRAMEBUFFER_DEFAULT_SAMPLES |
FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS |
params - a variable to receive the value of the parameter named pnamepublic static int glGetNamedFramebufferParameteriEXT(int framebuffer,
int pname)
GetFramebufferParameteriv.framebuffer - the framebuffer objectpname - a token indicating the parameter to be retrieved. One of:FRAMEBUFFER_DEFAULT_WIDTH | FRAMEBUFFER_DEFAULT_HEIGHT |
FRAMEBUFFER_DEFAULT_LAYERS | FRAMEBUFFER_DEFAULT_SAMPLES |
FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS |
public static void glGetFramebufferParameteriv(int target,
int pname,
int[] params)
GetFramebufferParameterivpublic static void glGetNamedFramebufferParameterivEXT(int framebuffer,
int pname,
int[] params)
GetNamedFramebufferParameterivEXTCopyright LWJGL. All Rights Reserved. License terms.