home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_c / bi.lzh / BI / BI.DOCS < prev    next >
Encoding:
Text File  |  1991-08-16  |  3.5 KB  |  68 lines
  1. >>>  BI 1.3 ©1990 by Terry W. Gintz <<<
  2.  
  3. BI is a brush-to-image 'C' code generator intended to be used from CLI.
  4. Any IFF ILBM or brush file may be loaded (except HAM) and converted to 'C'
  5. code for use as a gadget image, etc.  BI will display the image in low or
  6. high resolution, hi-res interlaced, and 672X432 overscan mode.
  7. BI 1.3 adds support for Basic programmers.
  8.  
  9. About the menus:
  10.  
  11. The project menu:
  12.  
  13.    "Load Image" loads any ILBM IFF file up to the size of the current
  14. screen, and converts it to an image that is displayed on the main drawing
  15. window.  A requester will ask the user to label the image, and any generated
  16. code will use that label for the Image structure and USHORT data.  BI
  17. displays the image using the colormap from the loaded file, but all menu and
  18. requester operations are performed with the default system palette.  All
  19. bitplanes in the image file are loaded (even if in hi-res screen mode.)
  20. You can flip between resolutions with the screen menu, and
  21. BI will display the fifth bitplane (if the image was lo-res and had
  22. five bitplanes when loaded) when the image is drawn on a lo-res screen.
  23. The code generated will contain as many bitplanes as the original IFF
  24. file, up to the depth limit of the current screen.  If the image is too
  25. large to display on the screen selected, a blank window will appear when
  26. you switch resolutions, but the image is retained in memory.
  27.  
  28.    "Load IFF" loads any ILBM IFF file up to 672 pixels wide by 432 rows
  29. high, and displays the file in the lowest resolution required.  The screen
  30. menu is disabled at this time, but resolution is checked.  You then choose
  31. "Make Image" to cut out an image (up to the screen-size limit), by clicking twice
  32. with the left mouse button to define the image at its rectangular corners.
  33. The size of the image is shown at the bottom of the screen, after clicking
  34. the first time.  The numbers are continuously updated as the mouse pointer is
  35. moved around, until the image has been fixed by clicking again.
  36. The image is then displayed at the current resolution, and the screen menu
  37. is enabled for changing resolution, if desired.  A requester will ask for a
  38. label for the new image, as in the "Load Image" option.
  39. "Make Image" uses only those bitplanes that were present in the
  40. original IFF file, up to the depth limit of the current screen.
  41.  
  42. "Generate 'C' Code"  writes the 'C' code to a file (via a file requester).
  43. First, the color palette for the image is written, then 
  44. both the Image structure and its associated ImageData are written.
  45.  
  46. "Generate 'Basic' Code writes the PALETTE statements and DATA statements
  47. that allow the basic programmer to PUT the images on the output window.  You
  48. must first READ the data into an array.  The number of elements in the
  49. integer array must be at least (3 + int(width of the image in pixels+16)/16)
  50. *(height of image in rows)*(depth of image)). A sample basic file is
  51. provided to illustrate the use of the basic file created by BI.
  52.  
  53. Choose "Quit" to exit BI.
  54.  
  55. The Screen menu allows you to see the image in resolutions other than lo-res,
  56. to determine the effects of screen aspect (pixel width vs height) on the
  57. image, when the image will be used in hi-res applications.
  58.  
  59. Any questions, comments or donations for this program should be addressed to:
  60.  
  61.    Terry W. Gintz
  62.    4237 Marcum Lane
  63.    Eugene, Or 97402
  64.  
  65. A $20 donation for BI gets you the docs to all my current programs
  66. (including those not in the Fred Fish collection), a choice of any of them
  67. at $5 off the suggested price, and update privileges for $10.
  68.