Zum Hauptinhalt springen

XR8.GlTextureRenderer.create()

XR8.GlTextureRenderer.create({ GLctx, vertexSource, fragmentSource, toTexture, flipY, mirroredDisplay })`

Beschreibung

Erzeugt ein Objekt zum Rendern von einer Textur auf eine Leinwand oder eine andere Textur.

Parameter

ParameterTypStandardBeschreibung
GLctxWebGlRenderingContext" oder "WebGl2RenderingContext".Der WebGlRenderingContext (oder WebGl2RenderingContext), der für das Rendering verwendet werden soll. Wenn kein "toTexture" angegeben ist, wird der Inhalt auf die Leinwand dieses Kontexts gezeichnet.
vertexSource [Optional]StringEin No-Op-Vertex-ShaderDie Vertex-Shader-Quelle, die für das Rendering verwendet wird.
fragmentSource [Optional]StringEin No-op-Fragment-ShaderDie Fragment-Shader-Quelle, die für das Rendering verwendet wird.
toTexture [Optional]WebGlTexturDie Leinwand von "GLctxEine Textur zum Zeichnen. Wenn keine Textur angegeben wird, wird auf die Leinwand gezeichnet.
flipY [Fakultativ]BooleanfalseWenn ja, wird das Rendering auf den Kopf gestellt.
mirroredDisplay [Optional]BooleanfalseWenn true, wird das Rendering von links nach rechts gespiegelt.

Rückgabe

Gibt ein Objekt zurück: {render, destroy, shader}

EigentumBeschreibung
render({ renderTexture, viewport })Eine Funktion, die die RenderTextur in das angegebene Ansichtsfenster rendert. Abhängig davon, ob toTexture angegeben wurde, befindet sich das Ansichtsfenster entweder auf der Leinwand, die GLctx erstellt hat, oder es ist relativ zu der angegebenen Rendertextur.
zerstörenBereinigt die mit diesem GlTextureRenderer verbundenen Ressourcen.
ShaderLiefert ein Handle auf den Shader, der zum Zeichnen der Textur verwendet wird.

Die Funktion "Rendern" hat die folgenden Parameter:

ParameterBeschreibung
renderTextureEine WebGlTextur (Quelle) zum Zeichnen.
AnsichtsfensterDer Bereich der Leinwand oder der Ausgabetextur, in den gezeichnet werden soll; dieser kann manuell oder mit XR8.GlTextureRenderer.fillTextureViewport() erstellt werden.

Das Ansichtsfenster wird durch { width, height, offsetX, offsetY } angegeben:

EigentumTypBeschreibung
BreiteNummerDie Breite (in Pixel), die gezeichnet werden soll.
HöheNummerDie Höhe (in Pixel), die gezeichnet werden soll.
offsetX [Optional]NummerDie minimale x-Koordinate (in Pixeln), bis zu der gezeichnet werden soll.
offsetY [Fakultativ]NummerDie minimale y-Koordinate (in Pixel), bis zu der gezeichnet werden soll.