home *** CD-ROM | disk | FTP | other *** search
/ Kosovo Orphans' Appeal Charity CD / KosovoOrphansAppeal.iso / commercialdemos / claresmicrosupplies / pca / docs / pca_swis < prev    next >
Text File  |  1996-08-20  |  2KB  |  72 lines
  1. Plug In Compliant Application protocol
  2. ====================================== 
  3.  
  4.  
  5. PCA support module SWIs
  6. =======================
  7.  
  8. Module : PCASupport
  9. Version : 0.07 (12 August 1996)
  10. Chunk : &4D6C0
  11.  
  12. The PCA support module is designed to facilitate the creation of PCA style
  13. 'tags' in an area of shared memory. At a future date other useful PCA
  14. related SWIs (eg. colaescing update area rectangles) may be added. In the
  15. meantime the following SWIs are provided. 
  16.   
  17. SWI PCA_CreateTag
  18. -----------------  
  19. on entry -
  20.  
  21. r1 = address of base
  22. r2 = Offset to object
  23. r3 = size of object (optional)
  24. r4 = flags/extension data (not in this version.)
  25.  
  26. on exit -
  27.  
  28. r0 = address of tag
  29. (r1-r4 are written into the tag as initial values.)
  30. All other registers preserved.
  31.  
  32.  
  33. Errors returnable:
  34.  
  35. "This version of the PCA support module cannot create extended tags."
  36.  
  37. Produced if bits set in R4 (b0-15).
  38.  
  39. "This version does not resize the tag block on old hardware. (too many tags)."
  40.  
  41. Produced on pre-RPC hardware if more than 2048 tags are in use.
  42.  
  43.   
  44. NOTE: PCASupport relies on the first value of a valid tag not being
  45. &FFFFFFFF (-1). NEVER write this value into the base field of the tag as the
  46. next call to PCA_CreateTag will probably map your tag to another object -
  47. causing chaos. 
  48.  
  49.   
  50. SWI PCA_DeleteTag
  51. -----------------  
  52. on entry -
  53.  
  54. R0 = ptr to tag
  55.  
  56. on exit all registers preserved.
  57.  
  58. Errors returnable:
  59. "Bad tag passed to PCASupport."
  60.  
  61.   
  62. SWI PCA_DeleteAndKill
  63. ---------------------  
  64. on entry -
  65.  
  66. R0 = ptr to tag
  67. R1 = filetype of object
  68.  
  69. on exit all registers preserved.
  70.   
  71. As well as the functionality of the above SWI this also broadcasts
  72. Message_Deselect for you.