Every other Pd object has its own help patch, so I don't understand why these wouldn't also. I think that it would be pretty straightforward to auto-generate help patches based on the blue book, then as people get inspired, they could add examples. I attached a quick example.
I don't remember all the details of every function I ever use, so I look things up a lot. Pd has a very handy and quick way to bring up a reference page, why wouldn't we use it?
.hc
On Mar 24, 2009, at 4:28 PM, marius schebella wrote:
I think a general help patch about the GEMgl objects would be nice. there are some special things people should be aware of, for example that you have to add the f for float in many of the objects: like GEMglVertex3f. I also think a couple of example patches would be good to have, like how to bind textures or vertexbuffer objects. otoh I think very few people ever used GEMgl objects, maybe if people start using them then there will be automatically some help/example patches? marius.
IOhannes m zmölnig wrote:
Hans-Christoph Steiner wrote:
I think it would be pretty easy to scrap that page and stick the key text bits into the help page. Something like "NAME", "C SPECIFICATION", "PARAMETERS", and "DESCRIPTION". I imagine that this stuff doesn't change very often.
Ideally there would be working examples for each function, but that's a big project. What else should go on that help page?
i think the only reasonable solution is to have a single helpfile for all the openGL-wrapper objects, that points to a "real" ressource, like the blue book; and probably anything else will just eat diskspace for naught. i don't think you can teach openGL by providing "working examples for each function"; you cannot use the GEMgl... objects without having a proper knowledge of openGL. mfg.adsr IOhannes _______________________________________________ GEM-dev mailing list GEM-dev@iem.at http://lists.puredata.info/listinfo/gem-dev
----------------------------------------------------------------------------
"Free software means you control what your computer does. Non-free software means someone else controls that, and to some extent controls you." - Richard M. Stallman