improved indentation and whitespace for markdown code blocks
All code blocks in markdown have been intended by at least 4 spaces. We add `--tab-stop=8` to all `pandoc(1)` executions in order to set a better tab stop indentation, especially for tab intended code blocks. Changed `bin/pandoc-wrapper.sh` VERSION from "1.5.3 2024-03-26" to "1.6 2024-03-31". Fixed `1991/brnstnd/sorta.README.md` so that the sorta code is code blocks. Removed unneeded paragraph group in copyright in `inc/footer.default.html`. Fixed excess whitespace after list Author on entry `index.html` page. Changed `bin/output-index-author.sh` VERSION from "1.5.2 2024-03-26" to "1.6 2024-03-31". Performed `make www` to perform the above and test under macOS. TODO: Fix the problem of the initial line of code being extra intended. TODO: Fix excess whitespace around code that is inline.
This commit is contained in:
Landon Curt Noll committed
1 parent
b84c27ce02
commit
a996f8d2b8
734 files changed
+16723
-16963
No files matched your search
+12
-12
@@ -1,7 +1,7 @@
|
||||
## To build:
|
||||
|
||||
```sh
|
||||
make all
|
||||
make all
|
||||
```
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ make all
|
||||
The current status of this entry is:
|
||||
|
||||
```
|
||||
STATUS: INABIAF - please **DO NOT** fix
|
||||
STATUS: INABIAF - please **DO NOT** fix
|
||||
```
|
||||
|
||||
For more detailed information see [2013 hou bugs](../../bugs.html#2013_hou).
|
||||
@@ -19,7 +19,7 @@ For more detailed information see [2013 hou bugs](../../bugs.html#2013_hou).
|
||||
## To use:
|
||||
|
||||
```sh
|
||||
./hou [scene-file-name] [options]
|
||||
./hou [scene-file-name] [options]
|
||||
```
|
||||
|
||||
Follow the instructions in `stdout`, preferably with an auto-refreshing PPM
|
||||
@@ -30,7 +30,7 @@ effects should be more or less recognizable when you see 16.
|
||||
## Try:
|
||||
|
||||
```sh
|
||||
./try.sh
|
||||
./try.sh
|
||||
```
|
||||
|
||||
Try opening the file noted by the program then let the program run a while and
|
||||
@@ -63,8 +63,8 @@ NOTE: the author refers to [a.c](a.c), placed in a gzipped file `a.c.gz`. We do
|
||||
include it but it can be generated like:
|
||||
|
||||
```sh
|
||||
cc -Wall hou.c -o hou -lm
|
||||
./hou > a.c
|
||||
cc -Wall hou.c -o hou -lm
|
||||
./hou > a.c
|
||||
```
|
||||
|
||||
but there is no need to do this as the Makefile takes care of it without even
|
||||
@@ -79,7 +79,7 @@ This program is a programmable rendering engine with a built-in default scene.
|
||||
The standard command line is:
|
||||
|
||||
```sh
|
||||
./hou [scene-file-name] [options]
|
||||
./hou [scene-file-name] [options]
|
||||
```
|
||||
|
||||
As `hou` runs, it writes a progressively refining image to a ppm file specified
|
||||
@@ -182,11 +182,11 @@ doesn't copy saved sessions across different endianness.
|
||||
### Spoiler
|
||||
|
||||
```
|
||||
3225 3225 3225 9 9 3225 3225
|
||||
1 1 1 1 1 1 1 1 1 1
|
||||
4225 1226 1 1 1 1 1222 1226
|
||||
1 1 1 1 1 1 1 1 1
|
||||
4226 1 4226 8 4222 4226 1 1
|
||||
3225 3225 3225 9 9 3225 3225
|
||||
1 1 1 1 1 1 1 1 1 1
|
||||
4225 1226 1 1 1 1 1222 1226
|
||||
1 1 1 1 1 1 1 1 1
|
||||
4226 1 4226 8 4222 4226 1 1
|
||||
```
|
||||
|
||||
The program consists of a recursive-descent interpreter, a `3DDDA` (3D Discrete
|
||||
|
||||
+219
-219
@@ -125,38 +125,38 @@
|
||||
<h1 id="scene-format-documentation">Scene format documentation</h1>
|
||||
<p>The file must be encoded in UTF-8 as the BOF marker indicates.</p>
|
||||
<p>You can directly feed it to the renderer. If you’re wondering about what the following code block does, that’s why:)</p>
|
||||
<pre><code>@|?|?z#
|
||||
@|||?z&
|
||||
>?Sedvf
|
||||
??Tdeu#
|
||||
>>Tdeui
|
||||
??Tdmmf
|
||||
??[[euf
|
||||
?}?Oq}e
|
||||
?}?Oqqf
|
||||
v}?|q}e
|
||||
v}?|qqf
|
||||
?Sj|?{f
|
||||
?Tjk?{e
|
||||
FF?Oqq$
|
||||
RR?Oqq$
|
||||
^^?Oqq$
|
||||
jj?Oqq$
|
||||
vv?|qq$
|
||||
IOBMqqe
|
||||
U]BMqqe
|
||||
aiBMqqe
|
||||
muBMqqe
|
||||
EEEJpp%
|
||||
QQEJpp%
|
||||
]]EJpp%
|
||||
iiEJpp%
|
||||
uuEJpp%
|
||||
ZnY|{|e
|
||||
[mZ|\{\{#
|
||||
[mZ|||f
|
||||
kkdr\{\{\%
|
||||
lkdr\{\{></code></pre>
|
||||
<pre><code> @|?|?z#
|
||||
@|||?z&
|
||||
>?Sedvf
|
||||
??Tdeu#
|
||||
>>Tdeui
|
||||
??Tdmmf
|
||||
??[[euf
|
||||
?}?Oq}e
|
||||
?}?Oqqf
|
||||
v}?|q}e
|
||||
v}?|qqf
|
||||
?Sj|?{f
|
||||
?Tjk?{e
|
||||
FF?Oqq$
|
||||
RR?Oqq$
|
||||
^^?Oqq$
|
||||
jj?Oqq$
|
||||
vv?|qq$
|
||||
IOBMqqe
|
||||
U]BMqqe
|
||||
aiBMqqe
|
||||
muBMqqe
|
||||
EEEJpp%
|
||||
QQEJpp%
|
||||
]]EJpp%
|
||||
iiEJpp%
|
||||
uuEJpp%
|
||||
ZnY|{|e
|
||||
[mZ|\{\{#
|
||||
[mZ|||f
|
||||
kkdr\{\{\%
|
||||
lkdr\{\{></code></pre>
|
||||
<h2 id="basic-structure">Basic structure</h2>
|
||||
<p>A scene file begins with arbitrary binary data, followed by several shader
|
||||
functions.</p>
|
||||
@@ -164,33 +164,33 @@ functions.</p>
|
||||
character. There are some special function names, which will be explained below.</p>
|
||||
<p>The language used to write shader functions is very simple. Basically, you write
|
||||
a sequence of assignment statements like this:</p>
|
||||
<pre><code>A=A+D
|
||||
B=B+E</code></pre>
|
||||
<pre><code> A=A+D
|
||||
B=B+E</code></pre>
|
||||
<p>Namely, you write a one-character variable name, an equal sign (<code>=</code>), followed
|
||||
by an expression (made of operators and one-character variable names, of
|
||||
course).</p>
|
||||
<h2 id="expressions">Expressions</h2>
|
||||
<p>The shader language supports seven operators, listed highest priority first:</p>
|
||||
<pre><code>*/+-<#:</code></pre>
|
||||
<pre><code> */+-<#:</code></pre>
|
||||
<p><code>*/+-<</code> each mean what they mean in C, but the priority part is a bit different.
|
||||
Basically, <code>*</code> has higher priority than <code>/</code>, so <code>A/4*4</code> actually computes
|
||||
<code>A/(4*4)</code>. And you can’t write <code>(A/4)*4</code> – brackets are not supported. As an
|
||||
advice, keep your expressions simple :) If you really needs to write something
|
||||
like <code>C=(A/4)*4</code>, write instead:</p>
|
||||
<pre><code>B=A/4+
|
||||
C=B*4</code></pre>
|
||||
<pre><code> B=A/4+
|
||||
C=B*4</code></pre>
|
||||
<p>The <code>#</code> operator acts somewhat like the C <code>?:</code>. It returns one of its two
|
||||
operands based on, what else, the value of variable <code>#</code>. When <code>#</code> is true, <code>#</code>
|
||||
returns its second operand.</p>
|
||||
<p>The <code>:</code> operator calls built-in functions. The first operand is the function id and the second is the parameter. Here is a list of functions:</p>
|
||||
<pre><code>0:x = the x-th byte of the scene file
|
||||
1:x = sin(x*PI)
|
||||
2:x = atan2(x,#)/PI
|
||||
3:x = sqrt(max(x,0))
|
||||
4:x = floor(x)
|
||||
5:x = the next number in the (allegedly random) number sequence, can't be called in volume shaders
|
||||
6:x = value of the variable (char)(120+x)
|
||||
7:x = write #'s value to the variable (char)(120+x)</code></pre>
|
||||
<pre><code> 0:x = the x-th byte of the scene file
|
||||
1:x = sin(x*PI)
|
||||
2:x = atan2(x,#)/PI
|
||||
3:x = sqrt(max(x,0))
|
||||
4:x = floor(x)
|
||||
5:x = the next number in the (allegedly random) number sequence, can't be called in volume shaders
|
||||
6:x = value of the variable (char)(120+x)
|
||||
7:x = write #'s value to the variable (char)(120+x)</code></pre>
|
||||
<p>Contrary to popular belief, the language itself doesn’t support numerical
|
||||
constants. Any character sitting between operators is a variable. When you see
|
||||
1/2, it’s in fact dividing the variable 1’s value by the variable 2’s value. For
|
||||
@@ -208,7 +208,7 @@ the Windows <code>\r\n</code>), and it terminates your function. Also, the first
|
||||
must begin immediately after <code>]</code>.</p>
|
||||
<p>When a function terminates, the interpreter calls the next function specified by
|
||||
variable <code>R</code>. If you want to call function <code>n</code>, just write somewhere:</p>
|
||||
<pre><code>R=n</code></pre>
|
||||
<pre><code> R=n</code></pre>
|
||||
<p>providing you have left <code>n</code> at its initial value. If you want to actually return
|
||||
to the renderer, put in <code>R=0</code>.</p>
|
||||
<p>As you may have noticed, you can put in all kinds of stuff between functions,
|
||||
@@ -224,28 +224,28 @@ material shaders.</p>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<pre><code>//As an (optional) assignment, figure out what function 'n' does. And why there is a plus sign at every EOL except the last.
|
||||
n]#=1+
|
||||
x=X+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Y+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Z+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1+
|
||||
U=U+2+
|
||||
C=C#d+3*9+
|
||||
#=d+
|
||||
R=0#n</code></pre>
|
||||
<pre><code> //As an (optional) assignment, figure out what function 'n' does. And why there is a plus sign at every EOL except the last.
|
||||
n]#=1+
|
||||
x=X+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Y+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Z+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1+
|
||||
U=U+2+
|
||||
C=C#d+3*9+
|
||||
#=d+
|
||||
R=0#n</code></pre>
|
||||
<hr />
|
||||
<p>The function <code>A</code> initializes global settings:</p>
|
||||
<pre><code>G -- Image width, in pixels
|
||||
H -- Image height, in pixels
|
||||
I -- Perturbation probability
|
||||
J -- Camera ray stratification probability</code></pre>
|
||||
<pre><code> G -- Image width, in pixels
|
||||
H -- Image height, in pixels
|
||||
I -- Perturbation probability
|
||||
J -- Camera ray stratification probability</code></pre>
|
||||
<p>If you have used a MLT renderer before, you probably know what <code>I</code> and <code>J</code> does.
|
||||
If you don’t, well, use the same value as the default scene. Everything
|
||||
converges just fine under suboptimal settings, just a little slower. Generally,
|
||||
@@ -280,17 +280,17 @@ the one facing my bed, to thank me for the effort.</p>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<pre><code>//As a bonus, find out what the first line does
|
||||
A]#=#-#;"=7:0-p+^;#="+
|
||||
R=n+
|
||||
G=p*:+
|
||||
#=0<B+
|
||||
G=G*2#G+
|
||||
H=G*3/4+
|
||||
I=4/5+
|
||||
J=1/2+
|
||||
C=p+1+
|
||||
U=w+w+w</code></pre>
|
||||
<pre><code> //As a bonus, find out what the first line does
|
||||
A]#=#-#;"=7:0-p+^;#="+
|
||||
R=n+
|
||||
G=p*:+
|
||||
#=0<B+
|
||||
G=G*2#G+
|
||||
H=G*3/4+
|
||||
I=4/5+
|
||||
J=1/2+
|
||||
C=p+1+
|
||||
U=w+w+w</code></pre>
|
||||
<hr />
|
||||
<p>The function <code>a</code> is the camera shader, which, well, generates the camera ray.
|
||||
It’s supposed to return the ray in variables <code>UVWXYZ</code> and <code>ABCDEF</code> (that may
|
||||
@@ -312,8 +312,8 @@ coordinate space, volume 0 is scaled up 64x here to <code>(0,0,0)-(4096,4096,409
|
||||
happen. Wall up everything.</p>
|
||||
<p>Variables <code>ABCDEF</code> control the color returned from the ray. They will be
|
||||
explained in the material shaders part. For now, just put in:</p>
|
||||
<pre><code>A=0;B=0;C=0
|
||||
D=1;E=1;F=1</code></pre>
|
||||
<pre><code> A=0;B=0;C=0
|
||||
D=1;E=1;F=1</code></pre>
|
||||
<table>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
@@ -321,29 +321,29 @@ D=1;E=1;F=1</code></pre>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<pre><code>a]R=0+
|
||||
X=5:5+
|
||||
Y=5:5+
|
||||
X=X-1/2+
|
||||
Y=Y-1/2+
|
||||
x=5:5+
|
||||
y=5:5+
|
||||
x=x-1/2+
|
||||
y=y-1/2+
|
||||
x=x*8*7;y=y*8*7+
|
||||
X=X*G+
|
||||
Y=Y*H+
|
||||
Z=H*2/3+
|
||||
d=4*;+
|
||||
d=d*p/Z+
|
||||
X=x+X*d+
|
||||
Y=y+Y*d+
|
||||
Z=Z*d+
|
||||
U=p*p/2-p*2+x+
|
||||
V=p*p/2+p*1-y+
|
||||
W=p*8+
|
||||
A=0;B=0;C=0+
|
||||
D=1;E=1;F=1</code></pre>
|
||||
<pre><code> a]R=0+
|
||||
X=5:5+
|
||||
Y=5:5+
|
||||
X=X-1/2+
|
||||
Y=Y-1/2+
|
||||
x=5:5+
|
||||
y=5:5+
|
||||
x=x-1/2+
|
||||
y=y-1/2+
|
||||
x=x*8*7;y=y*8*7+
|
||||
X=X*G+
|
||||
Y=Y*H+
|
||||
Z=H*2/3+
|
||||
d=4*;+
|
||||
d=d*p/Z+
|
||||
X=x+X*d+
|
||||
Y=y+Y*d+
|
||||
Z=Z*d+
|
||||
U=p*p/2-p*2+x+
|
||||
V=p*p/2+p*1-y+
|
||||
W=p*8+
|
||||
A=0;B=0;C=0+
|
||||
D=1;E=1;F=1</code></pre>
|
||||
<hr />
|
||||
<p>The numbered functions define materials, i.e., surface reflectance properties.
|
||||
As the name suggests, the shader simulates ray-surface interaction. It’s done by
|
||||
@@ -374,32 +374,32 @@ Function) importance sampling. Let’s continue to function <code>o</code>.</p>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<pre><code>//This function computes the starred wallpaper
|
||||
//Original color: 0.36 0.714285 0.8
|
||||
1]R=o+
|
||||
d=p*6+
|
||||
x=U+W+
|
||||
x=4:x/d+
|
||||
z=4:V/d+
|
||||
#=3*x-4*z+
|
||||
y=4:#/5+
|
||||
#=#-y*5+
|
||||
y=1#0+
|
||||
x=x*d+d/2-U+W+
|
||||
z=z*d+d/2-V+
|
||||
r=3:x*x+z*z+
|
||||
#=z+
|
||||
u=2:x+
|
||||
d=1:u*5+
|
||||
d=d*d*d+3/2+
|
||||
d=d*p+
|
||||
#=r<d+
|
||||
#=#*y+
|
||||
d=2/5#I+
|
||||
D=D*d+
|
||||
E=E*4/7+
|
||||
d=I#2/5+
|
||||
F=F*d</code></pre>
|
||||
<pre><code> //This function computes the starred wallpaper
|
||||
//Original color: 0.36 0.714285 0.8
|
||||
1]R=o+
|
||||
d=p*6+
|
||||
x=U+W+
|
||||
x=4:x/d+
|
||||
z=4:V/d+
|
||||
#=3*x-4*z+
|
||||
y=4:#/5+
|
||||
#=#-y*5+
|
||||
y=1#0+
|
||||
x=x*d+d/2-U+W+
|
||||
z=z*d+d/2-V+
|
||||
r=3:x*x+z*z+
|
||||
#=z+
|
||||
u=2:x+
|
||||
d=1:u*5+
|
||||
d=d*d*d+3/2+
|
||||
d=d*p+
|
||||
#=r<d+
|
||||
#=#*y+
|
||||
d=2/5#I+
|
||||
D=D*d+
|
||||
E=E*4/7+
|
||||
d=I#2/5+
|
||||
F=F*d</code></pre>
|
||||
<hr />
|
||||
<p>Function <code>o</code> defines a diffuse (that is, dull) surface. To define reflectance
|
||||
properties like this, one needs to sample an outgoing ray direction, based on
|
||||
@@ -415,9 +415,9 @@ defined as a bunch of cube-shaped cells, there are only 6 possible normals:
|
||||
<code>(±1,0,0) (0,±1,0) (0,0,±1)</code>. Here <code>S</code> is the sign and <code>T</code> is the dimension. If
|
||||
you get <code>S=-1</code> and <code>T=1</code>, the normal is <code>(0,-1,0)</code>.</p>
|
||||
<p>If you don’t want to redo all the math yourself… this file provides a few simple shader functions:</p>
|
||||
<pre><code>o -- Diffuse surface. Do the color thing your self and call R=o
|
||||
5 -- Perfect mirror.
|
||||
f -- Surface with a Fresnel term. Basically, it resembles a polished surface made from a dielectric material.</code></pre>
|
||||
<pre><code> o -- Diffuse surface. Do the color thing your self and call R=o
|
||||
5 -- Perfect mirror.
|
||||
f -- Surface with a Fresnel term. Basically, it resembles a polished surface made from a dielectric material.</code></pre>
|
||||
<p>For something more complex like a fluffy carpet, well, you could use a volume to
|
||||
directly model the
|
||||
<a href="https://en.wikipedia.org/wiki/Mesoscopic_physics">mesoscopic</a> detail. Shader
|
||||
@@ -430,107 +430,107 @@ appearance.</p>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<pre><code>//diffuse ray generation
|
||||
o]R=0+
|
||||
u=5:5+
|
||||
v=5:5+
|
||||
v=v*2+
|
||||
r=3:u+
|
||||
z=1:v+
|
||||
y=1:1/2+v+
|
||||
z=z*r+
|
||||
y=y*r+
|
||||
x=3:1-u+
|
||||
x=0-x*S+
|
||||
X=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Y=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Z=6:T
|
||||
<pre><code> //diffuse ray generation
|
||||
o]R=0+
|
||||
u=5:5+
|
||||
v=5:5+
|
||||
v=v*2+
|
||||
r=3:u+
|
||||
z=1:v+
|
||||
y=1:1/2+v+
|
||||
z=z*r+
|
||||
y=y*r+
|
||||
x=3:1-u+
|
||||
x=0-x*S+
|
||||
X=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Y=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Z=6:T
|
||||
|
||||
//reflector
|
||||
5]R=0+
|
||||
x=1;y=1;z=1+
|
||||
#=0-1+
|
||||
#=7:T+
|
||||
X=x*X;Y=y*Y;Z=z*Z
|
||||
//reflector
|
||||
5]R=0+
|
||||
x=1;y=1;z=1+
|
||||
#=0-1+
|
||||
#=7:T+
|
||||
X=x*X;Y=y*Y;Z=z*Z
|
||||
|
||||
//approximate Fresnel, works better than the real thing when you don't want to tweak the IOR
|
||||
f]x=X;y=Y;z=Z+
|
||||
r=3:x*x+z*z+y*y+
|
||||
d=6:T+
|
||||
d=1-d*S/r+
|
||||
d=d*d*d+
|
||||
#=5:5+
|
||||
#=d<#+
|
||||
R=5#o+
|
||||
d=d#1-d+
|
||||
u=1#u+
|
||||
v=1#v+
|
||||
w=1#w+
|
||||
D=D*d*u+
|
||||
E=E*d*v+
|
||||
F=F*d*w
|
||||
//approximate Fresnel, works better than the real thing when you don't want to tweak the IOR
|
||||
f]x=X;y=Y;z=Z+
|
||||
r=3:x*x+z*z+y*y+
|
||||
d=6:T+
|
||||
d=1-d*S/r+
|
||||
d=d*d*d+
|
||||
#=5:5+
|
||||
#=d<#+
|
||||
R=5#o+
|
||||
d=d#1-d+
|
||||
u=1#u+
|
||||
v=1#v+
|
||||
w=1#w+
|
||||
D=D*d*u+
|
||||
E=E*d*v+
|
||||
F=F*d*w
|
||||
|
||||
//the handles
|
||||
B]R=0+
|
||||
#=X<8*3+
|
||||
C=3#0
|
||||
//the handles
|
||||
B]R=0+
|
||||
#=X<8*3+
|
||||
C=3#0
|
||||
|
||||
C]R=0+
|
||||
#=X<8*4+
|
||||
C=0#4
|
||||
C]R=0+
|
||||
#=X<8*4+
|
||||
C=0#4
|
||||
|
||||
//red-Fresnel
|
||||
2]R=f+
|
||||
u=1/2;v=1/9;w=v
|
||||
//red-Fresnel
|
||||
2]R=f+
|
||||
u=1/2;v=1/9;w=v
|
||||
|
||||
//white-Fresnel and the full moon
|
||||
3]R=f+
|
||||
u=7*9/p;v=u;w=v+
|
||||
x=3*:+8+
|
||||
z=U-x*p+p/2+
|
||||
x=V-x*p-p/2+
|
||||
r=3:x*x+z*z+
|
||||
#=4<r/p+
|
||||
D=D*I#D+
|
||||
E=E*4/7#E+
|
||||
F=F*2/5#F+
|
||||
d=1/5#0+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d
|
||||
//white-Fresnel and the full moon
|
||||
3]R=f+
|
||||
u=7*9/p;v=u;w=v+
|
||||
x=3*:+8+
|
||||
z=U-x*p+p/2+
|
||||
x=V-x*p-p/2+
|
||||
r=3:x*x+z*z+
|
||||
#=4<r/p+
|
||||
D=D*I#D+
|
||||
E=E*4/7#E+
|
||||
F=F*2/5#F+
|
||||
d=1/5#0+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d
|
||||
|
||||
//handle
|
||||
4]R=5+
|
||||
D=D*I;E=E*4/7;F=F*2/5
|
||||
//handle
|
||||
4]R=5+
|
||||
D=D*I;E=E*4/7;F=F*2/5
|
||||
|
||||
//light from the window
|
||||
6]R=0+
|
||||
#=P+
|
||||
d=2#8*2+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d*I+
|
||||
P=9
|
||||
//light from the window
|
||||
6]R=0+
|
||||
#=P+
|
||||
d=2#8*2+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d*I+
|
||||
P=9
|
||||
|
||||
//carpet
|
||||
7]R=o+
|
||||
D=D/7+
|
||||
E=E/3+
|
||||
F=F/7
|
||||
//carpet
|
||||
7]R=o+
|
||||
D=D/7+
|
||||
E=E/3+
|
||||
F=F/7
|
||||
|
||||
D]R=0+
|
||||
#=8<Y+
|
||||
C=0#3+
|
||||
#=4:3*X-4*Z+
|
||||
y=4:#/7+
|
||||
#=#-y*7+
|
||||
C=7#C</code></pre>
|
||||
D]R=0+
|
||||
#=8<Y+
|
||||
C=0#3+
|
||||
#=4:3*X-4*Z+
|
||||
y=4:#/7+
|
||||
#=#-y*7+
|
||||
C=7#C</code></pre>
|
||||
<hr />
|
||||
<p>The last line, well, is the output filename. Just remember to throw in two <code>]</code>s
|
||||
and don’t put a newline after it.</p>
|
||||
<pre><code>]]example.ppm</code></pre>
|
||||
<pre><code> ]]example.ppm</code></pre>
|
||||
<!--
|
||||
|
||||
Copyright © 1984-2024 by Landon Curt Noll. All Rights Reserved.
|
||||
|
||||
+225
-226
@@ -1,43 +1,42 @@
|
||||
|
||||
# Scene format documentation
|
||||
# Scene format documentation
|
||||
|
||||
The file must be encoded in UTF-8 as the BOF marker indicates.
|
||||
|
||||
You can directly feed it to the renderer. If you're wondering about what the following code block does, that's why:)
|
||||
|
||||
```
|
||||
@|?|?z#
|
||||
@|||?z&
|
||||
>?Sedvf
|
||||
??Tdeu#
|
||||
>>Tdeui
|
||||
??Tdmmf
|
||||
??[[euf
|
||||
?}?Oq}e
|
||||
?}?Oqqf
|
||||
v}?|q}e
|
||||
v}?|qqf
|
||||
?Sj|?{f
|
||||
?Tjk?{e
|
||||
FF?Oqq$
|
||||
RR?Oqq$
|
||||
^^?Oqq$
|
||||
jj?Oqq$
|
||||
vv?|qq$
|
||||
IOBMqqe
|
||||
U]BMqqe
|
||||
aiBMqqe
|
||||
muBMqqe
|
||||
EEEJpp%
|
||||
QQEJpp%
|
||||
]]EJpp%
|
||||
iiEJpp%
|
||||
uuEJpp%
|
||||
ZnY|{|e
|
||||
[mZ|\{\{#
|
||||
[mZ|||f
|
||||
kkdr\{\{\%
|
||||
lkdr\{\{>
|
||||
@|?|?z#
|
||||
@|||?z&
|
||||
>?Sedvf
|
||||
??Tdeu#
|
||||
>>Tdeui
|
||||
??Tdmmf
|
||||
??[[euf
|
||||
?}?Oq}e
|
||||
?}?Oqqf
|
||||
v}?|q}e
|
||||
v}?|qqf
|
||||
?Sj|?{f
|
||||
?Tjk?{e
|
||||
FF?Oqq$
|
||||
RR?Oqq$
|
||||
^^?Oqq$
|
||||
jj?Oqq$
|
||||
vv?|qq$
|
||||
IOBMqqe
|
||||
U]BMqqe
|
||||
aiBMqqe
|
||||
muBMqqe
|
||||
EEEJpp%
|
||||
QQEJpp%
|
||||
]]EJpp%
|
||||
iiEJpp%
|
||||
uuEJpp%
|
||||
ZnY|{|e
|
||||
[mZ|\{\{#
|
||||
[mZ|||f
|
||||
kkdr\{\{\%
|
||||
lkdr\{\{>
|
||||
```
|
||||
|
||||
|
||||
@@ -53,8 +52,8 @@ The language used to write shader functions is very simple. Basically, you write
|
||||
a sequence of assignment statements like this:
|
||||
|
||||
```
|
||||
A=A+D
|
||||
B=B+E
|
||||
A=A+D
|
||||
B=B+E
|
||||
```
|
||||
|
||||
Namely, you write a one-character variable name, an equal sign (`=`), followed
|
||||
@@ -67,7 +66,7 @@ course).
|
||||
The shader language supports seven operators, listed highest priority first:
|
||||
|
||||
```
|
||||
*/+-<#:
|
||||
*/+-<#:
|
||||
```
|
||||
|
||||
`*/+-<` each mean what they mean in C, but the priority part is a bit different.
|
||||
@@ -77,8 +76,8 @@ advice, keep your expressions simple :) If you really needs to write something
|
||||
like `C=(A/4)*4`, write instead:
|
||||
|
||||
```
|
||||
B=A/4+
|
||||
C=B*4
|
||||
B=A/4+
|
||||
C=B*4
|
||||
```
|
||||
|
||||
The `#` operator acts somewhat like the C `?:`. It returns one of its two
|
||||
@@ -88,14 +87,14 @@ returns its second operand.
|
||||
The `:` operator calls built-in functions. The first operand is the function id and the second is the parameter. Here is a list of functions:
|
||||
|
||||
```
|
||||
0:x = the x-th byte of the scene file
|
||||
1:x = sin(x*PI)
|
||||
2:x = atan2(x,#)/PI
|
||||
3:x = sqrt(max(x,0))
|
||||
4:x = floor(x)
|
||||
5:x = the next number in the (allegedly random) number sequence, can't be called in volume shaders
|
||||
6:x = value of the variable (char)(120+x)
|
||||
7:x = write #'s value to the variable (char)(120+x)
|
||||
0:x = the x-th byte of the scene file
|
||||
1:x = sin(x*PI)
|
||||
2:x = atan2(x,#)/PI
|
||||
3:x = sqrt(max(x,0))
|
||||
4:x = floor(x)
|
||||
5:x = the next number in the (allegedly random) number sequence, can't be called in volume shaders
|
||||
6:x = value of the variable (char)(120+x)
|
||||
7:x = write #'s value to the variable (char)(120+x)
|
||||
```
|
||||
|
||||
Contrary to popular belief, the language itself doesn't support numerical
|
||||
@@ -120,14 +119,14 @@ When a function terminates, the interpreter calls the next function specified by
|
||||
variable `R`. If you want to call function `n`, just write somewhere:
|
||||
|
||||
```
|
||||
R=n
|
||||
```
|
||||
R=n
|
||||
```
|
||||
|
||||
providing you have left `n` at its initial value. If you want to actually return
|
||||
to the renderer, put in `R=0`.
|
||||
providing you have left `n` at its initial value. If you want to actually return
|
||||
to the renderer, put in `R=0`.
|
||||
|
||||
As you may have noticed, you can put in all kinds of stuff between functions,
|
||||
like this comment.
|
||||
As you may have noticed, you can put in all kinds of stuff between functions,
|
||||
like this comment.
|
||||
|
||||
|
||||
## How the ____ do I render an image with shaders?
|
||||
@@ -143,22 +142,22 @@ Continue to the comments before function A
|
||||
|
||||
|
||||
```
|
||||
//As an (optional) assignment, figure out what function 'n' does. And why there is a plus sign at every EOL except the last.
|
||||
n]#=1+
|
||||
x=X+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Y+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Z+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1+
|
||||
U=U+2+
|
||||
C=C#d+3*9+
|
||||
#=d+
|
||||
R=0#n
|
||||
//As an (optional) assignment, figure out what function 'n' does. And why there is a plus sign at every EOL except the last.
|
||||
n]#=1+
|
||||
x=X+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Y+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
x=Z+1/2+
|
||||
d=0:U;d=d-n;U=U+1;A=d<x;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1;A=x<d+1;#=#*A+
|
||||
d=0:U;d=d-n;U=U+1+
|
||||
U=U+2+
|
||||
C=C#d+3*9+
|
||||
#=d+
|
||||
R=0#n
|
||||
```
|
||||
|
||||
-------------------------------------------
|
||||
@@ -166,10 +165,10 @@ R=0#n
|
||||
The function `A` initializes global settings:
|
||||
|
||||
```
|
||||
G -- Image width, in pixels
|
||||
H -- Image height, in pixels
|
||||
I -- Perturbation probability
|
||||
J -- Camera ray stratification probability
|
||||
G -- Image width, in pixels
|
||||
H -- Image height, in pixels
|
||||
I -- Perturbation probability
|
||||
J -- Camera ray stratification probability
|
||||
```
|
||||
|
||||
If you have used a MLT renderer before, you probably know what `I` and `J` does.
|
||||
@@ -210,17 +209,17 @@ Continue to the comments before function a
|
||||
-------------------------------------------
|
||||
|
||||
```
|
||||
//As a bonus, find out what the first line does
|
||||
A]#=#-#;"=7:0-p+^;#="+
|
||||
R=n+
|
||||
G=p*:+
|
||||
#=0<B+
|
||||
G=G*2#G+
|
||||
H=G*3/4+
|
||||
I=4/5+
|
||||
J=1/2+
|
||||
C=p+1+
|
||||
U=w+w+w
|
||||
//As a bonus, find out what the first line does
|
||||
A]#=#-#;"=7:0-p+^;#="+
|
||||
R=n+
|
||||
G=p*:+
|
||||
#=0<B+
|
||||
G=G*2#G+
|
||||
H=G*3/4+
|
||||
I=4/5+
|
||||
J=1/2+
|
||||
C=p+1+
|
||||
U=w+w+w
|
||||
```
|
||||
|
||||
|
||||
@@ -253,8 +252,8 @@ Variables `ABCDEF` control the color returned from the ray. They will be
|
||||
explained in the material shaders part. For now, just put in:
|
||||
|
||||
```
|
||||
A=0;B=0;C=0
|
||||
D=1;E=1;F=1
|
||||
A=0;B=0;C=0
|
||||
D=1;E=1;F=1
|
||||
```
|
||||
|
||||
-------------------------------------------
|
||||
@@ -262,29 +261,29 @@ Continue to the comments before function 1
|
||||
-------------------------------------------
|
||||
|
||||
```
|
||||
a]R=0+
|
||||
X=5:5+
|
||||
Y=5:5+
|
||||
X=X-1/2+
|
||||
Y=Y-1/2+
|
||||
x=5:5+
|
||||
y=5:5+
|
||||
x=x-1/2+
|
||||
y=y-1/2+
|
||||
x=x*8*7;y=y*8*7+
|
||||
X=X*G+
|
||||
Y=Y*H+
|
||||
Z=H*2/3+
|
||||
d=4*;+
|
||||
d=d*p/Z+
|
||||
X=x+X*d+
|
||||
Y=y+Y*d+
|
||||
Z=Z*d+
|
||||
U=p*p/2-p*2+x+
|
||||
V=p*p/2+p*1-y+
|
||||
W=p*8+
|
||||
A=0;B=0;C=0+
|
||||
D=1;E=1;F=1
|
||||
a]R=0+
|
||||
X=5:5+
|
||||
Y=5:5+
|
||||
X=X-1/2+
|
||||
Y=Y-1/2+
|
||||
x=5:5+
|
||||
y=5:5+
|
||||
x=x-1/2+
|
||||
y=y-1/2+
|
||||
x=x*8*7;y=y*8*7+
|
||||
X=X*G+
|
||||
Y=Y*H+
|
||||
Z=H*2/3+
|
||||
d=4*;+
|
||||
d=d*p/Z+
|
||||
X=x+X*d+
|
||||
Y=y+Y*d+
|
||||
Z=Z*d+
|
||||
U=p*p/2-p*2+x+
|
||||
V=p*p/2+p*1-y+
|
||||
W=p*8+
|
||||
A=0;B=0;C=0+
|
||||
D=1;E=1;F=1
|
||||
```
|
||||
|
||||
|
||||
@@ -324,32 +323,32 @@ Continue to the comments before function o
|
||||
-------------------------------------------
|
||||
|
||||
```
|
||||
//This function computes the starred wallpaper
|
||||
//Original color: 0.36 0.714285 0.8
|
||||
1]R=o+
|
||||
d=p*6+
|
||||
x=U+W+
|
||||
x=4:x/d+
|
||||
z=4:V/d+
|
||||
#=3*x-4*z+
|
||||
y=4:#/5+
|
||||
#=#-y*5+
|
||||
y=1#0+
|
||||
x=x*d+d/2-U+W+
|
||||
z=z*d+d/2-V+
|
||||
r=3:x*x+z*z+
|
||||
#=z+
|
||||
u=2:x+
|
||||
d=1:u*5+
|
||||
d=d*d*d+3/2+
|
||||
d=d*p+
|
||||
#=r<d+
|
||||
#=#*y+
|
||||
d=2/5#I+
|
||||
D=D*d+
|
||||
E=E*4/7+
|
||||
d=I#2/5+
|
||||
F=F*d
|
||||
//This function computes the starred wallpaper
|
||||
//Original color: 0.36 0.714285 0.8
|
||||
1]R=o+
|
||||
d=p*6+
|
||||
x=U+W+
|
||||
x=4:x/d+
|
||||
z=4:V/d+
|
||||
#=3*x-4*z+
|
||||
y=4:#/5+
|
||||
#=#-y*5+
|
||||
y=1#0+
|
||||
x=x*d+d/2-U+W+
|
||||
z=z*d+d/2-V+
|
||||
r=3:x*x+z*z+
|
||||
#=z+
|
||||
u=2:x+
|
||||
d=1:u*5+
|
||||
d=d*d*d+3/2+
|
||||
d=d*p+
|
||||
#=r<d+
|
||||
#=#*y+
|
||||
d=2/5#I+
|
||||
D=D*d+
|
||||
E=E*4/7+
|
||||
d=I#2/5+
|
||||
F=F*d
|
||||
```
|
||||
|
||||
-------------------------------------------
|
||||
@@ -373,9 +372,9 @@ you get `S=-1` and `T=1`, the normal is `(0,-1,0)`.
|
||||
If you don't want to redo all the math yourself... this file provides a few simple shader functions:
|
||||
|
||||
```
|
||||
o -- Diffuse surface. Do the color thing your self and call R=o
|
||||
5 -- Perfect mirror.
|
||||
f -- Surface with a Fresnel term. Basically, it resembles a polished surface made from a dielectric material.
|
||||
o -- Diffuse surface. Do the color thing your self and call R=o
|
||||
5 -- Perfect mirror.
|
||||
f -- Surface with a Fresnel term. Basically, it resembles a polished surface made from a dielectric material.
|
||||
```
|
||||
|
||||
For something more complex like a fluffy carpet, well, you could use a volume to
|
||||
@@ -391,103 +390,103 @@ Continue to the EOF
|
||||
-------------------------------------------
|
||||
|
||||
```
|
||||
//diffuse ray generation
|
||||
o]R=0+
|
||||
u=5:5+
|
||||
v=5:5+
|
||||
v=v*2+
|
||||
r=3:u+
|
||||
z=1:v+
|
||||
y=1:1/2+v+
|
||||
z=z*r+
|
||||
y=y*r+
|
||||
x=3:1-u+
|
||||
x=0-x*S+
|
||||
X=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Y=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Z=6:T
|
||||
//diffuse ray generation
|
||||
o]R=0+
|
||||
u=5:5+
|
||||
v=5:5+
|
||||
v=v*2+
|
||||
r=3:u+
|
||||
z=1:v+
|
||||
y=1:1/2+v+
|
||||
z=z*r+
|
||||
y=y*r+
|
||||
x=3:1-u+
|
||||
x=0-x*S+
|
||||
X=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Y=6:T+
|
||||
w=x;x=z;z=y;y=w+
|
||||
Z=6:T
|
||||
|
||||
//reflector
|
||||
5]R=0+
|
||||
x=1;y=1;z=1+
|
||||
#=0-1+
|
||||
#=7:T+
|
||||
X=x*X;Y=y*Y;Z=z*Z
|
||||
//reflector
|
||||
5]R=0+
|
||||
x=1;y=1;z=1+
|
||||
#=0-1+
|
||||
#=7:T+
|
||||
X=x*X;Y=y*Y;Z=z*Z
|
||||
|
||||
//approximate Fresnel, works better than the real thing when you don't want to tweak the IOR
|
||||
f]x=X;y=Y;z=Z+
|
||||
r=3:x*x+z*z+y*y+
|
||||
d=6:T+
|
||||
d=1-d*S/r+
|
||||
d=d*d*d+
|
||||
#=5:5+
|
||||
#=d<#+
|
||||
R=5#o+
|
||||
d=d#1-d+
|
||||
u=1#u+
|
||||
v=1#v+
|
||||
w=1#w+
|
||||
D=D*d*u+
|
||||
E=E*d*v+
|
||||
F=F*d*w
|
||||
//approximate Fresnel, works better than the real thing when you don't want to tweak the IOR
|
||||
f]x=X;y=Y;z=Z+
|
||||
r=3:x*x+z*z+y*y+
|
||||
d=6:T+
|
||||
d=1-d*S/r+
|
||||
d=d*d*d+
|
||||
#=5:5+
|
||||
#=d<#+
|
||||
R=5#o+
|
||||
d=d#1-d+
|
||||
u=1#u+
|
||||
v=1#v+
|
||||
w=1#w+
|
||||
D=D*d*u+
|
||||
E=E*d*v+
|
||||
F=F*d*w
|
||||
|
||||
//the handles
|
||||
B]R=0+
|
||||
#=X<8*3+
|
||||
C=3#0
|
||||
//the handles
|
||||
B]R=0+
|
||||
#=X<8*3+
|
||||
C=3#0
|
||||
|
||||
C]R=0+
|
||||
#=X<8*4+
|
||||
C=0#4
|
||||
C]R=0+
|
||||
#=X<8*4+
|
||||
C=0#4
|
||||
|
||||
//red-Fresnel
|
||||
2]R=f+
|
||||
u=1/2;v=1/9;w=v
|
||||
//red-Fresnel
|
||||
2]R=f+
|
||||
u=1/2;v=1/9;w=v
|
||||
|
||||
//white-Fresnel and the full moon
|
||||
3]R=f+
|
||||
u=7*9/p;v=u;w=v+
|
||||
x=3*:+8+
|
||||
z=U-x*p+p/2+
|
||||
x=V-x*p-p/2+
|
||||
r=3:x*x+z*z+
|
||||
#=4<r/p+
|
||||
D=D*I#D+
|
||||
E=E*4/7#E+
|
||||
F=F*2/5#F+
|
||||
d=1/5#0+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d
|
||||
//white-Fresnel and the full moon
|
||||
3]R=f+
|
||||
u=7*9/p;v=u;w=v+
|
||||
x=3*:+8+
|
||||
z=U-x*p+p/2+
|
||||
x=V-x*p-p/2+
|
||||
r=3:x*x+z*z+
|
||||
#=4<r/p+
|
||||
D=D*I#D+
|
||||
E=E*4/7#E+
|
||||
F=F*2/5#F+
|
||||
d=1/5#0+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d
|
||||
|
||||
//handle
|
||||
4]R=5+
|
||||
D=D*I;E=E*4/7;F=F*2/5
|
||||
//handle
|
||||
4]R=5+
|
||||
D=D*I;E=E*4/7;F=F*2/5
|
||||
|
||||
//light from the window
|
||||
6]R=0+
|
||||
#=P+
|
||||
d=2#8*2+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d*I+
|
||||
P=9
|
||||
//light from the window
|
||||
6]R=0+
|
||||
#=P+
|
||||
d=2#8*2+
|
||||
A=A+D*d+
|
||||
B=B+E*d+
|
||||
C=C+F*d*I+
|
||||
P=9
|
||||
|
||||
//carpet
|
||||
7]R=o+
|
||||
D=D/7+
|
||||
E=E/3+
|
||||
F=F/7
|
||||
//carpet
|
||||
7]R=o+
|
||||
D=D/7+
|
||||
E=E/3+
|
||||
F=F/7
|
||||
|
||||
D]R=0+
|
||||
#=8<Y+
|
||||
C=0#3+
|
||||
#=4:3*X-4*Z+
|
||||
y=4:#/7+
|
||||
#=#-y*7+
|
||||
C=7#C
|
||||
D]R=0+
|
||||
#=8<Y+
|
||||
C=0#3+
|
||||
#=4:3*X-4*Z+
|
||||
y=4:#/7+
|
||||
#=#-y*7+
|
||||
C=7#C
|
||||
```
|
||||
|
||||
-------------------------------------------
|
||||
@@ -496,7 +495,7 @@ The last line, well, is the output filename. Just remember to throw in two `]`s
|
||||
and don't put a newline after it.
|
||||
|
||||
```
|
||||
]]example.ppm
|
||||
]]example.ppm
|
||||
```
|
||||
|
||||
|
||||
|
||||
+13
-14
@@ -132,8 +132,7 @@
|
||||
<h2 id="author"><a name="author"></a>Author:</h2>
|
||||
<ul>
|
||||
<li>Name: <a href="../../authors.html#Qiming_HOU">Qiming HOU</a><br>
|
||||
Location: <a href="../../location.html#CN">CN</a> - <em>People’s Republic of China</em> (<em>China</em>)
|
||||
<br><br></li>
|
||||
Location: <a href="../../location.html#CN">CN</a> - <em>People’s Republic of China</em> (<em>China</em>)</li>
|
||||
</ul>
|
||||
|
||||
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
|
||||
@@ -142,18 +141,18 @@ Location: <a href="../../location.html#CN">CN</a> - <em>People’s Republic of C
|
||||
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
||||
|
||||
<h2 id="to-build">To build:</h2>
|
||||
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> all</span></code></pre></div>
|
||||
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a> <span class="fu">make</span> all</span></code></pre></div>
|
||||
<h3 id="bugs-and-misfeatures">Bugs and (Mis)features:</h3>
|
||||
<p>The current status of this entry is:</p>
|
||||
<pre><code>STATUS: INABIAF - please **DO NOT** fix</code></pre>
|
||||
<pre><code> STATUS: INABIAF - please **DO NOT** fix</code></pre>
|
||||
<p>For more detailed information see <a href="../../bugs.html#2013_hou">2013 hou bugs</a>.</p>
|
||||
<h2 id="to-use">To use:</h2>
|
||||
<div class="sourceCode" id="cb3"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./hou</span> <span class="pp">[</span><span class="ss">scene</span><span class="pp">-</span><span class="ss">file</span><span class="pp">-</span><span class="ss">name</span><span class="pp">]</span> <span class="pp">[</span><span class="ss">options</span><span class="pp">]</span></span></code></pre></div>
|
||||
<div class="sourceCode" id="cb3"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a> <span class="ex">./hou</span> <span class="pp">[</span><span class="ss">scene</span><span class="pp">-</span><span class="ss">file</span><span class="pp">-</span><span class="ss">name</span><span class="pp">]</span> <span class="pp">[</span><span class="ss">options</span><span class="pp">]</span></span></code></pre></div>
|
||||
<p>Follow the instructions in <code>stdout</code>, preferably with an auto-refreshing PPM
|
||||
image viewer ready. Refresh the image every time the output refreshes, all
|
||||
effects should be more or less recognizable when you see 16.</p>
|
||||
<h2 id="try">Try:</h2>
|
||||
<div class="sourceCode" id="cb4"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./try.sh</span></span></code></pre></div>
|
||||
<div class="sourceCode" id="cb4"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a> <span class="ex">./try.sh</span></span></code></pre></div>
|
||||
<p>Try opening the file noted by the program then let the program run a while and
|
||||
every so often reopen the file, to see how it changes. The author suggests that
|
||||
you leave the program running overnight to see what happens. If however you do
|
||||
@@ -182,15 +181,15 @@ program.</p>
|
||||
<a href="https://en.wikipedia.org/wiki/Ray_tracing_(graphics)">raytraced</a> image.</p>
|
||||
<p>NOTE: the author refers to <a href="a.c">a.c</a>, placed in a gzipped file <code>a.c.gz</code>. We do not
|
||||
include it but it can be generated like:</p>
|
||||
<div class="sourceCode" id="cb5"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">cc</span> <span class="at">-Wall</span> hou.c <span class="at">-o</span> hou <span class="at">-lm</span></span>
|
||||
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./hou</span> <span class="op">></span> a.c</span></code></pre></div>
|
||||
<div class="sourceCode" id="cb5"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a> <span class="fu">cc</span> <span class="at">-Wall</span> hou.c <span class="at">-o</span> hou <span class="at">-lm</span></span>
|
||||
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a> <span class="ex">./hou</span> <span class="op">></span> a.c</span></code></pre></div>
|
||||
<p>but there is no need to do this as the Makefile takes care of it without even
|
||||
needing to create a temporary file.</p>
|
||||
<h2 id="authors-remarks">Author’s remarks:</h2>
|
||||
<h3 id="using-hou">Using hou</h3>
|
||||
<p>This program is a programmable rendering engine with a built-in default scene.
|
||||
The standard command line is:</p>
|
||||
<div class="sourceCode" id="cb6"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./hou</span> <span class="pp">[</span><span class="ss">scene</span><span class="pp">-</span><span class="ss">file</span><span class="pp">-</span><span class="ss">name</span><span class="pp">]</span> <span class="pp">[</span><span class="ss">options</span><span class="pp">]</span></span></code></pre></div>
|
||||
<div class="sourceCode" id="cb6"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a> <span class="ex">./hou</span> <span class="pp">[</span><span class="ss">scene</span><span class="pp">-</span><span class="ss">file</span><span class="pp">-</span><span class="ss">name</span><span class="pp">]</span> <span class="pp">[</span><span class="ss">options</span><span class="pp">]</span></span></code></pre></div>
|
||||
<p>As <code>hou</code> runs, it writes a progressively refining image to a ppm file specified
|
||||
in the scene. The initialization may take a while, but once it’s done, a rough
|
||||
preview should be available in seconds. Leave <code>hou</code> running for the night, and you
|
||||
@@ -280,11 +279,11 @@ quite memory consuming, requires IEEE754-compliant <code>double</code>, and assu
|
||||
doesn’t copy saved sessions across different endianness.</li>
|
||||
</ul>
|
||||
<h3 id="spoiler">Spoiler</h3>
|
||||
<pre><code> 3225 3225 3225 9 9 3225 3225
|
||||
1 1 1 1 1 1 1 1 1 1
|
||||
4225 1226 1 1 1 1 1222 1226
|
||||
1 1 1 1 1 1 1 1 1
|
||||
4226 1 4226 8 4222 4226 1 1</code></pre>
|
||||
<pre><code> 3225 3225 3225 9 9 3225 3225
|
||||
1 1 1 1 1 1 1 1 1 1
|
||||
4225 1226 1 1 1 1 1222 1226
|
||||
1 1 1 1 1 1 1 1 1
|
||||
4226 1 4226 8 4222 4226 1 1</code></pre>
|
||||
<p>The program consists of a recursive-descent interpreter, a <code>3DDDA</code> (3D Discrete
|
||||
Differential Analysis) ray tracer, a <code>PSSMLT</code> (Primary Sample Space Metropolis
|
||||
Light Transport) light path sampler, all squeezed into the size limit using a
|
||||
|
||||
Reference in new issue
Block a user