home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / gfx / conv / DTKoala.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  3.8 KB  |  133 lines
  1. Short:    Koala painter converter v 1.2
  2. Author:   glue@df.lth.se <Lars Malmborg>
  3. Uploader: glue@df.lth.se <Lars Malmborg>
  4. Version:  1.2
  5. Type:     gfx/conv
  6.  
  7. TITLE
  8.  
  9.      DTKoala - Convert a (datatype) picture to Koala painter format
  10.  
  11.  
  12. VERSION
  13.  
  14.      1.2
  15.  
  16.  
  17. AUTHOR
  18.  
  19.      Written by Lars Malmborg (glue@df.lth.se).
  20.  
  21.      The rendition is based on code by Pasi 'Albert' Ojala.
  22.        (Aminet:gfx/conv/C64Gfx12.lha)
  23.  
  24.  
  25. DESCRIPTION
  26.  
  27.      DTKoala is simply a converter for any 320x200 picture loadable by
  28.      a datatype of the AmigaOS 3.x. The color remapping isn't perfect,
  29.      but who cares? You can however help it by using only the following
  30.      colors in the picture you want to convert:
  31.  
  32.      Black (0,0,0)
  33.      White (240,240,240)
  34.      Red (192,0,64)
  35.      Cyan (0,208,192)
  36.      Purple (192,0,192)
  37.      Green (0,176,0)
  38.      Blue (0,0,208)
  39.      Yellow (224,240,96)
  40.      Orange (208,96,0)
  41.      Brown (112,48,0)
  42.      LightRed (240,112,144)
  43.      DarkGray (80,80,80)
  44.      Gray (128,128,128)
  45.      LightGreen (144,240,160)
  46.      LightBlue (112,144,240)
  47.      LightGray (192,192,208)
  48.  
  49.      This palette can be extracted from any picture shown by the Koala
  50.      painter datatype or you can use the supplied palette for PPaint.
  51.  
  52.      As the actual resolution of a Koala painter picture is 160x200 with
  53.      a ratio of 2:1, the remapper uses the medium of even and odd pixels
  54.      in the original 320x200 picture. Pixel 0 on a row in the Koala
  55.      painter matches pixel 0 and 1 in the original picture, pixel 1
  56.      matches pixel 2 and 3, ...
  57.      If you want sharp edges in the resulting picture you must make sure
  58.      that the color of the original pixels are the same to disable the
  59.      effect of the medium calculation. This is easilly done in a paint
  60.      program by scaling the picture to 160x200 and back to 320x200. Keep
  61.      in mind that if you resize a brush twice, most programs use the
  62.      initial brush even for the secont resize.
  63.  
  64.      To convert a picture simply state:
  65.  
  66.        DTKoala <infile> <outfile>
  67.  
  68.      where <infile> is any 320x200 picture loadable with with datatypes
  69.      and <outfile> is the resulting Koala painter file. The default
  70.      background color is black, but you can decide which color to use
  71.      as background and if this color is to be transparent.
  72.      F.ex. to convert the file "foo.iff" to a Koala painter file
  73.      "bar.pic" where the background is to be set to light blue, state:
  74.  
  75.        DTKoala foo.iff bar.pic LightBlue
  76.  
  77.      If you use a picture f.ex. on your home page and you have a grayish
  78.      background pattern, you can make the gray part transparent:
  79.  
  80.        DTKoala food.iff bart.pic Gray Transparent
  81.  
  82.      You can of course also use the british spelling of the colours:
  83.  
  84.        DTKoala food.iff bart.pic Grey Transparent
  85.  
  86.      This is kind of the counter part of my Koala painter datatype
  87.      (Aminet:util/dtype/KoalaDT.lha), which you'll probably want if are
  88.      going to watch the pictures you've converted.
  89.  
  90.  
  91. INSTALLATION
  92.  
  93.      Put "DTKoala" anywhere in your path.
  94.  
  95.  
  96. SPECIAL REQUIREMENTS
  97.  
  98.      Amiga running AmigaOS 3.x
  99.  
  100.  
  101. HISTORY
  102.  
  103.      1.0
  104.           * Initial Aminet release.
  105.  
  106.      1.1
  107.           * Corrected weights for color approximation.
  108.  
  109.      1.2
  110.           * Stack problems fixed.
  111.           * No longer depends on V43 picture.datatype.
  112.  
  113. KNOWN BUGS
  114.  
  115.      Only pictures with a color LUT works, i.e. no true color pictures
  116.      such as jpeg or IFF24.
  117.  
  118.  
  119. PRICE
  120.  
  121.      Freeware as always!
  122.  
  123.  
  124. ============================= Archive contents =============================
  125.  
  126. Original  Packed Ratio    Date     Time    Name
  127. -------- ------- ----- --------- --------  -------------
  128.    15656    9983 36.2% 05-Feb-97 18:39:20 +DTKoala
  129.     3438    1555 54.7% 05-Feb-97 18:44:36 +DTKoala.readme
  130.       96      83 13.5% 15-Dec-96 01:51:40 +Koala.col
  131. -------- ------- ----- --------- --------
  132.    19190   11621 39.4% 05-Feb-97 22:43:38   3 files
  133.