> I'm also not that awed by the SIGGRAPH presentations. Most of the > things > that are planned for OSG 1.2 we have already in OpenSG (except > Terrain,
i believe that, but how should other people (that are not yet using a OpenSG) know? > a panacea. I'm not as worried as Allen is, but I agree that on an > exponential curve being a little behind makes a big difference. > is OpenSG on an exponential curve at all? i don't see that from the number of unique posters on the mailing list ... > > Website: Allen and I have been working on getting a better website > system up and running. Check out http://opensg.vrsource.org . It uses i see this: "The fact that you are seeing this page indicates that the website you just visited is either experiencing problems, or is undergoing routine maintenance." ;-) > I'm not a big fan of documentation that explains me that the parameter > 'child' of the method 'addChild' is the child that is added. We also agreed -- BUT, i think the developers themselves are not the right people to decide which documentation is superfluous and which is not. So, as a rule i would recommend every developer to consider documentation an integral part of coding, however arduous that may be. So, for instance, i just took a quick look at OSGQuaternion.h: 1. slerp() -- if someone has never heard of 'spherical linear interpolation' he has no idea what that fct might do; but even half a sentence (namely, "does spherical linear interpolation") would explain most of it; and if the doc would mention the post-condition that the result is always a unit-quaternion, everything would be pretty clear. 2. QuaternionBase(const VectorType &axis, const ValueTypeT angle ) -- is angle in radians or in degrees? 3. setValueAsAxisRad(const ValueTypeT *valsP ) -- i have no idea what that might do (how can an axis be derived from a single float)? yes, i can *suspect* that the pointer points to an array of floats, but that's just a wild guess and is the angle the first or the last element? 4. setValueAsAxisRad(const Char8 *str ) -- format? 5. setValue (const ValueTypeT alpha, const ValueTypeT beta, const ValueTypeT gamma ) -- ranges? order (back-to-front or front-to- back)? 6. operator == (const QuaternionBase &other) -- is that comparison with epsilon or without? OK, that was just a very quick example from a very small header file ... (BTW, OSGQuaternion.h was the first header file i picked) > look at CGAL, and yes, that's impressive, but it lends itself much > more yes. > to this kind of documentation as every piece is very self- > contained. In i don't agree here. CGAL has a core and lots of stuff on top of that -- same for OSG. > problem. Doxygen takes longer than compiling the whole system (twice) ok, that's a nuisance, but during development you don't really need to run doxygen, do you? you just write the doc in the code, and only before checking in you run doxygen 1-2x to verify the docu, right? Well, i guess one big question is how to get more people involved in the development of OSG for a long time. Just my tupence. Best regards, Gabriel. _________________________________________________________________ If you know exactly what you will do -- why would you want to do it? (Picasso) _________________________________________________________________ ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Opensg-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/opensg-users
