home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / Games / WHDLoad / Src / ReadMeFirst < prev    next >
Text File  |  1999-10-07  |  3KB  |  97 lines
  1.  
  2.  
  3.     Here you will find several source code files which will help you in
  4.     developing your own installs using WHDLoad.
  5.  
  6.  
  7.     slave-examples
  8.     --------------
  9.     
  10.     The Slave examples are the recommend reading if you want self write
  11.     Slaves.
  12.     
  13.     winditup.asm:
  14.     this is a very simple Slave to give you an overview how a Slave is
  15.     working, the Slave loads from a disk image and uses the keyboard
  16.     routine provided in the sources directory
  17.  
  18.     oscar.asm:
  19.     this is a simple example for using usual files, it also contains a
  20.     simple exec.AllocMem() emulation which works fine as long as no
  21.     FreeMem() is required
  22.     
  23.     interphase.asm:
  24.     shows the usage of "savegame.s"
  25.     
  26.  
  27.     macros
  28.     ------
  29.     
  30.     some macros which are required for some sources
  31.  
  32.  
  33.     programs
  34.     --------
  35.     
  36.     some small tools, maybe useful for you
  37.     
  38.     WCmp:
  39.     simple compare utility, has wide output (16 bytes per line), shows
  40.     only differences, doesn't load whole file but works buffered,
  41.     interruptable with ^C
  42.     
  43.     WDate:
  44.     I use this to insert the date and time of assembling into the
  45.     created executable (see example-slaves)
  46.  
  47.     WVer:
  48.     I use this to increase the revision number each time the source
  49.     will be assembled (similar usage as WDate)
  50.     
  51.     
  52.     sources
  53.     -------
  54.     
  55.     these sources are code fragments containing one or more sub routines,
  56.     they should be used by including them at the bottom of the Slave 
  57.     source and calling from the slave source
  58.     
  59.     blitfix_#?.s:
  60.     these routines will patch instructions which are writing to the
  61.     blitsize custom register, the patched instruction will be replaced by
  62.     a routine doing the same but previously waiting for the blitter to
  63.     finish,    very useful to fix programs which will not correctly wait 
  64.     for blitter finish
  65.     
  66.     keyboard.s:
  67.     this file contains a complete keyboard initialisation and the required
  68.     interrupt handler, it will be useful for programs without a own
  69.     keyboard handling (most demos) or for programs with broken handling
  70.     (in this case you have to disable the original)
  71.  
  72.     savegames.s:
  73.     this routine contains a system for multiple savegames, there is
  74.     special code which creates a interface to select a save position and
  75.     to enter a description for each    savegame
  76.     
  77.     dbffix.s:
  78.     contains a routine to fix empty dbf loops, that means all instructions
  79.     like "dbf dn,*" will be patched by a wait routine based on vertical
  80.     raster beam, a well known example for empty dbf loops is the playback
  81.     routine of the old soundtracker used in many demos and games
  82.     
  83.  
  84.     PLEASE NOTE
  85.     -----------
  86.  
  87.     My Assembler is able to optimize the addressing mode (and much more):
  88.         (xxxxxxxx).L    -->    (d16,PC)
  89.     if possible.
  90.         
  91.     So I never do this myself !
  92.     Remember Slaves must be 100% PC-relativ !
  93.     So if your Assembler isn't able to do this and you want to use these
  94.     sources you have to add the "(pc)" by yourself. (or just get a better
  95.     assembler!)
  96.  
  97.