Spaces:
Running
Running
File size: 2,555 Bytes
87b3b3a |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 |
<h2>Random Number Generator</h2>
<p>While the built-in <code>Math.random()</code> function provides suitable results for game development purposes, it has its own weaknesses.
Most notably, it is not possible to seed the generator in order to reproduce a deterministic sequence of values. This is where <code>ROT.RNG</code> object comes to play.</p>
<p><strong>Note:</strong> We use the excellent <em>Alea</em> algorithm, developed by Johannes Baagøe. For more information about the code, please see
<a href="http://baagoe.org/en/wiki/Better_random_numbers_for_javascript">his article on RNGs in JavaScript</a>. Alea is distributed under the <a href="http://en.wikipedia.org/wiki/MIT_License">MIT License</a>.</p>
<h2>Generating random values</h2>
<p>Three main modes of operation are available:</p>
<ul>
<li><code>ROT.RNG.getUniform()</code> – random number [0..1) with uniform distribution (similar to <code>Math.random()</code>)</li>
<li><code>ROT.RNG.getNormal(mean, stddev)</code> – random number with normal distribution, parametrized by a mean value and standard deviation</li>
<li><code>ROT.RNG.getPercentage()</code> – random integer 1..100</li>
</ul>
<div class="example">
SHOW(
ROT.RNG.getUniform(),
ROT.RNG.getNormal(0, 10),
ROT.RNG.getPercentage()
)
</div>
<div class="example">
var canvas = document.createElement("canvas");
canvas.width = 500;
canvas.height = 200;
SHOW(canvas);
var ctx = canvas.getContext("2d");
ctx.fillStyle = "#fff";
ctx.fillRect(0, 0, canvas.width, canvas.height);
ctx.fillStyle = "#f00";
var data = [];
for (var i=0;i<40000;i++) { /* generate histogram */
var num = Math.round(ROT.RNG.getNormal(250, 100));
data[num] = (data[num] || 0) + 1;
}
for (var i=0;i<data.length;i++) { /* plot histogram */
ctx.fillRect(i, canvas.height-data[i], 1, data[i]);
}
</div>
<h2>Working with RNG state</h2>
<p>RNG's internal state can be retrieved and set to produce identical results.</p>
<div class="example">
var state = ROT.RNG.getState();
SHOW(ROT.RNG.getUniform());
ROT.RNG.setState(state);
SHOW(ROT.RNG.getUniform());
</div>
<p>The RNG can be seeded by a given number. Seeding initializes RNG's internal state.
Retrieving the current seed is not very useful, but might come handy if you want to reproduce a behavior resulting from a random seed.</p>
<div class="example">
var seed = ROT.RNG.getSeed();
ROT.RNG.setSeed(12345);
SHOW(
ROT.RNG.getUniform(),
ROT.RNG.getUniform()
);
ROT.RNG.setSeed(12345);
SHOW(
ROT.RNG.getUniform(),
ROT.RNG.getUniform()
);
</div>
|