home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1996 #1 / amigaacscoverdisc01.iso / libs / toshstart.doc < prev    next >
Text File  |  1997-09-29  |  4KB  |  219 lines
  1.     ToshStart Library Docs
  2. ---------------------------------------------
  3. Routines:
  4.  
  5. TakeSystem        equ    -30
  6. FreeSystem        equ    -36
  7. TakeDos        equ    -42
  8. FreeDos        equ    -48
  9. WaitFrame        equ    -54
  10. WaitFrames        equ    -60
  11. Play_CD        equ    -66
  12. Stop_CD        equ    -72
  13. Check_CD        equ    -78
  14. Print_Dos        equ    -84
  15. Get_FileLength    equ    -90
  16. Load_File        equ    -96
  17. Save_File        equ    -102
  18. Load_Sectors    equ    -108
  19. Save_Sectors    equ    -114
  20. GetKey        equ    -120
  21. GetLibs        equ    -126
  22. Dec_Number        equ    -132
  23. Hex_Number        equ    -138
  24. Get_Number        equ    -144
  25. FlushKeyboard        equ    -150
  26.  
  27. ---------------------------------------------
  28. TakeSystem         
  29.  
  30. in:    a0.l    -    Pointer To Copper
  31.     a1.l    -    Pointer To Vbl Routine
  32.     a2.l    -    Pointer To Dos Text (0 = No text)
  33.     d0.l    -    CD Flag (0=off 1=on)
  34.     
  35. out:    d0.l    -    0 = Everything Okay...
  36.                     -1 = Could Not Open CD Device
  37.  
  38. Legally Takes Over The System..
  39. Opens Librarys (Dos , Graphics , Intuition)
  40. Sets Up Keyboard And Vbl Routines...
  41. Sets Up CD Device If Need Be..
  42.  
  43. ---------------------------------------------
  44. FreeSystem
  45.  
  46. Legally Returns System..
  47. Closes Libraries (Dos , Graphics , Intuition)
  48. Closes CD Device (If Open..)
  49.  
  50. ---------------------------------------------
  51. TakeDos
  52.  
  53. Takes Back Control Of System Stuff.. (Your Stuff Max Priority..)
  54.  
  55. ---------------------------------------------
  56. FreeDos    
  57.  
  58. Frees System Stuff For Your Use.. (Frees Max Priority..)
  59.  
  60. ---------------------------------------------
  61. WaitFrame
  62.  
  63. Legally Waits One Frame Using Library Vbl Routine..
  64.  
  65. ---------------------------------------------
  66. WaitFrames
  67.  
  68. in:    d0.l    -    Amount Of Frames To Wait
  69.  
  70. Legally Waits Amount Of Frames Using Library Vbl Routine..
  71.  
  72. ---------------------------------------------
  73. Play_CD
  74.  
  75. IN:    d0.l    -    Track Number To Play
  76. Out:    d0.l    -    0 = okay 
  77.                     -1 = Error Can't Play
  78.      
  79. Starts Playing Track From CD Drive..
  80.  
  81. ;---------------------------------------------
  82. Stop_CD
  83.  
  84. out:    d0.l    -     0 = okay
  85.              -1 = error
  86.  
  87. Stops Current Track Playing From CD Drive..
  88. ;---------------------------------------------
  89. Check_CD
  90.  
  91. IN:    d0.l    -    Track Number To Restart
  92. OUT:    d0.l    -     0 = okay
  93.              -1 = Error
  94.  
  95. Checks Current Track To See If Finished Then Restarts Track..
  96.  
  97. ;---------------------------------------------
  98. Print_Text
  99.  
  100. IN:    a0.l    -    Pointer To Dos String
  101.  
  102. Prints Text String To Current Output Cli..
  103.  
  104. ;---------------------------------------------
  105. Load_File
  106.  
  107. in:    d0.l    -    File Address
  108.     d1.l    -    File Size (MaxSize)
  109.     d2.l    -    File Name
  110.  
  111. out:    d0.l    -    File Size
  112.         -    -1 = Load Error
  113.  
  114. Loads In A Dos File To Memory..
  115.  
  116. ;---------------------------------------------
  117. Save_File
  118.  
  119. in:    d0.l    -    File Address
  120.     d1.l    -    File Size (MaxSize)
  121.     d2.l    -    File Name
  122.  
  123. out:    d0.l    -    File Size
  124.         -    -1 = Save Error
  125.  
  126. Savess In A Dos File To Memory..
  127.  
  128. ;---------------------------------------------
  129. Load_Sectors
  130.     
  131. in:    d0.l    -    File Address
  132.     d1.l    -    Sector Start  (0-1759)
  133.     d2.l    -    Sector Length (1-1759)
  134.     d3.l    -    Disk Drive    (0-3)
  135.  
  136. Out:    d0.l    -    0 = Okay
  137.                     -1 = Error
  138.  
  139. Loads In Sectors From Current Floppy Drive...
  140.  
  141. ;---------------------------------------------
  142. Save_Sectors
  143.     
  144. in:    d0.l    -    File Address
  145.     d1.l    -    Sector Start  (0-1749)
  146.     d2.l    -    Sector Length (1-1749)
  147.     d3.l    -    Disk Drive    (0-3)
  148.  
  149. Out:    d0.l    -    0 = Okay
  150.                     -1 = Error
  151. ;---------------------------------------------
  152. GetKey
  153.  
  154. Out:    d0.l    -    Current Key Pressed (Ascii)
  155.     d1.l    -    Special Key
  156.  
  157. Cursor Left    =    $e0
  158. Cursor Right    =    $e1
  159. Cursor Up    =    $e2
  160. Cursor Down    =    $e3
  161. Tab        =    $e4
  162. Escape        =    $e5
  163. Return (Enter)    =    $e6
  164. Del        =    $e7
  165. Help        =    $e8
  166. Backspace    =    $e9
  167. F1-F10        =    $f1-$fa
  168.  
  169. Special Keys Bit Values:
  170.  
  171. Left Shift        =    0
  172. Right Shift        =    1
  173. Ctrl             =    2
  174. Left Alt        =    3
  175. Right Alt        =    4
  176. Left Amiga        =    5
  177. Right Amiga        =    6
  178.  
  179. ;---------------------------------------------
  180. GetLibs
  181.  
  182. out:    d0.l    -    Pointer To Structure
  183.  
  184. Gets Address's of Open Libs (Dos , Graphics , Intuition)
  185.  
  186. ;---------------------------------------------
  187. Dec_Number
  188.  
  189. IN:    d0.l    -    number to convert
  190. OUT:    d0.l    -    Pointer To Ascii String
  191.  
  192. Convert's Number To Decimal Text String
  193.  
  194. ;---------------------------------------------
  195. Hex_Number
  196.  
  197. IN:    d0.l    -    number to convert
  198. OUT:    d0.l    -    Pointer To Ascii String
  199.  
  200. Convert's Number To Hex Text String
  201.  
  202. ;---------------------------------------------
  203. Get_Number
  204.  
  205. IN:    a0.l    -    pointer To Ascii String
  206. OUT:    d0.l    -    Decimal Number
  207.  
  208. Convert's Ascii String To Decimal Number
  209.  
  210. ;---------------------------------------------
  211. Get_FileLength
  212.  
  213. IN:    d0.l    -    pointer to Filename String.
  214. OUT:    d0.l    -    Length Of File (-1=Error)
  215.  
  216. Gets Length Of Dos File Specified..
  217.  
  218. ;---------------------------------------------
  219.