public class WGLARBPbuffer
extends java.lang.Object
This extension defines pixel buffers (pbuffer for short). Pbuffers are additional non-visible rendering buffers for an OpenGL renderer. Pbuffers are equivalent to a window that has the same pixel format descriptor with the following exceptions:
The intent of the pbuffer semantics is to enable implementations to allocate pbuffers in non-visible frame buffer memory. These pbuffers are intended to be "static" resources in that a program will typically allocate them only once rather than as a part of its rendering loop. (Pbuffers should be deallocated when the program is no longer using them -- for example, if the program is iconified.)
The frame buffer resources that are associated with a pbuffer are also static and are deallocated when the pbuffer is destroyed or possibly when a display mode change occurs.
Requires WGL_ARB_extensions_string and WGL_ARB_pixel_format.
| Modifier and Type | Field and Description |
|---|---|
static int |
WGL_DRAW_TO_PBUFFER_ARB
Accepted by the
attribIList parameter of ChoosePixelFormatARB and the attributes parameter of
GetPixelFormatAttribivARB. |
static int |
WGL_MAX_PBUFFER_HEIGHT_ARB
Accepted by the
attributes parameter of GetPixelFormatAttribivARB. |
static int |
WGL_MAX_PBUFFER_PIXELS_ARB
Accepted by the
attributes parameter of GetPixelFormatAttribivARB. |
static int |
WGL_MAX_PBUFFER_WIDTH_ARB
Accepted by the
attributes parameter of GetPixelFormatAttribivARB. |
static int |
WGL_PBUFFER_HEIGHT_ARB
Accepted by the
attribute parameter of QueryPbufferARB. |
static int |
WGL_PBUFFER_LARGEST_ARB
Accepted by the
attribList parameter of CreatePbufferARB. |
static int |
WGL_PBUFFER_LOST_ARB
Accepted by the
attribute parameter of QueryPbufferARB. |
static int |
WGL_PBUFFER_WIDTH_ARB
Accepted by the
attribute parameter of QueryPbufferARB. |
| Modifier and Type | Method and Description |
|---|---|
static long |
nwglCreatePbufferARB(long hdc,
int pixelFormat,
int width,
int height,
long attribList)
Unsafe version of:
CreatePbufferARB |
static int |
nwglQueryPbufferARB(long pbuffer,
int attribute,
long value)
Unsafe version of:
QueryPbufferARB |
static long |
wglCreatePbufferARB(long hdc,
int pixelFormat,
int width,
int height,
int[] attribList)
Array version of:
CreatePbufferARB |
static long |
wglCreatePbufferARB(long hdc,
int pixelFormat,
int width,
int height,
java.nio.IntBuffer attribList)
Creates a pixel buffer (pbuffer) and returns a handle to it.
|
static boolean |
wglDestroyPbufferARB(long pbuffer)
Destroys a pbuffer.
|
static long |
wglGetPbufferDCARB(long pbuffer)
Creates a device context for the pbuffer.
|
static boolean |
wglQueryPbufferARB(long pbuffer,
int attribute,
int[] value)
Array version of:
QueryPbufferARB |
static boolean |
wglQueryPbufferARB(long pbuffer,
int attribute,
java.nio.IntBuffer value)
Queries an attribute associated with a specific pbuffer.
|
static int |
wglReleasePbufferDCARB(long pbuffer,
long hdc)
Releases a device context obtained from a previous call to
GetPbufferDCARB. |
public static final int WGL_DRAW_TO_PBUFFER_ARB
attribIList parameter of ChoosePixelFormatARB and the attributes parameter of
GetPixelFormatAttribivARB.public static final int WGL_MAX_PBUFFER_PIXELS_ARB
attributes parameter of GetPixelFormatAttribivARB.public static final int WGL_MAX_PBUFFER_WIDTH_ARB
attributes parameter of GetPixelFormatAttribivARB.public static final int WGL_MAX_PBUFFER_HEIGHT_ARB
attributes parameter of GetPixelFormatAttribivARB.public static final int WGL_PBUFFER_LARGEST_ARB
attribList parameter of CreatePbufferARB.public static final int WGL_PBUFFER_WIDTH_ARB
attribute parameter of QueryPbufferARB.public static final int WGL_PBUFFER_HEIGHT_ARB
attribute parameter of QueryPbufferARB.public static final int WGL_PBUFFER_LOST_ARB
attribute parameter of QueryPbufferARB.public static long nwglCreatePbufferARB(long hdc,
int pixelFormat,
int width,
int height,
long attribList)
CreatePbufferARBpublic static long wglCreatePbufferARB(long hdc,
int pixelFormat,
int width,
int height,
@Nullable
java.nio.IntBuffer attribList)
Support for pbuffers may be restricted to specific pixel formats. Use GetPixelFormatAttribivARB to query the DRAW_TO_PBUFFER_ARB
attribute to determine which pixel formats support the creation of pbuffers.
hdc - a device context for the device on which the pbuffer is createdpixelFormat - a non-generic pixel format descriptor indexwidth - the pixel width of the rectangular pbufferheight - the pixel height of the rectangular pbufferattribList - a 0-terminated list of attributes {type, value} pairs containing integer attribute valuespublic static long wglGetPbufferDCARB(long pbuffer)
pbuffer - a pbuffer handle returned from a previous call to CreatePbufferARBpublic static int wglReleasePbufferDCARB(long pbuffer,
long hdc)
GetPbufferDCARB.pbuffer - a pbuffer handlehdc - a device context handlepublic static boolean wglDestroyPbufferARB(long pbuffer)
The pbuffer is destroyed once it is no longer current to any rendering context. When a pbuffer is destroyed, any memory resources that are attached to it are freed and its handle is no longer valid.
pbuffer - a pbuffer handlepublic static int nwglQueryPbufferARB(long pbuffer,
int attribute,
long value)
QueryPbufferARBpublic static boolean wglQueryPbufferARB(long pbuffer,
int attribute,
java.nio.IntBuffer value)
pbuffer - a pbuffer handleattribute - the attribute to query. One of:PBUFFER_WIDTH_ARB | PBUFFER_HEIGHT_ARB | PBUFFER_LOST_ARB |
value - the attribute valuepublic static long wglCreatePbufferARB(long hdc,
int pixelFormat,
int width,
int height,
@Nullable
int[] attribList)
CreatePbufferARBpublic static boolean wglQueryPbufferARB(long pbuffer,
int attribute,
int[] value)
QueryPbufferARBCopyright LWJGL. All Rights Reserved. License terms.