home *** CD-ROM | disk | FTP | other *** search
/ Joystick Magazine 1996 April / cd3.iso / emul / xf33demo.txt < prev    next >
Text File  |  1995-12-01  |  14KB  |  335 lines
  1.  
  2. PC Xformer 3.30 Demo - The Atari 8-bit Emulator For MS-DOS Compatible PCs
  3. =========================================================================
  4.  
  5. December 1, 1995.
  6.  
  7. Branch Always Software
  8. 14150 N.E. 20th Street
  9. Suite 302
  10. Bellevue, WA  98007
  11. U.S.A.
  12.  
  13. phone: 206-236-0540
  14. fax:   206-236-0257
  15. email: brasoft@halcyon.com, brasoft@msn.com
  16. WWW:   http://www.halcyon.com/brasoft/
  17.  
  18.  
  19. Program and documentation by Darek Mihocka.
  20.  
  21.  
  22. This is a free demo!
  23. --------------------
  24.  
  25. PC Xformer 3.3 is the latest version of my Atari 8-bit emulator. It replaces
  26. PC Xformer 3.2 which was released this summer and is a major improvement
  27. over PC Xformer 3.0 released last year.
  28.  
  29. This demo version of PC Xformer demonstrates many of the capabilities of the
  30. new emulator. In fact, you'll find it to be a significant improvement over
  31. PC Xformer 2.0, the freeware version of PC Xformer released last year. PC
  32. Xformer 2.0 is almost 2 years old, so if you are still using it, chuck it!
  33.  
  34. Over the last several months I have been tracking down bugs in PC Xformer,
  35. and thanks to the many users who reported those bugs and beta tested the
  36. new version, I'm glad to say that PC Xformer 3.3 now runs many more Atari
  37. 8-bit games and demos than did earlier versions, and faster than ever.
  38.  
  39. PC Xformer 3.3 has been specifically optimized for use on 486 and Pentium
  40. processors, making it absolutely the fastest 6502 emulator in the world.
  41. On a 90 Mhz Pentium, PC Xformer 3.3 runs about 10 times faster than a 130XE.
  42. Even on the slowest 486 it still runs faster than the real thing.
  43.  
  44. This is a demo version. You are free to copy it and give it to others. The
  45. real PC Xformer 3.3 goes on sale at Atari 8-bit dealers in North America and
  46. Europe later this week and includes a detailed printed manual as well as
  47. lots of useful features such as joystick, modem, printer, and sound support.
  48. The list price is $34.95 U.S. but dealers may sell for less.
  49.  
  50.  
  51. Features of PC Xformer 3.3
  52. --------------------------
  53.  
  54. PC Xformer is the only complete Atari 8-bit emulator (for any computer) written
  55. in machine language. As such, it runs much faster and is more compatible than
  56. the various other Atari 8-bit emulators.
  57.  
  58. Features of this demo include:
  59.  
  60.     - 48K Atari 400/800 emulation
  61.     - 64K Atari 800XL emulation
  62.     - displays all ANTIC text and graphics modes, including GTIA modes
  63.     - 256 color GTIA color palette
  64.     - player missile graphics with collision detection
  65.     - horizontal and vertical fine scrolling
  66.     - display list interrupts, IRQ, and NMI interrupts
  67.     - reads and writes to ST Xformer and SIO2PC generated disk images
  68.     - reads MS-DOS files directly
  69.     - switch Atari BASIC on/off with one keystroke
  70.     - switch between Atari 400/800 and Atari 800XL emulation with one keystroke
  71.     - joystick emulation using the keyboard's cursor keys
  72.     - full speed emulation on any 486 or Pentium
  73.     - normal and turbo speeds of emulation
  74.  
  75. In addition, the real PC Xformer 3.3 available from your Atari dealer has
  76. these additional features:
  77.  
  78.     - 130XE emulation with 256K of extended XE memory
  79.     - built-in 6502 debugger
  80.     - the ability to change disk images on-the fly
  81.     - 4 voices of sound, printer, and modem support
  82.     - joystick and Gravis gamepad support
  83.     - command line options to disable BASIC and set emulation modes
  84.     - lots of printed documentation and Atari reference documentation
  85.     - free upgrade to PC Xformer 4.0 when it becomes available
  86.  
  87.  
  88. How to buy PC Xformer 3.3
  89. -------------------------
  90.  
  91. PC Xformer 3.3 can be ordered immediately from Branch Always Software
  92. for $34.95 U.S. and that includes shipping anywhere in the world. Call
  93. us at the phone number listed above or fax in your order. We accept VISA
  94. and MasterCard orders over the phone and personal checks by mail.
  95.  
  96. Here in the U.S. you can also purchase PC Xformer 3.3 from Atari dealers such
  97. as Toad Computers and Xanth. In England, contact Micro Discount. In Germany
  98. contact the ABBUC user group.
  99.  
  100. Toad Computers
  101. 570-F Ritchie Highway
  102. Severna Park, MD 21146
  103. phone: 800-448-8623, fax: 410-544-1329
  104.  
  105. Xanth Corporation
  106. 14100 N.E. 20th Street #105
  107. Bellevue, WA 98007
  108. phone: 206-643-9697
  109.  
  110. Micro Discount
  111. 265 Chester Road, Streetly
  112. West Midlands, England B74 3EA
  113. phone: +44 021 353 5730
  114.  
  115. ABBUC c/o Wolfgang Burger
  116. Wieschenbeck 45
  117. D-4352 Herten, Germany
  118. phone: +49 02366/39623
  119.  
  120. ABBUC also has available a brand new CD-ROM that contains hundreds of megabytes
  121. of free and shareware Atari 8-bit software. I highly recommend this CD as it
  122. contains compilations of Atari 8-bit software from all over the world and
  123. includes magazine disks. The CD can be purchased for $35 U.S. directly from:
  124.  
  125. Ernest R. Schreurs
  126. Kempenlandstraat 8
  127. 5211 VN Den Bosch
  128. The Netherlands
  129.  
  130.  
  131. Upgrading to PC Xformer 3.3
  132. ---------------------------
  133.  
  134. If you are already a registered user of PC Xformer 3.0, 3.0a, 3.1, or 3.2
  135. then you can download the PC Xformer 3.3 upgrade free of charge directly
  136. from the private download area on our web page. If you do not have Internet
  137. web access, you can order the upgrade by mail for $15 U.S. to cover our
  138. shipping and materials costs.
  139.  
  140.  
  141. Hardware requirements
  142. ---------------------
  143.  
  144. PC Xformer 3.3 (including this demo version) is a 32-bit MS-DOS program. It
  145. can only run on 32-bit processors such as the 386, 486, and Pentium. It cannot
  146. be used on 8-bit and 16-bit processors such as the 8088, 8086, and 286.
  147.  
  148. A VGA or SuperVGA card is also required since CGA and EGA cards cannot display
  149. 256 colors. The brand of VGA card is not important. Any VGA card will work.
  150.  
  151. You also need to be running MS-DOS or a DOS compatible operating system,
  152. such as Windows 3.1, Windows 95, and OS/2 Warp.
  153.  
  154.  
  155. Running this demo
  156. -----------------
  157.  
  158. Unlike earlier demo versions of PC Xformer, this time around I am not
  159. packing the ZIP file full of sample Atari 8-bit software. Why? Simple:
  160. the Internet! There are numerous sites, including our own web page, where
  161. you can download unlimited amounts of Atari 8-bit software. Or you can
  162. purchase the CD-ROM. So to keep this demo lean, there are only 3 files:
  163.  
  164.     XF33DEMO.EXE - the PC Xformer 3.3 demo Atari 8-bit emulator
  165.     XF33DEMO.TXT - this documentation file
  166.     DEMOS.XFD    - disk image containing Atari DOS and some demo programs
  167.  
  168. To run PC Xformer, simply type XF33DEMO at your MS-DOS command prompt. You
  169. will get an intro screen and at the bottom will be a list of special keyboard
  170. keys you need to know about. Press any key and within a few seconds you'll
  171. be running Atari BASIC.
  172.  
  173. The most important keys to know about are:
  174.  
  175.     Shift+F5  - this exits back to MS-DOS
  176.     F7 F8 F9  - the START SELECT and OPTION keys
  177.     F10       - System Reset
  178.     Shift+F10 - Toggle Atari BASIC on/off
  179.     Shift+F12 - switch between Atari 800 and Atari 800XL modes.
  180.     End       - the Atari BREAK key
  181.     `         - the Atari logo key (inverse key)
  182.     Scrl Lock - toggle between normal speed and turbo speed
  183.     Page Up and Page Down - move the screen up and down a pixel
  184.  
  185. Use the F10 key to "system reset". Press F10 while holding the Shift key to
  186. toggle Atari Basic on or off. Remember, most machine language games prefer
  187. to not have BASIC present.
  188.  
  189. In Atari 800XL mode you have access to the new graphics modes (GR.9 through
  190. GR.15), plus you can run the newer software designed for the 800XL. Switch
  191. back to Atari 400/800 mode to run older software, especially old games.
  192.  
  193. The Scroll Lock (or Scrl Lock) key is very important. It controls the speed
  194. of the emulator. Normally the emulator boots up in normal speed mode. i.e. it
  195. runs at about the speed of a 1.8 Mhz Atari computer. This gives maximum
  196. compatibility with your Atari 8-bit software. For most Atari BASIC programs
  197. and even some machine language programs, you can crank up the speed. You do
  198. this by pressing the Scroll Lock key. When the Scroll Lock light goes out
  199. you are now in turbo speed mode. The emulator will run as fast as possible.
  200.  
  201. For example, on the DEMOS.XFD disk image is a famous Atari demo called
  202. swandemo.obj. This is a machine language demo so run it with BASIC disabled.
  203. As the demo is running, press the Scrl Lock key every few seconds and you
  204. should see a difference in the speed of the rotation of the Atari logo.
  205.  
  206. If you find that some games are simply too fast and unplayable in turbo
  207. speed mode, press Scroll Lock again to switch back to normal speed mode.
  208. Some games may not even function properly in turbo speed mode because
  209. their timing gets too messed up and affects player missile graphics collision
  210. detection. However, I've found that many programs still do run fine in turbo
  211. speed mode so all I can say is... experiment!
  212.  
  213.  
  214. Installing Disk Images
  215. ----------------------
  216.  
  217. PC Xformer 3.3 uses the same 90K, 130K, and 180K disk images used by my
  218. older ST Xformer and PC Xformer 8-bit emulators, and it also supports reading
  219. and writing of SIO2PC generated disk images.
  220.  
  221. If you specify virtual disk files and/or MS-DOS files after the XF33DEMO, those
  222. will be installed as Atari disk drives. For example, type:
  223.  
  224. XF33DEMO DOS25.XFD
  225.  
  226. to install DOS 2.5 as D1:. You can specify up to 8 disk image files, which will
  227. correspond to drive D1: through D8:.
  228.  
  229. You can also specify individial MS-DOS files on the command line. They will
  230. magically appear to the emulator as disk images containing that file.
  231.  
  232. When specifying disk image and other file names on the command line, you can
  233. use full path names. For example:
  234.  
  235. XF33DEMO C:\ATARI\DOS25.XFD D:\BASIC\RAINBOW.BAS
  236.  
  237. will load the DOS 2.5 disk image from the C:\ATARI directory and load a BASIC
  238. file as drive D2: from the D:\BASIC directory. This way you do not need to
  239. keep all your Atari 8-bit software in one directory.
  240.  
  241.  
  242. Transfering Atari files to your PC
  243. ----------------------------------
  244.  
  245. Downloading files from the Internet or from a CD-ROM is fine, but you probably
  246. want to copy your own Atari 8-bit disks to your PC. These are your options:
  247.  
  248.     - use the SIO2PC cable
  249.     - use the Xformer cable
  250.     - use a null modem cable or two modems
  251.     - read it on a 5.25" disk drive
  252.     - have someone else do it
  253.  
  254. Let's look at each option in detail.
  255.  
  256. The SIO2PC cable has been around for 5 years and is fairly well known in
  257. the Atari 8-bit community. Contact your local Atari dealer, your user group,
  258. download files #5281 and #6414 from the Atari 8-bit roundtable on GEnie, or
  259. best yet, contact Nick Kennedy directly at 501-967-3843 or write to him at:
  260.  
  261. Nick Kennedy
  262. 300 South Vancouver St.
  263. Russellville, AR  72801
  264.  
  265. I also tackled this problem back in 1988 when I was writing my ST Xformer
  266. emulator. The goal there was to connect the Atari disk drive directly to
  267. the Atari ST computer. Unlike SIO2PC, this method does not require the use
  268. of an 8-bit computer, since the disk drive connects directly to the computer
  269. running the emulator. The Xformer cable worked great and in 1988 and 1989 I
  270. built and sold hundreds of the cables. Atari dealers also built and sold
  271. many more cables.
  272.  
  273. As it turns out, these cables can also be used to connect the Atari disk
  274. drives to your PC. The bad news is, neither I nor any Atari dealer has built or
  275. sold a Xformer cable in years so you can't exactly buy one right now! I am
  276. taking advance orders on the cables and will start producing them again in
  277. early 1996. The cables will cost $25 and if you own PC Xformer you will also
  278. receive a free upgrade disk that supports the cable. If you are interested
  279. in purchasing a PC Xformer cable let me know now.
  280.  
  281. Another way to transfer files directly to your PC is to use one of several
  282. utilities that attempts to read Atari 5.25" disks on your PC's 5.25" disk
  283. drive (if you still have one). These utilities are not 100% reliable but
  284. they do work for some people.
  285.  
  286. There is one other very common way to transfer a file between any two
  287. computers, and that is to use a null modem cable or two modems. Run modem
  288. software on both your Atari and your PC and transfer each file one by one
  289. over to the PC. Then load it into PC Xformer by specifying it on the command
  290. line as drive D2: through D7:.
  291.  
  292. PC Xformer allows for up to 8 files to be specified on the XF33DEMO command
  293. line. The first file MUST be a virtual disk, since it must contain a valid
  294. DOS on it to install as drive D1:. The remaining 7 files may either specify
  295. other virtual disk files, or MS-DOS files which will automatically appear
  296. as virtual disks as described above.
  297.  
  298. Note that by default DOS 2.5 will only access 2 disk drives (D1: and D2:).
  299. See you DOS manual on how to expand that, or use a different DOS (such as
  300. MyDOS 4.5) which supports up to 8 drives.
  301.  
  302. Finally, you can have your Atari disks transfered from Atari 8-bit 5.25"
  303. floppy  disks to IBM PC 3.5" floppy disks for a small fee by contacting Rob 
  304. Satonica at:
  305.  
  306.     Creative Software Systems
  307.     7775 Scottdale Rd.
  308.     Berrien Springs, MI 49103
  309.  
  310.     phone: (616) 473-3904
  311.  
  312. Also available from Creative Software Systems is the Atari Emulator 
  313. Manager, an inexpensive MS-DOS utility which allows you to manage your 
  314. Atari 8-bit files, configure your PC Xformer settings, and run PC 
  315. Xformer, all by using your mouse to click on the various options and 
  316. files on the screen. Contact Rob for more details.
  317.  
  318.  
  319. Don't be a stranger
  320. -------------------
  321.  
  322. Well, enjoy this latest demo of PC Xformer. Please do visit the PC Xformer
  323. web page at http://www.halcyon.com/brasoft/ and give me a shout to let me
  324. know what you think of this emulator.
  325.  
  326. PC Xformer 95 (a.k.a. PC Xformer 4.0) is also in the works and is made
  327. especially for Windows 95. As soon as it is released I will post the
  328. announcement on the web page. As with PC Xformer 3.3, upgrades to version 4.0
  329. will be free to owners of PC Xformer 3.x.
  330.  
  331. Darek Mihocka, Owner of Branch Always Software
  332. Creator of ST Xformer, Quick ST, PC Xformer, and Gemulator
  333.  
  334.  
  335.