Signature
glNamedRenderbufferStorageMultisample(
GLuint (
renderbuffer
)
,
GLsizei (
samples
)
,
GLenum (
internalformat
)
,
GLsizei (
width
)
,
GLsizei (
height
)
)-> void
glRenderbufferStorageMultisample(
GLenum (
target
)
,
GLsizei (
samples
)
,
GLenum (
internalformat
)
,
GLsizei (
width
)
,
GLsizei (
height
)
)-> void
Parameters
Variables | Description |
---|---|
target |
Specifies a binding target of the allocation for
glRenderbufferStorageMultisample
function. Must
be
GL_RENDERBUFFER
.
|
renderbuffer |
Specifies the name of the renderbuffer object for
glNamedRenderbufferStorageMultisample
function.
|
samples |
Specifies the number of samples to be used for the
renderbuffer object's storage.
|
internalformat |
Specifies the internal format to use for the renderbuffer
object's image.
|
width |
Specifies the width of the renderbuffer, in pixels.
|
height |
Specifies the height of the renderbuffer, in pixels.
|
Description
glRenderbufferStorageMultisample
and
glNamedRenderbufferStorageMultisample
establish the
data storage, format, dimensions and number of samples of a renderbuffer
object's image.
For
glRenderbufferStorageMultisample
, the
target of the operation, specified by
target
must
be
GL_RENDERBUFFER
. For
glNamedRenderbufferStorageMultisample
,
renderbuffer
must be an ID of an existing
renderbuffer object.
internalformat
specifies the
internal format to be used for the renderbuffer object's storage and must
be a color-renderable, depth-renderable, or stencil-renderable format.
width
and
height
are the
dimensions, in pixels, of the renderbuffer. Both
width
and
height
must be
less than or equal to the value of
GL_MAX_RENDERBUFFER_SIZE
.
samples
specifies the number of samples to be used
for the renderbuffer object's image, and must be less than or equal to the
value of
GL_MAX_SAMPLES
. If
internalformat
is a signed or unsigned integer
format then
samples
must be less than or equal to
the value of
GL_MAX_INTEGER_SAMPLES
.
Upon success,
glRenderbufferStorageMultisample
and
glNamedRenderbufferStorageMultisample
delete any
existing data store for the renderbuffer image and the contents of the
data store after calling either of the functions are undefined.
Errors
GL_INVALID_ENUM
is generated by
glRenderbufferStorageMultisample
function if
target
is not
GL_RENDERBUFFER
.
GL_INVALID_OPERATION
is generated by
glNamedRenderbufferStorageMultisample
function if
renderbuffer
is not the name of an existing
renderbuffer object.
GL_INVALID_OPERATION
is generated if
samples
is greater than the maximum number of samples
supported for
internalformat
.
GL_INVALID_ENUM
is generated if
internalformat
is not a color-renderable,
depth-renderable, or stencil-renderable format.
GL_INVALID_OPERATION
is generated if
internalformat
is a signed or unsigned integer
format and
samples
is greater than the value of
GL_MAX_INTEGER_SAMPLES
GL_INVALID_VALUE
is generated if either of
width
or
height
is negative,
or greater than the value of
GL_MAX_RENDERBUFFER_SIZE
.
GL_OUT_OF_MEMORY
is generated if the GL is
unable to create a data store of the requested size.
Version Support
glNamedRenderbufferStorageMultisample | |
glRenderbufferStorageMultisample |
See Also
Copyright
Copyright
2010-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.
http://opencontent.org/openpub/
.