vloada_halfn3clc

floatn vloada_halfn(size_t offset, const __global half *p);

floatn vloada_halfn(size_t offset, const __local half *p);

floatn vloada_halfn(size_t offset, const __constant half *p);

floatn vloada_halfn(size_t offset, const __private half *p);

Overview

For n = 1, 2, 4, 8 and 16 read sizeof(halfn) bytes of data from address (p + (offset * n)). The data read is interpreted as a halfn value. The halfn value read is converted to a floatn value and the floatn value is returned.

The address computed as (p + (offset * n)) must be aligned to sizeof(halfn) bytes.

For n = 3, vloada_half3 reads a half3 from address (p + (offset * 4)) and returns a float3. The address computed as (p + (offset * 4)) must be aligned to sizeof (half) * 4 bytes.

Notes

Vector Data Load and Store Functions allow you to read and write vector types from a pointer to memory.

The generic type gentype is used to indicate the built-in data types char, uchar, short, ushort, int, uint, long, ulong, float, or double.

The generic type name gentypen represents n-element vectors of gentype elements. The suffix n is also used in the function names (i.e. vloadn, vstoren, etc.), where n = 2, 3, 4, 8, or 16.

The results of vector data load and store functions are undefined if the address being read from or written to is not correctly aligned. The pointer argument p can be a pointer to global(3clc), local(3clc), or private(3clc) memory for store functions. The pointer argument p can be a pointer to __global, __local, constant(3clc) or __private memory for load functions.

In addition vloada_half3 reads x, y, z components from address (p + (offset * 4)) into a 3- component vector.

Specification

OpenCL Specification[1]

Notes

1.

OpenCL Specification

page 267, section 6.12.7 - Vector Data Load and Store Functions