read_imageh_(2D,_Half) - Do an element lookup in the 2D image object, returning half floating-point

TheKhronosGroup

       Copyright © 2007-2011 The Khronos Group Inc.
       Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or
       associated documentation files (the "Materials"), to deal in the Materials without restriction, including
       without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
       copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to
       the condition that this copyright notice and permission notice shall be included in all copies or
       substantial portions of the Materials.

       For the forms that take an image2d_t, use the coordinate (x,y) to do an element lookup in the 2D image
       object specified by image.

       For the forms that take an image2d_array_t, Use coord.xy to do an element lookup in the 2D image
       identified by coord.z in the 2D image array specified by image.

       The samplerless read image functions behave exactly as the corresponding read image functions that take
       integer coordinates and a sampler with filter mode set to CLK_FILTER_NEAREST, normalized coordinates set
       to CLK_NORMALIZED_COORDS_FALSE and addressing mode to CLK_ADDRESS_NONE.

       read_imageh returns half floating-point values in the range [0.0... 1.0] for image objects created with
       image_channel_data_type set to one of the predefined packed formats or CL_UNORM_INT8 or CL_UNORM_INT16.

       read_imageh returns half floating-point values in the range [-1.0... 1.0] for image objects created with
       image_channel_data_type set to CL_SNORM_INT8, or CL_SNORM_INT16.

       read_imageh returns half floating-point values for image objects created with image_channel_data_type set
       to CL_HALF_FLOAT.

       The read_imageh calls that take integer coordinates must use a sampler with filter mode set to
       CLK_FILTER_NEAREST, normalized coordinates set to CLK_NORMALIZED_COORDS_FALSE and addressing mode set to
       CLK_ADDRESS_CLAMP_TO_EDGE, CLK_ADDRESS_CLAMP or CLK_ADDRESS_NONE; otherwise the values returned are
       undefined.

       Values returned by read_imageh for image objects with image_channel_data_type values not specified in the
       description above are undefined.

       read_imageh_(2D,_Half) - Do an element lookup in the 2D image object, returning half floating-point
       values.

       half4read_imageh(image2d_timage,sampler_tsampler,int2coord);half4read_imageh(image2d_timage,sampler_tsampler,float2coord);half4read_imageh(image2d_timage,int2coord);half4read_imageh(image2d_array_timage,int4coord);half4read_imageh(image2d_array_timage,sampler_tsampler,int4coord);half4read_imageh(image2d_array_timage,sampler_tsampler,float4coord);

        1. OpenCL Specification
           page 27, section 9.5.8 - Image Read and Write Functions (half)

The Khronos Group                                  11/18/2024                         READ_IMAGE(2D,HALF(3clc)

imageFunctions(3clc)

OpenCLSpecification[1]