mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

force use of pandoc version >= 3.1.12.2

Browse Source 
The `bin/pandoc-wrapper.sh` tool will verify that the ssytem
has a recent enough version of `pandoc(1)`.

We explain why we insist on `pandoc(1)`. version >= 3.1.12.2
in comments where the $PANDOC_MIN_VERSION is set.

Added `--wrap=preserve` as a default argument to `pandoc(1)`.
While this change will impact every HTML file generated,
we believe this will improve the ability of someone to look
at the generated HTML and correlate with the original markdown.

Changed `bin/pandoc-wrapper.sh` VERSION from "1.4.2 2024-03-17"
to "1.4.3 2024-03-18".

Performed `make www` to achieve all of the above and to generate
HTML using the new  `--wrap=preserve` `pandoc(1)` mode.
This commit is contained in:
Landon Curt Noll committed 2024-03-18 01:26:39 -07:00
1 parent 9eb7a54e9f
commit b0b212acb1
402 files changed
+37061 -55132
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2011/zucker/index.html
+101 -147
View File
@@ -130,8 +130,8 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Matt_Zucker">Matt Zucker</a><br>
Location: <a href="../../location.html#US">US</a> - <em>United States of
America</em> (<em>United States</em>) <br><br></li>
Location: <a href="../../location.html#US">US</a> - <em>United States of America</em> (<em>United States</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -141,32 +141,28 @@ America</em> (<em>United States</em>) <br><br></li>
<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></span></code></pre></div>
<p>There is an alternate version which should work for Windows which
distinguishes binary mode from text mode. See <a
href="#alternate-code">alternate code</a> below.</p>
<p>There is an alternate version which should work for Windows which distinguishes
binary mode from text mode. See <a href="#alternate-code">alternate code</a> below.</p>
<h2 id="to-use">To use:</h2>
<div class="sourceCode" id="cb2"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./zucker</span> <span class="op">&gt;</span> image.ppm</span></code></pre></div>
<p>Now open <code>image.ppm</code> with your image viewer of choice.</p>
<h2 id="try">Try:</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">./try.sh</span></span></code></pre></div>
<p>After running <code>try.sh</code>, open the PPM images
<code>ioccc.ppm</code>, <code>hello.ppm</code> and
<p>After running <code>try.sh</code>, open the PPM images <code>ioccc.ppm</code>, <code>hello.ppm</code> and
<code>image2.ppm</code> with your image viewer of choice.</p>
<h2 id="alternate-code">Alternate code:</h2>
<p>This version uses the Windows functions <code>_setmode()</code> and
<code>_fileno()</code> to set binary mode on <code>stdout</code> which
the author noted would be necessary for systems that distinguish binary
and text.</p>
<p>This version uses the Windows functions <code>_setmode()</code> and <code>_fileno()</code> to set
binary mode on <code>stdout</code> which the author noted would be necessary for systems
that distinguish binary and text.</p>
<h3 id="alternate-build">Alternate build:</h3>
<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="fu">make</span> alt</span></code></pre></div>
<h3 id="alternate-use">Alternate use:</h3>
<p>Use <code>zucker.alt</code> as you would <code>zucker</code>
above.</p>
<p>Use <code>zucker.alt</code> as you would <code>zucker</code> above.</p>
<h3 id="alternate-try">Alternate try:</h3>
<p>Try <code>zucker.alt</code> instead of <code>zucker</code> above.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>The rendered image is centered and is output as a 600 by 220 pixel
PPM. The vector font is proportional.</p>
<p>The rendered image is centered and is output as a 600 by 220 pixel PPM.
The vector font is proportional.</p>
<p>This entry uses no local variables. None! At! All!</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<h3 id="an-image-generator">An image generator</h3>
@@ -174,40 +170,32 @@ PPM. The vector font is proportional.</p>
<p>This program makes pretty pictures. To see the default output, try
running</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="ex">./zucker</span> <span class="op">&gt;</span> ioccc2011.ppm</span></code></pre></div>
<p>On the author’s 2.5 GHz MacBook Pro, this command takes approximately
1 minute and 18 seconds to run – your runtime may vary. You will need an
image viewer capable of displaying <a
href="https://en.wikipedia.org/wiki/Netpbm">Netpbm images</a> in order
to display the output. On the Mac, the system supplied
<code>Preview.app</code> works well; otherwise <a
href="http://www.imagemagick.org/">ImageMagick</a> and/or <a
href="http://www.graphicsmagick.org/">GraphicsMagick</a> are both
capable of displaying Netpbm files, and are available on multiple
platforms.</p>
<p>On the author’s 2.5 GHz MacBook Pro, this command takes approximately 1 minute
and 18 seconds to run – your runtime may vary. You will need an image viewer
capable of displaying <a href="https://en.wikipedia.org/wiki/Netpbm">Netpbm images</a> in
order to display the output. On the Mac, the system supplied <code>Preview.app</code> works
well; otherwise <a href="http://www.imagemagick.org/">ImageMagick</a> and/or
<a href="http://www.graphicsmagick.org/">GraphicsMagick</a> are both capable of displaying
Netpbm files, and are available on multiple platforms.</p>
<p>With macOS you can type at the command line:</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">open</span> ioccc2021.ppm</span></code></pre></div>
<p>and it will open image in the default application Preview.app.</p>
<p>To use ImageMagick you might do something like:</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="ex">convert</span> ioccc2011.ppm ioccc2011.png</span></code></pre></div>
<p>and then open <code>ioccc2011.png</code> in your viewer of
choice.</p>
<p>and then open <code>ioccc2011.png</code> in your viewer of choice.</p>
<p>To use GraphicsMagick you might do something like:</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="ex">gm</span> convert ioccc2011.ppm ioccc2011.png</span></code></pre></div>
<p>and then open <code>ioccc2011.png</code> in your viewer of
choice.</p>
<p>and then open <code>ioccc2011.png</code> in your viewer of choice.</p>
<p>Aside from the default image, you may create your own by running the
program as follows:</p>
<div class="sourceCode" id="cb9"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./zucker</span> <span class="st">&quot;your text&quot;</span> <span class="op">&gt;</span> image.ppm</span></code></pre></div>
<p>To mitigate long runtime, the program can be invoked in a “preview”
mode by appending <code>-preview</code> to the command line arguments,
like so:</p>
<div class="sourceCode" id="cb10"><pre
class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./zucker</span> faster<span class="dt">\!</span> <span class="at">-preview</span> <span class="op">&gt;</span> image.ppm</span></code></pre></div>
<p>If your platform distinguishes between binary and text streams, you
may need to insert some code to reopen standard output in binary mode at
the start of <code>main()</code> (the provided <a
href="#alternate-code">alternate version</a> will set binary mode on
<code>stdout</code> in Windows). An ASCII platform is assumed.</p>
mode by appending <code>-preview</code> to the command line arguments, like so:</p>
<div class="sourceCode" id="cb10"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./zucker</span> faster<span class="dt">\!</span> <span class="at">-preview</span> <span class="op">&gt;</span> image.ppm</span></code></pre></div>
<p>If your platform distinguishes between binary and text streams, you may need to
insert some code to reopen standard output in binary mode at the start of
<code>main()</code> (the provided <a href="#alternate-code">alternate version</a> will set binary mode
on <code>stdout</code> in Windows). An ASCII platform is assumed.</p>
<h4 id="pedagogical-value">Pedagogical value:</h4>
<p>This program is quite suitable for the inexperienced programmer, due
to a number of considerations:</p>
@@ -216,142 +204,108 @@ to a number of considerations:</p>
lines of source.</p></li>
<li><p>It compiles cleanly as ANSI C under gcc 4.2.1 with very strict
compilation flags.</p></li>
<li><p>It uses a very small subset of the keywords available in C,
namely <code>char</code>, <code>float</code>, <code>int</code>,
<code>typedef</code>, <code>struct</code>, <code>for</code>, and
<code>return</code>. More difficult concepts such as <code>void</code>,
<code>if</code>, <code>switch</code>, and <code>while</code> are
eschewed for simplicity’s sake.</p></li>
<li><p>It also uses a very small number of library functions: just
<code>putchar(3)</code>, <code>cos(3)</code>, <code>sin(3)</code>,
<code>atan2(3)</code>, <code>sqrt(3)</code>, and
<code>pow(3)</code>.</p></li>
<li><p>It uses a very small subset of the keywords available in C, namely
<code>char</code>, <code>float</code>, <code>int</code>, <code>typedef</code>, <code>struct</code>, <code>for</code>, and <code>return</code>.
More difficult concepts such as <code>void</code>, <code>if</code>, <code>switch</code>, and
<code>while</code> are eschewed for simplicity’s sake.</p></li>
<li><p>It also uses a very small number of library functions: just <code>putchar(3)</code>,
<code>cos(3)</code>, <code>sin(3)</code>, <code>atan2(3)</code>, <code>sqrt(3)</code>, and <code>pow(3)</code>.</p></li>
<li><p>New programmers often prefer to use global variables when
possible. Hence, <em>all</em> variables in this program (aside from
function parameters) have global scope.</p></li>
<li><p>An important aspect of the computation is graphically illustrated
by the source code itself: the geometric construction of a reflection
ray at an object’s surface, given the incoming direction and surface
normal.</p></li>
by the source code itself: the geometric construction of a
reflection ray at an object’s surface, given the incoming
direction and surface normal.</p></li>
</ul>
<h4 id="further-details-contains-spoilers">Further details (contains
spoilers):</h4>
<p>The program is not quite a traditional <a
href="https://en.wikipedia.org/wiki/Ray_tracing_(graphics)">ray
tracer</a>, but a “<a href="sphere-tracing.pdf">sphere tracer</a>” which
uses distance fields to encode proximity to objects in the scene. Using
sphere tracing to compute visibility instead of analytic ray tracing
provides two advantages: first, it greatly eases the computation of <a
href="https://en.wikipedia.org/wiki/Toric_lens#Torus">ray-torus</a>
intersection (which would otherwise require solving a quartic
polynomial), and second, it makes it possible to compute <a
href="https://en.wikipedia.org/wiki/Ambient_occlusion">ambient
occlusion</a> (which is used to generate soft shadows). Unlike many
traditional ray tracers and sphere tracers, this one uses iteration
instead of recursion to compute the effect of reflections. This,
unfortunately, resulted in the programmer going insane; however, program
size was reduced and readability hindered. Neither the plaintext for the
program’s default output nor for the Netpbm header appears in the
program source, which hinders readability as well. Also, unlike some
previous IOCCC entries which render ASCII text, this one uses a vector
(as opposed to raster) font. Although the program does not generate
uppercase letters, it handles them in a reasonable manner when they
appear in the input.</p>
<h4 id="further-details-contains-spoilers">Further details (contains spoilers):</h4>
<p>The program is not quite a traditional <a href="https://en.wikipedia.org/wiki/Ray_tracing_(graphics)">ray
tracer</a>, but a “<a href="sphere-tracing.pdf">sphere
tracer</a>” which uses distance fields to encode proximity to
objects in the scene. Using sphere tracing to compute visibility instead of
analytic ray tracing provides two advantages: first, it greatly eases the
computation of <a href="https://en.wikipedia.org/wiki/Toric_lens#Torus">ray-torus</a>
intersection (which would otherwise require solving a quartic polynomial), and
second, it makes it possible to compute <a href="https://en.wikipedia.org/wiki/Ambient_occlusion">ambient
occlusion</a> (which is used to
generate soft shadows). Unlike many traditional ray tracers and sphere tracers,
this one uses iteration instead of recursion to compute the effect of
reflections. This, unfortunately, resulted in the programmer going insane;
however, program size was reduced and readability hindered. Neither the
plaintext for the program’s default output nor for the Netpbm header appears in
the program source, which hinders readability as well. Also, unlike some
previous IOCCC entries which render ASCII text, this one uses a vector (as
opposed to raster) font. Although the program does not generate uppercase
letters, it handles them in a reasonable manner when they appear in the input.</p>
<p>Even when the program is pretty-printed and preprocessor macros are
translated, it should be fairly resistant to analysis due to reckless
reuse of global variables, the inherently opaque nature of the math, and
its overall density. Global variables are used to store the results of
intermediate computation. As a result, seemingly simple functions have
important side effects. Although some of the global variables are simply
constants, their use is overloaded. For instance, the variable
<code>X</code> is used both as the number <code>40</code> and as the
ASCII character <code>'('</code>. Maintainability is hindered due to
hardcoding several aspects of the program in multiple locations. As an
example, it is impossible to modify either the image width or height
without changing the source in at least three different places,
including inside the large string literal <code>J</code>.</p>
reuse of global variables, the inherently opaque nature of the
math, and its overall density. Global variables are used to store
the results of intermediate computation. As a result, seemingly simple
functions have important side effects. Although some of the global
variables are simply constants, their use is overloaded. For instance,
the variable <code>X</code> is used both as the number <code>40</code> and as the ASCII
character <code>'('</code>. Maintainability is hindered due to hardcoding
several aspects of the program in multiple locations. As an example,
it is impossible to modify either the image width or height without
changing the source in at least three different places, including
inside the large string literal <code>J</code>.</p>
<p>Some of the functions are simple vector algebraic operations such as
vector construction, dot product, and normalization. However, it was
found to be much more compact to define a single operation for
multiply-and-add rather than to have separate functions for addition,
subtraction, and scaling. Again, compactness led to obfuscation.</p>
<p>This program heavily abuses <code>for</code> loops. The comma
operator is used to get as much mileage as possible out of statements
inside of loop declarations. Between <code>for</code> loops, the comma
operator, and the ternary operator, it was possible to avoid
<code>if</code> and <code>while</code> altogether.</p>
<p>Bitwise and arithmetic operators are used instead of logical
operators whenever gcc doesn’t warn about it. Conversely, integer
multiplication, division, and modulus are sometimes used in place of
traditional bitwise operators just to keep the reader on his or her
toes. Automatic casting between characters, integers, and floats is
performed just about everywhere. Fascinatingly, this doesn’t seem to
affect performance too badly. Sometimes when an explicit cast (i.e. from
<code>float</code> to <code>int</code>) is needed, the program instead
simply assigns to a free variable of the desired type instead. Both the
<code>array[index]</code> and <code>index[array]</code> notations are
used interchangeably throughout the program.</p>
<p>Two other programs were written to support development of this
program. The first used a randomized search algorithm to deduce the most
compact encoding of the vector font instructions into ASCII; the second
used a modified form of the <a
href="https://en.wikipedia.org/wiki/Line_wrap_and_word_wrap">Knuth-Plass</a>
algorithm to layout the final text on top of a hand-generated ASCII
“stencil”. The programs were not submitted as entries for this year’s
IOCCC, not because they lack obfuscation, but because neither is written
in C (they are in C++ and Python, respectively).</p>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0
License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights
Reserved. You are free to share and adapt this file under the terms of
this license:</p>
<p>This program heavily abuses <code>for</code> loops. The comma operator is used to
get as much mileage as possible out of statements inside of loop
declarations. Between <code>for</code> loops, the comma operator, and the ternary
operator, it was possible to avoid <code>if</code> and <code>while</code> altogether.</p>
<p>Bitwise and arithmetic operators are used instead of logical operators whenever
gcc doesn’t warn about it. Conversely, integer multiplication, division, and
modulus are sometimes used in place of traditional bitwise operators just to
keep the reader on his or her toes. Automatic casting between characters,
integers, and floats is performed just about everywhere. Fascinatingly, this
doesn’t seem to affect performance too badly. Sometimes when an explicit cast
(i.e. from <code>float</code> to <code>int</code>) is needed, the program instead simply assigns to a
free variable of the desired type instead. Both the <code>array[index]</code> and
<code>index[array]</code> notations are used interchangeably throughout the program.</p>
<p>Two other programs were written to support development of this program. The
first used a randomized search algorithm to deduce the most compact encoding of
the vector font instructions into ASCII; the second used a modified form of the
<a href="https://en.wikipedia.org/wiki/Line_wrap_and_word_wrap">Knuth-Plass</a> algorithm
to layout the final text on top of a hand-generated ASCII “stencil”. The
programs were not submitted as entries for this year’s IOCCC, not because they
lack obfuscation, but because neither is written in C (they are in C++ and
Python, respectively).</p>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0 License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
You are free to share and adapt this file under the terms of this license:</p>
<pre><code>Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</code></pre>
<p>For more information, see:
https://creativecommons.org/licenses/by-sa/4.0/</p>
<p>For more information, see: https://creativecommons.org/licenses/by-sa/4.0/</p>
<!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- START: this line starts content for HTML phase 22 by: bin/output-index-inventory.sh via bin/md2html.sh -->
<!-- START: this line starts content generated by: bin/output-index-inventory.sh -->
<h1 id="inventory-for-2011zucker"><a name="inventory"></a>Inventory for
2011/zucker</h1>
<h1 id="inventory-for-2011zucker"><a name="inventory"></a>Inventory for 2011/zucker</h1>
<p><a href="#top">Jump to top</a></p>
<h2 id="primary-files">Primary files</h2>
<ul>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/zucker.c">zucker.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/zucker.alt.c">zucker.alt.c</a>
- alternative source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/zucker.orig.c">zucker.orig.c</a>
- original source</li>
<li><a href="sphere-tracing.pdf">sphere-tracing.pdf</a> - research paper
on antialiased ray tracing</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/try.sh">try.sh</a>
- how to run</li>
<li><a href="2011_zucker.tar.bz2">2011_zucker.tar.bz2</a> - download
entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/zucker.c">zucker.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/zucker.alt.c">zucker.alt.c</a> - alternative source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/zucker.orig.c">zucker.orig.c</a> - original source</li>
<li><a href="sphere-tracing.pdf">sphere-tracing.pdf</a> - research paper on antialiased ray tracing</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/try.sh">try.sh</a> - how to run</li>
<li><a href="2011_zucker.tar.bz2">2011_zucker.tar.bz2</a> - download entry source</li>
</ul>
<h2 id="secondary-files">Secondary files</h2>
<ul>
<li><a href="index.html">index.html</a> - entry home page</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/.gitignore">.gitignore</a>
- list of files that should not be committed under git</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/.gitignore">.gitignore</a> - list of files that should not be committed under git</li>
<li><a href=".path">.path</a> - directory path from top directory</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2011/zucker/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->