glFramebufferRenderbuffer

Aus DGL Wiki
(Weitergeleitet von glFrameBufferRenderBuffer)
Wechseln zu: Navigation, Suche

glFramebufferRenderbuffer

Name

glFramebufferRenderbuffer - Hängt ein Renderpuffer als einen "logischen" Puffer an das gerade gebundene Framepuffer-Objekt


Delphi-Spezifikation

procedure glFramebufferRenderbuffer(target : GLenum; attachment : GLenum; renderbuffertarget : GLenum; renderbuffer : GLuint);


Parameter

target Ziel des Framepuffers. Mögliche Werte: GL_DRAW_FRAMEBUFFER, GL_READ_FRAMEBUFFER, GL_FRAMEBUFFER (entspricht GL_DRAW_FRAMEBUFFER).
attachment Bestimmt den "Attachment Point".
renderbuffertarget Ziel des Renderpuffers. Mögliche Wert: GL_RENDERBUFFER.
renderbuffer Bestimmt den Namen eines existierenden Renderpuffers vom Typ renderbuffertarget, das gebunden werden soll.


Beschreibung

glFramebufferRenderbuffer hängt ein Renderpuffer als einen der logischen Puffer an das aktuell gebundene Framepuffer-Objekts an. renderbuffer ist der Name des zu bindenden Renderbuffer-Objekts und muss entweder Null der der Name eines existierenden Renderpuffers vom Typ renderbuffertarget sein. Ist renderbuffer nicht Null und ist glFramebufferRenderbuffer erfolgreich, wird der Renderpuffer renderbuffer ein, logischer Puffer des gerade an das Ziel target gebundenen Framepuffers, der durch attachment indentifizierbar ist.

Der Wert von GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE für den angegebenen "Attachment Point" wird auf GL_RENDERBUFFER, der Wert von GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME auf renderbuffer gesetzt. Alle anderen Zustandswerte des in attachment angegebenen "Attachment Points" werden auf ihre Standartwerte gesetzt.

Der Zustand des Renderpuffers verändert sich nicht und es werden alle vorher existierenden Bindungen bezüglich des logischen Puffers des Framebuffers target aufgehoben.

Ein Aufruf mit renderbuffer gleich Null löst eine bereits bestehende Bindung von attachment im gerade an target gebundenen Framepuffer auf. Alle Zustandswerte des "Attachment Points" attachment werden im an das Ziel gebunden Objekt auf ihre Standartwerte gesetzt.

attachment stellt mit dem Wert GL_DEPTH_STENCIL_ATTACHMENT einen besonderen Fall dar; es werden die Tiefen- und Stencil"attachments" des Framepuffer-Objekts auf renderbuffer gesetzt, das das interne Format GL_DEPTH_STENCIL haben sollte.


Hinweise

glFramebufferRenderbuffer ist erst ab OpenGL Version 3.0 verfügbar!


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn target keines der akzeptieren Werte ist.

GL_INVALID_ENUM wird generiert, wenn renderbuffertarget nicht GL_RENDERBUFFER ist.

GL_INVALID_OPERATION wird generiert, wenn target Null ist.


Siehe auch

glGenFramebuffers, glBindFramebuffer, glGenRenderbuffers, glFramebufferTexture