Страницы справочника OS X

Эта страница руководства является частью версии 5.0 Инструментов XCode

Читать страницы руководства

GLRENDERBUFFERSTORAG(3G)                         OpenGL 3.3                         GLRENDERBUFFERSTORAG(3G)



NAME
       glRenderbufferStorageMultisample - establish data storage, format, dimensions and sample count of a
       renderbuffer object's image

C SPECIFICATION
       void glRenderbufferStorageMultisample(GLenum target, GLsizei samples, GLenum internalformat,
                                             GLsizei width, GLsizei height);

PARAMETERS
       target
           Specifies a binding to which the target of the allocation and must be GL_RENDERBUFFER.

       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 establishes the data storage, format, dimensions and number of
       samples of a renderbuffer object's image.

       The target of the operation, specified by target must be GL_RENDERBUFFER.  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 deletes any existing data store for the renderbuffer
       image and the contents of the data store after calling glRenderbufferStorageMultisample are
       undefined.

ERRORS
       GL_INVALID_ENUM is generated if target is not GL_RENDERBUFFER.


       GL_INVALID_VALUE is generated if samples is greater than GL_MAX_SAMPLES.


       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.

SEE ALSO
       glGenRenderbuffers(), glBindRenderbuffer(), glRenderbufferStorage(), glFramebufferRenderbuffer(),
       glDeleteRenderbuffers()


COPYRIGHT
       Copyright (C) 2010 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/.



OpenGL 3.3                                       03/08/2011                         GLRENDERBUFFERSTORAG(3G)