Package org.lwjgl.opengl

Class GLXAMDGPUAssociation

java.lang.Object

org.lwjgl.opengl.GLXAMDGPUAssociation

public class GLXAMDGPUAssociation
extends java.lang.Object

Native bindings to the GLX_AMD_gpu_association extension.

There currently is no way for applications to efficiently use GPU resources in systems that contain more than one GPU. Vendors have provided methods that attempt to split the workload for an application among the available GPU resources. This has proven to be very inefficient because most applications were never written with these sorts of optimizations in mind.

This extension provides a mechanism for applications to explicitly use the GPU resources on a given system individually. By providing this functionality, a driver allows applications to make appropriate decisions regarding where and when to distribute rendering tasks.

Requires OpenGL 1.5, GLX 1.3, EXT_framebuffer_object and GLX_ARB_get_proc_address.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GLX_GPU_CLOCK_AMD GLX_GPU_FASTEST_TARGET_GPUS_AMD GLX_GPU_NUM_PIPES_AMD GLX_GPU_NUM_RB_AMD GLX_GPU_NUM_SIMD_AMD GLX_GPU_NUM_SPI_AMD GLX_GPU_OPENGL_VERSION_STRING_AMD GLX_GPU_RAM_AMD GLX_GPU_RENDERER_STRING_AMD GLX_GPU_VENDOR_AMD Accepted by the property parameter of GetGPUInfoAMD.

Method Summary

Modifier and Type	Method and Description
static void	glXBlitContextFramebufferAMD(long dstCtx, int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter)
static long	glXCreateAssociatedContextAMD(int id, long share_list) Creates an associated context.
static long	glXCreateAssociatedContextAttribsAMD(int id, long share_context, int[] attribList) Array version of: CreateAssociatedContextAttribsAMD
static long	glXCreateAssociatedContextAttribsAMD(int id, long share_context, java.nio.IntBuffer attribList) Creates an associated context and requests a specific GL version.
static int	glXDeleteAssociatedContextAMD(long ctx) Deletes an associated context.
static int	glXGetContextGPUIDAMD(long ctx) Determines which GPU a context is attached to.
static long	glXGetCurrentAssociatedContextAMD() Queries the crrent associated context.
static int	glXGetGPUIDsAMD(int maxCount, int ids) Queries the IDs for available GPUs.
static int	glXGetGPUInfoAMD(int id, int property, int dataType, java.nio.ByteBuffer data) Queries GPU properties.
static int	glXMakeAssociatedContextCurrentAMD(long ctx) Makes an associated context current in the current thread.

Methods inherited from class java.lang.Object

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

Field Detail

GLX_GPU_VENDOR_AMD, GLX_GPU_RENDERER_STRING_AMD, GLX_GPU_OPENGL_VERSION_STRING_AMD, GLX_GPU_FASTEST_TARGET_GPUS_AMD, GLX_GPU_RAM_AMD, GLX_GPU_CLOCK_AMD, GLX_GPU_NUM_PIPES_AMD, GLX_GPU_NUM_SIMD_AMD, GLX_GPU_NUM_RB_AMD, GLX_GPU_NUM_SPI_AMD

Accepted by the property parameter of GetGPUInfoAMD.

Method Detail

glXBlitContextFramebufferAMD

public static void glXBlitContextFramebufferAMD(long dstCtx,
                                                int srcX0,
                                                int srcY0,
                                                int srcX1,
                                                int srcY1,
                                                int dstX0,
                                                int dstY0,
                                                int dstX1,
                                                int dstY1,
                                                int mask,
                                                int filter)

glXCreateAssociatedContextAMD

public static long glXCreateAssociatedContextAMD(int id,
                                                 long share_list)

Creates an associated context.

Parameters:

id -

share_list -

glXCreateAssociatedContextAttribsAMD

public static long glXCreateAssociatedContextAttribsAMD(int id,
                                                        long share_context,
                                                        java.nio.IntBuffer attribList)

Creates an associated context and requests a specific GL version.

Parameters:

id -

share_context -

attribList -

glXDeleteAssociatedContextAMD

public static int glXDeleteAssociatedContextAMD(long ctx)

Deletes an associated context.

Parameters:

ctx - the GLXContext

glXGetContextGPUIDAMD

public static int glXGetContextGPUIDAMD(long ctx)

Determines which GPU a context is attached to.

Parameters:

ctx - the GLXContext

glXGetCurrentAssociatedContextAMD

public static long glXGetCurrentAssociatedContextAMD()

Queries the crrent associated context.

glXGetGPUIDsAMD

public static int glXGetGPUIDsAMD(int maxCount,
                                  int ids)

Queries the IDs for available GPUs.

Parameters:

maxCount -

ids -

glXGetGPUInfoAMD

public static int glXGetGPUInfoAMD(int id,
                                   int property,
                                   int dataType,
                                   java.nio.ByteBuffer data)

Queries GPU properties.

Parameters:

id -

property - one of:

GPU_VENDOR_AMD	GPU_RENDERER_STRING_AMD	GPU_OPENGL_VERSION_STRING_AMD	GPU_FASTEST_TARGET_GPUS_AMD
GPU_RAM_AMD	GPU_CLOCK_AMD	GPU_NUM_PIPES_AMD	GPU_NUM_SIMD_AMD
GPU_NUM_RB_AMD	GPU_NUM_SPI_AMD

dataType -

data -

glXMakeAssociatedContextCurrentAMD

public static int glXMakeAssociatedContextCurrentAMD(long ctx)

Makes an associated context current in the current thread.

Parameters:

ctx - the GLXContext

glXCreateAssociatedContextAttribsAMD

public static long glXCreateAssociatedContextAttribsAMD(int id,
                                                        long share_context,
                                                        int[] attribList)

Array version of: CreateAssociatedContextAttribsAMD