home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 420.lha / makec_v2.0 / makec.readme < prev    next >
Encoding:
Text File  |  1990-09-30  |  5.9 KB  |  133 lines
  1. **************************************************************************
  2.  
  3.                                MakeC 2.0
  4.                         
  5. **************************************************************************
  6.  
  7.  
  8. **NOTE:  For some reason as yet unknown to me, this program will NOT work
  9.          properly under WorkBench 1.3.  I will see if I can figure out what
  10.          the trouble is and repair it, but in the meantime, here it is, so
  11.          those of oyu with WorkBench 2.0 can go ahead with it.
  12.  
  13.  
  14.     Well here's the latest incarnation of MakeC, the program that lets you
  15. easily create C source from IFF pictures, brushes, etc., without a lot of
  16. headaches, hassles, or coordinate typing.  There are a lot of changes 
  17. since the last version.  Usage instructions and documentation from version
  18. 1.9 still apply (included below).
  19.  
  20.     Changes since version 1.9:
  21.     
  22.     Bug Fixes (Ack!):
  23.     
  24.         Color palette decoding routine was wrong.  Somehow it still managed
  25.         to come out close enough that I never really noticed.  At any rate,
  26.         colors are now displayed properly.
  27.         
  28.         Problem with the top portion of the picture being displayed being
  29.         hidden behind the screen's title bar has been repaired.
  30.         
  31.         Problem with filename generation has been repaired.  Thanks to 
  32.         Mike Seinz for pointing out and repairing this one.
  33.         
  34.     Enhancements:
  35.     
  36.         MakeC now supports direct display and manipulation of full overscan
  37.         pictures.  Scrolling is still supported for larger-than-screen 
  38.         images.
  39.         
  40.         MakeC's save/close/cancel window has been reworked to give it a 
  41.         look that is more at home under WorkBench 2.0.  It now features
  42.         simulated three-dimensional buttons that "push into" the screen
  43.         when hit. 
  44.                 
  45.         MakeC's output now supports the "chip" keyword to force data into
  46.         chip memory under some compilers.  Check your compiler's
  47.         documentation to see if you can use this or not.  The feature can
  48.         be turned on or off from the command line.
  49.     
  50.             
  51. **************************************************************************
  52.  
  53.                                MakeC 1.9
  54.                                
  55.     This is a program I wrote because I had an IFF picture I wanted to 
  56. use as an image in one of my programs.  I tried a couple of PD iff-to-c
  57. converters, but none of them worked right (gave me garbage).  On top of 
  58. that, all of them expected me to type in x,y coordinates of the area I 
  59. wanted to clip.  Type in coordinates on an Amiga?  What for?
  60.     So anyway, this program is the result of these problems.  It will 
  61. load any IFF picture, even HAM and overscan, and allow you to clip out a 
  62. box to save as C source code.  The image can be written as either image 
  63. structure or bitmap structure by clicking the appropriate gadget at save 
  64. time.
  65.     It only works from the CLI, because most of the time when you're doing 
  66. C programming, you're probably using the CLI anyway.
  67.     This version allows you to scroll around in super-bitmaps by holding 
  68. down the right mouse button and scrolling.  The pointer will change to 
  69. indicate the fact that scrolling is active.  Also note that overscan 
  70. pictures are not displayed in overscan, but in a normal screen, so you 
  71. can't see the overscan area.  (I'm one of these weird types who wants my 
  72. programs to continue to run under WorkBench 2.0 without changing a lot of 
  73. stuff around.)
  74.     So anyway, here it is.  Works like a charm on all the pictures I have 
  75. tested it with. 
  76.      While the picture is displayed,  just draw boxes around the areas to 
  77. save with the left mouse button, and you will get the save/cancel/quit 
  78. window automatically.  When that window appears, you select the desired
  79. ouput format by clicking on the Image or BitMap gadgets. You can save it 
  80. by clicking on the save gadget, while clicking the cancel gadget will 
  81. return you to the picture for clipping another area.  Clicking the quit 
  82. button will end the program.
  83.     Also, while the picture window is active, the following keys are 
  84. available for use:
  85.     
  86.     'b'        sends the screen to the back
  87.     'f'        brings the screen to the front
  88.     'h'        home the picture (scroll back to top left corner)
  89.     'q'        bring up the save/cancel/quit window
  90.     
  91.     This program could obviously double as an IFF viewer.  It includes my 
  92. own IFF reading routines, which are greatly over-simplified and will 
  93. probably only work right with FORM ILBM pictures (no LISTs or CATs).  Also
  94. not that overscan HAM pictures may appear brain-damaged when displayed an 
  95. a normal (non-overscan) way.  However, the image is still correct and the 
  96. source code generated will still work.  It's just due to the way HAM 
  97. handles color generation.
  98.  
  99. IFFInfo
  100.  
  101.     This is a quick little utility written as an aid for MakeC.  It reads 
  102. an IFF picture and tells you what the BitMapHeader says about it -- size,
  103. number of colors, page size, masking and compression, that sort of 
  104. thing.  Pretty handy for figuring out why that 320 X 1500 picture won't 
  105. load into Photon Paint or whatever...    
  106.     
  107.     Note that I do not request any donation for the use of this program, 
  108. however should you feel you need to send something, please feel free to 
  109. do so.  
  110.     This source code is explicitly NOT public domain.  However, it may be 
  111. distributed by any means you so desire as long as all these files remain 
  112. included and no charge is made for such distribution (other than 
  113. reasonable media charges).  The source code may not be included in any 
  114. COMMERCIAL product without my consent.  However, PD and shareware authors 
  115. may feel free to include my routines in their own programs, although I 
  116. would appreciate brief mention if they do so (this is my way of saying 
  117. thanks to those PD authors whose work has helped me out).
  118.     This program was developed using Lattice C v5.05.  It may or may not 
  119. require modification to compile under other environments.  The code is 
  120. pretty heavily commented to make it easy to do so if necessary.
  121.  
  122.  
  123.     Comments, flames, large denomination US currency and hard drives of 
  124. outrageous capacity may be sent to me at the following address:
  125.     
  126.     Robert Kesterson
  127.     6418 30th Street
  128.     Lubbock, TX 79407
  129.     (806)-792-3639 (voice)
  130.     BIX: rkesterson
  131.     
  132.     
  133.