home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma37.dms / ma37.adf / PAM / PAM.doc < prev    next >
Text File  |  1994-02-25  |  5KB  |  122 lines
  1.         #####    ####   ##    ##     ####      ####
  2.         ##  ##  ##  ##  ###  ###    ##  ##    ##  ##
  3.         ##  ##  ##  ##  ########       ##     ##  ##
  4.         #####   ######  ## ## ##      ##      ##  ##
  5.         ##      ##  ##  ##    ##     ##       ##  ##
  6.         ##      ##  ##  ##    ##    ##        ##  ##
  7.         ##      ##  ##  ##    ##    ###### ##  ####
  8.  
  9.             Picture And Music
  10.  
  11.                 by El Pedro of LSD
  12.  
  13. PAM combines a picture and a Protracker module into an executable file. If
  14. you think that this is just a lamer-tool, then you are probably right. But
  15. as you need the CLI to use it, and you need to install a library, then the
  16. user will need at least half a brain to use it. Believe me, I know people
  17. who will find this program too hard to use. Experienced users could use
  18. this program without docs, but here is a lamer-guide:
  19.  
  20. PAM requires Kickstart 2.04 to work. It also requires iffparse.library v37+
  21. and packilbm.library v1+, so copy them into your LIBS:. Note that the
  22. programs produced work fine under 1.3, provided the graphics mode of the
  23. picture is available under 1.3 (ie no SuperHires or AGA)
  24.  
  25. Put the name of the picture you want showing in the 'Picture to load'
  26. gadget, or click the 'Select' for a file requester. (or press SHIFT-P)
  27.  
  28. Put the name of the module you want playing in the 'Module to load' gadget,
  29. or click the 'Select' for a file requester. (or press SHIFT-M)
  30.  
  31. Put the name of the picture you want showing in the 'Program to save'
  32. gadget, or click the 'Select' for a file requester. (or press SHIFT-R)
  33.  
  34. Click 'Start' to do the biz.
  35.  
  36. Voila, instant intro! Just click 'Test' to see it.
  37.  
  38. This program will handle _any_ type of IFF picture, including HAM8, and
  39. most PT-Modules, but remember that you can't show HAM8 if you haven't got
  40. AGA, or AGA isn't enabled! Put Setpatch V39+ in the startup-sequence to
  41. enable AGA, or you can't show AGA pics. (This applies to all programs which
  42. need AGA, btw)
  43.  
  44. Warning: PAM does not check whether the module given really is a Protracker
  45. module (as the format is hard to detect, ie crap) This allows you to use
  46. old ST1.0 modules, but it also allows everything else!
  47.  
  48. ----
  49.  
  50. Still to come is the version of PAM which handles any kind of module
  51. (provided there is a player for it).
  52.  
  53. The image compressor promised in the PAM 1.0 doc is still in preparation.
  54. (Actually, it hasn't been touched in months...) The current 'amazing' ILBM3
  55. compressor may be scrapped if a better one emerges.
  56.  
  57. ----
  58.  
  59. Version History:
  60.  
  61. Version 1.0 (13-Jan-94)
  62.  
  63. The original, CLI based hack.
  64.  
  65.  
  66. Version 1.1 (??-Jan-94)
  67.  
  68. Some small optimisations.
  69.  
  70. Removed static data tables, and replaced with linked lists. This reduced
  71. the size of the executable by 30%! Was a problem with my linker library
  72. using static arrays. The linker just needs another generation, and it may
  73. well be released in its own right.
  74.  
  75. Included newer version of packilbm.library, which is smaller and a bit
  76. faster.
  77.  
  78. Removed subtle error in viewer code. Did not affect 1.0, but hit 1.1ß. It
  79. was a documented 'feature' of genim2. Fixed.
  80.  
  81. Now uses intuition mouse read instead of hardware. This means that the CLI
  82. is not deselected when you quit. Now use the right mouse button to quit.
  83. Now it is OS clean, apart from the PT-replay (which isn't my code anyway.)
  84.  
  85.  
  86. Version 2.0 (21-Feb-94)
  87.  
  88. Now features a GUI, for the superlamer! Now only a few mouse clicks
  89. required!
  90.  
  91. Now runnable from workbench as well as CLI. (Supply your own icon - I can't
  92. draw!) CLI parsing removed - now just pops GUI. Same goes for the produced
  93. executable - just add icons, and instant slideshow!
  94.  
  95. Fixed a problem where a pointer wasn't cleared on exit from one of my
  96. routines, so when it was called again, it gurued! Not a problem in 1.1,
  97. because the routine was never called twice.
  98.  
  99. The PT-Replay pokes the longword after the end of the module. This causes
  100. memory corruption. This only corrupts with certain modules (not the
  101. original test module...) and was never spotted until I changed my test
  102. module, and MungWall complained. Now I have added 8 bytes of BSS at the end
  103. of the module to fix it.
  104.  
  105. Picture shower fouled up because it was taking the byte width of the
  106. picture data to be the same as the byte width of the screen, so a picture
  107. would only show if it was a multiple of 64 pixels wide. (for AGA, 16 for
  108. ECS.) I had previously thought this was a problem with packilbm.library.
  109.  
  110. Music player had the classic DBRA DMA-wait which fails on fast processors.
  111. Instead, it uses VHPOS to wait a few scanlines. Now should work on
  112. anything.
  113.  
  114. Sometimes the palette for a picture would be fouled up. Caused by sign
  115. extension of palette values, so blue clobbered green clobbered red.
  116.  
  117. This version has been tested with MungWall and Enforcer, and has no hits.
  118. There is no memory loss on exit. So there.
  119.  
  120. This now seems to be a reliable fully working version. Now watch me muck it
  121. up for version 2.1...
  122.