Class ARBCopyImage


  • public class ARBCopyImage
    extends java.lang.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

      All Methods Static Methods Concrete Methods 
      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 Detail

      • 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