Top Description Constructors Methods
org.lwjgl.opengl

public Class ARBCopyImage

extends Object
Class Inheritance
Imports
org.lwjgl.system.*
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.

Constructor Summary

AccessConstructor and Description
protected
ARBCopyImage()

Method Summary

Modifier and TypeMethod and Description
public static void
glCopyImageSubData(int
the name of a texture or renderbuffer object from which to copy
srcName, int
the target representing the namespace of the source name srcName
srcTarget, int
the mipmap level to read from the source
srcLevel, int
the X coordinate of the left edge of the souce region to copy
srcX, int
the Y coordinate of the top edge of the souce region to copy
srcY, int
the Z coordinate of the near edge of the souce region to copy
srcZ, int
the name of a texture or renderbuffer object to which to copy
dstName, int
the target representing the namespace of the destination name dstName
dstTarget, int
the mipmap level to write to the source
dstLevel, int
the X coordinate of the left edge of the destination region
dstX, int
the Y coordinate of the top edge of the destination region
dstY, int
the Z coordinate of the near edge of the destination region
dstZ, int
the width of the region to be copied
srcWidth, int
the height of the region to be copied
srcHeight, int
the depth of the region to be copied
srcDepth)

Performs a raw data copy between two images.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

ARBCopyImageback to summary
protected ARBCopyImage()

Method Detail

glCopyImageSubDataback to summary
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:int

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

srcTarget:int

the target representing the namespace of the source name srcName

srcLevel:int

the mipmap level to read from the source

srcX:int

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

srcY:int

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

srcZ:int

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

dstName:int

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

dstTarget:int

the target representing the namespace of the destination name dstName

dstLevel:int

the mipmap level to write to the source

dstX:int

the X coordinate of the left edge of the destination region

dstY:int

the Y coordinate of the top edge of the destination region

dstZ:int

the Z coordinate of the near edge of the destination region

srcWidth:int

the width of the region to be copied

srcHeight:int

the height of the region to be copied

srcDepth:int

the depth of the region to be copied