Name Strings

SPV_QCOM_image_vector_read_write

Contact

To report problems with this extension, please open a new issue at:

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

Status

  • Final

Version

Last Modified Date

2026-07-23

Revision

1

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 Capability

This extension introduces a new capability:

VectorImageOperationsQCOM

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
Add QCOM-defined vector image instructions.

Read/Write Access Shape

A new section in 3. "Binary Form".

Access Shape Enabling Capabilities

0x0

AccessShape2x1QCOM
2 elements in the form of a 2x1 vector (column-major). The two elements are ordered from left to right starting from element[0].
+-------+
| 0 | 1 |
+-------+

VectorImageOperationsQCOM

0x1

AccessShape3x1QCOM
3 elements in the form of a 3x1 vector (column-major). The three elements are ordered from left to right starting from element[0].
+-----------+
| 0 | 1 | 2 |
+-----------+

VectorImageOperationsQCOM

0x2

AccessShape4x1QCOM

4 elements in the form of a 4x1 vector (column-major). The four elements are ordered from left to right starting from element[0].
+---------------+
| 0 | 1 | 2 | 3 |
+---------------+

VectorImageOperationsQCOM

0x3

AccessShape2x2QCOM

4 elements in the form of a 2x2 vector.
For read operation, element[0] is the lower left element. The four elements are ordered in counter clock wise starting from element[0].
+-------+
| 3 | 2 |
+-------+
| 0 | 1 |
+-------+
For write operation, element[0] is the upper left element. The four elements are written out in the order illustrated in the following 2x2 quad.
+-------+
| 0 | 1 |
+-------+
| 2 | 3 |
+-------+

VectorImageOperationsQCOM

Instructions

Modify Section 3.3.10, "Image Instructions", adding before OpImageSampleFootprintNV:

OpImageVectorReadQCOM

Loads the specified component of each of the four adjacent texels according to the specified access shape and returns them as a vector of four components.

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:
VectorImageOperationsQCOM

7

4537

<id> Result Type

<id> Result

<id>
Texture Sampled Image

<id>
Coordinate

<id>
Component Id

Access Shape
Shape

OpImageVectorWriteQCOM

Write multiple values into the specified image at the adjacent locations according to the specified access shape.

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.

  • 32-bit / 16-bit floating point values for NV12YQCOM, P010YQCOM, TP10YQCOM, CompressedNV12YQCOM, CompressedP010YQCOM, and CompressedTP01YQCOM

  • vectors of 32-bit / 16-bit floating point values whose lengths are 2 for NV12UVQCOM, P010UVQCOM, TP10UVQCOM, CompressedNV12UVQCOM, CompressedP010UVQCOM, and CompressedTP10UVQCOM

  • 32-bit floating point scalar values for UNORM_MIPI10QCOM and UNORM_MIPI12QCOM

  • 32-bit integer scalar values for UNSIGNED_MIPI10QCOM and UNSIGNED_MIPI12QCOM

Capability:
VectorImageOperationsQCOM

7 + variable

4538

<id>
Image

<id>
Coordinate

Access Shape
Shape

Image Format
Format

<id>
Value 0

<id>
Value 1

Optional
<id>,<id>
Value 2, Value 3

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.

Issues

Revision History

Rev Date Author Changes

1

2026-07-23

Wooyoung Kim

Initial version