From b50852a3c285a5163d7deea02b4b3b500bd7027a Mon Sep 17 00:00:00 2001
From: faiface <faiface@ksp.sk>
Date: Tue, 22 Nov 2016 23:18:04 +0100
Subject: [PATCH] add an important BeginEnder interface
---
pixelgl/interface.go | 34 ++++++++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
create mode 100644 pixelgl/interface.go
diff --git a/pixelgl/interface.go b/pixelgl/interface.go
new file mode 100644
index 0000000..90b433a
--- /dev/null
+++ b/pixelgl/interface.go
@@ -0,0 +1,34 @@
+package pixelgl
+
+// BeginEnder is an interface for manipulating OpenGL state.
+//
+// OpenGL is a state machine and as such, it is natural to manipulate it in a begin-end manner.
+// This interface is intended for all OpenGL objects, that can begin being active and end being active
+// such as windows, vertex arrays, vertex buffers, textures, shaders, pretty much everything.
+//
+// It might seem natural to use BeginEnders this way:
+//
+// window.Begin()
+// shader.Begin()
+// texture.Begin()
+// vertexarray.Begin()
+// vertexarray.Draw()
+// vertexarray.End()
+// texture.End()
+// shader.End()
+// window.End()
+//
+// Don't do this! A better practice is to make a BeginEnder so that it wraps another BeginEnder like this:
+//
+// shader = NewShader(window)
+// texture = NewTexture(shader)
+// vertexarray = NewVertexArray(texture)
+// // now, somewhere else in your code, instead of calling numerous Begin/Ends, you just calling
+// vertexarray.Draw()
+//
+// The final single call to draw a vertex array executes all of the Begins and Ends, because the objects are
+// wrapped around each other.
+type BeginEnder interface {
+ Begin()
+ End()
+}
--
GitLab