26.01.2015 Views

The RenderMan Interface - Paul Bourke

The RenderMan Interface - Paul Bourke

The RenderMan Interface - Paul Bourke

SHOW MORE
SHOW LESS
  • No tags were found...

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

adhandle<br />

badparamlist<br />

badripcode<br />

badstringtoken<br />

badtoken<br />

badversion<br />

limitcheck<br />

An invalid light or object handle was supplied as a parameter to an<br />

Illuminate, ObjectInstance, LightSource, AreaLightSource, or ObjectBegin<br />

request. For Illuminate, the light handle must be an integer<br />

value specified in a previous LightSource or AreaLightSource<br />

request. For ObjectInstance, the object handle must be an integer<br />

value specified in a previous ObjectBegin request. For LightSource,<br />

AreaLightSource, and ObjectBegin this error is raised if the number<br />

specified for a light handle is significantly larger than any previous<br />

handle; for example, specifying 3000 when the largest previous handle<br />

was 10 (this is used as a “sanity check” to guard against corrupted<br />

input data).<br />

EXAMPLE<br />

LightSource ”finite” 1<br />

Illuminate 99999<br />

In a token-value pair of a parameter list, the type of a value did not<br />

agree with the declared type of the token.<br />

EXAMPLE<br />

Declare ”gridsize” ”uniform float[2]”<br />

Option ”limits” ”gridsize” ”not a number”<br />

A binary encoded token that specified a RIB request used an undefined<br />

request code. Request codes must be defined, prior to their use,<br />

with the binary encoding protocol; see the section on Binary Encoding.<br />

A binary encoded string token referenced a string that had not previously<br />

been defined. <strong>The</strong> binary encoding scheme is described in<br />

Binary encoding.<br />

A byte with the most significant bit set was not recognized as a valid<br />

binary encoding. <strong>The</strong> binary encoding scheme is described in Binary<br />

encoding.<br />

EXAMPLE<br />

\300<br />

<strong>The</strong> RIB protocol version number specified in a version request was<br />

greater than the protocol version number of the interpreter. SEE ALSO<br />

version<br />

An internal limit was encountered during normal operation of the interpreter.<br />

Implementers of RIB interpreters are expected to avoid imposing<br />

arbitrary limits. Some implementations may, however, need to<br />

limit the maximum size of strings, arrays, etc. due to memory constraints.<br />

182

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!