Graphics.Vulkan.Core10.Event

Documentation

newtype VkEventCreateFlags

VkEventCreateFlags - Reserved for future use

Description

VkEventCreateFlags is a bitmask type for setting a mask, but is currently reserved for future use.

See Also

VkEventCreateInfo

Constructors

VkEventCreateFlags VkFlags

Instances

Eq VkEventCreateFlags

Methods

(==) :: VkEventCreateFlags -> VkEventCreateFlags -> Bool

(/=) :: VkEventCreateFlags -> VkEventCreateFlags -> Bool

Ord VkEventCreateFlags

Methods

compare :: VkEventCreateFlags -> VkEventCreateFlags -> Ordering

(<) :: VkEventCreateFlags -> VkEventCreateFlags -> Bool

(<=) :: VkEventCreateFlags -> VkEventCreateFlags -> Bool

(>) :: VkEventCreateFlags -> VkEventCreateFlags -> Bool

(>=) :: VkEventCreateFlags -> VkEventCreateFlags -> Bool

max :: VkEventCreateFlags -> VkEventCreateFlags -> VkEventCreateFlags

min :: VkEventCreateFlags -> VkEventCreateFlags -> VkEventCreateFlags

Read VkEventCreateFlags

Methods

readsPrec :: Int -> ReadS VkEventCreateFlags

readList :: ReadS [VkEventCreateFlags]

readPrec :: ReadPrec VkEventCreateFlags

readListPrec :: ReadPrec [VkEventCreateFlags]

Show VkEventCreateFlags

Methods

showsPrec :: Int -> VkEventCreateFlags -> ShowS

show :: VkEventCreateFlags -> String

showList :: [VkEventCreateFlags] -> ShowS

Storable VkEventCreateFlags

Methods

sizeOf :: VkEventCreateFlags -> Int

alignment :: VkEventCreateFlags -> Int

peekElemOff :: Ptr VkEventCreateFlags -> Int -> IO VkEventCreateFlags

pokeElemOff :: Ptr VkEventCreateFlags -> Int -> VkEventCreateFlags -> IO ()

peekByteOff :: Ptr b -> Int -> IO VkEventCreateFlags

pokeByteOff :: Ptr b -> Int -> VkEventCreateFlags -> IO ()

peek :: Ptr VkEventCreateFlags -> IO VkEventCreateFlags

poke :: Ptr VkEventCreateFlags -> VkEventCreateFlags -> IO ()

Bits VkEventCreateFlags

Methods

(.&.) :: VkEventCreateFlags -> VkEventCreateFlags -> VkEventCreateFlags

(.|.) :: VkEventCreateFlags -> VkEventCreateFlags -> VkEventCreateFlags

xor :: VkEventCreateFlags -> VkEventCreateFlags -> VkEventCreateFlags

complement :: VkEventCreateFlags -> VkEventCreateFlags

shift :: VkEventCreateFlags -> Int -> VkEventCreateFlags

rotate :: VkEventCreateFlags -> Int -> VkEventCreateFlags

zeroBits :: VkEventCreateFlags

bit :: Int -> VkEventCreateFlags

setBit :: VkEventCreateFlags -> Int -> VkEventCreateFlags

clearBit :: VkEventCreateFlags -> Int -> VkEventCreateFlags

complementBit :: VkEventCreateFlags -> Int -> VkEventCreateFlags

testBit :: VkEventCreateFlags -> Int -> Bool

bitSizeMaybe :: VkEventCreateFlags -> Maybe Int

bitSize :: VkEventCreateFlags -> Int

isSigned :: VkEventCreateFlags -> Bool

shiftL :: VkEventCreateFlags -> Int -> VkEventCreateFlags

unsafeShiftL :: VkEventCreateFlags -> Int -> VkEventCreateFlags

shiftR :: VkEventCreateFlags -> Int -> VkEventCreateFlags

unsafeShiftR :: VkEventCreateFlags -> Int -> VkEventCreateFlags

rotateL :: VkEventCreateFlags -> Int -> VkEventCreateFlags

rotateR :: VkEventCreateFlags -> Int -> VkEventCreateFlags

popCount :: VkEventCreateFlags -> Int

FiniteBits VkEventCreateFlags

Methods

finiteBitSize :: VkEventCreateFlags -> Int

countLeadingZeros :: VkEventCreateFlags -> Int

countTrailingZeros :: VkEventCreateFlags -> Int

type VkEvent = Ptr VkEvent_T

VkEvent - Opaque handle to a event object

Description

See Also

vkCmdResetEvent, vkCmdSetEvent, vkCmdWaitEvents, vkCreateEvent, vkDestroyEvent, vkGetEventStatus, vkResetEvent, vkSetEvent

vkCreateEvent :: ("device" ::: VkDevice) -> ("pCreateInfo" ::: Ptr VkEventCreateInfo) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pEvent" ::: Ptr VkEvent) -> IO VkResult

vkCreateEvent - Create a new event object

Parameters

• device is the logical device that creates the event.

• pCreateInfo is a pointer to an instance of the VkEventCreateInfo structure which contains information about how the event is to be created.
• pAllocator controls host memory allocation as described in the Memory Allocation chapter.
• pEvent points to a handle in which the resulting event object is returned.

Description

When created, the event object is in the unsignaled state.

Valid Usage (Implicit)

• device must be a valid VkDevice handle

• pCreateInfo must be a valid pointer to a valid VkEventCreateInfo structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure
• pEvent must be a valid pointer to a VkEvent handle

Return Codes

Success

- VK_SUCCESS

Failure

- VK_ERROR_OUT_OF_HOST_MEMORY

• VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkAllocationCallbacks, VkDevice, VkEvent, VkEventCreateInfo

vkDestroyEvent :: ("device" ::: VkDevice) -> ("event" ::: VkEvent) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> IO ()

vkDestroyEvent - Destroy an event object

Parameters

• device is the logical device that destroys the event.

• event is the handle of the event to destroy.
• pAllocator controls host memory allocation as described in the Memory Allocation chapter.

Description

Valid Usage

• All submitted commands that refer to event must have completed execution

• If VkAllocationCallbacks were provided when event was created, a compatible set of callbacks must be provided here
• If no VkAllocationCallbacks were provided when event was created, pAllocator must be NULL

Valid Usage (Implicit)

• device must be a valid VkDevice handle

• If event is not VK_NULL_HANDLE, event must be a valid VkEvent handle
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure
• If event is a valid handle, it must have been created, allocated, or retrieved from device

Host Synchronization

• Host access to event must be externally synchronized

See Also

VkAllocationCallbacks, VkDevice, VkEvent

vkGetEventStatus :: ("device" ::: VkDevice) -> ("event" ::: VkEvent) -> IO VkResult

vkGetEventStatus - Retrieve the status of an event object

Parameters

• device is the logical device that owns the event.

• event is the handle of the event to query.

Description

Upon success, vkGetEventStatus returns the state of the event object with the following return codes:

+-----------------------------------+-----------------------------------+
| Status                            | Meaning                           |
+===================================+===================================+
| @VK_EVENT_SET@                    | The event specified by @event@ is |
|                                   | signaled.                         |
+-----------------------------------+-----------------------------------+
| @VK_EVENT_RESET@                  | The event specified by @event@ is |
|                                   | unsignaled.                       |
+-----------------------------------+-----------------------------------+

Event Object Status Codes

If a vkCmdSetEvent or vkCmdResetEvent command is in a command buffer that is in the pending state, then the value returned by this command may immediately be out of date.

The state of an event can be updated by the host. The state of the event is immediately changed, and subsequent calls to vkGetEventStatus will return the new state. If an event is already in the requested state, then updating it to the same state has no effect.

Valid Usage (Implicit)

• device must be a valid VkDevice handle

• event must be a valid VkEvent handle
• event must have been created, allocated, or retrieved from device

Return Codes

Success

- VK_EVENT_SET

• VK_EVENT_RESET

Failure

- VK_ERROR_OUT_OF_HOST_MEMORY

• VK_ERROR_OUT_OF_DEVICE_MEMORY

• VK_ERROR_DEVICE_LOST

See Also

VkDevice, VkEvent

vkSetEvent :: ("device" ::: VkDevice) -> ("event" ::: VkEvent) -> IO VkResult

vkSetEvent - Set an event to signaled state

Parameters

• device is the logical device that owns the event.

• event is the event to set.

Description

When vkSetEvent is executed on the host, it defines an /event signal operation/ which sets the event to the signaled state.

If event is already in the signaled state when vkSetEvent is executed, then vkSetEvent has no effect, and no event signal operation occurs.

Valid Usage (Implicit)

• device must be a valid VkDevice handle

• event must be a valid VkEvent handle
• event must have been created, allocated, or retrieved from device

Host Synchronization

• Host access to event must be externally synchronized

Return Codes

Success

- VK_SUCCESS

Failure

- VK_ERROR_OUT_OF_HOST_MEMORY

• VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDevice, VkEvent

vkResetEvent :: ("device" ::: VkDevice) -> ("event" ::: VkEvent) -> IO VkResult

vkResetEvent - Reset an event to non-signaled state

Parameters

• device is the logical device that owns the event.

• event is the event to reset.

Description

When vkResetEvent is executed on the host, it defines an /event unsignal operation/ which resets the event to the unsignaled state.

If event is already in the unsignaled state when vkResetEvent is executed, then vkResetEvent has no effect, and no event unsignal operation occurs.

Valid Usage

• event must not be waited on by a vkCmdWaitEvents command that is currently executing

Valid Usage (Implicit)

• device must be a valid VkDevice handle

• event must be a valid VkEvent handle
• event must have been created, allocated, or retrieved from device

Host Synchronization

• Host access to event must be externally synchronized

Return Codes

Success

- VK_SUCCESS

Failure

- VK_ERROR_OUT_OF_HOST_MEMORY

• VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDevice, VkEvent

data VkEventCreateInfo

VkEventCreateInfo - Structure specifying parameters of a newly created event

Description

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_EVENT_CREATE_INFO

• pNext must be NULL
• flags must be 0

See Also

VkEventCreateFlags, VkStructureType, vkCreateEvent

Constructors

VkEventCreateInfo

Fields

• vkSType :: VkStructureType

  sType is the type of this structure.

• vkPNext :: Ptr ()

  pNext is NULL or a pointer to an extension-specific structure.

• vkFlags :: VkEventCreateFlags

  flags is reserved for future use.

Instances

Eq VkEventCreateInfo

Methods

(==) :: VkEventCreateInfo -> VkEventCreateInfo -> Bool

(/=) :: VkEventCreateInfo -> VkEventCreateInfo -> Bool

Show VkEventCreateInfo

Methods

showsPrec :: Int -> VkEventCreateInfo -> ShowS

show :: VkEventCreateInfo -> String

showList :: [VkEventCreateInfo] -> ShowS

Storable VkEventCreateInfo

Methods

sizeOf :: VkEventCreateInfo -> Int

alignment :: VkEventCreateInfo -> Int

peekElemOff :: Ptr VkEventCreateInfo -> Int -> IO VkEventCreateInfo

pokeElemOff :: Ptr VkEventCreateInfo -> Int -> VkEventCreateInfo -> IO ()

peekByteOff :: Ptr b -> Int -> IO VkEventCreateInfo

pokeByteOff :: Ptr b -> Int -> VkEventCreateInfo -> IO ()

peek :: Ptr VkEventCreateInfo -> IO VkEventCreateInfo

poke :: Ptr VkEventCreateInfo -> VkEventCreateInfo -> IO ()