Add conversion notes to Readme

This commit is contained in:
Andrew Cooper
2022-04-17 19:47:43 +10:00
parent ab48a16f7f
commit 89dba2e3f8

View File

@@ -1,3 +1,26 @@
# Bounce
Original source downloaded [from Vintage Basic](http://www.vintage-basic.net/games.html)
Conversion to [Microsoft C#](https://docs.microsoft.com/en-us/dotnet/csharp/)
## Conversion notes
### Mode of Operation
This conversion performs the same function as the original, and provides the same experience, but does it in a different
way.
The original BASIC code builds the graph as it writes to the screen, scanning each line for points that need to be
plotted.
This conversion steps through time, calculating the position of the ball at each instant, building the graph in memory.
It then writes the graph to the output in one go.
### Failure Modes
The original BASIC code performs no validation of the input parameters. Some combinations of parameters produce no
output, others crash the program.
In the spirit of the original this conversion also performs no validation of the parameters, but it does not attempt to
replicate the original's failure modes. It fails quite happily in its own way.