The RenderMan Interface - Paul Bourke

ErrorHandler ”ignore”
ErrorHandler ”print”
ErrorHandler ”abort”
If ”ignore”, ”print”, or ”abort” is specified, the equivalent predefined error handling
procedure will be invoked in the RIB server. Notice that the RIB parser process may
detect RIB stream syntax errors which make it impossible to correctly parse a request.
In this case, the error procedure will be invoked and the parser will do its best to
resynchronize the input stream by scanning for the next recognizable token.
EXAMPLE
ErrorHandler ”ignore”
7.3 Archive Files
One important use of the RIB protocol is to store a scene description in an archive file for
rendering at a later time or in a remote location from the modeling application. Appendix
D, RenderMan Interface Bytestream Conventions, outlines a structuring conventions to
make these archives as portable and useful as possible.
RiArchiveRecord ( RtToken type, char *format [, arg ...] )
This call writes a user data record (data which is outside the scope of the requests
described in the rest of Part I of this document) into a RIB archive file or stream.
type is one of ”comment”, or ”structure”, or ”verbatim”. ”comment” begins the user
data record with a RIB comment marker and terminates it with a newline. ”structure”
begins the user data record with a RIB structuring convention preface and terminates
it with a newline. ”verbatim” just outputs the data as-is, with no leading comment
character and no trailing newline. The user data record itself is supplied as a printf()
format string with optional arguments. It is an error to embed newline characters in
the format or any of its string arguments.
RiReadArchive ( RtToken name, RtVoid (*callback)(RtToken,char*,...), ...parameterlist...)
This function will read the named file. Each RIB command in the archive will be
parsed and executed exactly as if it had been called by the application program directly,
or been in-line in the calling RIB file, as the case may be. This is essentially a
RIB-file include mechanism.
In the C API version, the callback parameter is a function which will be called for any
RIB user data record or structure comment which is found in the file. This routine
104