home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 10 / AU_CD10.iso / Archived / Emulators / BBC-6502Em / 6502de / Docs / Scripts < prev    next >
Encoding:
Text File  |  1996-05-29  |  2.3 KB  |  101 lines
  1. 6502Em: BBC Script files
  2. ========================
  3.  
  4. These are files intended to be the !Run file of
  5. an application directory containing a BBC game.
  6. When the application is run, !6502Em will be
  7. loaded if necessary (so long as it has been 'seen'
  8. by the filer).
  9. Within the script file, you can alter certain
  10. features of the emulator and specify which
  11. file to run first to load the game.
  12.  
  13. The emulator's internal Currently Selected Directory (CSD)
  14. will be set to the directory containing the script file.
  15.  
  16. The first line of the file MUST be:
  17.  
  18. BBC Script
  19.  
  20. On later lines, you may use the following commands:
  21.  
  22. Palette [On|Off]
  23. Sound [On|Off]
  24. Patch [Off|<patchname>]
  25. Machine <machinename>
  26. TapeFile <filename>
  27. IndexFile <filename>
  28. Keymap [Default|<keymapname>]
  29. DisableTape
  30. ScrollHack
  31. LoadROM <filename>
  32. LoadRAM <filename>
  33. KillROM <ROMName>
  34.  
  35. where:
  36. <patchname> is the name of a 'Patch' in !6502Em.Patches,
  37. <keymapname> is the name of a 'Keymap' in !6502Em.Keymaps,
  38. <machinename> is one of BBCB, Master128, Compact
  39.  
  40. IndexFile takes a file containing names of files (in order)
  41. that will be loaded when a CHAIN"" or *RUN"" is issued
  42. (in the same directory as the Script)
  43.  
  44. The last line of the script is then used to determine
  45. how to run the game.
  46.  
  47. If the last line is non-existent, then the emulator
  48. will try to load a file of the same name as the application
  49. directory.
  50.  
  51. If the last line is just a single word, then the emulator
  52. will try to load a file of this name.
  53.  
  54. In both these cases, the emulator will try to work out
  55. whether the file is BASIC from its execution address or
  56. filetype.
  57. (&801F, &8023, &802B, &80E7 are executions addresses recognised)
  58. Otherwise it will be *Run'ed
  59. If it is recognised as BASIC from its execution address,
  60. page will be set to its load address before it is loaded.
  61.  
  62. If the last line contains a space (ie is not a single word)
  63. or starts with CHAIN or * then that line will be typed into
  64. BASIC by the emulator.
  65.  
  66. eg to turn the sound off, the last line might be:
  67. OSCLI "FX210,1" : *Run GameObj
  68.  
  69. Some example Scripts:
  70.  
  71. BBC Script
  72.  
  73. BBC Script
  74. Patch Off
  75. Keymap Arcadians
  76.  
  77. BBC Script
  78. Palette Off
  79. ExileL
  80.  
  81. BBC Script
  82. Machine BBCB
  83. Patch Elite
  84. Palette Off
  85. Elite
  86.  
  87. BBC Script
  88. Machine Master128
  89. Patch M128Elite
  90. Palette Off
  91. MODE2 : */M128Elt
  92.  
  93. BBC Script
  94. Patch Off
  95. Palette On
  96. PAGE=&1900 : OSCLI "FX210,1" : LOAD "LISTING"
  97.  
  98. BBC Script
  99. TapeFile JSW
  100. Machine BBCB
  101. OSCLI "TAPE" : CHAIN ""