Name

imageLoad — load a single texel from an image

Declaration

gvec4 imageLoad(gimage1D image, int P);

gvec4 imageLoad(gimage2D image, ivec2 P);

gvec4 imageLoad(gimage3D image, ivec3 P);

gvec4 imageLoad(gimage2DRect image, ivec2 P);

gvec4 imageLoad(gimageCube image, ivec3 P);

gvec4 imageLoad(gbufferImage image, int P);

gvec4 imageLoad(gimage1DArray  image,
 ivec2  P);
gvec4 imageLoad(gimage2DArray  image,
 ivec3  P);
gvec4 imageLoad(gimageCubeArray  image,
 ivec3  P);
gvec4 imageLoad(gimage2DMS  image,
 ivec2  P,
 int  sample);
gvec4 imageLoad(gimage2DMSArray  image,
 ivec3  P,
 int  sample);

Parameters

image

Specify the image unit from which to load a texel.

P

Specify the coordinate from which to load the texel.

sample

When present, specifies the sample within the image to load

Description

imageLoad loads the texel at the coordinate P from the image unit image. For multi-sample loads, the sample number is given by sample. When image, P, sample identify a valid texel, the bits used to represent the selected texel in memory are converted to a vec4, ivec4, or uvec4 in the manner described in the OpenGL Specification and returned.

Version Support

FunctionVersion 1.10Version 1.20Version 1.30Version 1.40Version 1.50Version 3.30Version 4.00Version 4.10Version 4.20Version 4.30
imageLoad--------YY

See Also

imageStore, imageAtomicAdd, imageAtomicMin, imageAtomicMax, imageAtomicAnd, imageAtomicOr, imageAtomicXor, imageAtomicExchange, imageAtomicCompSwap

Copyright

Copyright © 2011 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.