[GEM-dev] help files gemgl*

[Hans-Christoph Steiner]

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

-------------- next part --------------
A non-text attachment was scrubbed...
Name: GEMglBegin-help.pd
Type: application/octet-stream
Size: 705 bytes
Desc: not available
URL: <http://lists.puredata.info/pipermail/gem-dev/attachments/20090324/e8aac5d3/attachment.obj>
-------------- next part --------------


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 at 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