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.
GetPastPresentationTimingGOOGLE
struct VkPastPresentationTimingGOOGLE {
uint32_t presentID;
uint64_t desiredPresentTime;
uint64_t actualPresentTime;
uint64_t earliestPresentTime;
uint64_t presentMargin;
}
| Modifier and Type | Class and Description |
|---|---|
| public static class | VkPastPresentationTimingGOOGLE.
An array of |
| Modifier and Type | Field and Description |
|---|---|
| public static final int | ACTUALPRESENTTIME
The struct member offsets. |
| public static final int | ALIGNOF
The struct alignment in bytes. |
| public static final int | DESIREDPRESENTTIME
The struct member offsets. |
| public static final int | EARLIESTPRESENTTIME
The struct member offsets. |
| public static final int | PRESENTID
The struct member offsets. |
| public static final int | PRESENTMARGIN
The struct member offsets. |
| public static final int | SIZEOF
The struct size in bytes. |
| Access | Constructor and Description |
|---|---|
| protected | |
| public | VkPastPresentationTimingGOOGLE(ByteBuffer container)
Creates a |
| Modifier and Type | Method and Description |
|---|---|
| public long | |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE. | calloc(int
the buffer capacity capacity)Returns a new |
| public static VkPastPresentationTimingGOOGLE | calloc(MemoryStack
the stack from which to allocate stack)Returns a new |
| public static VkPastPresentationTimingGOOGLE. | calloc(int
the buffer capacity capacity, MemoryStack the stack from which to allocate stack)Returns a new |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE. | |
| public static VkPastPresentationTimingGOOGLE. | |
| protected VkPastPresentationTimingGOOGLE | create(long
the struct memory address address, ByteBuffer an optional container buffer, to be referenced strongly by the struct instance. container)Implements abstract org. the constructor, but returns the exact type of the Struct subclass.
|
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE | create(long address)
Returns a new |
| public static VkPastPresentationTimingGOOGLE. | create(int
the buffer capacity capacity)Returns a new |
| public static VkPastPresentationTimingGOOGLE. | create(long
the memory address address, int the buffer capacity capacity)Create a |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE. | |
| public long | desiredPresentTime()
an application-provided value that was given to a previous |
| public long | |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE. | malloc(int
the buffer capacity capacity)Returns a new |
| public static VkPastPresentationTimingGOOGLE | malloc(MemoryStack
the stack from which to allocate stack)Returns a new |
| public static VkPastPresentationTimingGOOGLE. | malloc(int
the buffer capacity capacity, MemoryStack the stack from which to allocate stack)Returns a new |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE | |
| public static VkPastPresentationTimingGOOGLE. | |
| public static VkPastPresentationTimingGOOGLE. | |
| public static long | |
| public static long | |
| public static long | |
| public static int | |
| public static long | |
| public int | presentID()
an application-provided value that was given to a previous |
| public long | presentMargin()
an indication of how early the |
| public int |
| ACTUALPRESENTTIME | back to summary |
|---|---|
| public static final int ACTUALPRESENTTIME The struct member offsets. | |
| ALIGNOF | back to summary |
|---|---|
| public static final int ALIGNOF The struct alignment in bytes. | |
| DESIREDPRESENTTIME | back to summary |
|---|---|
| public static final int DESIREDPRESENTTIME The struct member offsets. | |
| EARLIESTPRESENTTIME | back to summary |
|---|---|
| public static final int EARLIESTPRESENTTIME The struct member offsets. | |
| PRESENTID | back to summary |
|---|---|
| public static final int PRESENTID The struct member offsets. | |
| PRESENTMARGIN | back to summary |
|---|---|
| public static final int PRESENTMARGIN The struct member offsets. | |
| SIZEOF | back to summary |
|---|---|
| public static final int SIZEOF The struct size in bytes. | |
| VkPastPresentationTimingGOOGLE | back to summary |
|---|---|
| protected VkPastPresentationTimingGOOGLE(long address, ByteBuffer container) | |
| VkPastPresentationTimingGOOGLE | back to summary |
|---|---|
| public VkPastPresentationTimingGOOGLE(ByteBuffer container) Creates a The created instance holds a strong reference to the container object. | |
| actualPresentTime | back to summary |
|---|---|
| public long actualPresentTime() the time when the image of the
| |
| calloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE calloc() Returns a new | |
| calloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Returns a new
| |
| calloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE calloc(MemoryStack stack) Returns a new
| |
| calloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Returns a new
| |
| callocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE callocStack()
Deprecated
Deprecated for removal in 3.4.0. Use
| |
| callocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE callocStack(MemoryStack stack)
Deprecated
Deprecated for removal in 3.4.0. Use
| |
| callocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Deprecated
Deprecated for removal in 3.4.0. Use
| |
| callocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Deprecated
Deprecated for removal in 3.4.0. Use
| |
| create | back to summary |
|---|---|
| protected VkPastPresentationTimingGOOGLE create(long address, ByteBuffer container) Implements abstract org. Doc from org. Similar to Effectively, every
| |
| create | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE create() Returns a new | |
| create | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE create(long address) Returns a new | |
| create | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Returns a new
| |
| create | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Create a
| |
| createSafe | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE createSafe(long address) Like
| |
| createSafe | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Like
| |
| desiredPresentTime | back to summary |
|---|---|
| public long desiredPresentTime() an application-provided value that was given to a previous
| |
| earliestPresentTime | back to summary |
|---|---|
| public long earliestPresentTime() the time when the image of the
| |
| malloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE malloc() Returns a new | |
| malloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Returns a new
| |
| malloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE malloc(MemoryStack stack) Returns a new
| |
| malloc | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Returns a new
| |
| mallocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE mallocStack()
Deprecated
Deprecated for removal in 3.4.0. Use
| |
| mallocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE mallocStack(MemoryStack stack)
Deprecated
Deprecated for removal in 3.4.0. Use
| |
| mallocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Deprecated
Deprecated for removal in 3.4.0. Use
| |
| mallocStack | back to summary |
|---|---|
| public static VkPastPresentationTimingGOOGLE. Deprecated
Deprecated for removal in 3.4.0. Use
| |
| nactualPresentTime | back to summary |
|---|---|
| public static long nactualPresentTime(long struct) Unsafe version of | |
| ndesiredPresentTime | back to summary |
|---|---|
| public static long ndesiredPresentTime(long struct) Unsafe version of | |
| nearliestPresentTime | back to summary |
|---|---|
| public static long nearliestPresentTime(long struct) Unsafe version of | |
| npresentID | back to summary |
|---|---|
| public static int npresentID(long struct) Unsafe version of | |
| npresentMargin | back to summary |
|---|---|
| public static long npresentMargin(long struct) Unsafe version of | |
| presentID | back to summary |
|---|---|
| public int presentID() an application-provided value that was given to a previous
| |
| presentMargin | back to summary |
|---|---|
| public long presentMargin() an indication of how early the
| |
| sizeof | back to summary |
|---|---|
| public int sizeof() Implements abstract org. Doc from org. Returns
| |
VkPastPresentationTimingGOOGLE structs.
| Modifier and Type | Field and Description |
|---|---|
| private static final VkPastPresentationTimingGOOGLE |
| Access | Constructor and Description |
|---|---|
| public | Buffer(ByteBuffer container)
Creates a new |
| public | |
| pack-priv |
| Modifier and Type | Method and Description |
|---|---|
| public long | Returns: the value of theVkPastPresentationTimingGOOGLE#actualPresentTime field.
|
| public long | Returns: the value of theVkPastPresentationTimingGOOGLE#desiredPresentTime field.
|
| public long | Returns: the value of theVkPastPresentationTimingGOOGLE#earliestPresentTime field.
|
| protected VkPastPresentationTimingGOOGLE | |
| public int | |
| public long | |
| protected VkPastPresentationTimingGOOGLE. |
| ELEMENT_FACTORY | back to summary |
|---|---|
| private static final VkPastPresentationTimingGOOGLE ELEMENT_FACTORY | |
| Buffer | back to summary |
|---|---|
| public Buffer(ByteBuffer container) Creates a new Changes to the container's content will be visible to the struct buffer instance and vice versa. The two buffers' position, limit, and mark values
will be independent. The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided
by The created buffer instance holds a strong reference to the container object. | |
| Buffer | back to summary |
|---|---|
| public Buffer(long address, int cap) | |
| Buffer | back to summary |
|---|---|
| pack-priv Buffer(long address, ByteBuffer container, int mark, int pos, int lim, int cap) | |
| actualPresentTime | back to summary |
|---|---|
public long actualPresentTime()
| |
| desiredPresentTime | back to summary |
|---|---|
public long desiredPresentTime()
| |
| earliestPresentTime | back to summary |
|---|---|
public long earliestPresentTime()
| |
| getElementFactory | back to summary |
|---|---|
| protected VkPastPresentationTimingGOOGLE getElementFactory() Implements abstract org.
| |
| presentID | back to summary |
|---|---|
public int presentID()
| |
| presentMargin | back to summary |
|---|---|
public long presentMargin()
| |
| self | back to summary |
|---|---|
| protected VkPastPresentationTimingGOOGLE. Implements abstract org.
| |