The RenderMan Interface - Paul Bourke

RiProcedural ((RtPointer)args, mybound, RiProcDelayedReadArchive, RiProcFree);
Procedural ”DelayedReadArchive” [ ”sodacan.rib” ] [ -1 1 -1 1 0 6 ]
SEE ALSO
RiProcDelayedReadArchive, RiProcRunProgram, RiProcDynamicLoad
RiProcDelayedReadArchive ( RtPointer data, RtFloat detail )
The built-in procedural RiProcDelayedReadArchive operates exactly like ReadArchive,
except that the reading is delayed until the procedural primitive bounding box is
reached (unlike ReadArchive, which reads RIB files immediately during parsing).
The advantage of the procedural primitive is that because the reading is delayed,
memory for the read primitives is not used unless (or until) the contents of the bounding
box are actually needed.
The data parameter consists of a pointer to an RtString array. The first element of the
array (that is, ((RtString *)data)[0]) is the name of a RIB file to read.
The file can contain any amount of valid RIB, although it is suggested that it either
be “flat” (have no hierarchy) or have some balanced hierarchy (matching Begin-End
calls). As with all RIB parameters that are bounding boxes, the boundingbox is an
array of six floating-point numbers, which are xmin, xmax, ymin, ymax, zmin, zmax in
the current object space.
RIB BINDING
Procedural ”DelayedReadArchive” [filename] [boundingbox]
The argument string list contains a single string giving the filename the file to read
when the contents of the boundingbox are needed.
EXAMPLE
RtString args[] = { ”sodacan.rib” };
RtBound mybound = { -1, 1, -1, 1, 0, 6 };
RiProcedural ((RtPointer)args, mybound, RiProcDelayedReadArchive, RiProcFree);
Procedural ”DelayedReadArchive” [ ”sodacan.rib” ] [ -1 1 -1 1 0 6 ]
SEE ALSO
RiProcedural, RiProcRunProgram, RiProcDynamicLoad
RiProcRunProgram ( RtPointer data, RtFloat detail )
The built-in procedural RiProcRunProgram will run an external “helper program,”
capturing its output and interpreting it as RIB input. The data parameter consists
of a pointer to an RtString array. The first element of the array is the name of the
program to run (including any command line arguments), and the second element is
an argument string to be written to the standard input stream of the helper program.
89