src/add-ons/translators/jpeg/README

   1 JPEG Translator v1.1.1
   2 ©2002-2003 by Marcin 'Shard' Konicki
   3 shard@beosjournal.org
   4 http://shard.beosjournal.org
   5
   6 TranslationKit add-on for JPEG files. Has more options and can write jpg files with far much better quality than default one in BeOS r5.
   7
   8 It's based on libjpeg by IJG (http://www.ijg.org/files/), with patch to support "lossless" (really bad and misinformative name) encoded images by Ken Murchison (http://www.oceana.com/ftp/ljpeg/). I also used some color space conversion routines by Magnus Hellman found in TestBMPTranslator (http://www.bebits.com/app/802).
   9
  10
  11 A little explanation ("what is what"):
  12
  13 To install translator drag & drop "JPEGTranslator" file onto "Drag JPEGTranslator here" folder.
  14
  15 When You run DataTranslations application and go to JPEG Translator settings, You'll see 3 tabs:
  16 - Write
  17 - Read
  18 - About
  19
  20 Write tab shows settings used for writing jpeg files:
  21
  22 Output quality let's You chose how much output image will be similar to original image. Less quality means worse output image. There is a scale from 0% to 100% but in reality 95% is maximum quality, more percent only will make output file bigger without any noticable image quality changes.
  23
  24 Output smoothing strength let's You chose how much blurred output image will be. It sometimes helps to make it 3-5% smoothed when You use smaller quality. Depends on what that image will be used for of course.
  25
  26 Use progressive compression will make output file to be loaded progressively on webpage, ie: first client will see very big pixels, than after each "rescan" of image it will get better and better up to full image. This option usually makes output file smaller.
  27
  28 Prevent colors 'washing out' makes output file bigger but with full colors from original file. If You made some jpg files on BeOS before, You've probably noticed colors were "washed out". This option prevents that :)
  29
  30 Make file smaller (slightly worse quality) is available only with previous option set on. It will make outout file smaller but with a little worse quality (from what i've seen it's like difference between quality of 95% and 93% - but it's highly subjective opinion. Some people who have seen images generated with this option said they're the same as 95%, others said they're mych worse :)
  31
  32 Write Black&White images as RGB24 tells translator to write B_GRAY1 images as rgb jpeg. If it's turned off, translator will write them as greyscale.
  33
  34
  35 Read tab shows settings used for reading jpeg files:
  36
  37 Read Greyscale images as RGB32 makes translator to read greyscale images as they have been color. Most applications on BeOS can't "understand" greyscale images from translation properly (i've tried ShowImage, ViewImage, Gobe Productive 2, NetPositive, and ArtPaint - only NetPositive can understand them).
  38
  39 Use CMYK code with 0 for 100% ink coverage is to let You read properly CMYK color space jpeg images generated by Photoshop.
  40
  41 Note: CMYK support is only basic - just to give You idea how image can look. Exact translation will be available someday in the future maybe.
  42
  43 Show warning messages lets You turn off read warnings. There are damaged/wrongly written jpg files which can be rendered ok, or almost ok. With this option checked You'll not be bugged about missing few bytes in some image anymore ;]
  44
  45
  46 About tab shows info about this translator.
  47
  48
  49 Shard