KhronosGroup/OpenGL-Registry | GitHub

0.0 ,4

0.1 ,4

0.10 ,10

0.11 ,02

0.12 ,02

0.13 ,10

0.14 ,10

0.15 ,10

0.16 ,11

0.17 ,11

0.18 ,11

0.19 ,01

0.2 ,4

0.3 ,4

0.4 ,4

0.5 ,4

0.6 ,05

0.7 ,05

0.8 ,05

0.9 ,10

1.WhatAPIshouldweusetoallowanapplicationtoindicateitwants *

10.WhatistheOES_framebuffer_objectinteraction *

11.ShouldweaddretroactivesupportforEXT_texture_type_2_10_10_10_REV *

12.DoweneeddifferenttokenvaluesfromOpenGL *

2.Shouldthisspecificationmakeanymentionof *

3.4.yinthisextensionmustbeacceptedbytheirrespectivecommands. *

3.Whatshouldbetherecommendedwaytoaddnewformatsinthefuture *

32 ,32

4.Howshouldwehandlerendervs.texturebuffers *

5.ShouldthisextensionrequireRGBA8 *

6.Whatshouldthisextensionsay ,ifanything,aboutdepthandstencil

7.Shouldwealloweverycombinationof <format>,<type>,and

8.Shouldwesplitthisextensionintomultipleextensions *

9.Shouldweaddaquerythatletstheimplementationadvertisewhich *

ALPHA *

ALPHA8_OES *

ALPHA8_OES0x803C *

ALPHAUNSIGNED_BYTE1ALPHA ,ALPHA8

AaftabMunshi *

Acceptedbythe <internalformat>argumentofTexImage2D,TexImage3DOES,and

Acceptedbythe <internalformat>argumentofRenderbufferStorageOES

AdditionstoAppendixAoftheOpenGLES1.1Specification *

AdditionstoChapter2oftheOpenGLES1.1Specification *

AdditionstoChapter3oftheOpenGLES1.1Specification *

AdditionstoChapter4oftheOpenGLES1.1Specification *

AdditionstoChapter5oftheOpenGLES1.1Specification *

AdditionstoChapter6oftheOpenGLES1.1Specification *

AdditionstotheAGL *

Allsizedformatsinthesetablesmustbestoredwithatleastthe *

Animplementationmustacceptallofthevaluesfor <internalformat>

Animplementationthatexportsthisextensioniscommittingtosupportall *

AnotheroptionwastocreateanewsetofglTexImage *

ApprovedbytheKhronosPromotersonApril26 ,2012.

AuthorRevision *

AvailabilityofRGB8renderbuffersisstillbasedonpresenceofthe *

BenjLipchak ,Apple,Inc.

Complete. *

Contact *

Contributors *

CopyTexImage2D *

CopyTexImage2Discalledwithavalueof <internalformat>notlistedin

Copyright *

DEPTH24_STENCIL8_OES *

DEPTH24_STENCIL8_OES0x88F0 *

DEPTH_COMPONENT16_OES *

DEPTH_COMPONENT16_OES0x81A5 *

DEPTH_COMPONENT24_OES *

DEPTH_COMPONENT24_OES0x81A6 *

DEPTH_COMPONENT24_OESshouldbedeleted. *

DEPTH_COMPONENT32_OES *

DEPTH_COMPONENT32_OES0x81A7 *

DEPTH_COMPONENT32_OESshouldbedeleted. *

DEPTH_COMPONENTUNSIGNED_INT4DEPTH_COMPONENT ,DEPTH_COMPONENT32_OES,DEPTH_COMPONENT24_OES,DEPTH_COMPONENT16_OES

DEPTH_COMPONENTUNSIGNED_SHORT2DEPTH_COMPONENT ,DEPTH_COMPONENT16_OES

DEPTH_COMPONENTasalegalvaluefor <format>whencallingTexImage2Dand

DEPTH_STENCIL_OES ,DEPTH24_STENCIL8_OES,andUNSIGNED_INT_24_8_OESshouldbe

DEPTH_STENCIL_OESUNSIGNED_INT_24_8_OES4DEPTH_STENCIL_OES ,DEPTH24_STENCIL8_OES

Dependencies *

DependenciesonEXT_texture_type_2_10_10_10_REV *

DependenciesonOES_depth24andOES_depth32 *

DependenciesonOES_depth_texture *

DependenciesonOES_framebuffer_object *

DependenciesonOES_packed_depth_stencil *

DependenciesonOES_rgb8_rgba8 *

DependenciesonOES_stencil1 ,OES_stencil4,andOES_stencil8

DependenciesonOES_texture_3D *

DependenciesonOpenGLES2.0 *

EXT_texture_type_2_10_10_10_REVaffectsthedefinitionofthisextension. *

Errors *

FOO_expanded_internalformat. *

Feature1 *

Feature2 *

Feature3 *

FormatTypeExternalBytesperPixelInternalformat *

Forreference ,

GLXProtocol *

GL_DEPTH_COMPONENT ,GL_UNSIGNED_INT,myD32TexelData

GL_OES_required_internalformat *

GL_RGBA ,GL_UNSIGNED_BYTE,myTexelData

GL_SUPPORTED_TEXTURE_INTERNALFORMATforqueryingsupportedtexture *

However ,itseemsthesimplestthingtodoistojustusethe

However ,thislatterapproachranintotheproblemthatglCopyTexImage2D

INVALID_ENUMisgenerated. *

INVALID_ENUMtoINVALID_OPERATION *

IfEXT_texture_type_2_10_10_10_REVisnotsupported ,thenallreferencesto

IfOES_depth24isnotsupported ,thenallreferencesto

IfOES_depth32isnotsupported ,thenallreferencesto

IfOES_depth_textureisnotsupported ,thenallreferencesto

IfOES_framebuffer_objectisnotsupportedandOpenGLES2.0isnot *

IfOES_packed_depth_stencilisnotsupported ,thenallreferencesto

IfOES_rgb8_rgba8isnotsupported ,thenreferencestoRGB8_OESasa

IfOES_stencil1isnotsupported ,thenallreferencestoSTENCIL_INDEX1_OES

IfOES_stencil4isnotsupported ,thenallreferencestoSTENCIL_INDEX4_OES

IfOES_stencil8isnotsupportedandOpenGLES2.0isnotsupported ,then

IfOES_texture_3Disnotsupported ,thenallreferencestoTexImage3DOES

IfOpenGLES2.0issupported ,thefollowingtokensdonothavethe

IfRenderbufferStorageOESorCopyTexImage2Discalledwithavalueof *

IfTexImage2DorTexImage3DOESiscalledwithacombinationof <format>,

Ifoneofthebase *

Inaddition ,ES1.1doesnotallowanimplementationtofailarequestto

Inaddition ,onlycertainvaluesfor<internalformat>arevalidwhen

Insection3.6.2 *

Insection3.7.9 *

Internalformat *

Issues *

JeremySandmel *

Justlikebefore ,newextensionscanaddnewvaluesfor<internalformat>

Khronos-approvedextensionspecificationsareupdatedinresponseto *

LUMINANCE *

LUMINANCE ,ALPHA,DEPTH_COMPONENT,orDEPTH_STENCIL_OES

LUMINANCE4_ALPHA4_OES *

LUMINANCE4_ALPHA4_OES0x8043 *

LUMINANCE8_ALPHA8_OES *

LUMINANCE8_ALPHA8_OES0x8045 *

LUMINANCE8_OES *

LUMINANCE8_OES0x8040 *

LUMINANCEUNSIGNED_BYTE1LUMINANCE ,LUMINANCE8

LUMINANCE_ALPHA *

LUMINANCE_ALPHAUNSIGNED_BYTE2LUMINANCE_ALPHA ,LUMINANCE8_ALPHA8,LUMINANCE4_ALPHA4

LastModifiedDate *

MembersoftheKhronosOpenGLESworkinggroup *

MyExtensionQuery *

Name *

NameStrings *

NewImplementationDependentState *

NewProceduresandFunctions *

NewState *

NewTokens *

NewTypes *

No ,we

No ,wespecificallydisallowconversionsbetween

No.Initiallysomenewtokens *

No.Novendorhasexpressedinterestinsubsettingthese3features *

None. *

Note ,thisextensiondoesnotrequireRGB8forrenderbuffers.

Notethatintheoppositesituationwhereanapplicationprovideshigher *

Notice *

Number *

OES_depth24andOES_depth32affectthedefinitionofthisextension. *

OES_depth_textureaffectsthedefinitionofthisextension. *

OES_framebuffer_objectaffectsthedefinitionofthisextension. *

OES_packed_depth_stencilaffectsthedefinitionofthisextension. *

OES_required_internalformat *

OES_rgb8_rgba8affectsthedefinitionofthisextension. *

OES_rgb8_rgba8extension. *

OES_stencil1 ,OES_stencil4,andOES_stencil8affectthedefinitionofthis

OES_texture_3Daffectsthedefinitionofthisextension. *

OES_texture_cube_map *

OpenGL *

OpenGLES1.0isrequired. *

OpenGLES2.0affectsthedefinitionofthisextension. *

OperationsandtheFrameBuffer *

Otherextensionsmayintroducenewvaluesfor <internalformat>.Ifthey

Overview *

RENDERBUFFER_INTERNALFORMAT.Oninput <count>isthemaximum

RENDERBUFFER_OESsection *

RESOLVED ,allthevaluesfor<internalformat>inTables3.4,3.4.x,and

RESOLVED *

RGB *

RGB10_A2_EXT ,RGB10_EXT,andUNSIGNED_INT_2_10_10_10_REV_EXTshouldbe

RGB10_A2_EXT *

RGB10_A2_EXT0x8059 *

RGB10_EXT *

RGB10_EXT.Thisformatcontinuestobeunrenderable ,consistentwith

RGB10_EXT0x8052 *

RGB565_OES *

RGB565_OES0x8D62 *

RGB5_A1_OES *

RGB5_A1_OES0x8057 *

RGB8_OES *

RGB8_OES0x8051 *

RGBA *

RGBA4_OES *

RGBA4_OES0x8056 *

RGBA8_OES *

RGBA8_OES0x8058 *

RGBAUNSIGNED_BYTE4RGBA ,RGBA8,RGB5_A1,RGBA4

RGBAUNSIGNED_INT_2_10_10_10_REV_EXT4RGBA ,RGB10_A2_EXT,RGB5_A1

RGBAUNSIGNED_SHORT_4_4_4_42RGBA ,RGBA4

RGBAUNSIGNED_SHORT_5_5_5_12RGBA ,RGB5_A1

RGBAandLUMINANCE_ALPHA ,forinstance

RGBUNSIGNED_BYTE3RGB ,RGB8,RGB565

RGBUNSIGNED_INT_2_10_10_10_REV_EXT4RGB ,RGB10_EXT,RGB8,RGB565

RGBUNSIGNED_SHORT_5_6_52RGB ,RGB565

RenderbufferStorageOES *

RenderbufferStorageOESiscalledwithavalueof <internalformat>not

Requests *

RevisionHistory *

STENCIL_INDEX1_OES *

STENCIL_INDEX4_OES *

STENCIL_INDEX8_OES *

SampleCode *

Sizedformathintsandminimumprecisionguaranteesfortexturesare *

SpecificationUpdatePolicy *

Status *

StencilanddepthformatsarelistedintheTable3.4.x.Ifan *

Table3.4 *

Table3.4 ,eveniftheimplementationdoesnotnativelysupportdatastored

Table3.4.x *

Table3.4.y *

Table3.4.y ,thenINVALID_ENUMisgenerated.

Table3.4andreplacetheprecedingparagraphasfollows *

TexImage *

TexImage3DOESshouldbedeleted. *

TheES1.1APIallowsanimplementationtostoretexturedatainternally *

Theprimarymotivationformoving *

Thisextensionaddressesthesituationintwoways *

ThisextensioniswrittenagainsttheOpenGLES1.1specification. *

UNPACKparameter. *

Version *

Wehavethreetablesinthespec ,onefortexturesspecifiedwith

Weintentionallydon *

Weoriginallyhadconsideredusinganew *

Weusethe *

WhencallingTexImage2DorTexImage3DOES ,notallcombinationsof

Whilethisallowsflexibilityforimplementations ,itdoesmeanthatan

XXXTBD *

Yes ,forboth.OpenGLES2.0implementationsareverylikelytohave

Yes.Weintroducedtwonewsizedinternalformats ,RGB10_A2_EXTand

allocatedbyglRenderbufferStorageOES. *

allocation. *

allowstheusertorequestthattheGLusealowerprecisionthanthe *

allreferencestoSTENCIL_INDEX8_OESshouldbedeleted. *

andRENDERBUFFER.Also ,RenderbufferStoragedoesnothavethe

andglRenderbufferStorageOESdon *

andglRenderbufferStorageOESentrypointsthatimpliedaminimum *

andoneforCopyTexImagesinceyoucancreateadepth *

application *

applicationcanchoosean <internalformat>withadifferentbaseinternal

applicationdesiressomeminimumprecisionforinternalstorageand *

applicationdoesnothaveareliablemeanstorequesttheimplementation *

applicationtofindoutthatthishashappened. *

arenotchanged. *

asmuchprecisionaspossible ,giventhesourceargumentstothose

availablefunctionality.Well-behavedapplicationsshouldalwaysquery *

avoidingformatconversion. *

baseinternalformatof <internalformat>.

bedeleted ,includingTable3.4.x.

booldepth32_available =CheckExtension

booldepth_texture_available =CheckExtension

booleanIsPreciseInternalformatOES *

booleanQuerySupportOES *

boolreqSupportAvailable =

boolreqSupportAvailable =CheckExtension

callingRenderbufferStorageOESandCopyTexImage2D.Thevalidvaluesof *

checkingtheminimumprecisionstorageguarantee. *

chooseanarbitraryprecisionfortheinternalstorageofimagedata *

combinationsacceptedbytheGLaredefinedinTable3.4.IfTexImage2D *

commands. *

completeness *

componentfortexturesandrenderbuffers. *

componentwithatleastthenumberofbitsprescribed. *

contain <count>entries.

containsallthevaluesof <internalformat>forwhichthe

conversion.Ifsomeimplementationreallywantstoaddthis *

correspondingminimumprecision. *

definingtheparticularbaseformatandprecisionthattheapplicationwants *

deleted. *

describedinmoredetailat *

do ,theyshouldmodifyTables3.4,3.4.x,and3.4.y.Ifan

don *

entriesthatwouldrequiretheGLtousemoreprecisionthanthe *

enum *

eventuallybebackportedtotheextensiondocument.Thispolicyis *

exit *

exporttheextension. *

exportthisextensionornot ,dependingonwhethertheysupport8bit

extension. *

extensionswhichhavebeenpromotedtoacoreSpecification ,fixeswill

external <type>wouldrequire,butthattabledoesnotincludeany

external <type>wouldrequire.

fail.Furthermore ,itisguaranteeingthatforanysizedinternalformat,

firstappearinthelatestversionofthatcoreSpecification ,andwill

for <internalformat>toTexImage2D,TexImage3DOES,orCopyTexImage2D,

for *

foravailablefunctionalityonaparticularimplementation. *

forextensionstringsandotherimplementation-dependentstatetocheck *

format. *

formatoflowerprecisionthanrequested.The <param>couldbe

formats--thosewithexplicitcomponentresolutions--bystoringeach *

formatthanthesourceformatspecifiedby <format>.Theimplementationis

formatwiththecurrentlyboundcontext ,wouldresultinaninternal

fortextureorrenderbufferimageallocation. *

fromequivalentOpenGLtokens ,andaddedissue12

fromthelistbelowbeforewedroppedthequeryentirely *

functionality ,itwouldneedtocreateanadditionalextension,say

futureextensions ,newsizedinternalformatswillprovidethesamekind

generated. *

glPixelStoreithatindicatedtheexternal <format>and<type>arguments

glRenderbufferStorageOES *

glTexImage *

glTexImage2D *

glTexImage2Dforanyofthelegal <format>and<type>combinationslistedin

guaranteeminimumprecision ,likethis

if *

ifOES_rgb8_rgba8ispresent. *

implementationcansupportthenew <internalformat>values,itwill

implementationisguaranteeingthatchoosingan <internalformat>argument

implementationisstillfreetostoreatthehigherprecision ,thereby

implementationthatsupportsthisextensiondoesn *

implementationwillguaranteespecifiedprecision. <list>will

implementationwillmaintainforagiventextureorrenderbufferimage. *

instance.Further ,sinceESremovestheabilitytoquerythetextureobject

int *

internalformatsforRenderbufferStorageOES *

inthatexternal <format>and<type>.However,therearenoadditional

isgenerated. *

issuesandbugsprioritizedbytheKhronosOpenGLESWorkingGroup.For *

isthenumberofinternalformatsin <list>.Onoutput,<list>

listedinTable3.4.xthenINVALID_ENUMisgenerated.Similarly ,if

listofsized <internalformats>forwhichitwillguaranteeto

maintainaspecificprecisionortofindoutwhatprecisionthe *

maintainthespecifiedminimumprecisionwhenthoseformatsareused *

makeFBOsaprerequisite. *

mechanismin *

minimumprecisiontoday *

mustbesupportedwithno *

mustrespecttheminimumprecisionrequirementsofsizedinternal *

necessary.Todayallsizedinternalformatshaveguaranteedminimum *

nordotheyhaveexternal <format>or<type>argumentstoindicatethe

notrequiredtoexactlymatchtheprecisionspecifiedby <internalformat>

nowspecifiesanumberofformatsasbeing *

numberofinternalformatstoreturn ,andonoutput<count>

ofexistingsizedinternalformatsontherequiredlistofformatsfor *

ofminimumprecisionguaranteesastheformatsdescribedherein. *

ofthelegalvaluesfor <internalformat>inTables3.4,3.4.x,and3.4.y,

ofthestencil *

orTexImage3DOESiscalledwithacombinationof <format>,<type>,and

points.It *

precision.Forposterity ,wewereclosetochoosingquerymechanism

precisionofallavailablesizedinternalformats. *

precisionsandGL_SUPPORTED_RENDERBUFFER_INTERNALFORMATforquerying *

precisionsourcedataandasksittobestoredatlowerprecision ,an

prerequisite *

prescribedbythesizedinternalformat. *

printf *

renderbufferbutnottexture. *

renderbufferformatinTable3.4.xshouldbedeleted. *

renderbuffersallocatedwithRenderbufferStorageOES. *

renderbuffersifFBOsaren *

requested *

requiredprecision. *

requirementsplacedontheimplementation.TheESimplementationisfreeto *

respecttheminimumprecisionguarantee *

returnsGL_FALSEifanyofthem ,whenusedasasizedinternal

samesenseofalowerboundonprecision ,andthetokenvalues

separatedefinedextensions *

shouldbedeleted. *

sincethatwouldrequireexpandingthealphachannel *

sizedinternalformatsitsupportswithminimumprecision *

specifiedinTables3.4 ,3.4.x,3.4.y.Furthermore,animplementation

storageofatleastacertainprecisionforaparticularsourceformat *

storethetexturedatawithlowerprecisionthanoriginallyspecified ,for

subjecttotheextensiondependenciesdescribedherein.Thatistosay ,the

suppliedbytheapplication.Similarly ,ESallowsanimplementationto

supported *

supported ,thenallreferencestoRENDERBUFFER_OESandrenderbuffersshould

supportedrenderbufferprecisions. *

texture.ESimplementationsarestillencouraged ,however,tomaintain

thantheyprovideexternallybecauseitwouldnecessitateaformat *

thattheGLshouldnotuselessthanthespecifiedprecision. *

theEXT_texture_type_2_10_10_10_REVspec.Theseformatsjointherest *

theGLisfreetochoosetheprecisionthatitwillmaintainforthe *

thedesired *

theideathatitissupposedtocheckforerrorsinordertoqueryfor *

theimplementationtomaintainwhenstoringtheimagedata.Further ,the

theirownextensionsissothatawell-behavedapplicationnevergets *

therenderbufferortexturedatawillbestoredwithatleasttheprecision *

thissupportanyway ,andOpenGLES1.ximplementationscanchooseto

thoseenumsareNOTlistedinTable3.4.x. *

tofindoutwhatinternalformatitchose ,thereisnowayforthe

typecombination *

usefulevenonimplementationswhereFBOsaren *

values ,whichwasduetoadifferenceinthemeaningrelativeto

voidGetSupportedInternalFormatsOES *

whenchoosinganinternalstorageprecision ,butitisrequiredtomatchthe

where <param>mustbeTEXTUREorRENDERBUFFER_OES,and

where <param>mustbeTEXTURE_INTERNALFORMATor

whereasinthisextensiontheyarelowerbounds.However ,OpenGL

whichprecisionisguaranteed. *

whichtakesa <list>of<count>sizedinternalformatenumsand

witharbitraryprecision ,regardlessoftheformatandtypeofthedata

withavaluefromthesetableswillnotcauseanimageallocationrequestto *

Ecosyste.ms: Repos

GitHub / KhronosGroup / OpenGL-Registry

Files

Dependencies