aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2022-11-15 01:33:00 -0500
committerB. Watson <urchlay@slackware.uk>2022-11-15 01:33:00 -0500
commitee5329425e496e184b8b7c589647b5ea1a3d5241 (patch)
tree60fee4da742fb86303e30e7aea4fb85f2471ec3f
parent5b2aeaf27a176e88dd06efb43a5ea35bed9a17b2 (diff)
downloaddla-asm-ee5329425e496e184b8b7c589647b5ea1a3d5241.tar.gz
Add a few notes to README.
-rw-r--r--README.txt23
1 files changed, 17 insertions, 6 deletions
diff --git a/README.txt b/README.txt
index 900c621..7a7f46c 100644
--- a/README.txt
+++ b/README.txt
@@ -45,8 +45,15 @@ Using dla.xex
The executable is called "dla.xex", and is a standard Atari binary
load file. It can be run in the same way you run any other .xex files,
-e.g. in an emulator or with an SIO2PC cable on real hardware. It will
-run on any Atari 8-bit with at least 48K of RAM.
+e.g. in an emulator, with an SIO2PC cable on real hardware, boot from
+the TNFS server with FujiNet, etc. It will run on any Atari 8-bit with
+at least 48K of RAM. XL/XE users should boot without BASIC (hold down
+Option at boot, or "BASIC OFF" if you use SpartaDOS).
+
+SpartaDOS X users, you'll have to run it with the X command, e.g.
+"X DLA.XEX". If you try to run it normally, it will complain that
+there's not enough memory (and there's not; the SDX cart "eats" 8K
+of RAM).
At startup, you're asked "How many particles?". The more particles you
enter here, the longer it will take to generate the image. The default
@@ -106,10 +113,11 @@ overwritten if it exists (unless of course it can't be overwritten due
to permissions or the Atari locked-file bit).
Next, the conversion process starts. This takes about half a minute on
-the Atari, and is instantaneous on a modern machine. Progress is shown
-as a percentage. When it's finished, the output CSV file has been
-written. On the Atari, you can press Ctrl-C during the conversion to
-abort the process (and delete the partial CSV file).
+the Atari (for a file with 1000 particles), and is instantaneous on a
+modern machine. Progress is shown as a percentage. When it's finished,
+the output CSV file has been written. On the Atari, you can press
+Ctrl-C during the conversion to abort the process (and delete the
+partial CSV file).
At the end of conversion, you'll be shown the number of particles.
This includes the seed particles, so e.g. if you used the single-dot
@@ -142,6 +150,9 @@ Run dla2img.sh from a terminal (a shell). If it's not executable, make
it so, with "chmod +x dla2img.sh". The script has built-in help, which
can be viewed by running it with no arguments (as "./dla2img.sh").
+If you're going to be using dla2img.sh a lot, copy it to some place
+like /usr/local/bin (somewhere in your $PATH).
+
Examples:
# convert TEST.DLA to a 256x170 PNG image: