For Your Eyes Only 2.03 Manual:
-------------------------------

Contents:
---------
    - Gettings started
    - Multitasking
    - Preferences 
    - The output settings
    - The input settings
    - The misc settings
    - Understanding the pixel aspect
    - The 16 and 32 bpp output settings

Getting started:
----------------

- Load the application by double clicking on the !FYEO2 icon.
- Click the mouse to cancel the welcome box.
- Find a jpeg, targa, gif or ppm file and either:
   - double click on it if it is correctly filetyped.
   - drag it on the FYEO2 icon on the iconbar or on a FYEO2 window if you
      don't know.
      
Multitasking:
-------------

You can at any time stop the processing of an image by cliking on the 
close icon of its window. You can't close an already loaded image window
when your are processing an image.      

The Preferences:
----------------

Settings boxes can be obtained with the fyeo2 iconbar choices menu item.
In each boxes you can:

- Validate settings for the next processed file by clicking OK.

- Validate settings for the next processed file and saving them as default 
  by clicking SAVE.

- Cancel the change you've just made by clicking CANCEL.

- Getting the default settings by clicking DEFAULT (you have to click
  OK to validate them).

The output settings:
--------------------

Output settings box offers you to select the aspect of the output sprite.
You can choose:

  - Its byte per pixel rate.

  - Its pixel aspect: horizontal and vertical dot per inch.
     In term of screen mode 8bpp 90x90dpi is mode 28, 8bpp 90x45 is mode 15,
        8bpp 45x45 is mode 13.
    Selecting Use current means that the output sprite mode will be the 
       same as the one the desktop is in.

  - Its colorspace: Color or grayscale .
     Selecting grayscale is an important speed up when viewing JPEG files.

  - The dithering type: dithering is an error diffusion processing which
     enhance image quality when viewing in 8bpp modes. FYEO offers 3 alternatives:
     - No dithering: quoted 'None' in the settings box.
     - Simple dithering: quoted 'Simple'. It's a simple and fast but coarse dithering
       aimed at image previewing. (Offers a 30% speed increase when viewing JPEGs).
     - Floyd-Steinberg dithering: quoted 'Floyd-Steinberg'. It's a much more accurate but
       slower dithering. This is the default dithering in FYEO.

  - It's scaling: the way the image will be reduced or magnified.

     - 1:1 means that the image will not be scaled.

     - 1:4 means that the image will be scaled to 1:4 1:4.

     - 1:8 means that the image will be scaled to 1:8 1:8.
        Selecting 1:8 enters the fast preview mode when viewing JPEG files.

     - To fit means that if the image is too big to fit the specified size,
        it will be automatically scaled in order to fit the whole image
        in the specified size with the pixel aspect ratio preserved.

     - To fill means that the image will be scaled automaticaly to fill
        the specified size, the pixel aspect is not preserved.        

     - Custom allows you to customize the scaling with the specified values.
     
     Be warned that scaling costs a lot of memory when using 'complex' 
     fractions such as 640:639 480:479. Despite the fact that fraction
     reduction is used you will get 'Not enough memory for scaling buffer'
     often if you do it. This apply also with implicit scaling generated
     by the to fill option. The to fit option use a fraction approximation
     to avoid that (the picture fit not exactly).


The input settings:
-------------------

Input settings box offers you to select the aspect of the input image.
You can specify the image pixel aspect in dot per inch.
It's useful for image with rectangular pixels: use either
90x45 or 45x90 dpi. 90x90 dpi is assumed for majority of files.


The misc settings:
------------------

Misc settings box offers you to change miscellanous settings.
You can choose if FYEO will or not auto filetype the files when dragged
to it.


Understanding the pixel aspect:
-------------------------------
Pixel aspect settings work as follow:

- The output dpi selects the way the wimp will scale the sprite:

   - a 90x90 dpi sprite means that the wimp will not scale the sprite in mode
     such as 28,21,31 (90x90 modes) but will reduce it by a factor of 1:1 1:2
     in mode such as 15,12 (90x45 dpi modes) and 1:2 1:2 in mode such as 13
     (45x45 modes).

   - a 90x45 dpi sprite means that the wimp will not scale the sprite 
      in mode such as 15,12 ... 

   - a 45x45 dpi sprite means that the wimp will not scale the sprite 
      in mode such as 13 ... 

- The input dpi selects the way FYEO will scale the original image to
   match the original image pixel aspect:

   - If the input dpi and the output dpi are equal, you will get 
      all the original image pixels in the sprite.

   - If the input dpi is 90x45 and the output dpi is 90x90 you will have
     twice as much pixels vertically in the sprite.

   - If the input dpi is 45x90 and the output dpi is 90x90 you will have
     twice as much pixels horizontally in the sprite.

   - If the input dpi is 45x45 and the output dpi is 90x90 you will have
     twice as much pixels horizontally and vertically in the sprite.

   - If the input dpi is 90x90 and the output dpi is 45x45 you will have
     twice as less pixels horizontally and vertically in the sprite.

and so on ..

The 16 and 32 bpp output settings:
----------------------------------
     
When used on a computer understanding the new 'Deep' sprite modes, FYEO acts
as usual. When used on a computer which don't understand such modes, FYEO
will warn you (warn can be disabled, see the !Run file) that it can't 
display the picture but is still processing it making it ready 
for saving via the save option of the picture's menu. 
In this way you will be able to use those 'Deep' sprites in softwares which
recognize them such as Impression Style for exemple.
