home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / graphics / utility / stadconv / readme < prev    next >
Encoding:
Text File  |  1992-07-12  |  4.1 KB  |  102 lines
  1. Hello ppl,
  2.  
  3. Here is a small ass-routine to decode packed STAD-pictures to 32k-
  4. (screenformat) pictures and to encode 32k-pictures to STAD-pics.
  5. Some remarks on STAD:
  6. STAD till version 1.2+ doesn't pack the pictures in the best way. Such
  7. stored pictures will shrink (10-1000 Bytes) by encoding and later decoding
  8. with my routine. The new files are absolutly compatible to the old ones
  9. (the old Stad-Versions <=1.2+ could read them too!).
  10. STAD 1.3+ doesn't make this "error" anymore, but sometimes there is an
  11. error in the 2nd Byte of the compressed pictures (to see in the 2nd line
  12. of the pictures to the left)
  13. Since i don't use STAD, I will be glad to get some more hints/infos.
  14. (adress is at the end of this doc)
  15.  
  16.  
  17. Decode STAD-pictures:
  18. =====================
  19. The routine assumes, that the packed STAD-pic is already in memory. You
  20. have to specify a destination-adress to write the uncompressed picture to
  21. (32000 Bytes length) - e.g. the screen-adress. Both adresses are passed
  22. via the stack to the routine. A return code is in the register D0. A zero
  23. means "everything ok", a 1 means "this is not a packed STAD-picture".
  24. The error 1 can in some very special (in fact only constructed) cases
  25. occure on STAD-pictures: The compression-algorithm used by STAD "compresses"
  26. the picture in the worst case to a 32507 Bytes length picture. STAD
  27. recognizes this of course and stores the 32k picture "as is" (not packed).
  28. In such a case it is clearly that you can't unpack the picture.....
  29. The decode-algorith takes about 0.2 - 0.3 sec. to decode a STAD-picture.
  30.  
  31. ...it should also be possible to call the routine by other languages. The
  32. routine returns by an RTS and leaves both 32-Bit-Values at the stack (a la
  33. TRAP..). The routine needs following params:
  34.  
  35.         (sp)  returnadress for RTS
  36.        4(sp)  adress of the packed STAD-Bildes
  37.        8(sp)  adress of the destination-buffer (Length 32000 Bytes)
  38. (Odd adresses are allowed.)
  39.  
  40.  
  41.  
  42. Packing 32k-Pictures:
  43. =====================
  44. The routine assumes, that the original 32k-pic is already in memory (e.g.
  45. in the screen-memory). The routine needs a buffer of 32507 Bytes (see the
  46. section "decode" for details). If the packed picture is greater than 32000
  47. Bytes then the original picture is copied to the buffer. The return value
  48. in register D0 is the length of the compressed picture - if the length is
  49. 32000 then the picture is not compressed, but copied.
  50. The pack-routine takes about 0.9 - 1.3 sec.
  51.  
  52. Calls (see also explanation in the "decode"-section): Stack:
  53.         (sp)  returen adress for RTS
  54.        4(sp)  adress of the unpacked 32k-pic
  55.        8(sp)  buffer (destination) of the packed STAD-Pic. 
  56.                 (Length min.32507 bytes)
  57.  
  58.  
  59.  
  60. Demo-programs:
  61. ==============
  62. Some people still have problems to use assembler-routines from another
  63. programming-language. This archive should contain a demo-program for
  64.  
  65. GfA-Basic V3.5                   (folder GFABASIC)
  66. Turbo C V2.0 (or Pure C)         (folder TURBO_C) 
  67. MAXON Pascal V1.5                (folder MAXONPAS)
  68.  
  69. The programs are all the same. Please read the extra READMEs inside the
  70. folders for special notes about the assembler-source. Every folder contains
  71. his on *.S assembler-source files.
  72.  
  73.  
  74.  
  75.  
  76.  
  77. By the way...
  78.  
  79. This package is public-domain. Everyone may (and should) it copy, use
  80. and give it to friends. The distribution is only allowed as COMPLETE(!)
  81. package (include ALL files - also the READMEs).
  82. If someone corrects or changes anything on this programm I would be
  83. glad if he/she drops me a note (and perhaps sends me the new version).
  84.  
  85.  
  86.        Wolfgang Ley                       e-mail to:
  87.        Teichstraße 9            or            Ley@rz.tu-clausthal.de
  88. W-3392 Clausthal-Zellerfeld                   bwwl@ibm.rz.tu-clausthal.de
  89.        (Germany)                              bwwl@sun.rz.tu-clausthal.de
  90.        Phone: Germany - 05323/82132
  91.  
  92.  
  93. ...some changes in the module 'tostad' were made by
  94.  
  95.      Jens Dittmer
  96.      Rosenstraße 10
  97. 3000 Braunschweig       (thanks a lot)
  98.  
  99. please refer to the history at the beginning of the assembler-source for
  100. details about changes...
  101.  
  102.