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

Attachment: GEMglBegin-help.pd
Description: Binary data



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
[email protected]
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


_______________________________________________
GEM-dev mailing list
[email protected]
http://lists.puredata.info/listinfo/gem-dev

Reply via email to