home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / screen / m / modex / ReadMe < prev   
Encoding:
Text File  |  1993-02-12  |  3.6 KB  |  95 lines
  1. > ReadMe for ModeX 0.15
  2.  
  3. ModeX provides new screen modes using only one module for any (well...)
  4. number of modes: you just add the mode data blocks to it. The module called
  5. ModeXraw is 'code only'; you can tuck your own mode definitions onto the end
  6. (see below for format). The module ModeX_CPD contains some ready-made modes
  7. suitable for the Sony CPD-1402E multisync monitor, but may work on others.
  8. See '*Help modes' for mode numbers.
  9.  
  10. ModeX no longer contains VIDC-Enhancer specific code; use Owen Smith's
  11. VIDCClock module for the Atomwide Enhancer or similar software. A540/A500 etc
  12. obviously don't need such support modules, RISC OS 2.01 or later selects the
  13. right clock automatically.
  14.  
  15.  
  16. Using your own modes with ModeXraw
  17. ----------------------------------
  18.  
  19. - mode definitions must be in 'new' A540 format, i.e. include the VIDC clock
  20. rate (in KHz). They work happily in Risc OS 2.00.
  21.  
  22. - at least one mode must be provided
  23.  
  24. - each three-part mode definition must start with a 4 byte information word:
  25.   ?0 mode number
  26.   ?1 monitor type to match (0 normal, 1 only for multisyncs)
  27.   ?2 reserved (=0)
  28.   ?3 reserved (=0)
  29.  
  30. - the last word must be -1 (&FFFFFFFF) to act as an end marker. This word is
  31. included in ModeXraw; insert your modes between it and the 'DATA' keyword.
  32. (This means that the last 8 bytes of ModeX are always &FF: the first four
  33. mark the end of that mode, and the last four is the end-of-modes marker.
  34.  
  35.  
  36. How to get the mode data
  37. ------------------------
  38. Either by hand, using VLSI's docs for the VIDC. This is possible, but hard
  39. work! Acceptable only if want to slightly alter an existing mode.
  40.  
  41. Alternatively, using a mode designer. There are several available, but you
  42. have to look out for two things:
  43.  
  44. 1) They have to include the VIDC clock rate as described above
  45. 2) Most designer don't allow to save the pure data; they insist to save a
  46. complete module. The data can often be found at the end; this is true for
  47. the Atomwide VIDCPlus mode designer, which is (by now) public domain (and
  48. worth getting).
  49.  
  50. Inserting the data is best done in a good editor; Edit is up to job, but
  51. Zap's word mode is ideal for this (actually Zap is ideal for almost
  52. everything). If you are in doubt how the finished module should look like
  53. take a look at the example ModeX_CPD file.
  54.  
  55.  
  56.  
  57. If you didn't understand all this gibberish, do the following (assuming you
  58. have a multisync monitor): try the modes supplied in ModeX_CPD and if they
  59. don't work - well, why not delete all this useless stuff and increase your
  60. disc space?
  61.  
  62.  
  63. Please note that you can damage your monitor by using badly defined modes;
  64. good multisync monitors should protect themselves, though (if it catches
  65. fire: well, it couldn't have been a good monitor then, could it?)
  66.  
  67. The software is offered "as is"; the author makes no warranty, express or
  68. implied, of its fitness for any particular purpose.  In no circumstances
  69. will the author be liable for any damage, loss of profits, time, or data, or
  70. any indirect or consequential loss arising out of the use of this software
  71. or inability to use this software, even if the author has been advised of
  72. the possibility of such loss.  
  73.  
  74. (the last paragraph has been borrowed from Chris Dennis.)
  75.  
  76. The code that reads the memory speed was lifted from Nick Smith's ArmSI
  77. application.
  78.  
  79. FINAL NOTE: ModeX is freeware. This program is Copyright © 1992,1993
  80. Holger Klingspohr and may be distributed freely provided only a _small_
  81. (i.e., non-commercial) amount is charged for it and this copyright notice is
  82. retained. Thank you.
  83.  
  84.  
  85. Send letters/bug reports/money/presents to:
  86.  
  87. email: <klingspohr@tu-harburg.dbp.de>
  88.  
  89.  Holger Klingspohr
  90.  Ebelingstr. 1 / 6.3.2.e
  91.  D-W 2100 Hamburg 90
  92.  Germany
  93.  
  94. Have fun!
  95.