Package org.lwjgl.opengl

Class ARBCopyImage

java.lang.Object

org.lwjgl.opengl.ARBCopyImage

public class ARBCopyImage
extends Object

Native bindings to the ARB_copy_image extension.

This extension enables efficient image data transfer between image objects (i.e. textures and renderbuffers) without the need to bind the objects or otherwise configure the rendering pipeline.

This is accomplised by adding a new entry-point CopyImageSubData, which takes a named source and destination.

CopyImageSubData does not perform general-purpose conversions such as scaling, resizing, blending, color-space, or format conversions. It should be considered to operate in a manner similar to a CPU memcpy, but using the GPU for the copy.

CopyImageSubData supports copies between images with different internal formats, if the formats are compatible for TextureViews.

CopyImageSubData also supports copying between compressed and uncompressed images if the compressed block / uncompressed texel sizes are the same.

Promoted to core in OpenGL 4.3.

Method Summary

Modifier and Type	Method	Description
static void	glCopyImageSubData(int srcName, int srcTarget, int srcLevel, int srcX, int srcY, int srcZ, int dstName, int dstTarget, int dstLevel, int dstX, int dstY, int dstZ, int srcWidth, int srcHeight, int srcDepth)	Performs a raw data copy between two images.

Methods inherited from class java.lang.Object

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

Method Details

glCopyImageSubData

public static void glCopyImageSubData(int srcName,
 int srcTarget,
 int srcLevel,
 int srcX,
 int srcY,
 int srcZ,
 int dstName,
 int dstTarget,
 int dstLevel,
 int dstX,
 int dstY,
 int dstZ,
 int srcWidth,
 int srcHeight,
 int srcDepth)

Performs a raw data copy between two images.

Parameters:

srcName - the name of a texture or renderbuffer object from which to copy

srcTarget - the target representing the namespace of the source name srcName

srcLevel - the mipmap level to read from the source

srcX - the X coordinate of the left edge of the souce region to copy

srcY - the Y coordinate of the top edge of the souce region to copy

srcZ - the Z coordinate of the near edge of the souce region to copy

dstName - the name of a texture or renderbuffer object to which to copy

dstTarget - the target representing the namespace of the destination name dstName

dstLevel - the mipmap level to write to the source

dstX - the X coordinate of the left edge of the destination region

dstY - the Y coordinate of the top edge of the destination region

dstZ - the Z coordinate of the near edge of the destination region

srcWidth - the width of the region to be copied

srcHeight - the height of the region to be copied

srcDepth - the depth of the region to be copied