SPV_INTEL_media_block_io

5579

SubgroupImageMediaBlockIOINTEL

SPV_INTEL_media_block_io

OpSubgroupImageMediaBlockReadINTEL

Reads a block of data from a 2D region of the specified Image.

Image must be an object whose type is OpTypeImage with a Sampled operand of 0 or 2.

The Result Type is used to compute the maximum size of the 2D region that may be read, and may be a scalar or a vector type. For this description, the block read Component Type is defined as the Result Type if Result Type is a scalar type, or as the vector Component Type if Result Type is a vector type.

The size of the 2D region to read is specified by the Width and Height operands. The Width of the 2D region is expressed in units of the block read Component Type, and the Height directly describes the number of rows of the 2D region to read.

The Coordinate describes where in the Image to start reading the 2D region, and must be a vector of integer type. The first component of the Coordinate is a byte coordinate into a row of the Image and is not expressed in units of the block read Component Type. Remaining coordinates are non-normalized texel coordinates.

The data read from the 2D region is assigned to Result for each invocation in the subgroup by reorganizing the data read from the 2D region into a different 2D destination region in row major order. The width of the destination 2D region is equivalent to SubgroupMaxSize in units of the Component Type, and the height of the destination 2D region is equivalent to one if Result Type is a scalar type, or to the vector Component Count if Result Type is a vector type. The reorganization assigns rows of the source 2D region to the destination 2D region in row-major order. If the source 2D region row byte width is not a power-of-two then the source 2D region row is assigned to the destination 2D region with undefined padding values to make a power-of-two row byte width. Each invocation in the subgroup is then assigned a Component Type column vector of the reorganized 2D region, i.e. each invocation_s subsequent data element_s index is strided by the SubgroupMaxSize in the 2D destination region.

If the size of the requested 2D region to read is smaller than the 2D destination region then some tail components of some Result values will not be assigned values. If the size of the 2D region to read is larger than the 2D destination region then some parts of the 2D region to read will be not be assigned and will be dropped.

Capability:
SubgroupImageMediaBlockIOINTEL

7

5580

<id> Result Type

<id> Result

<id> Image

<id> Coordinate

<id> Width

<id> Height

OpSubgroupImageMediaBlockWriteINTEL

Writes a block of data into a 2D region of the specified Image.

Image must be an object whose type is OpTypeImage with a Sampled operand of 0 or 2.

The type of Data is used to compute the maximum size of the 2D region that may be written, and may be a scalar or a vector type. For this description, the block write Component Type is defined as the type of Data if it is a scalar type, or the vector Component Type if it is a vector type.

The size of the 2D region to write is specified by the Width and Height operands. The Width of the 2D region is expressed in units of the block write Component Type, and the Height directly describes the number of rows of the 2D region to write.

The Coordinate describes where in the Image to start writing the 2D region, and must be a vector of integer type. The first component of the Coordinate is a byte coordinate into a row of the Image and is not expressed in units of the Component Type. Remaining coordinates are non-normalized texel coordinates.

The Data for each invocation in the subgroup collectively forms a 2D source region, where the width of the 2D source region is equivalent to the SubgroupMaxSize in units of the block write Component Type, and the height of the 2D source region is equivalent to one if the type of Data is a scalar type, or to the vector Component Count if it is a vector type. This 2D source region is then reorganized into a different 2D region to write. The reorganization assigns data from the 2D source region to rows of the 2D region to write in row-major order. If the row byte width of the 2D region to write is not a power-of-two, then some values from the 2D source region are skipped during assignment, so that each row of the 2D region to write begins at an byte offset that is a power-of-two.

If the size of the 2D source region is greater than the size of the 2D region to write then some tail components of some Data values will not be written. This SPIR-V extension does not require any specific behavior when the size of the 2D source region is smaller than the size of the 2D region to write, but some environments may define behavior for this case.

Capability:
SubgroupImageMediaBlockIOINTEL

6

5581

<id> Image

<id> Coordinate

<id> Width

<id> Height

<id> Data