home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / programming / assembler / thesource / volume4 / utilities / copdis.lha / copdis.readme < prev    next >
Encoding:
Text File  |  1993-02-26  |  1.7 KB  |  52 lines
  1.  
  2.                            COPDIS
  3.                            ======
  4.  
  5.         A Copper Disassembler for Workbench copperlists
  6.         -----------------------------------------------
  7.  
  8. CopDis is freely distributable, but copyrighted by Almathera
  9. Systems Ltd © 1993. All Rights Reserved, except where mentioned.
  10. This file may be included in any public domain collection/library,
  11. but may not be sold as part of a commercial product (excepting
  12. PD collections on CD-ROM or other mass-storage media)
  13.  
  14. ---------------------------------------
  15.  
  16. How to run:
  17.  
  18. Type COPDIS from the CLI/Shell. CopDis does not work from an
  19. Icon. You may specify an optional output device/file by the
  20. standard redirection syntax ( copdis >prt: for example)
  21.  
  22.  
  23. What does it do?
  24.  
  25. Have you ever needed to look at how a workbench copperlist is
  26. built up?
  27.  
  28. Well, I was intrigued at how the copperlists for 'odd' screenmodes
  29. (Super72, A2024, etc) were built up, so I decided to write a copperlist
  30. disassembler.
  31.  
  32. It scans the GfxBase->CopInit, and then follows this through to the
  33. main copperlist disassembling as it goes. Currently it does not
  34. support copper branching, except for the branch at the end of the copinit
  35. structure.
  36.  
  37. It supports all standard Amiga registers, the ECS registers and the
  38. new AGA chipset registers, so now you can see how all those weird
  39. DblPal modes really work.
  40.  
  41. Warning!
  42. --------
  43.  
  44. Do not make any assumptions in your code about the information
  45. returned by this program. Copperlists vary widely from machine to
  46. machine, and poking them *will* fail on other Amiga versions. Also
  47. beware, AGA registers *WILL* change on future Amigas. Do not use
  48. AGA registers unless you are 100% sure you are running on an Amiga
  49. 1200 or 4000.
  50.  
  51.  
  52. Written by Jolyon Ralph - jralph@cix.compulink.co.uk