Re: OSL API Documentation
|
Larry Gritz
I'm not trying to make excuses for our lack of documentation, just trying to explain it.
The "end users" are the people writing shaders, and so we do publish the language spec (and hopefully, are working toward more OSL programming tutorial material). The rest of the "end user" documentation is kind of pushed to the renderers, because OSL is embedded in rendering products as a library so the way it's exposed to users will vary a lot from renderer to renderer. But the basic reason that there is currently no separate documentation for the C++ APIs is that they aren't something that ordinary end users (people who write shaders) ever need to know about. Those APIs are only of interest to the authors of renderers who wish to embed OSL into their renderer. We're trying to improve this, but that's the basic reason why the current "documentation" is just the comments in the headers themselves, and the code of the sample programs like testshade and test render. -- lg
|
|
|