hi robert, osg community, to amplify on what paul said:
* we do a lab in our course in which we explore what plugins are capable of reading/writing. * but! our results always show that plugins support an inconsistent mix of return values, sometimes returning "ERROR_IN_READING_FILE" when they really mean that they don't handle files of that extension, sometimes returning "FILE_NOT_HANDLED" when there's an error in reading the file data. * as part of our course in paris this week, we've then wondered aloud if there's an official osg policy for these return values, and if robert had an original design idea behind each return value. our impression is that these mean, as follows: FILE_NOT_HANDLED, //!< file is not appropriate for this file reader, due to some incompatibility, but *not* a read error FILE_NOT_FOUND, //!< file could not be found or could not be read FILE_LOADED, //!< file successfully found, loaded, and converted into osg FILE_LOADED_FROM_CACHE, //!< file found in cache and returned ERROR_IN_READING_FILE //!< file found, loaded, but an error was encountered during processing if this interpretation of the errors are correct, i'd like to add doxygen documentation to that effect, and the above comments can be in-line replaced in the code to do so. and i've sent a fixed osgDB/ReadResult to osg-submissions for this purpose. the second thing i'd like to do, though i don't have the time, is to clean up the loaders so that the above return scheme is used consistently. the big problem with the current loaders is that there seems to not be a lot of consistency in error reporting among all loaders. thoughts? bob On Apr 29, 2008, at 12:11 PM, Paul Martz wrote: > Hi Robert -- > > If the .ive file can't read a node file for any reason, it returns > FILE_NOT_HANDLED. This is correct if the file type isn't .ive, but > if it > _is_ a .ive file and it is simply corrupt or something else went wrong > (permissions, whatever), the plugin should return > ERROR_IN_READING_FILE, > shouldn't it? > > Many plugins appear to use return values inconsistently, so this > might be a > widespread issue. > > Paul Martz > Skew Matrix Software LLC > http://www.skew-matrix.com <http://www.skew-matrix.com/> > +1 303 859 9466 > > _______________________________________________ > osg-users mailing list > [email protected] > http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org _______________________________________________ osg-users mailing list [email protected] http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
