home *** CD-ROM | disk | FTP | other *** search
/ Global Amiga Experience / globalamigaexperience.iso / graphic / utilities / pegger / pegger_demo_doc < prev    next >
Text File  |  1995-07-10  |  13KB  |  288 lines

  1.  
  2.                   PEGGER 2.0 Demo Documentation
  3.  
  4.     PEGGER is Copyright © 1993,1994, Express-Way Software, Inc.
  5.  
  6.     Published by:  DKB Software, Inc.
  7.  
  8.  
  9. 1.  What is PEGGER?
  10.  
  11.    Welcome to the PEGGER 2.0 Demo.  PEGGER is a utility to help save
  12. Amiga graphic animators and artists hard disk space and to give all
  13. your graphic programs the ability to load and save JPEG files 
  14. automatically.
  15.  
  16.    JPEG is a method of image compression that can reduce the size of
  17. a 24-bit image file by 15 to 1 with no noticeable loss in the quality
  18. of the image.  A 24-bit image file normally takes up to 1MB of disk
  19. space but JPEG'd it only takes 50 to 70K!
  20.  
  21.    PEGGER supports a number of popular Amiga file formats including:
  22.  
  23.    color JPEG
  24.    grayscale JPEG
  25.    IFF24
  26.    HAM8
  27.    color IFF8
  28.    grayscale IFF8 (often used for Alpha channel data)
  29.    DCTV 3 and 4 bit
  30.    Video Toaster FrameStore and CG Pages
  31.    Impulse RGB8
  32.    Targa
  33.  
  34.    PEGGER is fast, on an Amiga 4000 it only adds 5 seconds to the
  35. time it takes to load a 752 by 480 JPEG file as an IFF 24-bit file.
  36. Network support has been added and tested with Parnet, Enlan DFS,
  37. and Novell.
  38.  
  39.  
  40. 2.  Ordering information.
  41.  
  42.    PEGGER has a list price of DM 148.00 and is available from
  43. Hirsch & Wolf oHG, Mittelstr.33, D 56564 Neuwied, +49 2631 83990 (voice) 
  44. +49 2631 839931 (fax)
  45.  
  46.    PEGGER 2.0 started
  47. shipping in August 1994.  DKB Software is offering a
  48. limited introductory price of only $59.95 US plus S&H for PEGGER 2.0.
  49. Registered PEGGER owners can purchase the 2.0 upgraded for $15 US
  50. plus S&H.
  51.  
  52.    For more information please contact:
  53.  
  54.                    DKB Software, Inc.
  55.                    PO Box 438
  56.                    Wixom, MI 48393
  57.                    USA
  58.                    (810) 348-3755 (voice) (810) 348-3531 (fax)
  59.  
  60.  
  61.    Internet: pegger@express-way.com
  62.  
  63. 3.  About the PEGGER demo.
  64.  
  65.    The PEGGER demo is a fully functioning version of PEGGER with the
  66. following exceptions.  Any image PEGGER converts will have the PEGGER
  67. logo stamped into the center of the image.  Due to this, PEGGER will
  68. not allow you to use PEGGER to REPLACE any images that PEGGER converts.
  69. Also, the PEGGER "About window" has additional information in it about
  70. the demo and ordering PEGGER.  We will not try to provide complete
  71. documentation on how to use PEGGER.  Instead, we have included the
  72. text of several tutorials from the PEGGER manual.  These tutorials
  73. should help you become familiar with how PEGGER works.  The tutorials
  74. will use the JPEG files found in the TutorialFiles sub-directory
  75. of the PEGGER_Demo directory.
  76.  
  77.  
  78. 4.  Installing the PEGGER demo
  79.  
  80.    PEGGER requires an Amiga with AmigaDOS 2.0 or greater, a hard
  81. disk, and a minimum of 2 megabytes of RAM.
  82.  
  83.    PEGGER uses the standard Installer program provided by Commodore.
  84. PEGGER must be installed on your hard drive to run properly.  An
  85. Installer script is included in the PEGGER_Demo directory and its icon
  86. is named "Install PEGGER".  The installation is started by clicking
  87. on the "Install PEGGER" icon.  Three libraries will be installed
  88. in your LIBS: directory; pegger.library, peggersnoop.library, and
  89. the dctv.library.  And the installer will create some PEGGER data
  90. files in the PEGGER_Demo directory.
  91.  
  92.  
  93. 5.  Starting PEGGER
  94.  
  95.    Once PEGGER has been installed, you can start PEGGER by double-
  96. clicking on its icon.  PEGGER will open an "About window" with the
  97. PEGGER logo animation and information about PEGGER.  Just click
  98. on the close button of the "About Window" to continue.  Now PEGGER
  99. will open up all its windows; CJPEG, DJPEG, and SNOOP.  The CJPEG
  100. window is used for setting up image files to be JPEG compressed,
  101. the DJPEG window is used for setting up image files to be JPEG
  102. decompressed, and the SNOOP window is used to setup PEGGER to
  103. automatically JPEG compress or decompress files for other Amiga
  104. software running in the background.  These windows can be opened
  105. up by selecting their respective Menu Item from the Workbench
  106. Tools Menu or double clicking on their respective App Icons on
  107. your Workbench.
  108.  
  109.  
  110. 6.  JPEG Decompression of a single file.
  111.  
  112.    Open the DJPEG window.  Make sure the cycle gadgets in the
  113. upper center of the window say {Files} and {Create}.  In the area
  114. labeled "JPEG File to Decompress", click the {From} button to open
  115. a file requester, then select the Tutorial_1.JPG file from the
  116. TutorialFiles sub-directory.
  117.  
  118.    In the area labeled "Directory where Image Files go", select the
  119. type of image file you want to create using the cycle gadget on
  120. the far right.  Now click on the {To} button to open a directory
  121. requester and select the Images sub-directory as the directory
  122. where you want PEGGER to put the decompressed file.  PEGGER can
  123. rename files it creates for you.  Using rename you can give files
  124. a file name extension to indicate what type of file it is.  If
  125. you are creating a 24-bit IFF image you could use the extension
  126. .24, for HAM8 it could be .HAM8, for DCTV it could be .DCTV, etc.
  127. Now click on the {Rename} check box so that it is checked.  In the
  128. text gadget to the left of the Rename check box enter
  129. <all>.{your ext}, such as <all>.HAM8.
  130.  
  131.    You are now ready to begin decompressing the file.  Click on
  132. the {Decompress} button.  If there is a problem with your settings
  133. a requester will notify you of the problem and the decompression
  134. won't start.  Check your settings and try {Decompress} again.
  135. Once JPEG decompression of the file has started you will notice
  136. that a status box at the top of the window will say "Decompressing"
  137. and a small indicator box next to it will flash.  PEGGER does
  138. all of its JPEG processing in the background.  So, while this file
  139. is being decompressed you could set up additional files to be
  140. decompressed or compressed.  PEGGER keeps track of all the files
  141. you want it to decompress.  To view the status of file decompression
  142. click on the {Status} button to switch to the DJPEG Status window.
  143. To return back to the DJPEG setup window click on the {Setup} button
  144. on the DJPEG Status window.
  145.  
  146.    Switch back to the DJPEG Setup window and wait for the status
  147. to change from "Decompressing" to "Idle."
  148.  
  149.  
  150. 7.  JPEG Decompression of a batch of files in a directory.
  151.  
  152.    Open the DJPEG Setup window.  Make sure the cycle gadgets in the
  153. upper center of the window say {Batch Dir} and {Create}.  In the area
  154. labeled "JPEG File to Decompress", click the {From} button to open a
  155. directory requester, then select the TutorialFiles sub-directory.
  156.  
  157.    In the area labeled "Directory" where Image Files go, select the
  158. type of image file you want to create using the cycle gadget on
  159. the far right.  Now click on the {To} button to open a directory
  160. requester and select the Images sub-directory as the directory
  161. where you want PEGGER to put the decompressed files.  It is important
  162. to note that the directory requester will not show any filenames; only
  163. the directories available.  PEGGER can rename files it creates for you.
  164. Using rename you can give files a file name extension to indicate what
  165. type of file it is.  If you are creating a 24-bit IFF image you could
  166. use the extension .24, for HAM8 it could be .HAM8, for DCTV it could
  167. be .DCTV, etc. Now click on the {Rename} check box so that it is checked.
  168. In the text gadget to the left of the {Rename} check box enter
  169. <all>.{your ext}, such as <all>.HAM8.
  170.  
  171.    Click on the {Decompress} button.  This will bring up the Decompression
  172. Batch Directory window.  You will see a display of your selections for
  173. decompressing JPEG files in this directory.  The directory will be
  174. scanned and information about all the JPEG files found will be listed
  175. in the window.  Once PEGGER has found all the JPEG files, click on {OK}
  176. to start the decompression and return to the DJPEG Setup window.  You
  177. may want to use the {Status} button to switch to the DJPEG Status window
  178. to follow PEGGERs progress while it decompresses the files.  Or close
  179. the DJPEG Window and go on to the next tutorial.
  180.  
  181. 8.  JPEG Compression of a single file.
  182.  
  183. NOTE:  This tutorial requires that the Image files created from
  184. the previous tutorial be present in the Images sub-directory of
  185. the PEGGER_Demo directory.
  186.  
  187.    For this tutorial we'll start by demonstrating the AppIcon feature
  188. of PEGGER.  Open up the Images drawer in the PEGGER_Demo directory.
  189. You'll find icons there for the image files you created in the
  190. DJPEG tutorials.  Since the original JPEG files you decompressed
  191. earlier had icons, PEGGER made a copy of those icons when it
  192. created the image files.  Drag one of the image icons out of the
  193. drawer and drop it on PEGGER's CJPEG icon.  This will open the
  194. CJPEG Setup window automatically.  If the CJPEG Setup window were
  195. already open, you could just drop the icon for the image right on the
  196. CJPEG window. Or select the icon and then select CJPEG from the
  197. Workbench Tools Menu.
  198.  
  199.    Click on the {Next} button if the image file you chose to compress
  200. is not displayed in the text gadget in the "Image File to Compress"
  201. area of the window.
  202.  
  203.    Make sure the cycle gadgets in the upper center of the window say
  204. {Files} and {Create}.   Normally you would want to replace the image file
  205. with the JPEG file PEGGER creates to save hard disk space.  Since this
  206. demo is disabled by stamping every image it processes with the PEGGER
  207. logo, this feature is disabled for the demo.
  208.  
  209.    Click the {To} button to open a directory requester and select the
  210. JPEGs sub-directory.  Now we want to rename the file to have the
  211. extension of .JPG like it did before.  Click on the {Rename} check box
  212. and type <all>.JPG into the text gadget.
  213.  
  214.    Another option you will need to consider is the Quality setting
  215. you want to use when you compress a file.  It can be set from 0 to
  216. 100%.  With 100% producing the highest quality JPEG image file with
  217. the least compression, and 0% producing a poor quality JPEG image
  218. file with the most compression.  PEGGER defaults to using a Quality
  219. setting of 85% which produces JPEG images which rarely have any
  220. noticeable loss in quality, but offer significant compression.
  221.  
  222.    Click on the {Compress} button to start the JPEG Compression.
  223.  
  224.  
  225. 9.  JPEG Compression of a batch of files in a directory.
  226.  
  227. NOTE:  This tutorial requires that the Image files created from
  228. the previous tutorial be present in the Images sub-directory of
  229. the PEGGER_Demo directory.
  230.  
  231.    Batch compression of a directory of image files works just like
  232. batch decompression of JPEG files except for using the Quality
  233. setting instead of selecting the type of image to create.
  234.  
  235.  
  236. 10. SNOOP JPEG Decompression
  237.  
  238.    PEGGER's Snoop function is its most valuable feature and it couldn't
  239. be much easier.  Now that you've learned the other basic features of
  240. PEGGER you can now use Snoop to put them to work for you automatically.
  241. For purposes of the demo we will show you how to use SNOOP by Program.
  242. PEGGER was installed with SNOOP by Program settings for a number of
  243. graphic programs.  Scroll through the list of Programs and select one
  244. that you use.  If you don't see one that you use, start the program
  245. that you would like to test PEGGER with, then click the New button on
  246. the PEGGER Snoop Window and double click on the name of the program
  247. you want to use with PEGGER.  The program you setup for SNOOP could
  248. be the Toaster Switcher, ToasterPaint, DPaint, DCTV, Brilliance, or
  249. any other program you use that loads image files.
  250.  
  251.    The name of the program will be displayed underneath the list and
  252. the gadgets for setting up SNOOP will be enabled.  For this demo we
  253. want to show how PEGGER can allow other programs to load JPEG files.
  254.  
  255.    Now make sure the {Image Compression} check box is not checked and
  256. that the {JPEG Decompression} check box is checked.  Make sure the
  257. {Enable/Disable} cycle gadget is set to Enable.  Finally, select what
  258. type of image file you want PEGGER to create for this program when it
  259. decompresses a JPEG file.  The {Save} button should now be unghosted.
  260. Click the {Save} button to save the SNOOP settings for the selected
  261. program.
  262.  
  263.    To test SNOOP by Program you will need to start the program for
  264. which you setup SNOOP.  In that program try to load one of the
  265. JPEG files in the PEGGER_Demo/TutorialFiles directory.  When your
  266. program tries to load the JPEG file, PEGGER will popup a requester
  267. informing you that it is JPEG decompressing the file for you.  Once
  268. PEGGER is done the requester will go away and your program can load
  269. the JPEG file as the type of image you selected for the SNOOP JPEG
  270. Decompression.  Since this is a demo the JPEG file you load will
  271. have the PEGGER logo stamped in the center of the image.  Please note
  272. that the NewTek Video Toaster Switcher software as well as ToasterPaint
  273. only allow loading images as Framestores which have an exact resolution
  274. of 752 x 480.  ANY IMAGE WHICH DOES NOT HAVE THAT EXACT X AND Y PIXEL
  275. RESOLUTION WILL NOT LOAD INTO EITHER THE SWITCHER OR TOASTERPAINT'S
  276. "LOAD FRAME" MENU OPTION VIA PEGGER'S SNOOP FEATURE!
  277.  
  278. SNOOP by Directory works very similar to SNOOP by Program.
  279.  
  280. 11. SNOOP JPEG Compression
  281.  
  282.    PEGGER can automatically JPEG compress image files saved by
  283. graphic programs.  This feature is of great benefit to animators
  284. who need to create thousands of 24-bit frames for an animation.
  285. A 1000 frame animation saved as 24-bit IFF files would take up
  286. almost a gigabyte of hard disk space, but JPEG'd would only take
  287. up 50-100 megabytes.
  288.