Parthias Games Files

Jon's C Cumulative Die Iterator, version 3.2
Copyright 2010-2023 by Jonathan Brewer

USAGE

When launched, the die iterator will prompt the user to enter a number of dice
from 1 to 10. Entering any number outside this range will cause the iterator to
ask the user if they want to quit. After entering a valid number of dice, the
iterator will prompt the user to enter the number of sides on each die
individually. Each die must have from 1 to 20 sides; entering a number outside
of this range will cause the iterator to prompt the user to re-enter the number.

When invoked from the command line, you can pass a file name to the iterator:

	cumulative <filename>

The iterator will then write the output of all calculations performed to the
file. The file will be created if it does not exist, and new data will be
appended to the file if it does already exist (no data will be destroyed). If no
file name is passed, such as when the iterator is launched by double-clicking,
the iterator will operate in a strictly interactive mode (i.e. no data will be
saved).

A word of warning: depending on the number of dice and the number of sides on
each, the program may take quite a bit of time to finish calculating. In my
tests, it could calculate 10d12 in anywhere from ~24 seconds (64-bit build on
Windows 11, i7-10750H), ~35 seconds (Linux Mint 64-bit, i5-3340M), to several
minutes on slower processors or 32-bit builds. 10d20 will take ~165 times
longer. Your mileage may vary.

BUILDING

The included makefile should be compatible with GNU make on pretty much any
platform, but has only been tested on Slackware Linux and Windows XP/Vista with
MinGW. It has no install or clean targets, though, and will simply create a
binary in the 'bin' subdirectory.

With any other platforms/compilers, you may need to specify that the file should
be compiled according to the C99 standard. You will also want to specify any
speed optimizations your compiler supports.