home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / DEE-DR14.LHA / DynaRipV1.14 / DYNA_RIP_V1.14.DOC next >
Encoding:
Text File  |  1995-11-27  |  9.7 KB  |  297 lines
  1.  
  2. *=-------------------------------------------------------------------------=*
  3.  
  4.                           >> Dyna Rip V1.14 <<
  5.  
  6.                  Designed & Developed by: Kevin Picone 
  7.             
  8.                        V1.14 Released 27,11,1995
  9.  
  10.             © Copyright Kevin Picone 1995 of Underware Design
  11.  
  12.                           All Rights Reserved.
  13.  
  14. *=-------------------------------------------------------------------------=*
  15.  
  16.                     >> Contents of This Doc File <<
  17.  
  18.  
  19.                     * Firstly, What is Underware Design ?:
  20.  
  21.                     * Disclaimer:
  22.  
  23.                     * What is DYNA RIP:
  24.  
  25.                     * How do I use DYNA RIP:
  26.  
  27.                     * What are DYNA RIPS New Features:
  28.  
  29.                     * Format Information:
  30.  
  31.                     * Foreseeable Problems:
  32.  
  33.                     * Release And Contact Information:
  34.  
  35.                     * The Future of DYNA RIP:
  36.  
  37.                     * Some Underware Design Hello's:
  38.  
  39.                     * Other Stuff
  40.  
  41.  
  42.  
  43.  
  44.  Firstly, What is Underware Design ?
  45.  ===================================
  46.  
  47.         Underware Design is a (slowly) forming Amiga Only software
  48.  development house, based here in Australia.
  49.  
  50.         The name comes simply from a mixture of a common references to
  51.  Australia global location, most notably "DownUNDER" and our interests
  52.  in software development.  Hence 'Underware Design' seemed pretty logical
  53.  and just a little more interesting ( grin ) than some of other originally
  54.  proposed titles.
  55.  
  56.  
  57.  
  58.  Disclaimer:
  59.  ===========
  60.  
  61.     I take no responsibility for any damage caused as either, a direct
  62.  or indirect result of using this software, this includes but is not solely
  63.  limited too, loss of data, time,  etc etc etc.  Hence, you are using this
  64.  product entirely at your risk.
  65.  
  66.         Execution of the included 'Dyna Rip V1.14' program implies your
  67.  in agreement with this document.
  68.  
  69.  
  70.  
  71.  What Is Dyna Rip:
  72.  =================
  73.  
  74.     Dyna Rip is really just a useful programmers conversion tool, which
  75.  handles the removal of Dynamic Colour Palettes from AMIGA Dynamic IFF
  76.  Pictures.  Quite Handy for Game for and Demo development.
  77.  
  78.     It will convert the colour table into either direct Copper List
  79.  Source, or just plain Source Code Data, Allowing programmers to include
  80.  the data directly into there own masterpieces. !!!
  81.  
  82.     Well, that's it, that's all it does.
  83.  
  84.  
  85.  
  86.  How do I use DYNA RIP:  (Walk Through)
  87.  ======================
  88.  
  89.     > Load DYNA RIP V1.14
  90.  
  91.     > Select LOAD DYNAMIC IFF
  92.  
  93.     > A file requester should now appear for you to select the required
  94.       Dynamic IFF Picture file for conversion.
  95.  
  96.     > Now Select the 'Rip & Save Palette' Button.
  97.  
  98.     > A Percentage bar will now appear, as the program scans the
  99.       selected file for the location of the dynamic colour information.
  100.  
  101.     > if no DYNAMIC IFF information is found, the process is automatically
  102.           aborted. 
  103.  
  104.     > if the scanning process was indeed successful and the DYNAMIC IFF
  105.           information was located, now you'll be asked to select and output
  106.           file name for the converted palette, Via a file requester.
  107.  
  108.   Please Note: Selecting Cancel in this SAVE requester will also abort the
  109.                procedure ! )
  110.  
  111.     > Now, a second percentage bar will appear as the data is being
  112.           converted and saved to your selected PATH and FILENAME.
  113.  
  114.     > When the file is finally converted Dyna Rip will return you to
  115.           the main menu.
  116.  
  117.     > Process Complete.
  118.  
  119.  
  120.  
  121.  
  122.  What are Dyna Rips New features:
  123.  ================================
  124.  
  125.         Quick Exit, you quit out directly from the program via pressing
  126.  'Q' on the keyboard within the main menu.
  127.  
  128.         Also, In this revision, I've added two menu options to help in the
  129.  conversion/removal of the dynamic IFF data.
  130.  
  131.         "Include Colour Zero" (yes/no)
  132.  
  133.                       This option allows you to select if the Colour
  134.  $DFF180 (colour zero /backdrop colour) should be either included within
  135.  the outputed data or copper list.
  136.  
  137.  
  138.         "Colours Per Line" (1-16)
  139.  
  140.                       This just allows you too crop unused or unwanted 
  141.  colours from your outputed data or copper list source.  The Number of
  142.  colours as always starts at $dff180 and increases upwards, with
  143.  an upper limit of 16 colours per line.
  144.  
  145.  
  146.         Also, While saving, I've now added a 'File Exists' requester if you
  147.  should select to over write an existing file, then at least now your giving
  148.  the chance to abort the process without any loss of data.
  149.  
  150.  
  151.  
  152.  Format Information:
  153.  ===================
  154.  
  155.     Dyna Rip at present, Assumes that the dynamic colour palette data
  156.  located within the IFF is always setup as 16 Colours Per scan line. I've
  157.  not actually seen any that were not, but that's not to say that it's not
  158.  possible. (I've never actually seen a proper dynamic IFF file structure)
  159.  
  160.     The outputed source file, is setup so that each colour is set
  161.  each line, all 16 colours are set in 2 lines of source code. This
  162.  enables easy handling within your source code editor, be it, for example
  163.  SEKA / ASMONE etc etc.. 
  164.  
  165.  
  166.     E.g. COPPER LIST output !
  167.  
  168. Dynam_Wait=$0
  169.  
  170.  Dc.w ((Dynam_Wait+$0)*$100)+$DF,$fffe
  171.  Dc.w $180,$0,$182,$555,$184,$111,$186,$2,$188,$333,$18A,$668,$18C,$222,$18E,$444
  172.  Dc.w $190,$232,$192,$666,$194,$121,$196,$233,$198,$1,$19A,$777,$19C,$122,$19E,$545
  173.  
  174.  Dc.w ((Dynam_Wait+$1)*$100)+$DF,$fffe
  175.  Dc.w $180,$0,$182,$555,$184,$111,$186,$2,$188,$333,$18A,$668,$18C,$222,$18E,$444
  176.  Dc.w $190,$232,$192,$666,$194,$121,$196,$233,$198,$1,$19A,$777,$19C,$122,$19E,$545
  177.  
  178.  Dc.w ((Dynam_Wait+$2)*$100)+$DF,$fffe
  179.  Dc.w $180,$0,$182,$555,$184,$111,$186,$2,$188,$333,$18A,$656,$18C,$222,$18E,$444
  180.  Dc.w $190,$232,$192,$434,$194,$121,$196,$233,$198,$1,$19A,$545,$19C,$667,$19E,$556
  181.  
  182.  and so on.
  183.  
  184.  
  185.     As you can see I've tried to make it as easy to use as possible, 
  186.  by allowing you to set the starting scan line of the dynamic display.
  187.  
  188.  
  189.         In DATA output mode only the colour data is saved, so you'll have to
  190.  build your own Dynamic Copper list and hit the palettes in as your wish.
  191.  
  192.  
  193.  
  194.  Foreseeable Problems:
  195.  ====================
  196.  
  197.     Unfortunately, Dyna Rip V1.14 has some unsupported features
  198.  that you should be made aware of.
  199.         
  200.     > The Outputed copper source for displays that cross the NTSC line
  201.       will have incorrect copper waits. I could have fixed this via
  202.           allowing you to select within Dyna Rip, the pictures top/starting
  203.           scan line, but it didn't seem worth including, Sorry.
  204.  
  205.     > Make sure when using Dynamic HIRES displays that you cut the
  206.       display back to 640-16 pixels wide, as other wise you may have
  207.           some problems with the copper not having enough time to refresh
  208.           all 16 registers at the end of each scanline. (this is not Dyna
  209.           Rip's fault anyway)
  210.  
  211.     > When Converting INTERLACED dynamic IFF's you should be aware that
  212.       Dyna rip will *NOT* CREATE two separate copper lists, it will
  213.           simply create one overall list. Thus, you will need to split the
  214.           outputed copper into the even and odd palettes by hand! SORRY,
  215.           but I wrote this util for just lowres displays (320*256pal),
  216.           INTERLACE never actually crossed my mind.
  217.  
  218.  
  219.  
  220.  Release & Contact Information:
  221.  ==============================
  222.  
  223.     This release is FREE WARE, this means that you may freely
  224.  distribute DYNA RIP V1.14 as much as you like, via any media you see fit,
  225.  be it via, Diskette, Modem, FTP, Whatever!. But, I hence retain all
  226.  respective copyrights to this program and it's related documentation.
  227.  
  228.            There are only two restrictions upon DYNA RIP V1.14's release,
  229.  firstly, all the files included within the original archive are to be
  230.  included in full, and remain unedited.  Secondly, since this is meant to
  231.  be a FREE WARE release, anybody, that makes this program commercially
  232.  available ( apart from it's inclusion upon CDROM compilations, where
  233.  there are no limitations, such as, but not limited too cdrom products
  234.  like AMINET or The Fish CD's ), should only set it's price so that it
  235.  covers their media costs plus the related postage and handling costs,
  236.  and should *NOT* exceed 5$ Australian. ( or the equivalent in your native
  237.  currency. )
  238.  
  239.  
  240.          To contact UNDERWARE DESIGN about DYNA RIP Bug Reports or
  241.                        update information write to:
  242.  
  243.                             Mr. Kevin Picone
  244.                             74 Springs Road
  245.                             RSD M539 
  246.                             BALLARAT VIC.  
  247.                             AUSTRALIA 3352
  248.  
  249.         
  250.                    Email: uwdesign&lin.cbl.com.au
  251.  
  252.                  Fidonet: "Kevin Picone"  3:637/101.2
  253.  
  254.                 Amiganet: "Kevin Picone"  40:300/101.2
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  The Future of DYNA RIP ?
  262.  ========================
  263.  
  264.         Well, I'd say this will be the final revision of this little util,
  265.  apart from any other possible bug fixes or perhaps any major format
  266.  additions.
  267.  
  268.  
  269.  Some Underware Design Hello's
  270.  =============================
  271.  
  272.         Ben Hemming, Lars Jensen, Steven Sheedy & Anne, Chris McCallum,
  273.  Graeme Cooper, Marcus Mroczkowski, Steven Walsh, Andrew Muller,
  274.  Chris leathley, Daniel Martin, Michelle, Safron, DIGI SOFT, Full Moon
  275.  and all at Ballarat Amiga Users Group.
  276.  
  277.  
  278.  
  279.  OTHER STUFF:
  280.  ============
  281.  
  282.  
  283.         If your wondering why make this tool ?, well, like a lot of small
  284.  projects 'Dyna Rip's' need became rather obvious during the development
  285.  of a Shoot'em up game project we were doing, titled "Thesius XII" ( it's
  286.  on Aminet/ Game/shoot/TXIIv96.lha ).  Within this project, I had selected
  287.  to use small dynamic pictures within it's (just for show) terminal briefing
  288.  section.  Unfortunately, I couldn't find anything that actually did what
  289.  I wanted already, hence, this is what I made.
  290.  
  291.         So I hope it comes of some use to you.
  292.  
  293.  
  294. *=-------------------------------------------------------------------------=*
  295.                              >> End of Text << 
  296. *=-------------------------------------------------------------------------=*
  297.