To Do List

To Do in glitter Use with self._context for all GL calls, pass context when creating sub-objects. Use caching to reduce the number of bind and unbind operations caused by with statements. Implement NeHe tutorials as literate example programs, add an example for PyCUDA interoperability. Write documentation and tests, expecially for using multiple objects at the same time (e.g., Textures, Contexts). Provide example datasets for the examples (volume and mesh), link to source and to index for examples.

To Do in glitter.arrays.arraybuffer Implement slicing to allow for glVertexAttribPointer with size, stride, and pointer parameters.

To Do in glitter.arrays.basebuffer Implement binding as separate object to allow binding buffers to different targets. This problem is very similar to rebinding Samplers to different units and should probably be handled in a similar way. Implement slicing with glGetBufferSubData. Remember that glBindBuffer and glBindBufferRange/glBindBufferBase interfer with each other! accept another buffer in constructor, copy _id, proxy shape etc., keep reference to other buffer, disable set_data and __del__

To Do in glitter.arrays.vertexarray Rethink vertex array drawing: e.g., differing number of elements in vertex and color buffer, allow for use of glVertexAttribDivisor.

To Do in glitter.contexts Create a raw offscreen GLX context class with context generation and switching and use it as a default context instead of GLUT. Qt GL widgets and contexts.

To Do in glitter.contexts.context Provide convenience setters for glBlendFunc via blend_func=("SRC_ALPHA", "ONE_MINUS_SRC_ALPHA"). Add listing of all bound textures, buffers, etc. Do we need indexed variants for glEnable? Wrap glPatchParameter. Implement multiple viewports using glViewportIndexed, glViewportArray, glScissorIndexed, and glScissorArray. Wrap glSampleCoverage, glSampleMaski, glMinSampleShading, GL_SAMPLE_COVERAGE_VALUE, and GL_SAMPLE_COVERAGE_INVERT. Wrap glReadPixels and related framebuffer copy functions. Add indexed getters for GL_TRANSFORM_FEEDBACK_BUFFER_START, GL_TRANSFORM_FEEDBACK_BUFFER_SIZE, GL_UNIFORM_BUFFER_SIZE and GL_UNIFORM_BUFFER_START. Add getters for GL_CLIP_DISTANCEi, GL_DEPTH_CLAMP, GL_FRAMEBUFFER_SRGB, GL_MULTISAMPLE, GL_PRIMITIVE_RESTART, GL_TEXTURE_CUBE_MAP_SEAMLESS, GL_SAMPLE_ALPHA_TO_ONE, GL_SAMPLE_ALPHA_TO_COVERAGE, GL_SAMPLE_COVERAGE, GL_SAMPLE_SHADING, and GL_SAMPLE_MASK. Implement stencil buffers using GL_STENCIL_BACK_FUNC, GL_STENCIL_FUNC, GL_STENCIL_BACK_REF, GL_STENCIL_REF, GL_STENCIL_BACK_VALUE_MASK, GL_STENCIL_BACK_WRITEMASK, GL_STENCIL_VALUE_MASK, GL_STENCIL_WRITEMASK, GL_STENCIL_BACK_FAIL, GL_STENCIL_BACK_PASS_DEPTH_FAIL, GL_STENCIL_BACK_PASS_DEPTH_PASS, GL_STENCIL_FAIL, GL_STENCIL_PASS_DEPTH_FAIL, GL_STENCIL_PASS_DEPTH_PASS, etc.

To Do in glitter.contexts.glut Implement subwindows using glutCreateSubWindow and glutGet(GLUT_WINDOW_PARENT). Implement menus, font rendering, and geometric object rendering, Fail gracefully (better error message) when context cannot be created, e.g. when opengl 3.2 not available Key constants like GLUT_KEY_F1 should be available as an enum.

To Do in glitter.contexts.glut.main_loop Avoid destroying a window in __del__ that has already been destroyed by closing it; can glutCloseFunc help?

To Do in glitter.convenience.mesh Implement loading from obj, ply etc.

To Do in glitter.convenience.pipeline.Pipeline.__init__ _vao and _fbo should be created dynamically when (and if) attributes and attachments are accessed, respectively; use_framebuffer should not be necessary then.

To Do in glitter.convenience.pipeline.Pipeline.draw_with kwargs context properties should override _lazy_context_properties.

To Do in glitter.framebuffers.framebuffer Implement binding for reading; wrap glReadPixels, glBlitFramebuffer, glCopyTexSubImage and related framebuffer copy functions. Add properties for viewport, color_writemask, depth_writemask, blend_func, blend_equation, and depth_range (using glDepthRangeArray and glDepthRangeIndexed).

To Do in glitter.framebuffers.framebuffer.Framebuffer.clear Use glClearBuffer to clear selected attachments only.

To Do in glitter.framebuffers.renderbuffer.Renderbuffer Use glFramebufferRenderbuffer instead of _binding; returns GLsync! Wrap glRenderbufferStorage and glRenderbufferStorageMultisample.

To Do in glitter.misc.query.AnySamplesPassedQuery Wrap glBeginConditionalRender and glEndConditionalRender.

To Do in glitter.misc.query.SamplesPassedQuery Wrap glBeginConditionalRender and glEndConditionalRender.

To Do in glitter.misc.sync.Sync Implement properties using glGetSynciv.

To Do in glitter.misc.transformfeedback Implement this using glBeginTransformFeedback, glPauseTransformFeedback, glResumeTransformFeedback, glEndTransformFeedback, glDrawTransformFeedback, glDrawTransformFeedbackInstanced, glDrawTransformFeedbackStream, and glDrawTransformFeedbackStreamInstanced.

To Do in glitter.shaders.attribute.Attribute.__get__ Implement this.

To Do in glitter.shaders.attribute.Attribute.__set__ Implement this: if the shader is currently bound, set the attribute at once, else store only.

To Do in glitter.shaders.attribute.AttributeStruct.__get__ Implement this.

To Do in glitter.shaders.attribute.AttributeStruct.__set__ Implement this.

To Do in glitter.shaders.attribute.AttributeStructArray.__get__ Implement this.

To Do in glitter.shaders.attribute.AttributeStructArray.__set__ Implement this.

To Do in glitter.shaders.programpipeline Use glUseProgramStages, glValidateProgramPipeline etc.

To Do in glitter.shaders.shader.FragmentShader wrap glGetShaderPrecisionFormat.

To Do in glitter.shaders.shader.VertexShader wrap glGetShaderPrecisionFormat.

To Do in glitter.shaders.shaderprogram wrap glGetProgramStage, glGetActiveSubroutineName, glGetActiveSubroutineUniform, glGetActiveSubroutineUniformName, glGetSubroutineIndex, glGetSubroutineUniformLocation, glGetTransformFeedbackVarying, glTransformFeedbackVarying, glGetUniformBlockIndex, glGetUniformIndices, glGetActiveUniformBlock, glGetActiveUniformBlockName, glUniformBlockBinding, and glUniformSubroutine.

To Do in glitter.shaders.uniform.UniformStruct.__get__ Implement this.

To Do in glitter.shaders.uniform.UniformStruct.__set__ Implement this.

To Do in glitter.shaders.uniform.UniformStructArray.__get__ Implement this.

To Do in glitter.shaders.uniform.UniformStructArray.__set__ Implement this.

To Do in glitter.textures.sampler Implement getters and setters for Sampler.unit, but take care not to confuse any existing bindings on the stack. This problem is very similar to rebinding buffers to different targets and should probably be handled in a similar way.

To Do in glitter.textures.texture Check OpenGL memory layout; do shaders use the same coordinates as numpy does? Implement depth textures. Implement __getitem__ and __setitem__ for subimages (glTexSubImage3D, glGetTexImage with format=GL_RED etc.). Implement image textures.

To Do in glitter.textures.texture.BufferTexture Override constructor, set_data and get_data; use glTexBuffer

To Do in glitter.utils.constants Add internal formats GL_DEPTH_COMPONENT and GL_DEPTH_STENCIL to texture_formats.

To Do in glitter.utils.objects Rethink what __del__ and __exit__ methods should do when the interpreter exits (e.g. restoring to a deleted object will not work).