home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / frodo / !Help
Text File  |  1997-05-25  |  20KB  |  545 lines
  1. FRODO FOR ACORN RISC OS
  2. =======================
  3.  
  4.  
  5.  
  6.  
  7. This is the Acorn port of the C64 Emulator Frodo. General information and
  8. legal issues are included in the Docs directory, this file deals with the
  9. RISC OS aspects only.
  10.  
  11.  
  12.  
  13.  
  14. System Requirements:
  15. ====================
  16.  
  17. Frodo needs a WimpSlot of about 1376k, FrodoSC manages with 832k. Both
  18. require RISC OS 3 and a lot of processing power. Although they should
  19. in theory run on any machine with enough RAM and a recent enough OS the
  20. minimum spec where Frodo is _halfway_ usable is an A5000, FrodoSC should
  21. be usable on a StrongARM only. If you want full frame rate and sound
  22. you'll need a StrongARM even for Frodo. This is due to Frodo being
  23. written in C++ so you really can't expect it to be as fast as the
  24. Breadbox, for instance. Thus this is basically RiscPC only, StrongARM
  25. _strong_ly recommended. Any joker out there with an ARM2 or 250 complaining
  26. about the speed will feel my foot where mommy put the thermometer.
  27.  
  28.  
  29.  
  30.  
  31.  
  32. Using Frodo:
  33. ============
  34.  
  35. Simply start Frodo(SC) by double-clicking on its filer icon (the filer must
  36. have seen the shared resources of Frodo and FrodoSC first!). Frodo will
  37. install itself on the icon bar and open the emulation window (yes dudes,
  38. Frodo is multitasking). You should know how to use a C64 from now on
  39. because I won't start a course on that!
  40.  
  41.  
  42.  
  43.  
  44. Configuration:
  45. ==============
  46.  
  47. There are two configuration windows:
  48.  
  49. a) The Preferences window: deals with all system-independent configurations.
  50.    See the file "settings" in the Docs directory for more information.
  51.    You can set drive paths by dragging the object in question (a directory,
  52.    a D64- or a T64-image) onto the respective (writable) path icon. Frodo
  53.    will automatically try setting the drive emulation mode accordingly.
  54.    The reason the Preferences window is so big is that everything covered
  55.    there is in a class in Frodo, so regarding portability and unwanted
  56.    side-effects I decided to represent it as a unit rather than splitting
  57.    it up.
  58.  
  59. b) The System Configuration window deals with system-specific aspects of
  60.    the emulator. You can enter the keys used for the keyboard joystick
  61.    here as well as timing aspects. The entries are
  62.  
  63.    Poll After:    Number of centiseconds after which the WIMP should be
  64.            polled. This is never exact because the check whether
  65.            to poll is only done after an entire frame has been built.
  66.  
  67.    Speed After:    Number of centiseconds after which the Speedometer should
  68.            be updated. Don't use too small values because centiseconds
  69.            are basically too coarse a unit for something like this. Like
  70.            Poll After the check is made only once per frame.
  71.  
  72.    Poll Sound Lines: Number of rasterlines after which the sound system
  73.            should be polled to determine whether a new sample is
  74.            needed. For more see "Sound".
  75.  
  76.    Joystick Keys: You have to place the mouse pointer over the corresponding
  77.            icon and press the key you wish to use for this until you
  78.            see the icon change. For more see "Keyboard Joysticks"
  79.  
  80.  
  81. In both windows changes are only passed on to the emulator if you click OK
  82. or "save" (if present), drag the filer-sprite to a valid destination window
  83. or press return in the file-path icon (the only exception is "Skip Frames").
  84. "Cancel" in the "Preferences"-window will update the window with the currently
  85. used settings. This is done with the System Configuration window every time
  86. it's opened (i.e. to retrieve the current settings simply close the window and
  87. re-open it). You can activate new settings in both cases by dragging the
  88. corresponding files onto the window in question.
  89.  
  90.  
  91.  
  92.  
  93. Sound:
  94. ======
  95.  
  96. Sound is off by default. Switch it on from the Preferences window (SID Type).
  97.  
  98. Frodo uses a polling system to playback samples. "Poll Sound Lines" determines
  99. how often it should poll. If you don't poll enough (i.e. your machine is too
  100. slow) sample buffers will overflow, creating a discontinuity in the sound.
  101. The size of the sound buffer and the sample rate (22050Hz) are chosen in such
  102. a way that the polling has to be done every 2cs to avoid buffer overflows.
  103. Polling costs a little extra compared to an IRQ-oriented approach but it's
  104. the only way for a multitasking RISC OS-application which is mapped out between
  105. (WIMP) Polls. In this particular case it acually has its upsides because you
  106. can determine yourself how good a sound you want and how much computing power
  107. you wish to give to synthesis. Frodo's sound emulation is rather sophisticated
  108. and thus needs a lot of power; but if all you do is play some shoot'em up
  109. with laser-sounds overflowing sample buffers won't be all that noticable so
  110. you can get a rather good approximation by polling once per frame (every
  111. 312 lines).
  112. If you want to make sure no buffer overflow occurs you have to check how fast
  113. your computer can manage the emulation with sound enabled and SkipFrames=1.
  114. Then PollSoundLines = (speedometer percentage)*312/100 (i.e. for 100% speed
  115. once per frame). Buffer overflows can still occur during WIMP polls so if you
  116. want 100% accurate sound playback you have to force single tasking by pressing
  117. ScrollLock (see "Keyboard"). But unless you have a StrongARM I wouldn't use
  118. much sound at all.
  119.  
  120. The sound is known to work on a StrongARM RiscPC with the standard RO3.7 sound
  121. modules. It also works on an A5000 albeit very slowly.
  122.  
  123. You can alter the volume via the menus. A click on the volume bar will alter
  124. the volume immediately to that value, a drag will only alter the volume once
  125. it's completed.
  126.  
  127. Frodo for RISC OS uses 8 bit logarithmic samples. I don't have documentation
  128. about 16 bit linear and also have serious doubts it would make a hell of a lot
  129. of difference here.
  130.  
  131. Technical note:
  132.     The module "DigitalRenderer" provides the interface between Frodo's
  133.     sound system and RISC OS. Since Acorn's documentation of the DMA- and
  134.     Channel-Handlers is basically non-existant there might be problems
  135.     with future versions; if you experience problems try using older
  136.     versions of the modules "SoundChannels" and "SoundDMA". Sorry about
  137.     the inconvenience but I ABSOLUTELY REFUSE TO IMPLEMENT SOMETHING LIKE
  138.     THIS VIA VOICE GENERATORS!
  139.     Avoid activating new SoundDMA or SoundChannels modules while the
  140.     DigitalRenderer is active. You DON'T have to rmkill the DigitalRenderer
  141.     for this, but turn off sound emulation first, otherwise there might
  142.     be some confusion, although there shouldn't be any nasty crashes.
  143.     The DigitalRenderer module is documented in the resources directory.
  144.     It's registered and you may use it in your own programs.
  145.  
  146. More than one Frodo:
  147.     You can run more than one copy of Frodo / FrodoSC simultaneously. Only
  148.     one copy can have sound emulation enabled, though. But that much should
  149.     be obvious...
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157. Display and screen modes:
  158. =========================
  159.  
  160. The screen plotters are customized assembler jobs. Since I really have far better
  161. things to do than write thousands of drivers for all manner of exotic cases
  162. there are some restrictions:
  163.  
  164. - Modes with eigen_x > eigen_y are not supported (none of the standard modes fall
  165.   into that cathegory).
  166.  
  167. - In modes with eigen_y > eigen_x lines are left out rather than columns being
  168.   doubled. You can get the columns-doubled display by doubling the display size.
  169.   This mode will be rather slow, however, since I only optimised the plotters to
  170.   the full for square pixel modes.
  171.  
  172. So to run Frodo use a square pixel mode. If you still run non-square pixel modes
  173. your computer is probably much too slow for Frodo anyway. All colour-depths and
  174. resolutions are supported. 16 and 32 bpp modes will take longer to plot because
  175. colour-lookup couldn't be avoided there and of course we're seriously struggling
  176. for bandwidth there. The window will always be scaled to such a size that one
  177. (horizontal) pixel of the C64-image corresponds to <zoom_factor> pixels of the
  178. screen. Thus the display size is only dependent upon your physical pixels, not the
  179. eigen values.
  180.  
  181. The reason SkipFrames affects the emulation speed so much lies not with my
  182. plotters (which are more or less as fast as possible) but with Frodo being
  183. intelligent enough not to build a frame if it won't be displayed anyway.
  184.  
  185. If you switch to a screen-mode with