VkPastPresentationTimingGOOGLE (LWJGL 3.2.4 SNAPSHOT

java.lang.Object
- org.lwjgl.system.Pointer.Default
- - org.lwjgl.system.Struct
  - - org.lwjgl.vulkan.VkPastPresentationTimingGOOGLE

All Implemented Interfaces:

java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
```
public class VkPastPresentationTimingGOOGLE
extends org.lwjgl.system.Struct
implements org.lwjgl.system.NativeResource
```
Structure containing timing information about a previously-presented image.
Description

The results for a given swapchain and presentID are only returned once from vkGetPastPresentationTimingGOOGLE.

The application can use the VkPastPresentationTimingGOOGLE values to occasionally adjust its timing. For example, if actualPresentTime is later than expected (e.g. one refreshDuration late), the application may increase its target IPD to a higher multiple of refreshDuration (e.g. decrease its frame rate from 60Hz to 30Hz). If actualPresentTime and earliestPresentTime are consistently different, and if presentMargin is consistently large enough, the application may decrease its target IPD to a smaller multiple of refreshDuration (e.g. increase its frame rate from 30Hz to 60Hz). If actualPresentTime and earliestPresentTime are same, and if presentMargin is consistently high, the application may delay the start of its input-render-present loop in order to decrease the latency between user input and the corresponding present (always leaving some margin in case a new image takes longer to render than the previous image). An application that desires its target IPD to always be the same as refreshDuration, can also adjust features until actualPresentTime is never late and presentMargin is satisfactory.

See Also

GetPastPresentationTimingGOOGLE

Member documentation
- presentID – an application-provided value that was given to a previous vkQueuePresentKHR command via VkPresentTimeGOOGLE::presentID (see below). It can be used to uniquely identify a previous present with the QueuePresentKHR command.
- desiredPresentTime – an application-provided value that was given to a previous QueuePresentKHR command via VkPresentTimeGOOGLE::desiredPresentTime. If non-zero, it was used by the application to indicate that an image not be presented any sooner than desiredPresentTime.
- actualPresentTime – the time when the image of the swapchain was actually displayed.
- earliestPresentTime – the time when the image of the swapchain could have been displayed. This may differ from actualPresentTime if the application requested that the image be presented no sooner than VkPresentTimeGOOGLE::desiredPresentTime.
- presentMargin – an indication of how early the vkQueuePresentKHR command was processed compared to how soon it needed to be processed, and still be presented at earliestPresentTime.
Layout
```
 struct VkPastPresentationTimingGOOGLE {
     uint32_t presentID;
     uint64_t desiredPresentTime;
     uint64_t actualPresentTime;
     uint64_t earliestPresentTime;
     uint64_t presentMargin;
 }
```

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class VkPastPresentationTimingGOOGLE.Buffer
An array of VkPastPresentationTimingGOOGLE structs.
- Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
  org.lwjgl.system.Pointer.Default

Nested Classes
Modifier and Type	Class and Description
`static class`	`VkPastPresentationTimingGOOGLE.Buffer` An array of `VkPastPresentationTimingGOOGLE` structs.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ACTUALPRESENTTIME` The struct member offsets.
`static int`	`ALIGNOF` The struct alignment in bytes.
`static int`	`DESIREDPRESENTTIME` The struct member offsets.
`static int`	`EARLIESTPRESENTTIME` The struct member offsets.
`static int`	`PRESENTID` The struct member offsets.
`static int`	`PRESENTMARGIN` The struct member offsets.
`static int`	`SIZEOF` The struct size in bytes.

Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE

Constructor Summary

Constructors
Constructor and Description
`VkPastPresentationTimingGOOGLE(java.nio.ByteBuffer container)` Creates a `VkPastPresentationTimingGOOGLE` instance at the current position of the specified `ByteBuffer` container.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`long`	`actualPresentTime()` Returns the value of the `actualPresentTime` field.
`static VkPastPresentationTimingGOOGLE`	`calloc()` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated with `memCalloc`.
`static VkPastPresentationTimingGOOGLE.Buffer`	`calloc(int capacity)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated with `memCalloc`.
`static VkPastPresentationTimingGOOGLE`	`callocStack()` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static VkPastPresentationTimingGOOGLE.Buffer`	`callocStack(int capacity)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static VkPastPresentationTimingGOOGLE.Buffer`	`callocStack(int capacity, org.lwjgl.system.MemoryStack stack)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkPastPresentationTimingGOOGLE`	`callocStack(org.lwjgl.system.MemoryStack stack)` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkPastPresentationTimingGOOGLE`	`create()` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated with `BufferUtils`.
`static VkPastPresentationTimingGOOGLE.Buffer`	`create(int capacity)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated with `BufferUtils`.
`static VkPastPresentationTimingGOOGLE`	`create(long address)` Returns a new `VkPastPresentationTimingGOOGLE` instance for the specified memory address.
`static VkPastPresentationTimingGOOGLE.Buffer`	`create(long address, int capacity)` Create a `VkPastPresentationTimingGOOGLE.Buffer` instance at the specified memory.
`static VkPastPresentationTimingGOOGLE`	`createSafe(long address)` Like `create`, but returns `null` if `address` is `NULL`.
`static VkPastPresentationTimingGOOGLE.Buffer`	`createSafe(long address, int capacity)` Like `create`, but returns `null` if `address` is `NULL`.
`long`	`desiredPresentTime()` Returns the value of the `desiredPresentTime` field.
`long`	`earliestPresentTime()` Returns the value of the `earliestPresentTime` field.
`static VkPastPresentationTimingGOOGLE`	`malloc()` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated with `memAlloc`.
`static VkPastPresentationTimingGOOGLE.Buffer`	`malloc(int capacity)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated with `memAlloc`.
`static VkPastPresentationTimingGOOGLE`	`mallocStack()` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated on the thread-local `MemoryStack`.
`static VkPastPresentationTimingGOOGLE.Buffer`	`mallocStack(int capacity)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated on the thread-local `MemoryStack`.
`static VkPastPresentationTimingGOOGLE.Buffer`	`mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)` Returns a new `VkPastPresentationTimingGOOGLE.Buffer` instance allocated on the specified `MemoryStack`.
`static VkPastPresentationTimingGOOGLE`	`mallocStack(org.lwjgl.system.MemoryStack stack)` Returns a new `VkPastPresentationTimingGOOGLE` instance allocated on the specified `MemoryStack`.
`static long`	`nactualPresentTime(long struct)` Unsafe version of `actualPresentTime()`.
`static long`	`ndesiredPresentTime(long struct)` Unsafe version of `desiredPresentTime()`.
`static long`	`nearliestPresentTime(long struct)` Unsafe version of `earliestPresentTime()`.
`static int`	`npresentID(long struct)` Unsafe version of `presentID()`.
`static long`	`npresentMargin(long struct)` Unsafe version of `presentMargin()`.
`int`	`presentID()` Returns the value of the `presentID` field.
`long`	`presentMargin()` Returns the value of the `presentMargin` field.
`int`	`sizeof()`

Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull

Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.lwjgl.system.NativeResource
close, free

- Field Detail
  - SIZEOF
```
public static final int SIZEOF
```
    The struct size in bytes.
  - ALIGNOF
```
public static final int ALIGNOF
```
    The struct alignment in bytes.
  - PRESENTID
```
public static final int PRESENTID
```
    The struct member offsets.
  - DESIREDPRESENTTIME
```
public static final int DESIREDPRESENTTIME
```
    The struct member offsets.
  - ACTUALPRESENTTIME
```
public static final int ACTUALPRESENTTIME
```
    The struct member offsets.
  - EARLIESTPRESENTTIME
```
public static final int EARLIESTPRESENTTIME
```
    The struct member offsets.
  - PRESENTMARGIN
```
public static final int PRESENTMARGIN
```
    The struct member offsets.
- Constructor Detail
  - VkPastPresentationTimingGOOGLE
```
public VkPastPresentationTimingGOOGLE(java.nio.ByteBuffer container)
```
    Creates a VkPastPresentationTimingGOOGLE instance at the current position of the specified ByteBuffer container. Changes to the buffer's content will be visible to the struct instance and vice versa.
    The created instance holds a strong reference to the container object.
- Method Detail
  - sizeof
```
public int sizeof()
```
    Specified by:
    
    sizeof in class org.lwjgl.system.Struct
  - presentID
```
public int presentID()
```
    Returns the value of the presentID field.
  - desiredPresentTime
```
public long desiredPresentTime()
```
    Returns the value of the desiredPresentTime field.
  - actualPresentTime
```
public long actualPresentTime()
```
    Returns the value of the actualPresentTime field.
  - earliestPresentTime
```
public long earliestPresentTime()
```
    Returns the value of the earliestPresentTime field.
  - presentMargin
```
public long presentMargin()
```
    Returns the value of the presentMargin field.
  - malloc
```
public static VkPastPresentationTimingGOOGLE malloc()
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated with memAlloc. The instance must be explicitly freed.
  - calloc
```
public static VkPastPresentationTimingGOOGLE calloc()
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated with memCalloc. The instance must be explicitly freed.
  - create
```
public static VkPastPresentationTimingGOOGLE create()
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated with BufferUtils.
  - create
```
public static VkPastPresentationTimingGOOGLE create(long address)
```
    Returns a new VkPastPresentationTimingGOOGLE instance for the specified memory address.
  - createSafe
```
@Nullable
public static VkPastPresentationTimingGOOGLE createSafe(long address)
```
    Like create, but returns null if address is NULL.
  - malloc
```
public static VkPastPresentationTimingGOOGLE.Buffer malloc(int capacity)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - calloc
```
public static VkPastPresentationTimingGOOGLE.Buffer calloc(int capacity)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkPastPresentationTimingGOOGLE.Buffer create(int capacity)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated with BufferUtils.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkPastPresentationTimingGOOGLE.Buffer create(long address,
                                                           int capacity)
```
    Create a VkPastPresentationTimingGOOGLE.Buffer instance at the specified memory.
    
    Parameters:
    
    address - the memory address
    
    capacity - the buffer capacity
  - createSafe
```
@Nullable
public static VkPastPresentationTimingGOOGLE.Buffer createSafe(long address,
                                                                         int capacity)
```
    Like create, but returns null if address is NULL.
  - mallocStack
```
public static VkPastPresentationTimingGOOGLE mallocStack()
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated on the thread-local MemoryStack.
  - callocStack
```
public static VkPastPresentationTimingGOOGLE callocStack()
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
  - mallocStack
```
public static VkPastPresentationTimingGOOGLE mallocStack(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
  - callocStack
```
public static VkPastPresentationTimingGOOGLE callocStack(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPastPresentationTimingGOOGLE instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
  - mallocStack
```
public static VkPastPresentationTimingGOOGLE.Buffer mallocStack(int capacity)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated on the thread-local MemoryStack.
    
    Parameters:
    
    capacity - the buffer capacity
  - callocStack
```
public static VkPastPresentationTimingGOOGLE.Buffer callocStack(int capacity)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    capacity - the buffer capacity
  - mallocStack
```
public static VkPastPresentationTimingGOOGLE.Buffer mallocStack(int capacity,
                                                                org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - callocStack
```
public static VkPastPresentationTimingGOOGLE.Buffer callocStack(int capacity,
                                                                org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPastPresentationTimingGOOGLE.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - npresentID
```
public static int npresentID(long struct)
```
    Unsafe version of presentID().
  - ndesiredPresentTime
```
public static long ndesiredPresentTime(long struct)
```
    Unsafe version of desiredPresentTime().
  - nactualPresentTime
```
public static long nactualPresentTime(long struct)
```
    Unsafe version of actualPresentTime().
  - nearliestPresentTime
```
public static long nearliestPresentTime(long struct)
```
    Unsafe version of earliestPresentTime().
  - npresentMargin
```
public static long npresentMargin(long struct)
```
    Unsafe version of presentMargin().

Class VkPastPresentationTimingGOOGLE

Description

See Also

Member documentation

Layout

Nested Class Summary

Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

Field Summary

Fields inherited from interface org.lwjgl.system.Pointer

Constructor Summary

Method Summary

Methods inherited from class org.lwjgl.system.Struct

Methods inherited from class org.lwjgl.system.Pointer.Default

Methods inherited from class java.lang.Object

Methods inherited from interface org.lwjgl.system.NativeResource

Field Detail

SIZEOF

ALIGNOF

PRESENTID

DESIREDPRESENTTIME

ACTUALPRESENTTIME

EARLIESTPRESENTTIME

PRESENTMARGIN

Constructor Detail

VkPastPresentationTimingGOOGLE

Method Detail

sizeof

presentID

desiredPresentTime

actualPresentTime

earliestPresentTime

presentMargin

malloc

calloc

create

create

createSafe

malloc

calloc

create

create

createSafe

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

npresentID

ndesiredPresentTime

nactualPresentTime

nearliestPresentTime

npresentMargin