Package org.lwjgl.opengl

Class ARBGeometryShader4

java.lang.Object

org.lwjgl.opengl.ARBGeometryShader4

public class ARBGeometryShader4
extends java.lang.Object

Native bindings to the ARB_geometry_shader4 extension.

ARB_geometry_shader4 defines a new shader type available to be run on the GPU, called a geometry shader. Geometry shaders are run after vertices are transformed, but prior to color clamping, flat shading and clipping.

A geometry shader begins with a single primitive (point, line, triangle). It can read the attributes of any of the vertices in the primitive and use them to generate new primitives. A geometry shader has a fixed output primitive type (point, line strip, or triangle strip) and emits vertices to define a new primitive. A geometry shader can emit multiple disconnected primitives. The primitives emitted by the geometry shader are clipped and then processed like an equivalent OpenGL primitive specified by the application.

Furthermore, ARB_geometry_shader4 provides four additional primitive types: lines with adjacency, line strips with adjacency, separate triangles with adjacency, and triangle strips with adjacency. Some of the vertices specified in these new primitive types are not part of the ordinary primitives, instead they represent neighboring vertices that are adjacent to the two line segment end points (lines/strips) or the three triangle edges (triangles/tstrips). These vertices can be accessed by geometry shaders and used to match up the vertices emitted by the geometry shader with those of neighboring primitives.

Since geometry shaders expect a specific input primitive type, an error will occur if the application presents primitives of a different type. For example, if a geometry shader expects points, an error will occur at Begin time, if a primitive mode of TRIANGLES is specified.

Promoted to core in OpenGL 3.2.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_FRAMEBUFFER_ATTACHMENT_LAYERED_ARB GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER Accepted by the pname parameter of GetFramebufferAttachment- ParameterivARB.
static int	GL_FRAMEBUFFER_INCOMPLETE_LAYER_COUNT_ARB GL_FRAMEBUFFER_INCOMPLETE_LAYER_TARGETS_ARB Returned by CheckFramebufferStatusARB.
static int	GL_GEOMETRY_INPUT_TYPE_ARB GL_GEOMETRY_OUTPUT_TYPE_ARB Accepted by the pname parameter of ProgramParameteriARB and GetProgramiv.
static int	GL_GEOMETRY_SHADER_ARB Accepted by the type parameter of CreateShader and returned by the params parameter of GetShaderiv.
static int	GL_GEOMETRY_VERTICES_OUT_ARB Accepted by the pname parameter of ProgramParameteriARB and GetProgramiv.
static int	GL_LINE_STRIP_ADJACENCY_ARB GL_LINES_ADJACENCY_ARB Accepted by the mode parameter of Begin, DrawArrays, MultiDrawArrays, DrawElements, MultiDrawElements, and DrawRangeElements.
static int	GL_MAX_GEOMETRY_OUTPUT_VERTICES_ARB GL_MAX_GEOMETRY_TEXTURE_IMAGE_UNITS_ARB GL_MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS_ARB GL_MAX_GEOMETRY_UNIFORM_COMPONENTS_ARB GL_MAX_GEOMETRY_VARYING_COMPONENTS_ARB GL_MAX_VERTEX_VARYING_COMPONENTS_ARB Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
static int	GL_PROGRAM_POINT_SIZE_ARB Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetIntegerv, GetFloatv, GetDoublev, and GetBooleanv.
static int	GL_TRIANGLE_STRIP_ADJACENCY_ARB GL_TRIANGLES_ADJACENCY_ARB Accepted by the mode parameter of Begin, DrawArrays, MultiDrawArrays, DrawElements, MultiDrawElements, and DrawRangeElements.

Method Summary

Modifier and Type	Method and Description
static void	glFramebufferTextureARB(int target, int attachment, int texture, int level) Attaches a specified level of a texture object as one of the logical buffers of the currently bound framebuffer object, to render directly into the texture image.
static void	glFramebufferTextureFaceARB(int target, int attachment, int texture, int level, int face) Operates like FramebufferTextureARB, except that only a single face of a cube map texture, given by face, is attached to the attachment point.
static void	glFramebufferTextureLayerARB(int target, int attachment, int texture, int level, int layer) Operates like FramebufferTextureARB, except that only a single layer of the texture level, numbered layer, is attached to the attachment point.
static void	glProgramParameteriARB(int program, int pname, int value) Sets a program object parameter.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

GL_GEOMETRY_SHADER_ARB

Accepted by the type parameter of CreateShader and returned by the params parameter of GetShaderiv.

GL_GEOMETRY_VERTICES_OUT_ARB, GL_GEOMETRY_INPUT_TYPE_ARB, GL_GEOMETRY_OUTPUT_TYPE_ARB

Accepted by the pname parameter of ProgramParameteriARB and GetProgramiv.

GL_MAX_GEOMETRY_TEXTURE_IMAGE_UNITS_ARB, GL_MAX_GEOMETRY_VARYING_COMPONENTS_ARB, GL_MAX_VERTEX_VARYING_COMPONENTS_ARB, GL_MAX_GEOMETRY_UNIFORM_COMPONENTS_ARB, GL_MAX_GEOMETRY_OUTPUT_VERTICES_ARB, GL_MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS_ARB

Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_LINES_ADJACENCY_ARB, GL_LINE_STRIP_ADJACENCY_ARB, GL_TRIANGLES_ADJACENCY_ARB, GL_TRIANGLE_STRIP_ADJACENCY_ARB

Accepted by the mode parameter of Begin, DrawArrays, MultiDrawArrays, DrawElements, MultiDrawElements, and DrawRangeElements.

GL_FRAMEBUFFER_INCOMPLETE_LAYER_TARGETS_ARB, GL_FRAMEBUFFER_INCOMPLETE_LAYER_COUNT_ARB

Returned by CheckFramebufferStatusARB.

GL_FRAMEBUFFER_ATTACHMENT_LAYERED_ARB, GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER

Accepted by the pname parameter of GetFramebufferAttachment- ParameterivARB.

GL_PROGRAM_POINT_SIZE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetIntegerv, GetFloatv, GetDoublev, and GetBooleanv.

Method Detail

glProgramParameteriARB

public static void glProgramParameteriARB(int program,
                                          int pname,
                                          int value)

Sets a program object parameter.

The error INVALID_VALUE is generated if pname is GEOMETRY_INPUT_TYPE_ARB and value is not one of POINTS, LINES, LINES_ADJACENCY_ARB, TRIANGLES or TRIANGLES_ADJACENCY_ARB.

The error INVALID_VALUE is generated if pname is GEOMETRY_OUTPUT_TYPE_ARB and value is not one of POINTS, LINE_STRIP or TRIANGLE_STRIP.

The error INVALID_VALUE is generated if pname is GEOMETRY_VERTICES_OUT_ARB and value is negative.

The error INVALID_VALUE is generated if pname is GEOMETRY_VERTICES_OUT_ARB and value exceeds MAX_GEOMETRY_OUTPUT_VERTICES_ARB.

The error INVALID_VALUE is generated if pname is set to GEOMETRY_VERTICES_OUT_ARB and the product of value and the sum of all components of all active varying variables exceeds MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS_ARB.

Parameters:

program - the program object

pname - the parameter to set. One of:

GEOMETRY_VERTICES_OUT_ARB

GEOMETRY_INPUT_TYPE_ARB

GEOMETRY_OUTPUT_TYPE_ARB

value - the value being set

glFramebufferTextureARB

public static void glFramebufferTextureARB(int target,
                                           int attachment,
                                           int texture,
                                           int level)

Attaches a specified level of a texture object as one of the logical buffers of the currently bound framebuffer object, to render directly into the texture image.

If texture is zero, any image or array of images attached to the attachment point named by attachment is detached, and the state of the attachment point is reset to its initial values. level is ignored if texture is zero.

If texture is non-zero, FramebufferTextureARB attaches level level of the texture object named texture to the framebuffer attachment point named by attachment. The error INVALID_VALUE is generated if texture is not the name of a texture object, or if level is not a supported texture level number for textures of the type corresponding to target. The error INVALID_OPERATION is generated if texture is the name of a buffer texture.

If texture is the name of a three-dimensional texture, cube map texture, or one- or two-dimensional array texture, the texture level attached to the framebuffer attachment point is an array of images, and the framebuffer attachment is considered layered.

Parameters:

target - the render target. Must be:

FRAMEBUFFER

attachment - must be one of the attachments points of the framebuffer

texture - the texture object name

level - the texture level

glFramebufferTextureLayerARB

public static void glFramebufferTextureLayerARB(int target,
                                                int attachment,
                                                int texture,
                                                int level,
                                                int layer)

Operates like FramebufferTextureARB, except that only a single layer of the texture level, numbered layer, is attached to the attachment point.

If texture is non-zero, the error INVALID_VALUE is generated if layer is negative, or if texture is not the name of a texture object. The error INVALID_OPERATION is generated unless texture is zero or the name of a three-dimensional or one- or two-dimensional array texture.

Parameters:

target - the render target. Must be:

FRAMEBUFFER

attachment - must be one of the attachments points of the framebuffer

texture - the texture object name

level - the texture level

layer - the texture layer

glFramebufferTextureFaceARB

public static void glFramebufferTextureFaceARB(int target,
                                               int attachment,
                                               int texture,
                                               int level,
                                               int face)

Operates like FramebufferTextureARB, except that only a single face of a cube map texture, given by face, is attached to the attachment point.

If texture is non-zero, the error INVALID_VALUE is generated if texture is not the name of a texture object. The error INVALID_OPERATION is generated unless texture is zero or the name of a cube map texture.

Parameters:

target - the render target. Must be:

FRAMEBUFFER

attachment - must be one of the attachments points of the framebuffer

texture - the texture object name

level - the texture level

face - the cube map face. One of:

TEXTURE_CUBE_MAP_POSITIVE_X	TEXTURE_CUBE_MAP_NEGATIVE_X
TEXTURE_CUBE_MAP_POSITIVE_Y	TEXTURE_CUBE_MAP_NEGATIVE_Y
TEXTURE_CUBE_MAP_POSITIVE_Z	TEXTURE_CUBE_MAP_NEGATIVE_Z