glRenderbufferStorage - OpenGL ES 3 Reference Pages

文章推薦指數: 80 %
投票人數:10人

glRenderbufferStorage is equivalent to calling glRenderbufferStorageMultisample with the samples set to zero. The target of the operation, specified by target ... Name glRenderbufferStorage—establishdatastorage,formatanddimensionsofarenderbufferobject'simage CSpecification voidglRenderbufferStorage( GLenumtarget,   GLenuminternalformat,   GLsizeiwidth,   GLsizeiheight);   Parameters target SpecifiesabindingtowhichthetargetoftheallocationandmustbeGL_RENDERBUFFER. internalformat Specifiestheinternalformattousefortherenderbufferobject'simage. width Specifiesthewidthoftherenderbuffer,inpixels. height Specifiestheheightoftherenderbuffer,inpixels. Description glRenderbufferStorageisequivalenttocalling glRenderbufferStorageMultisamplewiththe samplessettozero. Thetargetoftheoperation,specifiedbytargetmustbeGL_RENDERBUFFER. internalformatspecifiestheinternalformattobeusedfortherenderbufferobject'sstorageand mustbeacolor-renderable,depth-renderable,orstencil-renderableformat,asshowninTable1below. widthandheightarethedimensions,inpixels,oftherenderbuffer. Bothwidthandheightmustbelessthanorequaltothevalueof GL_MAX_RENDERBUFFER_SIZE. Uponsuccess,glRenderbufferStoragedeletesanyexistingdatastorefortherenderbuffer imageandthecontentsofthedatastoreaftercallingglRenderbufferStorageareundefined. Table 1. SizedInternalFormats SizedInternalFormat BaseFormat RedBits GreenBits BlueBits AlphaBits GL_R8 GL_RED 8       GL_R8UI GL_RED_INTEGER ui8       GL_R8I GL_RED_INTEGER i8       GL_R16UI GL_RED_INTEGER ui16       GL_R16I GL_RED_INTEGER i16       GL_R32UI GL_RED_INTEGER ui32       GL_R32I GL_RED_INTEGER i32       GL_RG8 GL_RG 8 8     GL_RG8UI GL_RG_INTEGER ui8 ui8     GL_RG8I GL_RG_INTEGER i8 i8     GL_RG16UI GL_RG_INTEGER ui16 ui16     GL_RG16I GL_RG_INTEGER i16 i16     GL_RG32UI GL_RG_INTEGER ui32 ui32     GL_RG32I GL_RG_INTEGER i32 i32     GL_RGB8 GL_RGB 8 8 8   GL_RGB565 GL_RGB 5 6 5   GL_RGBA8 GL_RGBA 8 8 8 8 GL_SRGB8_ALPHA8 GL_RGBA 8 8 8 8 GL_RGB5_A1 GL_RGBA 5 5 5 1 GL_RGBA4 GL_RGBA 4 4 4 4 GL_RGB10_A2 GL_RGBA 10 10 10 2 GL_RGBA8UI GL_RGBA_INTEGER ui8 ui8 ui8 ui8 GL_RGBA8I GL_RGBA_INTEGER i8 i8 i8 i8 GL_RGB10_A2UI GL_RGBA_INTEGER ui10 ui10 ui10 ui2 GL_RGBA16UI GL_RGBA_INTEGER ui16 ui16 ui16 ui16 GL_RGBA16I GL_RGBA_INTEGER i16 i16 i16 i16 GL_RGBA32I GL_RGBA_INTEGER i32 i32 i32 i32 GL_RGBA32UI GL_RGBA_INTEGER ui32 ui32 ui32 ui32 SizedInternalFormat BaseFormat DepthBits StencilBits GL_DEPTH_COMPONENT16 GL_DEPTH_COMPONENT 16   GL_DEPTH_COMPONENT24 GL_DEPTH_COMPONENT 24   GL_DEPTH_COMPONENT32F GL_DEPTH_COMPONENT f32   GL_DEPTH24_STENCIL8 GL_DEPTH_STENCIL 24 8 GL_DEPTH32F_STENCIL8 GL_DEPTH_STENCIL f32 8 GL_STENCIL_INDEX8 GL_STENCIL   8 Errors GL_INVALID_ENUMisgeneratediftargetisnotGL_RENDERBUFFER. GL_INVALID_VALUEisgeneratedifeitherofwidthorheightisnegative, orgreaterthanthevalueofGL_MAX_RENDERBUFFER_SIZE. GL_INVALID_ENUMisgeneratedifinternalformatisnotacolor-renderable,depth-renderable, orstencil-renderableformat. GL_OUT_OF_MEMORYisgeneratediftheGLisunabletocreateadatastoreoftherequestedsize. APIVersionSupport OpenGLESAPIVersion FunctionName 2.0 3.0 glRenderbufferStorage ✔ ✔ SeeAlso glGenRenderbuffers, glBindRenderbuffer, glRenderbufferStorageMultisample, glFramebufferRenderbuffer, glDeleteRenderbuffers Copyright Copyright©2010-2014KhronosGroup. Thismaterialmaybedistributedsubjecttothetermsandconditionssetforthin theOpenPublicationLicense,v1.0,8June1999. http://opencontent.org/openpub/.



請為這篇文章評分?