home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / amigalib / d991 / copcoled.lha / CopColEd / CopColEd.doc < prev    next >
Encoding:
Text File  |  1994-04-05  |  10.4 KB  |  273 lines
  1. ·············································································
  2. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3. *****************************************************************************
  4.                       (---------------------------)
  5.                  THE  ( COPPER COLORS EDITOR V1.2 )  MANUAL
  6.                       (---------------------------)
  7. *****************************************************************************
  8. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  9. ·············································································
  10.  
  11.  
  12. RIGHTS: The manual and the program mustn't be changed by anyone who has
  13.         not the permission of the programmer.
  14.  
  15.         You may copy the COPCOL ED! If you use it,you should send 10DM or
  16.         $7 to:
  17.                                 Ludwig Huber
  18.                             Wilhelm-Busch-Weg 14
  19.                                86161 Augsburg
  20.                                   Germany
  21.  
  22.                    The CopColEd may be distributed freely.
  23.    
  24.  
  25. CHANGES FROM V1.0: -new "flicker" mode now built-in
  26.                    -when editing single lines,"UNDO" didn't work in some
  27.                     cases;not anymore
  28.                    -an error requester is now shown if not enough memory
  29.                     was available or the req.library couldn't be found
  30.                    -now you can save to the config a dir to load/save files
  31.                     from
  32. CHANGES FROM V1.1: -now the keyboard is used
  33.                    -new Paint-mode built-in
  34.                    -wrong description: flicker-mode can't simulate exactly
  35.                     a 15bit-color because there is no brighter step to a
  36.                     12bit-color of f.ex. $fff
  37.                                        
  38.  
  39. HOW TO RUN IT
  40. -------------
  41. To run CopCol Ed,you need to have the req.library in your LIBS: dir.
  42. You should find this library on the CopColEd-DISK.
  43. Req.library  was  written  by  Colin  Fox (of Pyramyd Designs) and
  44. Bruce  Dawson  (of  CygnusSoft  Software).Req.library is copyrighted.
  45.  
  46.  
  47. WHAT IS COPCOL ED?
  48. ------------------
  49. CopCol Ed is an editor for colors that can be displayed using the Amiga's
  50. COPPER.The program was made for PROGRAMMERS.
  51.  
  52.  
  53. THE SCREEN
  54. ----------
  55. On the left side,there are most of the gadgets of CopCol Ed,a zoom window
  56. of the selected Line and a display of numbers(S:Topline of right window;
  57. L:selected line;R,G,B:RED,GREEN,BLUE).On the right side of the screen,there
  58. is a window showing the colors as they will probably appear in you program.
  59.  
  60.  
  61. KEYBOARD CONTROL
  62. ----------------
  63. Many Gadgets can also be accessed via the keyboard.Except the Esc,F1,F2 and
  64. the HELP key,the keys correspond to the first character of a gadget's name.
  65.  
  66.  
  67. THE GADGETS
  68. -----------
  69. You select a line in the right window by clicking on it.(use the right
  70. slider to move in the whole colorlist)
  71.  
  72. Use the sliders on the left side to change the color of the selected  Line.
  73.  
  74.  
  75. ABOUT - See this text
  76.  
  77. BINARY/SOURCE - Here you select the type of data to be saved.Data can be
  78.                 saved as binary-data or as Assembler source code.
  79.  
  80. ONLYCOLS/HARDWARE/OWNFTYPE - Here you select the type of data to be loaded
  81.                              or saved.
  82.           ONLYCOLS:always 24bit-color data(dc.b RED,GREEN,BLUE)
  83.           HARDWARE:the data you'll probably want to write to the color
  84.                    register (shape when 24bit-colors are selected:
  85.                       dc.w normal12bit,lower12bits_with_bits_as_usual)
  86.                             (shape when flickering is selected:
  87.     dc.w normal12bit_for_line_x_in_frame0,normal12bit_for_line_x_in_frame1)
  88.           OWNFTYPE:always binary-save;this is useful if you want to load a
  89.                    edited colorlist again(a load restores some settings)
  90.  
  91. LOAD - loads data(with defined type) into the colorlist
  92. SAVE - saves   "   "     "       "   from  "      " 
  93.  
  94. PREFS - LOAD CONFIG - loads the preferences
  95.         SAVE CONFIG - saves the preferences to "S:CopCol_ED.config"
  96.                       To save also a special directory to load/save files
  97.                       from,you have to load a file out of it and then save
  98.                       the config.
  99.  
  100.         NTSC/PAL - changes the screen size for pal/ntsc
  101.         24B-COLS/12B-COLS/FLICKER - Here you select the depth of the colors
  102.                                     to edit.
  103.                        To edit with 24BIT-COLS you need to have AA-CHIPSET.
  104.                     The flicker mode simulates colors with a depth of nearly
  105.                     15bit.This is done by exchanging a color and a brighter
  106.                     color to simulate a color between the two displayed.
  107.                     The disadvantage here is that some colors flicker.I
  108.                     didn't build in a 24bit-flicker option because you
  109.                     wouldn't see a difference to a nonflicker AA-colorlist.
  110.  
  111.         AUTOSET - resets all settings
  112.         SIZE:XXXX - Here you can choose(use left&right mousebutton) the
  113.                     amount of lines to be edited and to be loaded(!).
  114.  
  115. CLRALL - sets all colors to black
  116. SPREAD - sets the colors of the selected line to the line you click after
  117.          the "SPREAD" gadget.You can abort this operation by clicking a
  118.          second time on "SPREAD".
  119. COPY - same as spread,but copies the selected line
  120. UNDO - if you think that your last change in the colorlist was wrong,click
  121.        here
  122.  
  123. PAINT - enters the Paint-Mode.Here,you can edit a Picture of width=40 and
  124.         height=300 with 4096 colors.(8 Lores-Points correspond to 1 point
  125.         here).This strange mode can be done with the copper by just writing
  126.         color after color without waiting between the points in a line.
  127.         Then,to get to the next line,the wait is done as normal.As you see,
  128.         this thing bases on the constant speed of the copper.Up to
  129.         AA-Chipset,the speed of the copper hasn't changed.Hope that the
  130.         newer coppers will have a compatible mode.
  131.  
  132.         12B-COLS/FLICKER - As in normal mode,flickering can also be done
  133.                            here to simulate more colors.
  134.  
  135.         NORM LINE/COPYPOINT... - These are the tools you get to paint with.
  136.                                  The system is:First,you click a point in
  137.                                  the edit-window,then select it's color and
  138.                                  finally use such a tool by clicking with
  139.                                  the right mousebutton on another point.
  140.  
  141.         ZOOM - This de-/activates the zoom where all points are displayed
  142.                twice as big as normal.
  143.  
  144.     LOAD,SAVE - to load/save these pictures.When you start it,you have
  145.                     the choice between:
  146.  
  147.                     BINARY/SOURCE - This only affects HARDWARE saves
  148.  
  149.                     HARDWARE - save the raw data:if flickering is off,a
  150.                      normal word of color data per point is written/loaded;
  151.                      if flickering is on,is saves/loads 2words per flicker-
  152.                      point(the even words for the 1st frame,the odd words
  153.                      for the 2nd frame)
  154.  
  155.                     OWNFTYPE - own format like in normal mode
  156.  
  157.                     24bit-ILBM - Here,you can load/save an 24bit-IFF/ILBM
  158.                                  Picture
  159.  
  160.  
  161. COPPER HARDWARE-PROGRAMMING EXAMPLES
  162. ------------------------------------
  163. - Part of a 12bit-color copperlist:
  164. dc.w $180,$fed  ;move RED:15 GREEN:14 BLUE:13 to color0
  165.  
  166. - Part of a 24bit-color(AA-chipset) copperlist:
  167. dc.w $180,$fed ;<-move RED:240 GREEN:224 BLUE:208 TO color0
  168. dc.w $106,$0200 ;set bit9 in bplcon3: now change lower colorbits
  169. dc.w $180,$123 ;<-move RED:241 GREEN:226 BLUE:211 to color0
  170. dc.w $106,$0000 ;clr bit9 in bplcon3: now change upper colorbits
  171.  
  172. -When displaying a copper-picture from Paint mode,it only works to show
  173.  40 points per line when each line is waited to with an X-value of
  174.  $1f(copper: $3f).Like this wait:
  175. dc.w $XX3f,$fffe ;where XX is the linenumber
  176.     
  177.  
  178. ***Two small Assembler-routines to test whether an Amiga has AA-chipset
  179. ***these two routines may be used&distributed in any way!
  180. ***INPUTS: NONE
  181. ***RESULT: d0.l=0 means no_aa_chipset_present
  182.  
  183. When you have to use hardware registers:
  184. -------------CUT HERE-------------
  185. testifaaispresent:
  186.     move.w $dff07c,d0
  187.     cmp.b #$f8,d0
  188.     bne.s noaachips
  189.     moveq #-1,d0
  190.     rts
  191. noaachips:
  192.     clr.l d0
  193.     rts
  194. -------------CUT HERE-------------
  195.  
  196. When you can use System-routines:
  197. -------------CUT HERE-------------
  198. SetChipRev=-888          ;only V39+
  199. GFXB_AA_ALICE=2
  200. gb_ChipRevBits0=$EC
  201.  
  202. testifaaispresent:    
  203.  
  204.     move.l $4,a6
  205.     lea aatst_graphname,a1
  206.     move.l #39,d0
  207.     jsr -552(A6)
  208.     tst.l d0
  209.     beq aatst_noV39
  210.     move.l d0,aatst_graphbase
  211.     
  212.     move.l aatst_graphbase,a6
  213.     move.l #-1,d0
  214.     jsr setchiprev(A6)    ;this is also done by c:setpatch of WB3.0
  215.         
  216.     move.l aatst_graphbase,a0
  217.     btst #gfxb_aa_alice,gb_chiprevbits0(a0)
  218.     beq aatst_notpresent
  219.     
  220.     move.l $4,a6
  221.     move.l aatst_graphbase,a1
  222.     jsr -414(a6)
  223.     
  224.     moveq.l #-1,d0
  225.     rts
  226. aatst_notpresent:
  227.  
  228.     move.l $4,a6
  229.     move.l aatst_graphbase,a1
  230.     jsr -414(a6)
  231.  
  232. aatst_noV39:
  233.     clr.l d0
  234.     rts
  235.  
  236. aatst_graphname:dc.b 'graphics.library',0
  237.     even
  238. aatst_graphbase:dc.l 0    
  239. -------------CUT HERE-------------
  240.  
  241.  
  242.  
  243. - When programming a flicker-copperlist,you must show different colors in
  244. each frame/screen/picture.You can either do this by setting the new colors
  245. from a vertical blanking interrupt,but so,processor/blitter time would be
  246. wasted.A better solution is to setup two copperlists in chipram (where
  247. the two lists contain different colors).Then,you just have to always set
  248. the address of the next copperlist to run to the copxlc-registers before
  249. ending the copperlists.In this way,there is practically not more time
  250. needed to display a flicker-colorlist than at a normal 12bit-colorlist.
  251. Don't forget how to read such a colorlist that was saved with COPCOLED:
  252. The 1st WORD for the even frames/pictures/screens,the 2nd WORD for the odd
  253. frames/pictures/screens,the 3rd WORD for the even....
  254.  
  255.  
  256.  
  257.  
  258. BUG REPORTS
  259. -----------
  260. If you find bugs in my program,report them to me and don't forget to tell
  261. me the conditions under which something happened(AXXXX,RAM?,68XXX).You can
  262. also write me if something worries you in my programs or if you have new
  263. ideas for improvements.
  264.  
  265.  
  266. ##############################################################################
  267. last changes in manual done on 14.2(FEBRUARY).1994
  268.  _         _   _
  269. ( )       ( )_( )
  270. ( )_   _  (  _  )  _   UUCP: midas@tomtec.abg.sub.org
  271. (___) (_) (_) (_) (_)
  272. The manual was written and COPCOL ED was programmed by Ludwig Huber.
  273. ##############################################################################