The RenderMan Interface - Paul Bourke

More documents

Recommendations

Info

4.2.11 Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 4.2.12 Geometric approximation . . . . . . . . . . . . . . . . . . . . . . . . . 53 4.2.13 Orientation and sides . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 4.3 Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 4.3.1 Named coordinate systems . . . . . . . . . . . . . . . . . . . . . . . . 58 4.3.2 Transformation stack . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 4.4 Implementation-specific Attributes . . . . . . . . . . . . . . . . . . . . . . . 60 Section 5 GEOMETRIC PRIMITIVES 62 5.1 Polygons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 5.2 Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 5.3 Subdivision Surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 5.4 Quadrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 5.5 Point and Curve Primitives . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 5.6 Blobby Implicit Surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 5.7 Procedural Primitives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 5.8 Implementation-specific Geometric Primitives . . . . . . . . . . . . . . . . . 92 5.9 Solids and Spatial Set Operations . . . . . . . . . . . . . . . . . . . . . . . . . 92 5.10 Retained Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Section 6 MOTION 96 Section 7 EXTERNAL RESOURCES 99 7.1 Texture Map Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 7.1.1 Making texture maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 7.1.2 Making environment maps . . . . . . . . . . . . . . . . . . . . . . . . 100 7.1.3 Making shadow maps . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 7.2 Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 7.3 Archive Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Part II <strong>The</strong> <strong>RenderMan</strong> Shading Language 106 Section 8 INTRODUCTION TO THE SHADING LANGUAGE 107 Section 9 OVERVIEW OF THE SHADING PROCESS 109 Section 10 RELATIONSHIP TO THE RENDERMAN INTERFACE 112 Section 11 TYPES 114 11.1 Floats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 11.2 Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 11.3 Points, Vectors, and Normals . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 11.4 Transformation Matrices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 11.5 Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 11.6 Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 11.7 Uniform and Varying Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Section 12 SHADER EXECUTION ENVIRONMENT 119 iii
12.1 Surface Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 12.2 Light Source Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 12.3 Volume Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 12.4 Displacement Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 12.5 Imager Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Section 13 LANGUAGE CONSTRUCTS 125 13.1 Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 13.2 Standard Control Flow Constructs . . . . . . . . . . . . . . . . . . . . . . . . 125 13.3 Illuminance and Illuminate Statements . . . . . . . . . . . . . . . . . . . . . . 127 Section 14 SHADERS AND FUNCTIONS 129 14.1 Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 14.2 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Section 15 BUILT-IN FUNCTIONS 133 15.1 Mathematical Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 15.2 Geometric Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 15.3 Color Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 15.4 Matrix Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 15.5 String Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 15.6 Shading and Lighting Functions . . . . . . . . . . . . . . . . . . . . . . . . . 141 15.7 Texture Mapping Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 15.7.1 Basic texture maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 15.7.2 Environment maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 15.7.3 Shadow depth maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 15.7.4 Getting Information About Texture Maps . . . . . . . . . . . . . . . . 146 15.8 Message Passing and Information Functions . . . . . . . . . . . . . . . . . . 146 Section 16 EXAMPLE SHADERS 151 16.1 Surface Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 16.1.1 Turbulence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 16.1.2 Ray tracer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 16.2 Light Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 16.3 Volume Shader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 16.4 Displacement Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 16.5 Imager Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Section A STANDARD RENDERMAN INTERFACE SHADERS 155 A.1 Null Shader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 A.2 Surface Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 A.2.1 Constant surface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 A.2.2 Matte surface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 A.2.3 Metal surface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 A.2.4 Shiny metal surface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 A.2.5 Plastic surface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 A.2.6 Painted plastic surface . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 A.3 Light Source Shaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 A.3.1 Ambient light source . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 iv
Page 1 and 2: The RenderMan Interface Version 3.2
Page 3: TABLE OF CONTENTS List of Figures L
Page 7 and 8: Section I DIFFERENCES BETWEEN VERSI
Page 9 and 10: LIST OF TABLES 4.1 Camera Options .
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

Create successful ePaper yourself

Delete template?

Save as template?