Hi Hartwig, On Sat, Nov 28, 2009 at 10:02 AM, Hartwig Wiesmann > is there anywhere a documentation of all used preprocessor symbols?
No and I wouldn't really expect them to be any single piece of documentation just dedicated to pre-processors symbols as they are typically very domain specific and localised in effect. Documentation for such if need will be done individually in headers or makefiles. As a general note, with the OSG I strive to use long names for #define's, classes, methods and variables to try and convey the appropriate meaning, so usually when one looks at the usage in context one can usually make an educated guess as to it's role/function. While this is not a substitute for conventional documentation in quite a few cases it's actually far more practical and maintainable. > Currently I am only interested in all common (not platform dependent) and Mac > OSX related symbols. > > I found these Mac OSX related symbols > > - DARWIN_QUICKTIME > - __USE_OSX_AGL_IMPLEMENTATION__ > > The first one seems to be only used in osgDB to enable the loading of a > QuickTime plugin. You guessed correctly - DARWIN_QUICKTIME switches on the alias of image extensions to use quicktime for loading rather than the individual image plugins used on other platforms. The the advent of 64bit OSX quicktime is a bugbear not being 64bit yet so ImageIO is used in it's place. > The consequences of using or not using the second one I do not know. __USE_OSX_AGL_IMPLEMENTATION__ only exists in Xcode/XcodeTemplates/TemplateNotes.rtf, so is just a hang of docs not getting update to reflect the current version of the OSG. Here's lies why I prefer to use long names in real active code rather than adding inline docs in a fine grained way - as they can cause far more harm than good when they get out sync. As a general note the OpenSceneGraph/XCode directory is deprecated and has been hand maintain by Stephan Huber while the CMake XCode support matures. Robert. _______________________________________________ osg-users mailing list [email protected] http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
