home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / coders / agraconv / agraconv.doc < prev    next >
Text File  |  1980-01-10  |  6KB  |  142 lines
  1. AGRACONV 1.0                                                   AGRACONV 1.0
  2.  
  3. AGRACONV  was  written for the progammers and for those who need to convert
  4. some  graphics from IFF to the standard format for the Amiga hardware:  the
  5. RAW  mode.   I  started  to  write  this  program because there are no very
  6. friendly converter for the Amiga.  The most powerful one was the KefrensIFF
  7. converter, but it is very old and currently (with new Amiga's) it's no more
  8. very reliable, can't manage any resolutions except 320x256 and of course it
  9. doesn't  support  AGA  display  modes...  AGRACONV tries to replace the old
  10. KefrensIFF Converter, reproducing all the original features and adding many
  11. exciting new options.
  12.  
  13.  
  14. SYSTEM REQUIREMENTS
  15.  
  16. This  Agraconv  release  requires  AmigaOS  2.0  (v36)  or  higher  to work
  17. properly, but it fully supports the OS 3.0.  Warning, no check is performed
  18. by  AGRACONV  to ensure that the user loaded a picture "displayable" on the
  19. in use Amiga (it could have a non AGA chipset!).
  20.  
  21.   Some libraries are required:
  22.  
  23. - reqtools.library v37 (or higher)
  24. - iff.library v22 (or higher)
  25. - iffparse.library v37 (or higher)
  26.  
  27.  
  28. HOW IT WORKS
  29.  
  30. Just  after  starting  the program, a little info window will be displayed.
  31. Clicking  the 'OK' gadget the screen will become grey and Agraconv is ready
  32. to  be  used.   Bringing  the  pointer  to the upper line of the screen and
  33. pressing  the  right  mouse button will display the menu strip (see above).
  34. Pressing  the  left  mouse  button anywhere in the screen will activate the
  35. picture  framing.   The  framed  picture  will  be  saved  using the Saving
  36. options.  Pressing the right mouse button anywhere else than the top of the
  37. screen will open a little info window containing:
  38.  
  39. a)  The current pointer coordinates (X and Y).
  40.  
  41. b)  The width and the height of the current framed picture (W and H).
  42.  
  43. c)  The  memory size of a single plane of the framed picture and the memory
  44. size of all the planes of the framed picture.
  45.  
  46. d)  The  number  of  the planes displayed (this is the number of the frames
  47. that will be saved too).
  48.  
  49. It  is possible to keep pressed simultaneously the right and the left mouse
  50. buttons to frame the picture and showing the info window.  However the info
  51. window  will  vanish  during  the  mouse  movements  and will be back again
  52. leaving  still  the pointer for 1/20 of a second.  Pressing the "+" key the
  53. number  of  bitplanes shown will be increased, pressing the "-" key it will
  54. be decreased.
  55.  
  56.  
  57. THE MENU STRIP
  58.  
  59. There  follows the step-by-step explanation of available menu strips.  They
  60. are specified as "Menu Title -> Item -> Sub-Item".
  61.  
  62. Project->Open  (shortcut Amiga + O) - Shows a file requester you can use to
  63. load  a  picture.   If this is a standard IFF ILBM file, and it has no more
  64. than  8  bitplane,  it  will  be  loaded  immediately.  If the file type is
  65. unknown  it  has  to  be  loaded  as  RAW  image and you have to select the
  66. video-mode.
  67.  
  68. Project->Save As->RAW (shortcut Amiga + R) - Shows a file requester you can
  69. use to save your framed picture as RAW bitmap file.
  70.  
  71. Project->Save  As->BLTRAW (shortcut Amiga + B) - Shows a file requester you
  72. can use to save your framed picture as BLTRAW (interleaved bitmap) file.
  73.  
  74. Project->Save  As->RAW  MASK  (shortcut Amiga + M) - Shows a file requester
  75. you can use to save your framed picture as RAW MASK file (all bitplanes are
  76. OR'ed together and the resulting outline is a single RAW bitplane).
  77.  
  78. Project->Save  As->SPRITE  4  (shortcut Amiga + 4) - Shows a file requester
  79. you  can  use  to  save  your  framed  picture  as  4  colour  sprite(s) in
  80. assembly-source  mode.   N  sprite  structures  will be created, where N is
  81. [framed image width]/16.
  82.  
  83. Project->Save  As->SPRITE  16 (shortcut Amiga + S) - Shows a file requester
  84. you  can  use  to  save  your  framed  picture  as  16  colour sprite(s) in
  85. assembly-source  mode.   N  sprite  structures  will be created, where N is
  86. [framed image width]/16.
  87.  
  88. Project->Save As->IFF (shortcut Amiga + I) - Shows a file requester you can
  89. use  to  save  your  framed  picture  as  standard IFF-ILBM file (using the
  90. byterun1 compression mode).
  91.  
  92. Project->Palette->Save  As  SOURCE (shortcut Amiga + C) - Saves the palette
  93. in  assembly-source  format (Copper codes).  Remember:  you have to set the
  94. "AGA Palette" item to save a full 24 bit palette.
  95.  
  96. Project->Palette->Save As RAW - Saves the palette as simply RGB values.
  97.  
  98. Project->Palette->Save As IFF - Saves the palette as standard ILBM CMAP (EA
  99. Deluxe Paint compatible).
  100.  
  101. Project->Palette->Load IFF - Load a standard ILBM CMAP palette (EA Deluxe
  102. Paint compatible).
  103.  
  104. Project->About - Shows some informations.
  105.  
  106. Project->Quit (shortcut Amiga + Q) - Quits AGRACONV.
  107.  
  108. Prefs->Grid - Turn on the grid on every sixteenth pixel of the frame box.
  109.  
  110. Prefs->AGA Palette - Turn on the 24 bit palette support.
  111.  
  112. Prefs->WB Requesters (shortcut Amiga + W) - Redirects all requester to the
  113. Workbench screen. If the AGRACONV screen is smaller than 200x200 this flag
  114. will be automatically set.
  115.  
  116. NOTE: Any other menu item have to be ignored from user.
  117.  
  118.  
  119. MANY THANKS TO...
  120.  
  121. Wouter von Oortmerssen for the Amiga E compiler v2.1b.
  122. Marco Lizza for the betatest and the AmigaGuide(tm) docs.
  123. Francesco Simula for the betatest and the betatips.
  124.  
  125.  
  126. Suggestions and bug reports are welcomed. Write to:
  127.  
  128. FIDONET:  Fabrizio Farenga 2:335/332.31
  129.  
  130. E-MAIL:   f.farenga@agora.stm.it
  131.  
  132.  
  133. Holodream Software
  134. Fabrizio Farenga
  135. Via C. De Fabritiis, 55
  136. I-00136
  137. Roma, ITALY
  138.  
  139. END_OF_FILE
  140.  
  141. $VER: AGRACONV.DOC v1.0 (17.12.94) by Fabrizio Farenga
  142.