From ee5329425e496e184b8b7c589647b5ea1a3d5241 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Tue, 15 Nov 2022 01:33:00 -0500 Subject: Add a few notes to README. --- README.txt | 23 +++++++++++++++++------ 1 file 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: -- cgit v1.2.3