home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / srvnt48d.sfx / B / Customizing
Encoding:
Text File  |  1990-02-12  |  6.6 KB  |  103 lines

  1. ┴PPENDIX ┬:  ├╒╙╘╧═╔┌╔╬╟ ╘╚┼ ╙┼╥╓┴╬╘
  2.  
  3. ╙INCE ╘╚┼ ╙┼╥╓┴╬╘ POPS UP WHENEVER YOU TURN ON OR RESET YOUR COMPUTER, IT WOULD BE QUITE ANNOYING IF YOU WERE STUCK WITH ╘╚┼ ╙┼╥╓┴╬╘S ORIGINAL APPEARANCE.
  4.  
  5. ═ODIFYING ╘╚┼ ╙┼╥╓┴╬╘ NOT HARD.  ╞IRST, LOAD ╘╚┼ ╙┼╥╓┴╬╘ INTO COMPUTER ╥┴═ MEMORY.  ╘O VERIFY THAT ╘╚┼ ╙┼╥╓┴╬╘ REALLY IS PRESENT AND WORKING IN THE COMPUTER'S MEMORY, INVOKE ╘╚┼ ╙┼╥╓┴╬╘S MAIN MENU.  ┘OU SHOULD SEE THE AUTHOR'S NAME AND ADDRESS BELOW THE MAIN MENU, AND THE MESSAGE "╚IT ├╧╬╘╥╧╠/+ TO SAVE ┼╨╥╧═ BURNER FILE".  ─╧ ╬╧╘ SAVE ╘╚┼ ╙┼╥╓┴╬╘ YET.  ╞IRST, MODIFY YOUR COPY ACCORDING TO YOUR PREFERENCES.  ╘O DO THAT, HIT ╥┼╘╒╥╬ TO RETURN TO ┬┴╙╔├.  ╬OW, YOU'RE READY TO MAKE MODIFICATIONS.
  6.  
  7. ╞╒╬├╘╔╧╬ ╦┼┘╙:
  8. ╫HENEVER YOU POWER UP OR RESET YOUR COMPUTER, ╘╚┼ ╙┼╥╓┴╬╘ WILL INSTALL ITS OWN FUNCTION KEYS DEFINITIONS.  ╘HE DEFAULT DEFINITIONS ARE AS FOLLOWS:
  9.  
  10. ╞1 = DLOAD "                 (╠OAD A ┬┴╙╔├ PROGRAM)
  11. ╞2 = DSAVE "@                (╙AVE A ┬┴╙╔├ PROGRAM)
  12. ╞3 = C┴                      (─IRECTORY ON DISK DRIVE 8)
  13. ╞4 = C┴U9                    (─IRECTORY ON DISK DRIVE 9)
  14. ╞5 = CLEAR SCREEN, SET COLORS, SET FAST MODE IF USING 80 COLUMNS.
  15. ╞6 = BANK15:SYSDEC("1300")   (├ALL A ═╠ ROUTINE AT 4864/$1300)
  16. ╞7 = L╔                      (╠IST A ┬┴╙╔├ PROGRAM)
  17. ╞8 = MO╬                     (╟O TO THE ═╠ MONITOR.)
  18.  
  19. ╘YPE ╦┼┘, AND THEN ╥┼╘╒╥╬.  ┴ LIST OF THE CURRENT FUNCTION KEYS WILL APPEAR ON THE SCREEN.  ╨LEASE NOTE HOW CONTROL CHARACTERS ARE UTILIZED.  ╘HE CONTROL CHARACTERS WILL MAKE THE FUNCTION KEYS WORK FLAWLESSLY, EVEN IF THEY ARE PRESSED IN THE MIDDLE OF A SCREEN FULL OF TEXT (TRY THAT USING THE ├128'S DEFAULT DEFINITIONS!).
  20.  
  21. ┘O CAN CHANGE OR MODIFY ANY OF THE DEFINITIONS USING THE ┬┴╙╔├ "╦┼┘" COMMAND.  ╔F YOU WANT, YOU CAN CHANGE THE FUNCTION OF THE ╚┼╠╨ KEY AND THE ╙╚╔╞╘/╥╒╬-╙╘╧╨ COMBINATION AS WELL.  ╚ERE'S HOW:
  22.  
  23. ╘O CHANGE THE ╥╒╬ KEY:
  24. BANK 15:SYS 24812 ,,8,,,"DEFINITION"
  25.  
  26. ╘O CHANGE THE ╚┼╠╨ KEY:
  27. BANK 15:SYS 24812 ,,9,,,"DEFINITION"
  28.  
  29. ╥EPLACE THE WORD "DEFINITION" WITH THE ACTUAL DEFINITION YOU WANT TO USE.  ╨LEASE NOTE THE USE OF COMMAS, YOU'LL NEED TO USE THEM EXACTLY AS SHOWN FOR THIS TRICK TO WORK.
  30.  
  31. ┘OU WON'T NEED TO INCLUDE A FUNCTION KEY DEFINITION TO INVOKE ╘╚┼ ╙┼╥╓┴╬╘ ITSELF.  ╚OWEVER, ╘╚┼ ╙┼╥╓┴╬╘ WILL AUTOMATICALLY CLAIM ONE FUNCTION KEY DEFINITION (OF YOUR OWN CHOICE) FOR THIS PURPOSE.  ╙EE THE SECTION ON ╘╚┼ ╙┼╥╓┴╬╘ CALL KEY BELOW.  ╨LEASE NOTE THAT THE TOTAL NUMBER OF CHARACTERS IN THE FUNCTION KEY STRINGS IS LIMITED TO 246.  ╘╚┼ ╙┼╥╓┴╬╘ CALL KEY USE 16 CHARACTERS, SO A TOTAL OF 230 CHARACTERS ARE AVAILABLE FOR YOUR USE.
  32.  
  33. ╫HEN YOU THINK YOUR CUSTOM FUNCTION KEYS ARE ╧╦, TEST THEM TO VERIFY THAT THEY REALLY WORK ACCORDING TO YOUR EXPECTATIONS.  ╘HE FINAL STEP IS TO COPY THE DEFINITIONS INTO ╘╚┼ ╙┼╥╓┴╬╘ ITSELF.  ─O IT USING THE FOLLOWING ┬┴╙╔├ LINE:
  34.  
  35. BANK0:FOR X=0TO255:POKE32795+X,PEEK(4096+X):NEXT
  36.  
  37. ─╔╙┴┬╠╔╬╟ ╘╚┼ ╙┼╥╓┴╬╘S ╞╒╬├╘╔╧╬ ╦┼┘ ╔╬╙╘┴╠╠┴╘╔╧╬:
  38. ╔F YOU DON'T WANT ╘╚┼ ╙┼╥╓┴╬╘ TO INSTALL FUNCTION KEYS UPON POWER UP OR RESET, USE THE COMMAND:
  39.  
  40. BANK0:POKE33058,0
  41.  
  42. ╘HIS WILL DISABLE ╘╚┼ ╙┼╥╓┴╬╘ FUNCTION KEYS INSTALLATION.  ╘O RE-ENABLE THE FUNCTION KEY DEFINITION, POKE A NONZERO VALUE INTO LOCATION 33058.  ╨LEASE NOTE THAT YOU CANNOT DISABLE ╘╚┼ ╙┼╥╓┴╬╘S AUTOMATIC CALL KEY DEFINITION (SEE BELOW).
  43.  
  44. ╙┼╘╘╔╬╟ ╘╚┼ ╙┼╥╓┴╬╘ ├┴╠╠ ╦┼┘:
  45. ╧NE KEY MUST BE RESERVED TO CALL ╘╚┼ ╙┼╥╓┴╬╘.  ╘╚┼ ╙┼╥╓┴╬╘ AUTOMATICALLY SETS THIS DEFINITION.  ╔T'S UP TO YOU HOWEVER, TO DECIDE WHICH FUNCTION KEY ╘╚┼ ╙┼╥╓┴╬╘ IS GOING TO USE.  ╒SE THE COMMAND:
  46.  
  47. BANK0:POKE33057,FUNCTION KEY NUMBER.
  48.  
  49. ╘HE FUNCTION KEY NUMBERS ARE 1 THROUGH 8 FOR THE FUNCTION KEYS 1 THROUGH 8; 9 IS THE ╙╚╔╞╘/╥╒╬-╙╘╧╨ COMBINATION, AND 10 IS THE ╚┼╠╨ KEY.  ╘AKE YOUR PICK.  ╘HE DEFAULT IS 9, USING THE ╙╚╔╞╘/╥╒╬-╙╘╧╨ COMBINATION.
  50.  
  51. 40 ├╧╠╒═╬ ╙├╥┼┼╬ ├╧╠╧╥╙:
  52.  
  53. ╘EXT COLOR:       BANK0:POKE33051,COLOR CODE
  54. ┬ACKGROUND COLOR: BANK0:POKE33052,COLOR CODE
  55. ┬ORDER COLOR:     BANK0:POKE33053,COLOR CODE
  56.  
  57. ╘HE COLOR CODES ARE AS FOLLOWS:
  58.  
  59. 0 = BLACK  4 = PURPLE   8 = ORANGE     12 = MEDIUM GRAY
  60. 1 = WHITE  5 = GREEN    9 = BROWN      13 = LIGHT GREEN
  61. 2 = RED    6 = BLUE    10 = LIGHT RED  14 = LIGHT BLUE
  62. 3 = CYAN   7 = YELLOW  11 = DARK GRAY  15 = LIGHT GRAY
  63.  
  64.  
  65. 80 ├╧╠╒═╬ ╙├╥┼┼╬ ├╧╠╧╥╙:
  66.  
  67. ╘EXT COLOR:       BANK0:POKE33054,COLOR CODE
  68. ┬ACKGROUND COLOR: BANK0:POKE33055,COLOR CODE
  69.  
  70. ╨LEASE NOTE THAT THESE COLOR CODES ARE DIFFERENT FROM THE CODES FOR THE 40 COLUMN SCREEN.  ╘HE COLOR CODES ARE AS FOLLOWS:  
  71.  
  72. 0 = BLACK      4 = DARK GREEN   8 = DARK RED     12 = BROWN
  73. 1 = DARK GRAY  5 = LIGHT GREEN  9 = LIGHT RED    13 = YELLOW
  74. 2 = DARK BLUE  6 = DARK CYAN   10 = DARK PURPLE  14 = LIGHT GRAY
  75. 3 = LIGHT BLUE 7 = LIGHT CYAN  11 = LIGHT PURPLE 15 = WHITE
  76.  
  77. ╙┼╘╘╔╬╟ ╒╨╨┼╥├┴╙┼ ╧╬ ┼╪╔╘:
  78. ╔F YOU HAVE PLAYED AROUND WITH ╘╚┼ ╙┼╥╓┴╬╘ A BIT, YOU'LL NOTICE THAT THE LETTERS ARE LOWERCASE WHEN YOU EXIT.
  79.  
  80. ╘O SET UPPERCASE UPON EXIT:
  81.  
  82. BANK0:POKE33056,142
  83.  
  84. ╘O SET LOWERCASE UPON EXIT:
  85.  
  86. BANK0:POKE33056,14
  87.  
  88. ─╔╙┴┬╠╔╬╟ ╞┴╙╘ (2═HZ) ═╧─┼:
  89. ╘╚┼ ╙┼╥╓┴╬╘ WILL USE FAST MODE WHENEVER THE 80 COLUMN SCREEN IS ACTIVE.  ╔F YOU NEED TO, YOU CAN PROHIBIT ╘╚┼ ╙┼╥╓┴╬╘ FROM USING FAST MODE:
  90.  
  91. BANK0:POKE32774,81
  92.  
  93. ╙ETTING THIS BYTE TO ANY OTHER VALUE (AVOID 0 OR 1; IT WILL MAKE ╘╚┼ ╙┼╥╓┴╬╘ MALFUNCTION) WILL ENABLE FAST MODE AS USUAL.  ╙ETTING THIS LOCATION TO 0 WILL DISABLE ╘╚┼ ╙┼╥╓┴╬╘S AUTOSTART.  ╙TILL, ╘╚┼ ╙┼╥╓┴╬╘ CAN BE CALLED BY BANK12:SYS32777 AND WILL WORK FLAWLESSLY.
  94.  
  95. ╙┴╓╔╬╟ ╘╚┼ ═╧─╔╞╔┼─ ╓┼╥╙╔╧╬ ╧╞ ╘╚┼ ╙┼╥╓┴╬╘:
  96. ╫HEN YOU HAVE MADE ALL YOUR MODIFICATIONS, TYPE BANK0:SYS32768 AND PRESS ╥┼╘╒╥╬ TO COLD START ╘╚┼ ╙┼╥╓┴╬╘.  ├HECK THAT THE COLORS ARE AS YOU EXPECT.  ┼XIT ╘╚┼ ╙┼╥╓┴╬╘ AGAIN AND CHECK THAT THE FUNCTION KEY DEFINITIONS WORKS AS EXPECTED.  ╨RESS ╘╚┼ ╙┼╥╓┴╬╘ CALL KEY TO SEE IF ╘╚┼ ╙┼╥╓┴╬╘ MAIN MENU POPS UP AS EXPECTED.
  97.  
  98. ╔F EVERYTHING SEEMS ╧╦, SAVE ╘╚┼ ╙┼╥╓┴╬╘ TO DISK BY HOLDING DOWN ├╧╬╘╥╧╠ AND PRESSING THE "+" KEY.  ╨LEASE MAKE SURE THAT THE DISK HAS AT LEAST 130 BLOCKS FREE.  ╘╚┼ ╙┼╥╓┴╬╘ WILL BE SAVED TO DISK DRIVE 8 USING THE FILE NAME "THE SERVANT.MOD".  ╔F A FILE OF THAT NAME ALREADY EXIST ON THE DISK (A PREVIOUSLY SAVED ╙┼╥╓┴╬╘), THAT FILE WILL BE DELETED.  ╨LEASE NOTE THAT YOU SHOULD ╬╧╘ USE ┬╙┴╓┼ FROM ┬┴╙╔├, "╙" FROM THE MACHINE LANGUAGE MONITOR, OR ANY OTHER SAVE FUNCTION.  ╔F ╘╚┼ ╙┼╥╓┴╬╘ IS SAVED IN ANY OF THOSE WAYS, IT MAY BE CORRUPTED.  ╒SE ├╧╬╘╥╧╠/+!
  99.  
  100. ╘HE FILE JUST SAVED CAN BE PROGRAMMED DIRECTLY INTO AN ┼╨╥╧═.
  101.  
  102. ╔═╨╧╥╘┴╬╘:  ┘OU ═╒╙╘ TEST YOUR MODIFIED ╘╚┼ ╙┼╥╓┴╬╘ RUNNING IN COMPUTER ╥┴═ BEFORE YOU HAVE IT PROGRAMMED INTO THE ┼╨╥╧═.  ┴ WRONG ╨╧╦┼ DURING YOUR CUSTOMIZING MAY MAKE ╘╚┼ ╙┼╥╓┴╬╘ MALFUNCTION.  ╔T IS BETTER TO REVEAL ERRORS AT THIS POINT RATHER THAN WHEN ╘╚┼ ╙┼╥╓┴╬╘ IS PHYSICALLY INSTALLED INTO YOUR COMPUTER.  ┴N ERROR DISCOVERED AT AFTER THE INSTALLATION WILL MAKE IT MUCH HARDER TO FIGURE OUT WHERE THE ERROR REALLY IS.
  103.