The RenderMan Interface - Paul Bourke

More documents

Recommendations

Info

LIST OF FIGURES 4.1 Camera-to-Raster Projection Geometry . . . . . . . . . . . . . . . . . . . . . 22 4.2 Imaging pipeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 5.1 Bicubic patch vertex ordering . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 5.2 Patch Meshes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 5.3 Quadric Surface Primitives . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 5.4 Quadric Surface Primitives (continued) . . . . . . . . . . . . . . . . . . . . . 82 9.1 <strong>The</strong> ray tracing paradigm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 9.2 Shader evaluation pipeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 12.1 Surface shader state . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 12.2 Light Source Shader State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 C.1 Example encoded RIB byte stream . . . . . . . . . . . . . . . . . . . . . . . . 184 vii
LIST OF TABLES 4.1 Camera Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 4.2 Point Coordinate Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 4.3 Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 4.4 Additional Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 4.5 Typical implementation-specific options . . . . . . . . . . . . . . . . . . . . 37 4.6 Shading Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 4.7 Standard Light Source Shader Parameters . . . . . . . . . . . . . . . . . . . . 42 4.8 Standard Surface Shader Parameters . . . . . . . . . . . . . . . . . . . . . . . 45 4.9 Standard Displacement Shader Parameters . . . . . . . . . . . . . . . . . . . 46 4.10 Standard Volume Shader Parameters . . . . . . . . . . . . . . . . . . . . . . 47 4.11 Geometry Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 4.12 Typical implementation-specific attributes . . . . . . . . . . . . . . . . . . . 61 5.1 Standard Geometric Primitive Variables . . . . . . . . . . . . . . . . . . . . . 64 5.2 RiBlobby opcodes for primitive fields. . . . . . . . . . . . . . . . . . . . . . 86 5.3 RiBlobby opcodes for combining fields. . . . . . . . . . . . . . . . . . . . . 87 6.1 Moving Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 10.1 Standard Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 11.1 Color Coordinate Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 11.2 Point coordinate systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 12.1 Predefined Surface Shader Variables . . . . . . . . . . . . . . . . . . . . . . . 121 12.2 Predefined Light Source Variables . . . . . . . . . . . . . . . . . . . . . . . . 123 12.3 Predefined Volume Shader Variables . . . . . . . . . . . . . . . . . . . . . . . 123 12.4 Predefined Displacement Shader Variables . . . . . . . . . . . . . . . . . . . 124 12.5 Predefined Imager Shader Variables . . . . . . . . . . . . . . . . . . . . . . . 124 15.1 Texture and Environment Map Access Parameters . . . . . . . . . . . . . . . 144 15.2 Shadow Map Access Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 147 15.3 Data names known to the textureinfo function. . . . . . . . . . . . . . . . . . 147 15.4 Data names known to the attribute function. . . . . . . . . . . . . . . . . . . 149 15.5 Data names known to the option function. . . . . . . . . . . . . . . . . . . . 149 15.6 Data names known to the rendererinfo function. . . . . . . . . . . . . . . . . 150 C.1 Binary Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 viii
Page 1 and 2: The RenderMan Interface Version 3.2
Page 3 and 4: TABLE OF CONTENTS List of Figures L
Page 5 and 6: 12.1 Surface Shaders . . . . . . .
Page 7: Section I DIFFERENCES BETWEEN VERSI
Page 11 and 12: PREFACE This document is version 3.
Page 13 and 14: Section 1 INTRODUCTION The RenderMa
Page 15 and 16: created using this language. This l
Page 17 and 18: Depth of Field The ability to simul
Page 19 and 20: typedef RtPointer typedef RtPointer
Page 21 and 22: RiContext (ctx1); ... There is no R
Page 23 and 24: Section 3 RELATIONSHIP TO THE RENDE
Page 25 and 26: through the interface. Any place wh
Page 27 and 28: RtContextHandle RiGetContext ( void
Page 29 and 30: RiWorldBegin (); ... RiColor (...);
Page 31 and 32: Camera Option Type Default Descript
Page 33 and 34: ottom top left right Screen Window
Page 35 and 36: EXAMPLE RiFrameAspectRatio (4.0/3.0
Page 37 and 38: not support the special projection
Page 39 and 40: This procedure sets the times at wh
Page 41 and 42: Output depth values are the camera-
Page 43 and 44: A particular renderer implementatio
Page 45 and 46: Renderers may additionally produce
Page 47 and 48: The number of color components, n,
Page 49 and 50: RiAttributeBegin () RiAttributeEnd
Page 51 and 52: RIB BINDING Color c0 c1... cn Color
Page 53 and 54: An area light source is defined by
Page 55 and 56: The sequencenumber is the integer l
Page 57 and 58: 4.2.5 Displacement shading The grap
Page 59 and 60:
SEE ALSO RiExterior RiAtmosphere Ri
Page 61 and 62:
Matte onoff EXAMPLE RiMatte (RI TRU
Page 63 and 64:
object foo2 will be drawn when the
Page 65 and 66:
the exterior is the region adjacent
Page 67 and 68:
RiIdentity ( ); SEE ALSO RiTransfor
Page 69 and 70:
RiScale ( RtFloat sx, RtFloat sy, R
Page 71 and 72:
4.3.2 Transformation stack Transfor
Page 73 and 74:
Section 5 GEOMETRIC PRIMITIVES The
Page 75 and 76:
Information Name Type Class Floats
Page 77 and 78:
No checking is done by the RenderMa
Page 79 and 80:
5.2 Patches Patches can be either u
Page 81 and 82:
U V 0 1 2 3 12 13 14 15 4 5 6 7 8 9
Page 83 and 84:
10 x 7 Aperiodic Bezier Bicubic Pat
Page 85 and 86:
SEE ALSO 2 2 [ 0 0 1 1 ] 0 1 ”Pw
Page 87 and 88:
parameterlist is a list of token-ar
Page 89 and 90:
Requests a sphere defined by the fo
Page 91 and 92:
Hyperboloid 0 0 0 .5 0 0 270 ”Cs
Page 93 and 94:
z N z V point2 height U x x y 0 max
Page 95 and 96:
particle. If a primitive variable i
Page 97 and 98:
The code array is a sequence of mac
Page 99 and 100:
is an array of floats that define t
Page 101 and 102:
The helper program generates geomet
Page 103 and 104:
Procedural ”DynamicLoad” [ ”m
Page 105 and 106:
SolidBegin ( ”difference” ); So
Page 107 and 108:
Section 6 MOTION Some rendering pro
Page 109 and 110:
Transformations Geometry Shading Ri
Page 111 and 112:
channels (usually an RGB color) can
Page 113 and 114:
Image Forward Axis Up Axis Right Ax
Page 115 and 116:
ErrorHandler ”ignore” ErrorHand
Page 117 and 118:
Part II The RenderMan Shading Langu
Page 119 and 120:
spaces (such as CMYK or pseudocolor
Page 121 and 122:
transmit reflect transmit P E light
Page 123 and 124:
Section 10 RELATIONSHIP TO THE REND
Page 125 and 126:
Section 11 TYPES The Shading Langua
Page 127 and 128:
Coordinate System ”shader” ”c
Page 129 and 130:
As in C, individual array elements
Page 131 and 132:
Light Source E Vantage Point N L Il
Page 133 and 134:
Surface Element to Illuminate L N I
Page 135 and 136:
Name Type Storage Class Description
Page 137 and 138:
• conditional execution, • loop
Page 139 and 140:
This example integrates over a hemi
Page 141 and 142:
Shader instance variable values can
Page 143 and 144:
} return 2 * (vector noise(p)) - 1;
Page 145 and 146:
These functions compute power and i
Page 147 and 148:
The actual change in a variable is
Page 149 and 150:
Return a unit vector in the directi
Page 151 and 152:
Return surface normal given a point
Page 153 and 154:
diffuse returns the diffuse compone
Page 155 and 156:
prevent aliasing. If one set of tex
Page 157 and 158:
15.7.3 Shadow depth maps Shadow dep
Page 159 and 160:
These functions access the value of
Page 161 and 162:
The standard data names supported b
Page 163 and 164:
} Oi = sum; Ci = Cs * Oi * (Ka + Kd
Page 165 and 166:
path of the ray. The input Ci and O
Page 167 and 168:
A.2.3 Metal surface surface metal(
Page 169 and 170:
distantlight( float intensity = 1;
Page 171 and 172:
A.6 Imager Shaders A.6.1 Background
Page 173 and 174:
variable definitions ; variables va
Page 175 and 176:
triple sixteentuple arrayindex: [ e
Page 177 and 178:
Logical expressions have the value
Page 179 and 180:
typedef RtPointer RtContextHandle;
Page 181 and 182:
RiOptionV(RtToken name, RtInt n, Rt
Page 183 and 184:
RtInt n, RtToken tokens[], RtPointe
Page 185 and 186:
#define RIE_NOTATTRIBS ((RtInt)26)
Page 187 and 188:
Comments Any occurrence of the ’#
Page 189 and 190:
In the following sections the synta
Page 191 and 192:
C.2.2 Error handling There are two
Page 193 and 194:
adhandle badparamlist badripcode ba
Page 195 and 196:
v e r s i o n 212 # version 003 007
Page 197 and 198:
Using RIB File structuring conventi
Page 199 and 200:
Attribute Format PixelFilter Shadin
Page 201 and 202:
##Include filename This entry allow
Page 203 and 204:
D.2.1 RIB Entity File example ##Ren
Page 205 and 206:
Motion Blur Programmable Shading Di
Page 207 and 208:
} E.4 Gaussian Filter RtFloat RiGau
Page 209 and 210:
Appendix G RENDERMAN INTERFACE QUIC
Page 211 and 212:
Function RiOpacity (color) RiOption
Page 213 and 214:
Geometric Primitives (continued) Fu
Page 215 and 216:
Function abs(x) Math Functions Desc
Page 217 and 218:
Function area(P) calculatenormal(P)
Page 219 and 220:
Texture Mapping Functions Function
Page 221 and 222:
RiInterior 47 RiLightSource 42 RiMa
Page 223 and 224:
and uniform variables on an RiNuPat
Page 225 and 226:
Statement About Pixar’s Copyright
show all

The RenderMan Interface - Paul Bourke

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?