Add specification for cl_ext_image_unorm_int_2_101010 (#1223)

* Add specification for cl_ext_image_unorm_int_2_101010

Change-Id: I51b0ec6f719c30a01637c56047a86d31fd78b7ca

* Update OpenCL_C.txt

Co-authored-by: Ben Ashbaugh <ben.ashbaugh@intel.com>

* review comments

Change-Id: Ib1ac6320c4f391336074f468158187e76099c7b9

---------

Co-authored-by: Ben Ashbaugh <ben.ashbaugh@intel.com>

OpenCL_C.txt

@@ -246,6 +246,12 @@ clock shared by all work-items executing in the same work-group.
 clock shared by all work-items executing in the same sub-group.
 endif::cl_khr_kernel_clock[]
 
+ifdef::cl_ext_image_unorm_int_2_101010[]
+| {opencl_c_ext_image_unorm_int_2_101010}
+| The OpenCL C compiler supports `CLK_UNORM_INT_2_101010_EXT` and returning it
+from `get_image_channel_data_type`.
+endif::cl_ext_image_unorm_int_2_101010[]
+
 |====
 
 In OpenCL C 3.0 or newer, feature macros must expand to the value `1` if the
@@ -12483,6 +12489,14 @@ endif::cl_khr_gl_msaa_sharing[]
 
       `CLK_UNORM_INT_101010_2` footnote:[{fn-CLK_UNORM_INT_101010_2}]
 
+ifdef::cl_ext_image_unorm_int_2_101010[]
+      Additionally, if the {opencl_c_ext_image_unorm_int_2_101010} feature is
+      supported:
+
+      `CLK_UNORM_INT_2_101010_EXT`
+
+endif::cl_ext_image_unorm_int_2_101010[]
+
 | int *get_image_channel_order*(_aQual_ image2d_t _image_) +
   int *get_image_channel_order*(_aQual_ image3d_t _image_)
 

api/cl_ext_image_unorm_int_2_101010.asciidoc

@@ -0,0 +1,39 @@
+// Copyright 2020-2024 The Khronos Group Inc.
+// SPDX-License-Identifier: CC-BY-4.0
+
+include::{generated}/meta/{refprefix}cl_ext_image_unorm_int_2_101010.txt[]
+
+=== Other Extension Metadata
+
+*Last Modified Date*::
+    2024-05-10
+*IP Status*::
+    No known IP claims.
+*Contributors*::
+  - Kévin Petit, Arm Ltd.
+
+=== Description
+
+{cl_ext_image_unorm_int_2_101010_EXT} adds support for the {CL_UNORM_INT_2_101010_EXT}
+image format.
+
+OpenCL C compilers supporting this extension will define the
+{opencl_c_ext_image_unorm_int_2_101010} feature macro.
+
+=== New feature macro
+
+  * {opencl_c_ext_image_unorm_int_2_101010}
+
+=== New Enums
+
+  * {cl_channel_type_TYPE}
+  ** {CL_UNORM_INT_2_101010_EXT}
+
+=== New OpenCL C channel data type
+
+  * `CLK_UNORM_INT_2_101010_EXT`
+
+=== Version History
+
+  * Revision 1.0.0, 2024-05-10
+  ** Initial version

api/opencl_runtime_layer.asciidoc

@@ -2474,6 +2474,15 @@ include::{generated}/api/version-notes/CL_UNORM_INT_101010_2.asciidoc[]
 
 include::{generated}/api/version-notes/CL_SIGNED_INT8.asciidoc[]
   | Each channel component is an unnormalized signed 8-bit integer value
+
+ifdef::cl_ext_image_unorm_int_2_101010[]
+| {CL_UNORM_INT_2_101010_EXT_anchor}
+
+include::{generated}/api/version-notes/CL_UNORM_INT_2_101010_EXT.asciidoc[]
+  | Represents a normalized 2-10-10-10 four-channel ABGR image.
+    The channel order must be {CL_ABGR}.
+endif::cl_ext_image_unorm_int_2_101010[]
+
 | {CL_SIGNED_INT16_anchor}
 
 include::{generated}/api/version-notes/CL_SIGNED_INT16.asciidoc[]
@@ -2565,6 +2574,10 @@ For {CL_UNORM_INT_101010}, bits 31:30 are undefined, R is in bits 29:20, G in
 bits 19:10 and B in bits 9:0.
 For {CL_UNORM_INT_101010_2}, R is in bits 31:22, G in bits 21:12, B in bits
 11:2 and A in bits 1:0.
+ifdef::cl_ext_image_unorm_int_2_101010[]
+For {CL_UNORM_INT_2_101010_EXT}, A is in bits 31:30, B in bits 29:20, G in bits
+19:10 and R in bits 9:0.
+endif::cl_ext_image_unorm_int_2_101010[]
 
 OpenCL implementations must maintain the minimum precision specified by the
 number of bits in `image_channel_data_type`.

c/features.txt

@@ -18,3 +18,4 @@ __opencl_c_integer_dot_product_input_4x8bit_packed
 __opencl_c_kernel_clock_scope_device
 __opencl_c_kernel_clock_scope_work_group
 __opencl_c_kernel_clock_scope_sub_group
+__opencl_c_ext_image_unorm_int_2_101010

env/common_properties.asciidoc

@@ -384,6 +384,11 @@ channel data types.
 | *UnormInt101010_2*
 | {CL_UNORM_INT_101010_2}
 
+ifdef::cl_ext_image_unorm_int_2_101010[]
+| 21
+| *UnormInt2_101010EXT*
+| {CL_UNORM_INT_2_101010_EXT}
+endif::cl_ext_image_unorm_int_2_101010[]
 |====
 
 [NOTE]

env/image_addressing_and_filtering.asciidoc

@@ -1030,6 +1030,12 @@ to the data vector component type or scalar type:
 `UnormInt24`, +
 `HalfFloat`, +
 `Float`
+ +
+ifdef::cl_ext_image_unorm_int_2_101010[]
+Additionally if the {cl_ext_image_unorm_int_2_101010_EXT} extension is
+supported: `UnormInt2_101010EXT`
+endif::cl_ext_image_unorm_int_2_101010[]
+
 |*OpTypeFloat*, with _Width_ equal to 16 or 32.
 
 |`SignedInt8`,

xml/cl.xml

@@ -1608,7 +1608,8 @@ server's OpenCL/api-docs repository.
             <unused start="0x10E1" end="0x10E2" comment="Reserved for cl_ext_yuv_images #722"/>
         <enum value="0x10E3"        name="CL_UNSIGNED_INT_RAW10_EXT"/>
         <enum value="0x10E4"        name="CL_UNSIGNED_INT_RAW12_EXT"/>
-            <unused start="0x10E5" end="0x10EF" comment="Reserved for cl_channel_type"/>
+        <enum value="0x10E5"        name="CL_UNORM_INT_2_101010_EXT"/>
+            <unused start="0x10E6" end="0x10EF" comment="Reserved for cl_channel_type"/>
         <enum value="0x10F0"        name="CL_MEM_OBJECT_BUFFER"/>
         <enum value="0x10F1"        name="CL_MEM_OBJECT_IMAGE2D"/>
         <enum value="0x10F2"        name="CL_MEM_OBJECT_IMAGE3D"/>
@@ -7475,5 +7476,10 @@ server's OpenCL/api-docs repository.
                 <enum name="CL_DEVICE_KERNEL_CLOCK_SCOPE_SUB_GROUP_KHR"/>
             </require>
         </extension>
+        <extension name="cl_ext_image_unorm_int_2_101010" revision="1.0.0" depends="CL_VERSION_1_2" supported="opencl">
+            <require comment="cl_channel_type">
+                <enum name="CL_UNORM_INT_2_101010_EXT"/>
+            </require>
+        </extension>
     </extensions>
 </registry>