diff --git a/doc/apple2.png b/doc/apple2.png new file mode 100644 index 0000000..ab6ce0d Binary files /dev/null and b/doc/apple2.png differ diff --git a/doc/applesplit.png b/doc/applesplit.png index 5c6f85a..8807365 100644 Binary files a/doc/applesplit.png and b/doc/applesplit.png differ diff --git a/doc/aspectratio.png b/doc/aspectratio.png new file mode 100644 index 0000000..1ae40bd Binary files /dev/null and b/doc/aspectratio.png differ diff --git a/doc/dos310rev0.png b/doc/dos310rev0.png index a393a6a..6d13f9b 100644 Binary files a/doc/dos310rev0.png and b/doc/dos310rev0.png differ diff --git a/doc/dos330boot.png b/doc/dos330boot.png index d8c768e..c9a923d 100644 Binary files a/doc/dos330boot.png and b/doc/dos330boot.png differ diff --git a/doc/download.asciidoc b/doc/download.asciidoc index abac3f1..5ac7b7f 100644 --- a/doc/download.asciidoc +++ b/doc/download.asciidoc @@ -46,10 +46,9 @@ from it ($D000-$FFFF) (into a file on your PC) and use it. Alternatively, you ca download footnoteref:[disclaimer] the firmware images from the http://mosher.mine.nu/apple2/[Apple II Library]. If you do not want to download the proprietary firmware, you can still use the emulator (albeit -in a restricted manner) with the free (GPLv3) _System ROM (Demo)_ package. Download -the file for your platform and -install as appropriate. You can choose either binary format (ready to run), or source if you want -to assemble it yourself (using the http://www.floodgap.com/retrotech/xa/[xa Assembler]). +in a rudimentary manner) with the free (GPLv3) _System ROM (Demo)_ package (included with the EPPLE ][ download). +The source code is also available; you can +assemble it using the http://www.floodgap.com/retrotech/xa/[xa Assembler] . The Demo System ROM only provides commands to dump or set memory bytes, or run a program in memory. It is not compatible with any Apple software, nor can it read from disks. It's just a free simple demo system to make the emulator do something reasonable. diff --git a/doc/gplrom.png b/doc/gplrom.png new file mode 100644 index 0000000..be74bdf Binary files /dev/null and b/doc/gplrom.png differ diff --git a/doc/pinkmystery.png b/doc/pinkmystery.png index 85274da..0ba1873 100644 Binary files a/doc/pinkmystery.png and b/doc/pinkmystery.png differ diff --git a/doc/screenshots.asciidoc b/doc/screenshots.asciidoc index 731a8c5..5060e10 100644 --- a/doc/screenshots.asciidoc +++ b/doc/screenshots.asciidoc @@ -97,7 +97,7 @@ RUN image::pinkmystery.png[] -Jim Sather's book +Jim Sather's book http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software[Understanding the Apple II], which was the primary reference for the internal design of the EPPLE ][ emulator, describes the video @@ -120,11 +120,45 @@ RUN +=== Display Aspect Ratio + +image::aspectratio.png[] + +Jim Sather also describes the aspect ratio of the Apple ][ when +displayed on a TV screen (p. 8-28). Software developers would need +to take this into account when trying to draw accurate shapes. +The EPPLE ][ emulates the correct aspect ratio. +For example, the following Applesoft BASIC program draws a +rectangle, and a proper square: + +[source,vbs] +--------------------------------- +NEW + +10 HGR +15 REM +16 REM RECTANGLE (VIOLET) +20 A = 36 : B = 136 +30 HCOLOR = 2 +40 HPLOT A,A TO A,B TO B,B TO B,A TO A,A +45 REM +46 REM SQUARE (GREEN) +50 A = 25 : B = 147 +60 HCOLOR = 1 +70 HPLOT A,A TO A,B TO (B*1.19+.5),B TO (B*1.19+.5),A TO A,A + +RUN +HOME +--------------------------------- + + + === Split Screen HIRES/LORES colors -image::splitcolors.png[] +image::splitcolorstv.png[] +image::splitcolorsmon.png[] -Jim Sather's book +Jim Sather's book http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software[Understanding the Apple II], shows an Applesoft BASIC program and assembly language subroutine on pages 3-16 and 3-17 (reproduced @@ -171,3 +205,19 @@ E000G RUN --------------------------------- + + + +=== Miscellaneous + +image::gplrom.png[] + +Example of the Demo System ROM provided with the EPPLE ][ emulator. + +image::static.png[] + +Random TV "static" when no video signal is present. + +image::apple2.png[] + +Apple System ROM showing the APPLE ][ title. diff --git a/doc/splitcolorsmon.png b/doc/splitcolorsmon.png new file mode 100644 index 0000000..941f87c Binary files /dev/null and b/doc/splitcolorsmon.png differ diff --git a/doc/splitcolorstv.png b/doc/splitcolorstv.png new file mode 100644 index 0000000..cb1b7ed Binary files /dev/null and b/doc/splitcolorstv.png differ diff --git a/doc/static.png b/doc/static.png new file mode 100644 index 0000000..3f45f31 Binary files /dev/null and b/doc/static.png differ