--background_vulkan_hidd--
Function
Provides OOP methods that dispatch Vulkan requests through a
driver-supplied Vulkan ICD. Driver subclasses supply
GetInstanceProcAddr; the base implementation of that method
returns NULL.
Notes
A Vulkan HIDD object requires the
aHidd_Vulkan_InterfaceVersion creation tag set to
VULKAN_INTERFACE_VERSION. Root.New rejects missing and mismatched
values. Method messages and IDs are defined in vulkan_hidd.h.
The base class caches the ICD's vkGetInstanceProcAddr pointer
and remembers the first successfully created VkInstance for
subsequent command lookup. It clears that instance pointer
when the same instance is destroyed.
Methods with a VkResult return expose it as IPTR. If an entry
point is unavailable, methods returning VkResult normally
return VK_ERROR_INITIALIZATION_FAILED. Methods returning
VOID normally skip an unavailable entry point. Individual
methods document exceptions to these defaults.
moHidd_Vulkan_AllocateCommandBuffers
Synopsis
struct pHidd_Vulkan_AllocateCommandBuffers
Function
Allocates command buffers from a command pool.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_AllocateDescriptorSets
Synopsis
struct pHidd_Vulkan_AllocateDescriptorSets
Function
Allocates descriptor sets from a descriptor pool.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_AllocateMemory
Synopsis
struct pHidd_Vulkan_AllocateMemory
Function
Allocates device memory of the requested size and memory type.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_BeginCommandBuffer
Synopsis
struct pHidd_Vulkan_BeginCommandBuffer
Function
Begins recording commands in a command buffer.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_BindBufferMemory
Synopsis
struct pHidd_Vulkan_BindBufferMemory
Function
Binds a device-memory allocation to a buffer.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_CmdBindDescriptorSets
Synopsis
struct pHidd_Vulkan_CmdBindDescriptorSets
Function
Records descriptor-set bindings.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdBindPipeline
Synopsis
struct pHidd_Vulkan_CmdBindPipeline
Function
Records a pipeline-binding command.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdCopyBuffer
Synopsis
struct pHidd_Vulkan_CmdCopyBuffer
Function
Records a buffer-to-buffer copy.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdDispatch
Synopsis
struct pHidd_Vulkan_CmdDispatch
Function
Records a compute-workgroup dispatch.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdFillBuffer
Synopsis
struct pHidd_Vulkan_CmdFillBuffer
Function
Records a buffer-fill operation.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdPipelineBarrier
Synopsis
struct pHidd_Vulkan_CmdPipelineBarrier
Function
Records execution and memory dependencies.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdPushConstants
Synopsis
struct pHidd_Vulkan_CmdPushConstants
Function
Records an update to push-constant values.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdResetEvent
Synopsis
struct pHidd_Vulkan_CmdResetEvent
Function
Records a command that resets an event.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdResetQueryPool
Synopsis
struct pHidd_Vulkan_CmdResetQueryPool
Function
Records a command that resets queries.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdSetEvent
Synopsis
struct pHidd_Vulkan_CmdSetEvent
Function
Records a command that sets an event.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdWaitEvents
Synopsis
struct pHidd_Vulkan_CmdWaitEvents
Function
Records a command that waits for events.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CmdWriteTimestamp
Synopsis
struct pHidd_Vulkan_CmdWriteTimestamp
Function
Records a timestamp write to a query pool.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_CreateBuffer
Synopsis
struct pHidd_Vulkan_CreateBuffer
Function
Creates a buffer with the requested size and usage.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
The base method sets size, usage, and sharingMode in
VkBufferCreateInfo. It does not supply queueFamilyIndexCount or
pQueueFamilyIndices, including for concurrent sharing mode.
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateCommandPool
Synopsis
struct pHidd_Vulkan_CreateCommandPool
Function
Creates a command pool for a queue family.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateComputePipelines
Synopsis
struct pHidd_Vulkan_CreateComputePipelines
Function
Creates compute pipelines from Vulkan create-info structures.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
Notes
The base implementation passes VK_NULL_HANDLE as the pipeline cache.
moHidd_Vulkan_CreateDescriptorPool
Synopsis
struct pHidd_Vulkan_CreateDescriptorPool
Function
Creates a pool used to allocate descriptor sets.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateDescriptorSetLayout
Synopsis
struct pHidd_Vulkan_CreateDescriptorSetLayout
Function
Creates a layout describing descriptor-set bindings.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateDevice
Synopsis
struct pHidd_Vulkan_CreateDevice
Function
Creates a logical Vulkan device for the selected physical device.
Result
Vulkan object handle, or NULL if creation fails or the entry point is
absent.
moHidd_Vulkan_CreateEvent
Synopsis
struct pHidd_Vulkan_CreateEvent
Function
Creates a Vulkan event.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
The base implementation passes a VkEventCreateInfo with sType set to
VK_STRUCTURE_TYPE_EVENT_CREATE_INFO.
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateFence
Synopsis
struct pHidd_Vulkan_CreateFence
Function
Creates a fence used for synchronization.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateInstance
Synopsis
struct pHidd_Vulkan_CreateInstance
Function
Creates a Vulkan instance using the driver's ICD entry point.
Result
Vulkan object handle, or NULL if creation fails or the entry point is
absent.
Notes
The base implementation creates a Vulkan 1.2 VkApplicationInfo and
retains the first successfully created instance for subsequent command
resolution. It does not keep a list of instances. DestroyInstance
clears that pointer only when destroying the retained instance.
The base method supplies VkInstanceCreateInfo with no instance
extensions or layers enabled and passes NULL allocation callbacks.
The message provides no extension or layer lists.
moHidd_Vulkan_CreatePipelineLayout
Synopsis
struct pHidd_Vulkan_CreatePipelineLayout
Function
Creates a layout for descriptor sets and push constants.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateQueryPool
Synopsis
struct pHidd_Vulkan_CreateQueryPool
Function
Creates a query pool.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateSemaphore
Synopsis
struct pHidd_Vulkan_CreateSemaphore
Function
Creates a semaphore used for queue synchronization.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
If pCreateInfo is NULL, the base implementation supplies a
VkSemaphoreCreateInfo containing sType and no explicit flags.
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_CreateShaderModule
Synopsis
struct pHidd_Vulkan_CreateShaderModule
Function
Creates a shader module from SPIR-V code.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED when the
entry point is absent.
Notes
The method constructs VkShaderModuleCreateInfo with the supplied code
and codeSize before invoking the ICD.
If the ICD entry point is unavailable, the base method returns
VK_ERROR_INITIALIZATION_FAILED without writing its output handle.
When the ICD entry point is called, the returned handle is written
even if the ICD reports a failure; the local handle starts as NULL.
moHidd_Vulkan_DestroyBuffer
Synopsis
struct pHidd_Vulkan_DestroyBuffer
Function
Destroys a Vulkan buffer.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DestroyDescriptorPool
Synopsis
struct pHidd_Vulkan_DestroyDescriptorPool
Function
Destroys a descriptor pool.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DestroyDescriptorSetLayout
Synopsis
struct pHidd_Vulkan_DestroyDescriptorSetLayout
Function
Destroys a descriptor-set layout.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DestroyDevice
Synopsis
struct pHidd_Vulkan_DestroyDevice
Function
Destroys a logical Vulkan device.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DestroyInstance
Synopsis
struct pHidd_Vulkan_DestroyInstance
Function
Releases a Vulkan instance through the driver's ICD.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
Notes
Destroying the retained instance clears the base class's instance
pointer. Other instances do not replace that pointer.
The base method clears its cached instance pointer for a matching
handle even when the ICD destroy entry point is unavailable.
moHidd_Vulkan_DestroyPipeline
Synopsis
struct pHidd_Vulkan_DestroyPipeline
Function
Destroys a Vulkan pipeline.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DestroyPipelineLayout
Synopsis
struct pHidd_Vulkan_DestroyPipelineLayout
Function
Destroys a pipeline layout.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DestroyShaderModule
Synopsis
struct pHidd_Vulkan_DestroyShaderModule
Function
Destroys a shader module.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_DeviceWaitIdle
Synopsis
struct pHidd_Vulkan_DeviceWaitIdle
Function
Waits for outstanding operations on a logical device to finish.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_DisplayResource
Synopsis
struct pHidd_Vulkan_DisplayResource
Function
Provides an optional driver-specific path for presenting an image.
Result
No value. The base class performs no presentation.
Notes
The base implementation has an empty method body. A display-capable
driver must provide the presentation behavior.
moHidd_Vulkan_EndCommandBuffer
Synopsis
struct pHidd_Vulkan_EndCommandBuffer
Function
Ends command-buffer recording.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_EnumerateDeviceExtensionProperties
Synopsis
struct pHidd_Vulkan_EnumerateDeviceExtensionProperties
Function
Enumerates the extensions exposed by a physical device.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_EnumerateInstanceExtensionProperties
Synopsis
struct pHidd_Vulkan_EnumerateInstanceExtensionProperties
Function
Enumerates the ICD's instance extensions.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_EnumerateInstanceVersion
Synopsis
struct pHidd_Vulkan_EnumerateInstanceVersion
Function
Reads the Vulkan API version exposed by the ICD.
Result
VkResult converted to IPTR. If the entry point is absent, the method
writes Vulkan 1.0 and returns VK_SUCCESS.
Notes
If the ICD lacks vkEnumerateInstanceVersion, the base implementation
writes VK_API_VERSION_1_0 and returns VK_SUCCESS.
moHidd_Vulkan_EnumeratePhysicalDevices
Synopsis
struct pHidd_Vulkan_EnumeratePhysicalDevices
Function
Enumerates physical devices associated with an instance.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_FreeCommandBuffers
Synopsis
struct pHidd_Vulkan_FreeCommandBuffers
Function
Frees command buffers allocated from a command pool.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_FreeMemory
Synopsis
struct pHidd_Vulkan_FreeMemory
Function
Frees a Vulkan device-memory allocation.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetBufferDeviceAddress
Synopsis
struct pHidd_Vulkan_GetBufferDeviceAddress
Function
Queries a buffer's Vulkan device address.
Result
Device address converted to IPTR, or zero when the entry point is
unavailable.
Notes
The base method returns IPTR, while vkGetBufferDeviceAddress returns a
Vulkan device address. On a target where IPTR is narrower than that
address, the conversion cannot represent all possible values.
moHidd_Vulkan_GetBufferMemoryRequirements
Synopsis
struct pHidd_Vulkan_GetBufferMemoryRequirements
Function
Queries the memory requirements of a buffer.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetDeviceProcAddr
Synopsis
struct pHidd_Vulkan_GetDeviceProcAddr
Function
Resolves a device-level Vulkan function by name.
Result
ICD function pointer, or NULL if the required entry point is
unavailable.
Notes
The base implementation looks up vkGetDeviceProcAddr through the
instance dispatch path retained by CreateInstance. A missing entry
point returns NULL.
moHidd_Vulkan_GetDeviceQueue
Synopsis
struct pHidd_Vulkan_GetDeviceQueue
Function
Retrieves a queue handle from a logical device.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
Notes
The base implementation initializes a local queue handle to NULL and
writes it to pQueue after attempting vkGetDeviceQueue.
moHidd_Vulkan_GetFenceStatus
Synopsis
struct pHidd_Vulkan_GetFenceStatus
Function
Queries whether a fence is signaled.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_GetInstanceProcAddr
Synopsis
struct pHidd_Vulkan_GetInstanceProcAddr
Function
Resolves an instance-level Vulkan function by name.
Result
NULL from the base class. A subclass can return an ICD function
pointer.
Notes
The base implementation always returns NULL. Driver subclasses must
override this method to supply their Vulkan ICD entry points.
moHidd_Vulkan_GetMemoryHostPointerPropertiesEXT
Synopsis
struct pHidd_Vulkan_GetMemoryHostPointerPropertiesEXT
Function
Queries external-memory properties for a host pointer.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_GetPhysicalDeviceFeatures
Synopsis
struct pHidd_Vulkan_GetPhysicalDeviceFeatures
Function
Reads the supported features of a physical device.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetPhysicalDeviceFeatures2
Synopsis
struct pHidd_Vulkan_GetPhysicalDeviceFeatures2
Function
Reads extended physical-device features.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetPhysicalDeviceMemoryProperties
Synopsis
struct pHidd_Vulkan_GetPhysicalDeviceMemoryProperties
Function
Reads the memory heaps and types of a physical device.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetPhysicalDeviceProperties
Synopsis
struct pHidd_Vulkan_GetPhysicalDeviceProperties
Function
Reads the properties of a physical device.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetPhysicalDeviceProperties2
Synopsis
struct pHidd_Vulkan_GetPhysicalDeviceProperties2
Function
Reads extended physical-device properties.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetPhysicalDeviceQueueFamilyProperties
Synopsis
struct pHidd_Vulkan_GetPhysicalDeviceQueueFamilyProperties
Function
Enumerates the queue families of a physical device.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_GetQueryPoolResults
Synopsis
struct pHidd_Vulkan_GetQueryPoolResults
Function
Retrieves data from queries in a query pool.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_MapMemory
Synopsis
struct pHidd_Vulkan_MapMemory
Function
Maps an allocation into the host address space.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_QueueSubmit
Synopsis
struct pHidd_Vulkan_QueueSubmit
Function
Submits command buffers to a Vulkan queue.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_QueueWaitIdle
Synopsis
struct pHidd_Vulkan_QueueWaitIdle
Function
Waits until a Vulkan queue is idle.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_ResetCommandPool
Synopsis
struct pHidd_Vulkan_ResetCommandPool
Function
Resets a command pool and its allocated command buffers.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_ResetEvent
Synopsis
struct pHidd_Vulkan_ResetEvent
Function
Clears the signaled state of an event.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_ResetFences
Synopsis
struct pHidd_Vulkan_ResetFences
Function
Resets one or more fences.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_ResetQueryPool
Synopsis
struct pHidd_Vulkan_ResetQueryPool
Function
Resets a range of queries.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_SetEvent
Synopsis
struct pHidd_Vulkan_SetEvent
Function
Sets the signaled state of an event.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.
moHidd_Vulkan_UpdateDescriptorSets
Synopsis
struct pHidd_Vulkan_UpdateDescriptorSets
Function
Updates the descriptors referenced by descriptor sets.
Result
No return value. If the Vulkan entry point is absent, the base method
does not invoke it.
moHidd_Vulkan_WaitForFences
Synopsis
struct pHidd_Vulkan_WaitForFences
Function
Waits for the specified fences.
Result
VkResult converted to IPTR, or VK_ERROR_INITIALIZATION_FAILED if the
requested Vulkan entry point is unavailable.