VkTensorDescriptionARM

The VkTensorDescriptionARM structure is defined as:

typedef struct VkTensorDescriptionARM {
    VkStructureType sType;
    const void* pNext;
    VkTensorTilingARM tiling;
    VkFormat format;
    uint32_t dimensionCount;
    const int64_t* pDimensions;
    const int64_t* pStrides;
    VkTensorUsageFlagsARM usage;
} VkTensorDescriptionARM;

pub struct TensorDescriptionARM {
    s_type: vk::StructureType,
    p_next: *const c_void,
    tiling: vk::TensorTilingARM,
    format: vk::Format,
    dimension_count: u32,
    p_dimensions: *const i64,
    p_strides: *const i64,
    usage: vk::TensorUsageFlagsARM,
}

• sType is a VkStructureType value identifying this structure.
• pNext is NULL or a pointer to a structure extending this structure.
• tiling is a VkTensorTilingARM value specifying the tiling of the tensor
• format is a one component VkFormat describing the format and type of the data elements that will be contained in the tensor.
• dimensionCount is the number of dimensions for the tensor.
• pDimensions is a pointer to an array of integers of size dimensionCount providing the number of data elements in each dimension.
• pStrides is either NULL or is an array of size dimensionCount providing the strides in bytes for the tensor in each dimension.
• usage is a bitmask of VkTensorUsageFlagBitsARM specifying the usage of the tensor.

When describing a tensor created with VK_TENSOR_TILING_OPTIMAL_ARM, pStrides must be equal to NULL. When describing a tensor created with VK_TENSOR_TILING_LINEAR_ARM, pStrides is either an array of size dimensionCount or NULL.

The formats that must be supported for format are documented in features-formats-mandatory-features-tensor.

Each element in the pStrides array describes the offset in bytes between increments of the given dimension. For example, pStrides[0] describes the offset between element [x0,x1,x2,x3] and element [x0+1,x1,x2,x3]. The pStrides array can be used to determine whether a tensor is packed or not. If pStrides[dimensionCount-1] is equal to the size of a tensor element and for each dimension n greater than 0 and less than dimensionCount, pStrides[n-1] is equal to pStrides[n] * pDimensions[n], then the tensor is a packed tensor. If the tensorNonPacked feature is not enabled, the tensor must be a packed tensor.

When a tensor is created with VK_TENSOR_TILING_LINEAR_ARM and pStrides equal to NULL the tensor strides are calculated by the vulkan implementation such that the resulting tensor is a packed tensor.

Expressed as an addressing formula, the starting byte of an element in a 4-dimensional, for example, linear tensor has address:

// Assume (x0,x1,x2,x3) are in units of elements.

address(x0,x1,x2,x3) = x0*pStrides[0] + x1*pStrides[1] + x2*pStrides[2] + x3*pStrides[3]