LWJGL 3.3.3 · org.lwjgl.opengl.GLXNVDelayBeforeSwap

Native bindings to the GLX_NV_delay_before_swap extension.

For most interactive applications, the standard rendering loop responding to input events on a frame granularity is sufficient. Some more demanding applications may want to exchange performance for the ability to sample input closer to the final frame swap and adjust rendering accordingly. This extension adds functionality to allow the application to wait until a specified time before a swapbuffers command would be able to execute.

Requires GLX11 and GLX_EXT_swap_control.

Access	Constructor and Description
protected	GLXNVDelayBeforeSwap()

Modifier and Type	Method and Description
public static boolean	glXDelayBeforeSwapNV(long the connection to the X server display, long the window drawable drawable, float the delay, in seconds seconds) Blocks the CPU until `seconds` seconds before a synchronized swap would occur on a particular GLX window drawable.

GLXNVDelayBeforeSwap	back to summary
protected GLXNVDelayBeforeSwap()

Method Detail

glXDelayBeforeSwapNV back to summary

glXDelayBeforeSwapNV	back to summary
public static boolean glXDelayBeforeSwapNV(long display, long drawable, float seconds) Blocks the CPU until `seconds` seconds before a synchronized swap would occur on a particular GLX window drawable. It also returns a boolean value equal to `True` when the implementation had to wait for the synchronized swap and `False` otherwise. The parameter `seconds` accepts positive floating point values not larger than the length in seconds of the swap period on the associated drawable. When buffer swaps are synchronized, the swap period is composed of one or multiple video frame periods. A video frame period is the time required by the monitor to display a full frame of video data. A swap interval set to a value of 2 means that the color buffers will be swapped at most every other video frame. If `seconds` is smaller than 0, `DelayBeforeSwapNV` will return False and will not wait for the end of the swap period. If `seconds` is greater than a swap period, `DelayBeforeSwapNV` will return immediately without generating any error and the return value will be False. The application should use a `seconds` delay large enough to have time to complete its work before the end of the swap period. If `seconds` is close to 0.0, the application may miss the end of the swap period and it will have to wait an additional swap period before it can swap. If `DelayBeforeSwapNV` detects that there is less than `seconds` seconds before the end of the swap period, it will return immediately and the return value will be False. The implementation will not wait an additional video frame period to have an exact delay of `seconds` seconds. If buffer swaps are unsynchronized, `DelayBeforeSwapNV` will return immediately and the return value will be False. It could happen for multiple reasons, for example if the swap interval is equal to 0, if the window is in a mode switch or if no monitors are active. Parameters display:long the connection to the X server drawable:long the window drawable seconds:float the delay, in seconds Annotations @NativeType:Bool

public static boolean glXDelayBeforeSwapNV(long display, long drawable, float seconds)

Blocks the CPU until seconds seconds before a synchronized swap would occur on a particular GLX window drawable. It also returns a boolean value equal to True when the implementation had to wait for the synchronized swap and False otherwise.

The parameter seconds accepts positive floating point values not larger than the length in seconds of the swap period on the associated drawable. When buffer swaps are synchronized, the swap period is composed of one or multiple video frame periods. A video frame period is the time required by the monitor to display a full frame of video data. A swap interval set to a value of 2 means that the color buffers will be swapped at most every other video frame. If seconds is smaller than 0, DelayBeforeSwapNV will return False and will not wait for the end of the swap period. If seconds is greater than a swap period, DelayBeforeSwapNV will return immediately without generating any error and the return value will be False.

The application should use a seconds delay large enough to have time to complete its work before the end of the swap period. If seconds is close to 0.0, the application may miss the end of the swap period and it will have to wait an additional swap period before it can swap.

If DelayBeforeSwapNV detects that there is less than seconds seconds before the end of the swap period, it will return immediately and the return value will be False. The implementation will not wait an additional video frame period to have an exact delay of seconds seconds.

If buffer swaps are unsynchronized, DelayBeforeSwapNV will return immediately and the return value will be False. It could happen for multiple reasons, for example if the swap interval is equal to 0, if the window is in a mode switch or if no monitors are active.

Parameters

display:long: the connection to the X server
drawable:long: the window drawable
seconds:float: the delay, in seconds

Annotations

@NativeType:Bool

public Class GLXNVDelayBeforeSwap

Constructor Summary

Method Summary

Constructor Detail

Method Detail