'\" t
.\"     Title: imageLoad
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 11/18/2024
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "IMAGELOAD" "3G" "11/18/2024" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
imageLoad \- load a single texel from an image
.SH "DECLARATION"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage1D\ " "image" ", int\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage2D\ " "image" ", ivec2\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage3D\ " "image" ", ivec3\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage2DRect\ " "image" ", ivec2\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimageCube\ " "image" ", ivec3\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gbufferImage\ " "image" ", int\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage1DArray\ " "image" ", ivec2\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage2DArray\ " "image" ", ivec3\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimageCubeArray\ " "image" ", ivec3\ " "P" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage2DMS\ " "image" ", ivec2\ " "P" ", int\ " "sample" ");"
.HP \w'gvec4\ imageLoad('u
.BI "gvec4 imageLoad(gimage2DMSArray\ " "image" ", ivec3\ " "P" ", int\ " "sample" ");"
.SH "PARAMETERS"
.PP
\fIimage\fR
.RS 4
Specify the image unit from which to load a texel\&.
.RE
.PP
\fIP\fR
.RS 4
Specify the coordinate from which to load the texel\&.
.RE
.PP
\fIsample\fR
.RS 4
When present, specifies the sample within the image to load
.RE
.SH "DESCRIPTION"
.PP
\fBimageLoad\fR
loads the texel at the coordinate
\fIP\fR
from the image unit
\fIimage\fR\&. For multi\-sample loads, the sample number is given by
\fIsample\fR\&. When
\fIimage\fR,
\fIP\fR,
\fIsample\fR
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\&.
.SH "VERSION SUPPORT"
.TS
allbox tab(:);
lB cB s s s s s s s s s s s
lB cB cB cB cB cB cB cB cB cB cB cB cB.
T{

T}:T{
\fBOpenGL Shading Language Version\fR
T}
T{
\fBFunction Name\fR
T}:T{
\fB1\&.10\fR
T}:T{
\fB1\&.20\fR
T}:T{
\fB1\&.30\fR
T}:T{
\fB1\&.40\fR
T}:T{
\fB1\&.50\fR
T}:T{
\fB3\&.30\fR
T}:T{
\fB4\&.00\fR
T}:T{
\fB4\&.10\fR
T}:T{
\fB4\&.20\fR
T}:T{
\fB4\&.30\fR
T}:T{
\fB4\&.40\fR
T}:T{
\fB4\&.50\fR
T}
.T&
l c c c c c c c c c c c c.
T{
imageLoad
T}:T{
\-
T}:T{
\-
T}:T{
\-
T}:T{
\-
T}:T{
\-
T}:T{
\-
T}:T{
\-
T}:T{
\-
T}:T{
✔
T}:T{
✔
T}:T{
✔
T}:T{
✔
T}
.TE
.sp 1
.SH "SEE ALSO"
.PP
\fBimageStore\fR(),
\fBimageAtomicAdd\fR(),
\fBimageAtomicMin\fR(),
\fBimageAtomicMax\fR(),
\fBimageAtomicAnd\fR(),
\fBimageAtomicOr\fR(),
\fBimageAtomicXor\fR(),
\fBimageAtomicExchange\fR(),
\fBimageAtomicCompSwap\fR()
.SH "COPYRIGHT"
.PP
Copyright
\(co
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\&.
\m[blue]\fBhttp://opencontent\&.org/openpub/\fR\m[]\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2011-2014 Khronos Group
.br