home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 7 / FreshFishVol7.bin / new / gfx / conv / imagestudio / docs / imagestudio.txt < prev    next >
Text File  |  1994-09-12  |  64KB  |  1,910 lines
  1. ImageStudio, shareware image processing and conversion package for the
  2. Amiga.
  3.  
  4.    Copyright (C) 1994 Andy Dean, Graham Dean.
  5.  
  6.    Welcome to ImageStudio, shareware image processing and conversion
  7. package for the Amiga.
  8.  
  9.    This document applies to version 1.0.0, written on 12th September
  10. 1994, Copyright (C) 1994 Andy Dean, Graham Dean.
  11.  
  12. Introduction
  13. ************
  14.  
  15.    This chapter gives a brief introduction into the features offered by
  16. the program.
  17.  
  18. Copyright and Disclaimer
  19. ========================
  20.  
  21.    No guarantee of any kind is given that the programs described in
  22. this document are 100% reliable. You are using this material at your
  23. own risk. The authors *can not* be made responsible for any damage
  24. which is caused by using this program.
  25.  
  26.    The unregistered package is freeware, but still copyright by Andy
  27. Dean and Graham Dean. This means that you can copy it freely as long as
  28. you don't ask for a more than nominal copying fee.
  29.  
  30.    The registered version of the program *may not* be freely
  31. distributed.
  32.  
  33.    Permission is granted to include the unregistered package in
  34. Public-Domain collections, especially in the excellent Fred Fish Amiga
  35. Disk Library (including CD ROM versions of it). The distribution file
  36. may be uploaded to Bulletin Board Systems or FTP servers. If you want
  37. to distribute this program you must use the original distribution
  38. archive ImageStudio-1.0.0.lha.
  39.  
  40.    This program (or parts of it) may not be included or used in
  41. commercial programs unless by written permission from the authors.
  42.  
  43. Machine requirements
  44. ====================
  45.  
  46.    ImageStudio requires the following system to run:
  47.  
  48.    * Workbench 2.04 or above.
  49.  
  50.    * Around 1 megabyte of free memory.
  51.  
  52.    * Several megabytes of free hard disk space.
  53.  
  54.    If ImageStudio is run on an AGA machine (A1200 or A4000), it will
  55. use the new display modes and palette routines to improve the quality
  56. of the internal viewer images.
  57.  
  58. Brief description
  59. =================
  60.  
  61.    ImageStudio is written for the casual graphics user who wishes to
  62. convert or manipulate various graphics formats on a modest Amiga
  63. system. There are several commercial offerings available, however the
  64. casual user is paying a lot of money for many facilities and options
  65. they would probably never use.
  66.  
  67.    Bitmap graphics, by their nature, usually require large amounts of
  68. RAM. One of the main objectives of ImageStudio was to reduce this
  69. burden by utilising virtual memory - most users have more spare hard
  70. disk space than spare RAM.
  71.  
  72.    ImageStudio works with several buffers at any one time (dependant on
  73. how many levels of undo are specified), each of these buffers can hold
  74. either colour-mapped or 24-bit images. For a detailed description of
  75. colour-mapped and 24-bit images, See Image types.
  76.  
  77. List of features
  78. ================
  79.  
  80.    General:
  81.    * Full 24-bit image buffers, with optimizations for colour-mapped
  82.      (palette based) images.
  83.  
  84.    * Up to 100 levels of undo / redo.
  85.  
  86.    * User configurable virtual memory.
  87.  
  88.    * User saveable preferences.
  89.  
  90.    * Operations applicable to the whole image or a selected region.
  91.  
  92.    * Up to 256 greyshade preview window (with optional dither).
  93.  
  94.    * Zoom on preview window.
  95.  
  96.    * Internal / external viewers (external for 3rd party 24-bit
  97.      graphics cards).
  98.  
  99.    * Loading / saving / manipulating of AGA image formats (e.g. 256
  100.      colours, HAM8) on non-AGA machines.
  101.  
  102.    * Max image size of 32000 x 32000 (limited to 250 x 250 in the
  103.      unregistered version).
  104.  
  105.    * Copy / paste to / from the system clipboard.
  106.  
  107.    * Runs on all Workbench 2.04+ Amiga's - utilises AGA chipset if
  108.      available.
  109.  
  110.    * On disk AmigaGuide and ASCII text documentation.
  111.  
  112.    * Multi-level help error requesters.
  113.  
  114.    * Standard Workbench2 interface.
  115.  
  116.    * Public screen.
  117.  
  118.    * Requires no third party libraries or utilities.
  119.  
  120.    Import:
  121.    * IFF-ILBM formats (Standard palette based, HAM6, HAM8, extra
  122.      halfbright, ILBM24)
  123.  
  124.    * BMP
  125.  
  126.    * GIF (conforming to GIF87a)
  127.  
  128.    * JPEG (conforming to JFIF standard)
  129.  
  130.    * PCX
  131.  
  132.    * Targa
  133.  
  134.    * Any installed Amiga datatype (with Workbench 2.1+)
  135.  
  136.    Export:
  137.    * IFF-ILBM formats (Standard palette based, HAM6, HAM8, extra
  138.      halfbright, ILBM24)
  139.  
  140.    * BMP
  141.  
  142.    * GIF (conforming to GIF87a)
  143.  
  144.    * JPEG (conforming to JFIF standard)
  145.  
  146.    * PCX
  147.  
  148.    * Targa
  149.  
  150.    Colour Balance:
  151.    * All operations are available to the R,G,B components separately.
  152.  
  153.    * Brightness ( upto ±100%)
  154.  
  155.    * Contrast (non to full)
  156.  
  157.    * Gamma ( + and - )
  158.  
  159.    Convolution:
  160.    * Built in convolutions: Blur, Sharpen, Emboss, Raise, Edge detect.
  161.  
  162.    * User definable convolutions, load and save to disk.
  163.  
  164.    Effects:
  165.    * Built in effects: FlipX, FlipY, RollX, RollY, Negative, Greyscale,
  166.      Highlight, Shadow, Random, Pixelize, Remove isolated pixels.
  167.  
  168.    Scale:
  169.    * Crop to selected region.
  170.  
  171.    * Increase / decrease scale by percentage or absolute image size.
  172.  
  173.    * Simple scale or colour averaged.
  174.  
  175.    Colour reduction:
  176.    * Increase colour mapped images to 24-bit.
  177.  
  178.    * Decrease number of colours in 24-bit or colour mapped images via
  179.      Heckbert median cut algorithm. Reduce to any number of colours
  180.      2-256 (not limited to powers of 2).
  181.  
  182.    * Methods of palette colour choice: Colour distance, highest count
  183.      and weighted average.
  184.  
  185.    * Dithers available for colour reduction: None, Floyd-Steinberg,
  186.      Burkes, Stucki, Sierra, Jarvis, Stevenson-Arce.
  187.  
  188.    Palette:
  189.    * Save current palette.
  190.  
  191.    * Force palette onto current image, dithering if necessary (all
  192.      dithers available).
  193.  
  194. Shareware version
  195. =================
  196.  
  197.    To encourage users to register, the freely distributable version of
  198. ImageStudio is limited to loading in pictures upto 250x250 pixels. All
  199. other operations are available.
  200.  
  201.    For details on how to register, See How to register.
  202.  
  203. Starting ImageStudio
  204. ====================
  205.  
  206.    ImageStudio can be started from either the Workbench or CLI. From
  207. the Workbench it is simply a case of double-clicking on the icon.
  208. ImageStudio supports shift-clicking on a file to start the program with
  209. (see the Workbench manual for more information).
  210.  
  211.    To start ImageStudio from the CLI, simply type:
  212.  
  213.      run ImageStudio [filename]
  214.  
  215.    where `filename' is an optional file to load in at startup. The full
  216. range of tooltypes is supported, and can be appended to the CLI
  217. command. For example:
  218.  
  219.      run ImageStudio "SCREENNAME=Image2" "PREVIEWDITHER=YES" [filename]
  220.  
  221.    would start the program on a public screen named `Image2' with
  222. preview dithering on. See Tooltypes, for a full list of available
  223. tooltypes.
  224.  
  225.    *If you are running ImageStudio from the CLI it is recommended that
  226. the stack be set to 40k*. To do this, type:
  227.  
  228.      stack 40000
  229.  
  230.    before running the program. This is not necessary if running
  231. ImageStudio from the Workbench, as the stack value is set in the
  232. program's icon.
  233.  
  234. Configuring ImageStudio
  235. =======================
  236.  
  237.    In order to benefit from ImageStudio's virtual memory, it is
  238. recommended that the default location used for the storage of the
  239. temporary files is changed. The default location for the storage of
  240. these files is `T:' which is usually in RAM - we want to move this out
  241. onto harddisk.
  242.  
  243.    To do this, select `Prefs' from the `Project' menu and open up the
  244. prefs requester. In the `Temp. files' string gadget, type the new
  245. location for the temp files.
  246.  
  247.    It is suggested that a drawer be made on a harddisk partition with
  248. lots of space to store these files. For example, make a drawer in your
  249. `Work:' partition called `tmp', and change the `Temp. files' string
  250. gadget to read `Work:tmp'.
  251.  
  252. Tutorial
  253. ********
  254.  
  255.    This chapter introduces ImageStudio by way of a few tutorials
  256. demonstrating commonly performed operations.
  257.  
  258. Changing the image format
  259. =========================
  260.  
  261.    The simplest use of ImageStudio is just as a file format converter;
  262. See File formats, for details about the supported file formats.
  263.  
  264.    In this example we will change the image format of the
  265. `FW14B_250x250.gif' from GIF to IFF-ILBM.
  266.  
  267.   1. Load the file `FW14B_250x250.gif' from the `Pics' drawer. To do
  268.      this, select `Open' from the `Project' menu. When the file
  269.      requester opens, select the file and it will load into
  270.      ImageStudio. The greyscale pre