Light | Dark

# docs.GL

GLSL 4
GLSL ES 3

# texelFetch

## Name

texelFetch — perform a lookup of a single texel within a texture

## Declaration

`gvec4 texelFetch(` | gsampler1D sampler,
| int P,
| int lod`)`;

`gvec4 texelFetch(` | gsampler2D sampler,
| ivec2 P,
| int lod`)`;

`gvec4 texelFetch(` | gsampler3D sampler,
| ivec3 P,
| int lod`)`;

`gvec4 texelFetch(` | gsampler2DRect sampler,
| ivec2 P`)`;

`gvec4 texelFetch(` | gsampler1DArray sampler,
| ivec2 P,
| int lod`)`;

`gvec4 texelFetch(` | gsampler2DArray sampler,
| ivec3 P,
| int lod`)`;

`gvec4 texelFetch(` | gsamplerBuffer sampler,
| int P`)`;

`gvec4 texelFetch(` | gsampler2DMS sampler,
| ivec2 P,
| sample sample`)`;

`gvec4 texelFetch(` | gsampler2DMSArray sampler,
| ivec3 P,
| sample sample`)`;

## Parameters

`sampler`

  Specifies the sampler to which the texture from which texels will be retrieved is bound.

`P`

  Specifies the texture coordinates at which texture will be sampled.

`lod`

  If present, specifies the level-of-detail within the texture from which the texel will be fetched.

`sample`

  For multisampled fetches, specifies which sample within the texel from which which will be returned.

## Description

`texelFetch` performs a lookup of a single texel from texture coordinate `P` in the texture bound to `sampler`. The array layer is specified in the last component of `P` for array forms. The `lod` parameter (if present) specifies the level-of-detail from which the texel will be fetched. The `sample` specifies which sample within the texel will be returned when reading from a multi-sample texure.

## Version Support

| OpenGL Shading Language Version
--- | ---
Function Name | 1.10 | 1.20 | 1.30 | 1.40 | 1.50 | 3.30 | 4.00 | 4.10 | 4.20 | 4.30 | 4.40 | 4.50
texelFetch | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔
texelFetch (gsampler2DRect, gsamplerBuffer) | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔
texelFetch (gsampler2DMS, gsampler2DMSArray) | - | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔

## See Also

texelFetch, texture, textureGather, textureGatherOffset, textureGatherOffsets, textureGrad, textureGradOffset, textureLod, textureLodOffset, textureOffset, textureProj, textureProjGrad, textureProjGradOffset, textureProjLod, textureProjLodOffset, textureProjOffset, textureQueryLod, textureSize

## Copyright

Copyright © 2011-2014 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. https://opencontent.org/openpub/.

Think you can improve this page? Edit this page on GitHub.