Contributors
-
Adam Brouwers-Harries, Qualcomm
-
Balaji Calidas, Qualcomm
-
Victor Lomuller, Qualcomm
-
Wooyoung Kim, Qualcomm
Notice
Copyright (c) 2026 The Khronos Group Inc. Copyright terms at http://www.khronos.org/registry/speccopyright.html
Dependencies
This extension is written against the SPIR-V Specification, Version 1.6 Revision 6.
This extension requires SPIR-V 1.4.
Overview
This extension introduces two vector read/write instructions on images along with new image formats.
Extension Name
To use this extension within a SPIR-V module, the following OpExtension must be present in the module:
OpExtension "SPV_QCOM_image_vector_read_write"
New Image Formats
The extension adds the following new image formats.
NV12QCOM NV12YQCOM NV12UVQCOM P010QCOM P010YQCOM P010UVQCOM TP10QCOM TP10YQCOM TP10UVQCOM UNORM_MIPI10QCOM UNORM_MIPI12QCOM UNSIGNED_MIPI10QCOM UNSIGNED_MIPI12QCOM CompressedRGBAQCOM CompressedRGBxQCOM CompressedNV12QCOM CompressedNV12YQCOM CompressedNV12UVQCOM CompressedP010QCOM CompressedP010YQCOM CompressedP010UVQCOM CompressedTP10QCOM CompressedTP10YQCOM CompressedTP10UVQCOM CompressedNV124RQCOM CompressedNV124RYQCOM CompressedNV124RUVQCOM
New Instructions
Instructions added under the VectorImageOperationsQCOM capability:
OpImageVectorReadQCOM OpImageVectorWriteQCOM
Modifications to the SPIR-V Specification, Version 1.6
Image Format
Modify Section 3.2.10, "Image Format", adding the following rows to the Image Format table:
| Image Format | Enabling Capabilities | |
|---|---|---|
4510 |
NV12QCOM |
VectorImageOperationsQCOM |
4511 |
NV12YQCOM |
VectorImageOperationsQCOM |
4512 |
NV12UVQCOM |
VectorImageOperationsQCOM |
4513 |
P010QCOM |
VectorImageOperationsQCOM |
4514 |
P010YQCOM |
VectorImageOperationsQCOM |
4515 |
P010UVQCOM |
VectorImageOperationsQCOM |
4516 |
TP10QCOM |
VectorImageOperationsQCOM |
4517 |
TP10YQCOM |
VectorImageOperationsQCOM |
4518 |
TP10UVQCOM |
VectorImageOperationsQCOM |
4519 |
UNORM_MIPI10QCOM |
VectorImageOperationsQCOM |
4520 |
UNORM_MIPI12QCOM |
VectorImageOperationsQCOM |
4521 |
UNSIGNED_MIPI10QCOM |
VectorImageOperationsQCOM |
4522 |
UNSIGNED_MIPI12QCOM |
VectorImageOperationsQCOM |
4523 |
CompressedRGBAQCOM |
VectorImageOperationsQCOM |
4524 |
CompressedRGBxQCOM |
VectorImageOperationsQCOM |
4525 |
CompressedNV12QCOM |
VectorImageOperationsQCOM |
4526 |
CompressedNV12YQCOM |
VectorImageOperationsQCOM |
4527 |
CompressedNV12UVQCOM |
VectorImageOperationsQCOM |
4528 |
CompressedP010QCOM |
VectorImageOperationsQCOM |
4529 |
CompressedP010YQCOM |
VectorImageOperationsQCOM |
4530 |
CompressedP010UVQCOM |
VectorImageOperationsQCOM |
4531 |
CompressedTP10QCOM |
VectorImageOperationsQCOM |
4532 |
CompressedTP10YQCOM |
VectorImageOperationsQCOM |
4533 |
CompressedTP10UVQCOM |
VectorImageOperationsQCOM |
4534 |
CompressedNV124RQCOM |
VectorImageOperationsQCOM |
4535 |
CompressedNV124RYQCOM |
VectorImageOperationsQCOM |
4536 |
CompressedNV124RUVQCOM |
VectorImageOperationsQCOM |
Capability
Modify Section 3.2.30, "Capability", adding one row to the Capability table:
| Capability | Implicitly declares | |
|---|---|---|
4509 |
VectorImageOperationsQCOM |
|
Read/Write Access Shape
A new section in 3. "Binary Form".
| Access Shape | Enabling Capabilities | |
|---|---|---|
0x0 |
AccessShape2x1QCOM |
VectorImageOperationsQCOM |
0x1 |
AccessShape3x1QCOM |
VectorImageOperationsQCOM |
0x2 |
AccessShape4x1QCOM |
VectorImageOperationsQCOM |
0x3 |
AccessShape2x2QCOM |
VectorImageOperationsQCOM |
Instructions
Modify Section 3.3.10, "Image Instructions", adding before OpImageSampleFootprintNV:
OpImageVectorReadQCOM Result Type is a vector type with four components. The element type is one of 32-bit floating-point type, 16-bit floating-point type, and 32-bit signed/unsigned integer type. Texture Sampled Image must be an object whose type is OpTypeSampledImage. The MS operand of the underlying OpTypeImage must be 0. The Sampled operand of the OpTypeImage is defined by the execution environment. Coordinate must be a vector of floating-point type, whose vector size is 2. Component Id must be a 32-bit integer type scalar and be one of 0, 1, 2, and 3 which correspond to R, G, B, and A, respectively, of the RGBA channel order. Shape is the read access shape and is either AccessShape4x1QCOM or AccessShape2x2QCOM. See Access Shape. For AccessShape2x2QCOM, the base point specified by Coordinate is the upper left corner of the 2x2 vector. Value 0 read is the value at the lower left corner. For AccessShape4x1QCOM, value 0 read is the value located at the base point Coordinate. |
Capability: |
||||||
7 |
4537 |
<id> Result Type |
<id> Result |
<id> |
<id> |
<id> |
Access Shape |
OpImageVectorWriteQCOM Image must be an object whose type is OpTypeImage. The type must not have the Unknown image format. The behavior is undefined if the type has the image format that is not supported. The Sampled operand of the OpTypeImage is defined by the execution environment. Coordinate must be a vector of integer type whose vector size is 2. Shape is the write access shape. See Access Shape. AccessShape2x1QCOM requires no additional operand. AccessShape3x1QCOM requires one additional operand; a total of three values are written. AccessShape4x1QCOM and AccessShape2x2QCOM require two additional operands; a total of four values are written. Value 0 is the value located at the base point Coordinate. Format is the image format associated with Image. See Image Format. Values depend on the image format associated with Image.
|
Capability: |
|||||||
7 + variable |
4538 |
<id> |
<id> |
Access Shape |
Image Format |
<id> |
<id> |
Optional |
Validation Rules
An OpExtension must be added to the SPIR-V for validation layers to check legal use of this extension:
OpExtension "SPV_QCOM_image_vector_read_write"
OpImageVectorWriteQCOM accepts only the image formats defined in the SPV_QCOM_image_vector_read_write extension. The behavior is undefined if NV12QCOM, P010QCOM, or TP10QCOM is passed as Format to OpImageVectorWriteQCOM.
The number of the Values operands and their types passed to OpImageVectorWriteQCOM must be consistent to the image format specified with the Format operand.