home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / programming / dasupport / SWIs (.txt) < prev   
Encoding:
Ovation Pro Document  |  1998-01-16  |  19.6 KB  |  89 lines
  1. OvationPro
  2. (18-Jun-97)
  3. Generic
  4. Black
  5. White
  6. Transparent
  7. Green
  8. Magenta
  9. Yellow
  10. Registration
  11. colour_0
  12. Transparent01
  13. Black01
  14. Homerton.Bold
  15. Homerton.Medium
  16. Trinity.Medium
  17. Trinity.Bold
  18. Corpus.Medium
  19. Bodytext
  20. Footer
  21. Heading
  22. Sub heading
  23. !MainDict
  24. !UserDict
  25. DASupport Module
  26. (version 0.04 16/01/98)
  27. Liam Gretton for Leicester University
  28. 16th January 1998
  29. This document describes the SWI calls provided by the DASupport module. It provides facilities to simplify the management of dynamic areas by external clients.
  30. The module
  31. s SWI chunk base is &50540, which has been allocated by Acorn, and so shouldn
  32. t clash with other modules out there.
  33. Changes
  34. 0.04 - Added DASupport_Fill.
  35. 0.03 - Altered DASupport_Claim: added ability to fill a newly created area with a particular word.
  36. DASupport module (16th January 1998)
  37. 1_Plain
  38. 1_Plain
  39. DASupport module (16th January 1998)
  40. SWI calls
  41. DASupport_Claim
  42. Used to create a dynamic area.
  43. On entry
  44. R0 = size of area to create
  45. bit 31 set means fill the area with the word in R2
  46. pointer to ctrl-terminated name to use for are
  47. word to fill area with (if bit 31 of R0 set)
  48. On exit
  49. R0 = 0 if area created successfully
  50. 1 if area not created
  51. base address of area if R0 = 0.
  52. All other registers preserved.
  53. This SWI attempts to create a dynamic area of the specified size, giving it the name pointed to by R1
  54. . Currently DASupport can manage up to 500 dynamic areas. If an attempt is made to create more, the error 
  55. DASupport cannot claim any more areas
  56.  will be reported.
  57. If bit 31 of R0 is set, the area is filled with the word given in R2.
  58. DASupport_Release
  59. Used to remove a dynamic area.
  60. On entry
  61. R1 = base address of area to remove (as returned from DASupport_Claim)
  62. On exit
  63. R0 = 0 if area removed successfully
  64. 1 if area not removed
  65. All other registers preserved.
  66. This SWI removes a dynamic area created with DASupport_Claim.
  67. DASupport_Fill
  68. Used to fill an existing area.
  69. On entry
  70. R1 = base address of area to fill (as returned from DASupport_Claim)
  71. R2 = value to fill area with
  72.         
  73. On exit
  74. R0 = 0 if area filled successfully
  75. 1 if area not filled
  76. All other registers preserved.
  77.         
  78. This SWI fills one of DASupport
  79. s dynamic areas with the value passed in R2.
  80. sed i
  81. DASupport module (16th January 1998)
  82. 1_Plain
  83. DASupport module (16th January 1998)
  84. 1_Plain
  85. DASupport module (16th January 1998)
  86. 1_Plain
  87. DASupport module (16th January 1998)
  88. 1_Plain
  89.