Hi Ben,
Very nice of you to start this documentation. As you already found out
this are not working out of the box wrt shadows, all the different
techniques have different characteristics. I am swamped with work but I
will try to fill in some of my experiences. So far I have spent most of
my (shadow-related) time on SSM and PSSM. To start with, you could add
references where the original ideas are published. E.g. SSM comes from
GPU Gems 2.
best regards
Raymond
Ben Discoe wrote:
Alright. I have created a wiki page here, with my best attempt at documenting
what i've learned so far:
http://www.openscenegraph.org/projects/osg/wiki/Support/ProgrammingGuide/osgShadow
It would be really great if someone who actually /knows/ the code could fill in
things like:
* How do the various ShadowTechniques differ?
* What specific card capabilities (geometry shaders, ?) does each
ShadowTechnique require?
* Which ShadowTechniques respect which CastsShadow/ReceivesShadow bits?
* What do those PSSM options do?
J-S, Wojtek, Adrian, Robert, Mihai, Raymond, Paul, others... can you take a
minute to help? Or if you prefer, you could answer any of the blanks from the
wiki page here on the list, and i'll be happy to paste them into the wiki for
you.
Thanks,
Ben
-----Original Message-----
From: Jean-Sébastien Guay
Hi Ben,
First of all, thanks for your willingness to contribute to documenting
parts of the OSG which are still pretty bleeding-edge! It's great to see
this kind of involvement.
About where to put documentation:
1. The wiki has a page:
http://www.openscenegraph.org/projects/osg/wiki/Community/Tasks/osgSha
dow
but that is an old page from before osgshadow joined the OSG source, it
seems like not the place for documentation.
The page is under the "tasks" section, so it's not the right place for
documentation on how to use the nodekit.
2. We could make a new Wiki page, perhaps linked from:
http://www.openscenegraph.org/projects/osg/wiki/Support/ProgrammingGuides
under 'Programming the NodeKit libraries'
3. The source-doxygen docs, which end up here:
http://www.openscenegraph.org/documentation/OpenSceneGraphReferenceDoc
s/a02211.html
I could submit modifications to the osgshadow source code with
appropriate comment paragraphs explaining how to use each class. But,
that appears to not be OSG's design, source docs seem to be deliberately
minimal, so perhaps extensive documentation with text formatting, charts
etc. belongs outside the source.
I think a combination of these two will give good documentation. In the
past, most of the documentation for OSG was in the doxycomments, but I
think a balanced approach will yield better overall documentation from a
"user-developer" point of view (users of the API, as opposed to developers
of OSG or contributors).
Of course, this is just my opinion, others might have other comments.
Thanks again for wanting to contribute, I look forward to reading your
work!
J-S
--
______________________________________________________
Jean-Sebastien Guay [EMAIL PROTECTED]
http://www.cm-labs.com/
http://whitestar02.webhop.org/
_______________________________________________
osg-users mailing list
osg-users@lists.openscenegraph.org
http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
_______________________________________________
osg-users mailing list
osg-users@lists.openscenegraph.org
http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org