

         ======================================================
        |            vorlufige Dokumentation  zu              |
        |                   GEM-View  2.32                     |
        |               ----------------------                 |
        |               GEM-View ist SHAREWARE                 |
        |               ----------------------                 |
        |                                                      |
        |                  1990/91/92/93 by                   |
        |                                                      |
        |                  Dieter Fiebelkorn                   |
        |                   Grner Weg  29a                    |
        |                 W4370 Marl-Brassert                  |
        |                      (Germany)                       |
        |                                                      |
        | ! MANY THANKS TO C.D. EDWARDS FOR THIS TRANSLATION!! |
        |                                                      |
        |   email: fiebelko@bonny.informatik.uni-dortmund.de   |
         ======================================================






  GEM-View  loads and displays  pictures in a variety of graphic formats in
  any desired resolution and virtual size ( BigScreen ) on the ATARI
  ST/TT/Falcon series of computers.  It is also anticipated that GEM-View
  will run on a diverse range of Graphic Cards.
         ======================================================
  I have so far established that GEM-View functions correctly on the
   following types of Graphics Card:
               - CyReL M16-1288
               - Spektrum1, Spektrum1HC, Spektrum1TC
               - Crazy Dots, Crazy Dots 32K
               - Matrix TrueColor Cards "MatGraph"
               - Nova 16M
               - ST-Magazin Graphiccard
  Of course GEM-View also runs on the new Atari bird of prey,the Falcon030,
  in 32K color mode and 64K color mode  ( the so-called  "TRUE-Colour " mode
  although it is really only a  High Color mode ).
         ======================================================
  GEM-View  is so designed that it will function either as an  Accessory or
  as a stand-alone Program. If the currently effective resolution of the
  computer does not permit  the display of the complete range of colors in a
  picture, the picture will be dithered ( monochrome resolution) or the
  number of colors in the color palett will be reduced by means of a special
  algorithm to the smaller number of available colors. Additionally there
  are several primary functions available  which allow modification of the
  picture during the loading process.  These include magnification,
  brightening, contrast correction, cutting out a part of the picture and
  overlaying one picture by another in a specified way.


  Summary of Contents
  ===================
         -Supported Formats
         -The GEM-View window
            -Reports
            -Description of Icons
         -The Desktop Menu
            -'GEM-View' menu
            -'File' menu
            -'Work' menu
            -'Extra' menu
            -'Window' menu
         -The Picture Window
            -Position Reports
            -Scrolling
            -Clipping
         -The Window Menu
            -for raster images
            -for GEM Hetafile images
            -for Texts/Hex Dumps
            -for Resource files
         -Keyboard Operation
            -No picture window open
            -Picture window open
         -Dialogs
            -'Globals'(GLOBALS.IMG, GLOBALS1.IMG,GLOBALS2.IMG)
            -'Presetting'(PRESET.IMG,PRERAST1.IMG,PRERAST2.IMG)
            -'Graphic Mode' (GRAPHIC{0.1.2.3.4.5}.IMG)
            -'Open Icon' (OPEN.IMG)
            -'Iconify'(ICONIFY.IMG)
            -'RGB-Scaling-Adjust' (RGBSCALE.IMG)
            -SAVING DEFAULT (SAVEDFLT.IMG,SAVEP{MON,COL,TRU}.IMG)
            -PICTURE-OPTIONS (PICTURE.IMG,PICTURE{1,2}.IMG,SCREEN.IMG)
            -RASTER-OPTIONS (RASTER.IMG, PRERAST1.IMG,PRERAST2.IMG)
            -SAVE-PICTURE (SAVEPMON.IMG,SAVEPCOL.IMG,SAVEPTRU.IMG)
            -METAFILES-> RASTER ( GEMRASTE.IMG)
            -COLOR MAP (COLOR.IMG)
         Special Matters
            -Wildcards
            -Automatic Conversion of the Pictures in a Directory
            -Environment Variables
            -DRAG & DROP Protocol
            -VIEW Protocol ( See enclosed documentation
            -'VIEW.TXT')
            -AV Protocol ( See GEMINI documentation)
            -xACC Protocol ( See xACC documentation by Konrad Hinsen)
            -GEM-Show{(c) Dieter Fiebelkorn}
            -GEM-xAcc{(c) Dieter Fiebelkorn}
            -GEM-VIEW{(c) Dieter Fiebelkorn}
            -Selectric{(c)  Stefan Radermacher}
            -VDI-Fix{(c) Karsten Isakovic }
            -WINX 2.0((c)  Martin Osieka )
            -MultiDialog 1.02 ((c) Helmut Neukirchen)
         GEM-View as  GTP  ( GEM Takes Parameters)
            -Enlarged Treatment of Parameters
            -GLOBAL Options
            -PICTURE related Options
          The GEM-View .INF File
          My Address
          Acknowledgements




  Supported  Picture  Formats
  

      "GEM-View images           [ *.GVW ]"   (internal format)
      "TIFF Format               [ *.TIF ]"
      "GIF Images 87/89          [ *.GIF ]"
      "JPEG Images               [ *.JPG ]"
      "Sun Rasterfiles           [ *.SUN ]"
      "Imagelab Images           [ *.B&W ]
      "STAD Images               [ *.PAC ]"
      "IFF Imagefiles            [ *.IFF ]"
      "HAM Hold & Modify         [ *.IFF ]"
      "MS-Windows Bitmap         ( *.BMP, *.RLE )"
      "OS/2 Bitmap               ( *.BMP )"
      "GEM-(X)Image Files        ( *.IMG )"
      "GEM-Metafiles (Vector)    ( *.GEM )"
      "Neochrome Rasterfiles     ( *.NEO )"
      "Art-Director Rasterfiles  ( *.ART )"
      "Degas Images              ( *.P[IC][123] )"
      "Tiny-Compressed Images    (*.TN[123Y] )"
      "Doodle Monochrome Rasters ( *.DOO [640x...] )"
      "Spectrum 512 Images       ( *.SPU, *.SPC )"
      "Portable Bit Map          [ *.P[BGP]M ]"
      "MacPaint Image            [ *.MAC ]"
      "PC Paintbrush             ( *.PCX )"
      "Targa Images              ( *.TGA )"
      "Enhanced Simplex          [ *.ESM ]"
      "Vidas Image               ( *.IMG )"
      "Vivid Raytracing          ( *.IMG )"
      "X Bitmap-File             [ *.XBM ]"
      "Resource File             ( *.RSC )"
      "1st Word Files            [ *.DOC ]"
      "Load as Text or Hexdump   [ *.* ]"

  The obigatory extenders to identify the picture type are those shown in
  round brackets. The extenders in square brackets are those commonly used
  for a type, but which are not essential to identification.

  GEM-View Images
  
  This  is  the  program's  internal  format  for dealing with pictures and
  related  data  and  which  allows  specially  fast loading. The format is
  strongly  resolution dependent so that pictures can only be loaded in the
  same  or higher screen resolution( Monochrome pictures in this format can
  be  loaded  in  any other resolution; 16 color pictures can be loaded  to
  screens supporting 16 colors, 256 colors,HighColor (32K,64K) or TrueColor
  (16M) ).
  The   GEM-View  format does not therefore constitute a new picture format
  and  should  not  be  so  used.; this will certainly be changed in future
  versions.
  This format is used for the 'iconisation' of pictures.(see below.)

  TIFF pictures
  
  GEM-View can load TIFF pictures in the following compression categories:-
               o  Uncompressed
               o  Hohe Packungsdichte
               o  PackBits  ( Also known as Macintosh-RLE )
               o  NeXT-RLE
               o  LZW
  Supported formats:-
               o  monochrome
               o  duochrome (2 colors)
               o  4 colors(= 2 planes )
               o  16 colors(= 4 planes )
               o  256 colors(= 8 planes)
               o  TrueColor format.

  GIF  Images  87/89
  
   The Graphic Interchange Format (GIF )  is a graphics format which is much
   used in the UNIX world. It supports a color palette of up to 256 out of
   16,777,216 possible colors.
   GIF pictures are very efficiently compressed and correspond very closely
   in the quality of compression with LhARC files.

  JPEG Images
  
   This is a picture format which has been developed in the past few years
   by the Joint Photographic Expert Group. It supports black and white,
   greyscale and color pictures up to TrueColor standard.
   It is noteworthy for its capability to store pictures of diverse
   quality  and  to  obtain   specially  good  compression.  GEM-View loads
   pictures in JPEG format ( more accurately described as JPEG/JFJF format)
   always as TrueColor pictures.

  Sun Rasterfiles
  
   This picture format is the standard available on SUN workstations.
   It uses an uncompressed format to deal with up to 256 out of a possible
   16,777,216 colors.     A compressed format version supposedly exists.
   GEM-View is prepared for it but, as no test pictures have been available
   to me, there might prove to be some minor difficulties in attempting to
   deal with pictures of that type.

  ImageLab  Images  (B&W 256-Format )
  
   The ImageLab format is a greyscale format with 256 true grey shades.
   It was originally thought that the ImageLab program could only cope with
   one format, namely B&W256, but it then emerged that the video digitizer
   format used by the firm Print Technik  had an identical header to that of
   B&W256.  And so that format can also be used by ImageLab.
   GEM-View  can work with both. The format is uncompressed.

  STAD  Images
  
   The STAD picture format is a product of the ATARI ST painting program
   STAD. It only supports monochrome 640x400 images ( the ST Hi-Res. )
   and is compressed.

  IFF Image Files
  
   The Interchange File Format ( IFF ),  originally  introduced on the
   Commodore AMIGA, is comparible in its flexibility with the IMG format,
   allowing the storage of text and sound information as well as pictures.
   GEM-View supports `ILBM' formats (Interleaved Bitmaps ) with up to 256
   colors that can be met in both uncompressed and compressed forms.
   There are apparently various compression algorithms of which, at the
   moment, only one - RLE-process - is supported by GEM-View.
   Uncompressed IFF pictures can also be loaded.

  HAM  Hold  &  Modify
  
   The HAM format presents a special  form of the IFF type.  Like IFF it
   was developed for the AMIGA.  The HAM format describes the color of a
   pixel by reference to an entry in the color table or by reference to a
   change  from  the color  information  on  the preceding pixel.
   The HAM format employs a bit depth of 6  and  of  8  bits.
   By means of the special process  a maximum of 4096 colors can be used
   with only 6 bits.  In a HAM8 picture with 8 bits a maximum of 262,144
   colors is possible.  GEM-View loads these pictures as TrueColor pictures
   and  subsequently transforms them  by means of color dithering or
   monochrome dithering  into the appropriate resolution.

  MS-Windows  Bitmap
  
   The Windows Bitmap format is a PC-specific picture format that exists in
   both uncompressed ( BMP ) and  compressed ( RLE ) forms. The color
   palette supports up to 256 colors and TrueColor pictures ( 16,777,216
   colors).  GEM-View supports all of these pictures including those in
   TrueColor format.

  OS/2 Bitmap
  
   This picture format originated in connection with the OS/2 operating
   system for PCs.It corresponds in the most part to a (shortened) variant
   of Windows-Bitmap. It exists in both compressed (RLE-process) and
   uncompressed forms.

  GEM-(X)Image Files
  
   With the GEM IMG format we have a GEM-specific standard format originally
   meant  only  for  monochrome pictures.
   As  extensions  were  introduced into the XIMG format, the color palette
   was  stored in the file header. GEM-View interprets the color palette in
   the color coding sequence in the following bitmap.As far as an X-IMG
   picture is concerned  where the sequence of the color palette corresponds
   to the VDI indices, one can  display the picture in a wrong color form or
   as a badly-dithered one. The option 'vdicolororder' or the'VDI-Order'
   switch in the GLOBAL dialog box can help here. Compressed format.

  GEM Metafiles
  
  The only vector graphic format supported by GEM-View. The format contains
  all the VDI function calls which are needed for  the  creation  of  the
  picture. GEM-View can open a new window and convert the GEM Metafile
  format to a raster format. GEM Metafiles can now be stored directly.

  Neochrome Rasterfiles
  
   The Neochrome picture format is a product of the ATARI ST painting
   program Neochrome. The only supported resolutions are those of the
   ST (640x400 pixels monochrome, 640x200  pixels in 4 colors and
   320x200 pixels in 16 colors.) The format is uncompressed.

  Art Director Rasterfiles
  
   The Art Director picture format is a  product of the ATARI ST program
   Art Director. The only supported  resolution  is  the  ST  resolution
   of 320x200 pixels in 256 colors.
   The format is uncompressed.

  Degas Images
  
   The Degas format originated with the ATARI ST painting program of the
   same name.The formats supported were those of the ST (640x400 pixels
   monochrome, 640x200 pixels in 4 colors, 320x200 pixels in 16 colors.)
   The format was uncompressed. (PI1,PI2,PI3) With the introduction of the
   successor program, Degas Elite, a compressed version of the Degas format
   was defined (PC1,PC2.PC3). Through the resolutions available on the TT
   further formats- PI4,PI5,PI6,PC4,PC5 and PC6 - have  been developed.
   These formats cannot be loaded in the present version of GEM-View. There
   are no plans to provide for them in future versions.

  Tiny Compressed Images
  
   The Tiny picture format was a compressed format running in the old ST
   resolutions ( 640x400 pixels monochrome, 640x200 pixels in 4 colors,
   320x200 pixels in 16 colors).

  Doodle Monochrome Rasters
  
   The Doodle picture format is, strictly speaking, not a picture format
   but a screen DUMP. As no color information is stored, it can only really
   be used for monochrome display. GEM-View deals with these 'pictures' on
   the assumption that they are monochrome images with a width of 640
   pixels and variable height.

  Spectrum 512 Images
  
   This format stemmed from the painting program named SPECTRUM 512 which
   is able to produce 512 colors on screen at the same time with an ATARI
   ST. The Spectrum picture can exist either in uncompressed form (SPU) or
   in compressed form (SPC). GEM-View supports only 256 out of the possible
   maximum of 512 colors but this does not amount to much of a limitation.
   In very few cases are more than 256 colors in fact used.

  Portable Bit Map
  
   A picture format widely used by UNIX systems is the Portable Bit Map
   format. Pictures in this format can be categorized in 7 different forms
   from 3 distinguishable groups.
         Group 1:The PBM format  ( Extender .PBM)
                  -pbm normal type file
                  -pbm compacty type file
                  -pbm raw bits type file
         Group 2: The PGM format ( Extender .PGM)
                  -pgm normal type file
                  -pgm raw bytes type file
         Group 3: The PPM format ( Extender .PPM)
                  -ppm normal type file (TrueColor format)
                  -ppm raw bytes type file (TrueColor format)

  MacPaint Image
  
   The MacPaint format is a product of the program MacPaint for Macintosh
   computers and is monochrome with a size of 576x720 pixels. The format
   is a compressed one and uses RLE similar processing.

  PC Paintbrush
  
   This format stems from the PC program Paintbrush. GEM-View only supports
   the monochrome version of this type correctly as there isn't sufficient
   information for complete support. From version 2.20 onwards color PCX
   pictures can also be loaded.

  Targa Images
  
   The Targa format was developed by Truevision Inc. and allows the storage
   of monochrome, greyscale, color pictures and TrueColor pictures with
   15/16/24/32-bits. In addition to this the picture carries further
   information - information on name, file, attribute-type or pixel-size.
   For more detail see the documentation- "Truevision TGA - File Format
   Specification - Version 2.0". The Targa format can give uncompressed or
   ( with an RLE-like process) compressed storage.

  Enhanced Simplex
  
   The ESM format originated as the 'House Format' of the firm tms.
   Monochrome pictures, greyscale pictures, color pictures and TrueColor
   pictures with masks and color tables can be stored. The mask serves to
   define the protected pixels which cannot be changed. GEM-View ignores
   this information.  Pictures in the ESM format can be imported into
   CALAMUS Publisher by DMC.  At present GEM-View does not load EMS
   pictures with color separation. The format is uncompressed and of
   simple construction.

  Vidas Image
  
   The Vidas format is used in the picture processing and raytracing
   programs of the firm, Contron. The format always deals with a 256
   colored picture which means that a color palette with 256 colors is
   always stored, irrespective of the number of colors used in the picture.
   The size of the picture can only assume the following values:
   (Width by Height ) 256x256, 512x512, 768x512. The format is uncompressed
   and of simple construction.

  Vivid Raytracing
  
   The Vivid Raytracing format is a 24 bit TrueColor format coming from a
   program by a firm in Canada - Alias Research,Toronto. Alias Research has
   made a name for itself in the areas of animation, rendering and
   raytracing applications. On the IBM the very popular(shareware) VIVID
   Raytracer also uses this format. The format is uncompressed and of
   simple construction.

  X  Bitmap-File
  
   The X Bitmap format stems from the X11 on UNIX computers. In this format
   various icons or smaller pictures are stored in bitmap form.

  Resource Files
  
   Since version 2.20 GEM-View can load and display Atari Resource files.
   The colored icons used since TOS 4.0 can only be displayed in GEM-View
   in monochrome fashion. Progress through an individual resource tree is
   possible by using the following key combinations: <ALT>-`-', <ALT>-`+'
   and <ALT>-`0`. The indicated resource tree can be changed into a
   rasterfile in the same way as a GEM-Metafile with a newly-opened window.
   Resource files cannot be stored directly so you must first change the
   picture into a raster picture with "Options|->Raster <ALT> R". That can
   then be saved in the usual way with "Export|Save<ALT>S".

  1st Word Files, Text or Hexdump
  
   Here the data is not  treated as a picture but as text or binary files.
   1st Word documents, text and hexdumps can in no way be saved!




  The GEM-View Window
  
   At the start of GEM-View a window is opened in which all notices and
   messages from GEM-View are displayed.
   The Copyright notice,  the overview of the available options and the
   listing of all supported picture formats are shown in this way. The
   information about  a picture's  format type and size also appear in this
   window together with the progress report while a picture is being
   processed. Apart from these information functions  the window possesses
   several  GEM operating  characteristics  which can be activated by
   'clicking on'.  Recognized elements from GEM  are the mover to relocate
   the window and the closer that only shuts the window.  If the menuline is
   switched off ( see GEMVIEW.INF ) the program comes to an end.  The
   GEM-View window also has a Fuller button which is used to switch between
   the larger window with its  Icons and information displaying capability
   and the smaller, space-saving window. A total of 12 icons are placed at
   the bottom of the larger window (  and of the program window ). They are,
   from left to right:-
                     "Load Image......       ^O"(LOAD)
                     "Identify.............  ^I"(IDENTI)
                     "Open Icon.........     #Q"(OPEN)
                     "Globals.............   ^G"(GLOBAL)
                     "Presetting..........   ^F"(PRESET)
                     "Graphic Mode...        ^J"(G-MODE)
                     "Instal Path.........   ^Z"(I-PATH)
  And next to the right are four small icons which act as switches:
                     "Color Reset.......  ^I" ( upper left mini icon )
                     "Auto Iconify......  ^Y" ( lower left mini icon )
                     "Small Windows..     ^S" ( upper right mini icon )
                     "External............^E" ( lower right mini icon )
  On the extreme right of the icon list  will be found "INFO":
                     "About GEM-View..    ^V"(INFO)
  All these icons can be activated by mouse-clicking, when they are available
  and not 'greyed-out'.

  If the GEM-View window is in the background  the icons can nevertheless be
  activated.  Press down the right mouse button and keep it pressed while
  you choose the relevant icon with the left mouse button, releasing both
  buttons when the  chosen icon becomes inverted.

  In the smaller GEM-View window there are no icons but four little buttons
  for the functions "LOAD", "IDENTIFY", "OPEN" and "GLOBAL".

            "Load Image......             ^O"( LOAD )
            
  This opens a File Selection Box to choose the picture to be loaded.
  When the choice has been made the Icon will be lighten in order to
  show that no other picture parallel to the chosen picture may be loaded.
  If you hold down the ALTERNATE key when clicking on the LOAD icon
  you can, after making your choice of picture,  choose installation
  settings  regarding magnification, brightening, ...... ( See the Dialog
  for RASTER options and PICTURE options.)

            "Identify.........     ^I"(IDENTI)
            
  This also opens a File Selection Box to choose a picture. The picture
  is examined and, if it is in a known picture format, the picture type
  and the size of the picture are reported.

            "Open Icon.....         ^#O"(OPEN)
            
  This opens a little selection box for displaying the iconized pictures.
  This icon is only active if the GEMVIEW.INF file  ( see under ) contains
  a valid path for storing iconized pictures and  they are loadable in the
  current resolution.

            "Globals.......        ^G"(GLOBAL)
            
  This opens a dialog box  for choosing various globally-valid options.  A
  button enables the adoption of the current settings or the restoration of
  the original settings/configuration.

            "Presetting......     ^F"(PRESET)
            
  This opens a dialog box  for setting several picture options which will
  then act as default values in loading pictures.  Comparable with the
  manual  settings  when  reading  in individual pictures. ( LOAD/ALTERNATE
  key).

            "Graphic mode....^J"(G-MODE)
            
  Here the current setting of the apparatus-specific picture format is
  displayed in a dialog box. As a rule there is the statement "palette-mode
  (xx colors)" to be found. In HighColor mode 2 bytes are always used for
  each pixel upon the order of which the working of the graphics card
  driver depends. It is possible to use either the Motorola format or the
  Intel format - in the latter case the two bytes are reversed. In TrueColor
  mode there is the option to choose between  Motorola and Intel formats and
  between 24 bit and 32 bit working. In Motorola format the colors Red,
  Green and Blue are stored sequentially in that order (always as byte);
  in the Intel format the sequence is Blue, Green, Red. When using the
  various graphics cards one can check whether GEM-View has correctly
  established the resolution by a screen demonstration. With HighColor or
  TrueColor cards it is obvious whether the correct order of  pixels.
  If, additionally, "INTEL" is inverted you must imagine that in HighColor
  the two bytes are reversed and that in TrueColor all bytes are read
  backwards. For the SPEKTRUM1HC/TC Graphic Card the following settings
  are laid down:
                     HC-mode  Intel/xRRRRRGG|GGGBBBBB
                     TC-mode  Intel/RR GG BB
  For the MegaVision Graphic Card from SANG the following settings are laid
  down:
                     HC-mode  Motorola/xRRRRRGG|GGGBBBBB
                     TC-mode  Motorola/RR GG BB xx
  If, against expectations, GEM-View fails to run correctly in HighColor or
  TrueColor modes please compare the data in the dialog box with that shown
  in your Graphic Card handbook.  ( See.  GEMVIEW.INF / Graphic Mode ).

            "Instal path...       ^Z"(I-PATH)
            
  Here the directory path can be set to show GEM-View where to look for
  iconised pictures. ( see under Menu/FILE/ICONIFY). The path serves
  furthermore for pictures pushed out when the "EXTERNAL ICONIFY" process
  is switched on.

            "Color Reset....^T"(upper left mini icon )
            
  If this option is switched on the color palette of the picture at the
  top of the corresponding window is again correctly set.  If the option
  is switched off  you will be asked whether the color should be set anew
  or whether the installed colors should be retained.

            "Auto iconify.....^Y"(lower left mini icon)
            
  If this is switched on the picture is automatically iconized when you
  close a window. You can subsequently reload this picture under the name
  "$_UNDO_$"with "Menu/FILE/OPEN ICON".

            "Small Windows.. ^S"(upper right mini icon)
            
  This defines the mode in which the windows will be opened. Switched off,
  the routine is identical to that in GEM-View 1.xx i.e. the windows are
  opened in a maximum size fitted into the upper lefthand corner. Switched
  on, the routine conforms to Version 2.0x of GEM-View where the windows
  are opened in a staggered stack. I personally prefer the style of Version
  2.0x especially when, with "Selectric", more pictures can be loaded
  simultaneously.
  Besides, the window with '*' on the numberblock can be switched
  immediately to the maximum size.

            "External....^E"(lower right mini icon)
            
  When a file is to be iconified, selecting this option results in the
  actual picture data being stored in the directory specified in the
  "ICONIFY-PATH".  Only minor information on screen position and order is
  retained in memory. If this option is switched off, or the iconify-path
  directory has not been set, the whole of the picture data is retained in
  memory.

            "About GEM-View...       ^V"(INFO)
            
  Opens a dialog box containing the copyright notice and  minor information.
  To leave this box click on it with either mouse button.


  The Desktop Menu
  
  For Version 1.1 onwards when GEM-View is started as a program a GEM menu
  is presented from which can be accessed the functions also obtainable from
  the icons in the GEM-View Window
-------------------------------------------------------------------------------
GEM-View   File                   Work                  Extras Window
-------------------------------------------------------------------------------
|About  GE| Load Image...    ^O| Open Log-Window   ^L| Globals...     ^G| GEM-V
          | Save  All  Not Show| Cycle Window      ^W| Preseting...   ^F| -----
          | Identify...      ^I|  Close  Window    ^U| Saving Dflt... ^D|
          | Convert image... ^N| --------------------| Graphic mode...^J|
          | -------------------| Resort Windows    ^R| Install path...^Z|
          | Iconify...       #I| Close All Windows ^X| -----------------|
          | Open Icon...     #O| --------------------| External       ^E|
          | Clean up...      #C| Icon Application  ^C| Small Windows  ^S|
          | -------------------| Open Application  ^A| Color Reset    ^T|
          | Quit  ^Q   Break ^B| Auto Iconify      ^Y|
          | ####    ####    ####|
                               

"GEM-View" Menu
===============

  "About GEM-View...             ^V"
  
  Opens a dialog box containing the copyright notice and minor information.
  To leave this box click on it with either mouse button.



"File"  Menu
============

  "Load Image....   ^O"
  
  This opens a File Selection Box to choose the picture to be loaded. When
  the choice has been made the Icon will be lightened in order to show that
  no other picture simultaneously to the chosen  picture  may  be loaded.
  If  you hold down the ALTERNATE key when clicking on the LOAD icon you
  can, after making your choice of picture,  choose various settings
  regarding  magnification, brightening, and much more.
  ( See the Dialog for RASTER options and PICTURE options.)

  "Save All   Not show"
  
  - "Save All": If this option is chosen all pictures which are subsequently
    loaded will be saved,using the format chosen in "Saving Dflt.".
    Differentiation  will be made between monochrome, color and TrueColor
    pictures.The name of the source file is adopted for the destination
    file  with the appropriate extender for the destination format. The
    converted files will be found in the same directory as the original
    pictures. Turning off this option automatically switches "Not show"
    off!
  - "Not show": Switching on this option  means that after any loading and
    converting there will be no further fitting and following display.
    Switching this option on automatically switches "Save  All" on!
    These two options can be used in conjunction with the Selectric File
    Selection Box  or by using wildcards ( see above ) for the plain
    conversion of entered pictures.

  "Identify....     ^I"
  
  This also opens a File Selection Box to choose a picture. The picture is
  examined and, if it is in a known picture format,the picture type and the
  size of the picture are reported.

  "Convert Image... ^N"
  
  For the first time (2.30) a convenience function is available which
  corresponds to the <ALT>LOAD function with automatic engagement of the
  "Do not Show" option. In the next version you will find a window-
  orientated conversion function.

  "Iconify...       #I"
  
  Because of the large amount of data  which  can relate to one picture, it
  is often inconvenient to hold  all pictures in memory at the same time.
  Therefore, in GEM-View, the iconisation of pictures is offered.   This
  involves the storage of pictures in an internal, particularly fast-loading
  format.   These pictures are put into a common directory, to which
  reference is made in the GEMVIEW.INF file. This menu item is  only active
  and available when a picture is displayed. After the item  has been chosen
  a dialog box appears in which you have to choose a name for the iconised
  image.  If there is a  conflict of names, you will be asked to decide
  whether to abort the action,  choose a new name or overwrite the old
  iconised picture.

  "Open Icon...     #O"
  
  This opens a little selection box for showing the iconised pictures. This
  function is only active  if the GEMVIEW.INF file ( see under ) contains a
  valid path for storing iconised pictures and they are loadable in the
  current resolution.

  "Clean up...      #C"
  
  After a security question, all iconised pictures are scrapped.

  "Quit...^Q  Break ^B"
  
  - "Quit" closes all open windows and ends the program.
    The operation of the closer button in the GEM-View window only brings
    the program to an end if the menu-line in a multi-tasking system has
    been switched off. (cf GEMVIEW.INF - File )
  - "Break" : After a security question, "Break" terminates the currently
    running action (e.g. a picture being loaded or converted ).
    If there is in fact no action running, then, after a security question,
    the program will be ended.



"Work"  Menu
============

  "Open Log-Window    ^L"
  
                      - Opens the Console-(LOG)-Window  from  GEM-View or
                        brings it to the foreground if it is already open.

  "Cycle Window..     ^W"
  
                      - When GEM-View is   running as a program this changes
                        the sequence of windows cyclically and will extend
                        to the windows called by AV protocol. When GEM-View
                        is running as an  Accessory the window cycle is
                        passed on to the main application when AV protocol
                        dominates; otherwise the windows are self regulated
                        by GEM-View.

  "Close Window...    ^U"
  
                      - Shuts the top window.
  "Resort Windows..   ^R"
  
                      - Staggers the windows in the new loading sequence.
  "Close All Windows  ^X"
  
                      - Shut all open windows!
  "Icon Application   ^C"
  
                      - Iconise the total application.  This means that
                        all windows ( both picture windows and the Log
                        window ) are closed but they are not removed from
                        memory and the position and sequence of the windows
                        are also stored.      In order to show that the
                        application has been iconised a small window with
                        an icon is opened.  This window is put into the
                        top righthand corner of the screen or,if the Icon
                        Manager is installed,  in a position ordered by
                        the Icon Manager. The picture data remains in
                        memory unless "EXTERNAL ICONIFY" is switched on,
                        when the treatment is different.
                        The application can be opened by "OPEN APPLICATION"
                        or clicking on the 'iconised' window.

  "Open Application   ^A"
  
                      - Opens a previously iconised application.
                        As a consequence both the position and order of all
                        windows will be restored.



"Extra"  Menu
=============
  "Globals...         ^G"
  
                      - This opens a dialog box for choosing various
                        globally-valid options. A button enables the
                        adoption of the current settings or the restoration
                        of the original settings/configuration.

  "Presetting...      ^F"
  
                      - This opens a dialog box for setting several picture
                        options which will then act as default values in
                        loading pictures. Comparable with the manual settins
                        when reading in individual pictures.
                        (LOAD/ALTERNATE key)

  "Saving Dflt..      ^D"
  
                      - Presents a dialog for setting the default destination
                        formats. In the dialog the formats to be adopted for
                        Mono, Color and Truecolor saving can be chosen.
                        These destination formats will then be used for
                        storage in the command line version when the options,
                        -savemono <name>, -savecolor <file>, -savetruecolor
                        <file> and -saveall {mono|color|truecolor} are used.

  "Graphic mode....   ^J"
  
                      - Here the current setting of the apparatus-specific
                        picture format is displayed in a dialog box. As a rule
                        there is the statement  "palette-mode (xx colors)"
                        to be found.
                        When using the various graphics cards  one can check
                        whether GEM-View has correctly established the
                        resolution by a screen demonstration. With HighColor
                        or TrueColor cards it is obvious whether the correct
                        order of pixels i.e. bytes is effective. If,
                        additionally, "INTEL" is inverted  you must imagine
                        that in HighColor the two bytes are reversed and
                        that in TrueColor all  bytes are read backwards.
                        For the SPEKTRUM1HC/TC  Graphic  Card  the  following
                        settings are laid down:
                                 HC-mode  Intel/xRRRRRGG|GGGBBBBB
                                 TC-mode  Intel/RR GG BB
                        For the MegaVision Graphic Card from SANG the
                        following settings are laid down:
                                 HC-mode  Motorola/xRRRRRGG|GGGBBBBB
                                 TC-mode  Motorola/RR GG BB xx
                        If, against expectations, GEM-View  fails to run
                        correctly in HighColor or TrueColor modes please
                        compare the data in the dialog box with that shown  in  your Graphic Card
                        handbook. ( See.  GEMVIEW.INF / Graphic Mode ).

  "Instal path...     ^Z"
  
                      - The installed path is that used in searching for and
                        storing iconised pictures.

  "External...        ^E"
  
                      - Selecting  this  has  the  result  that, when a
                        picture is iconised the picture data is stored on
                        disk in the directory specified under "ICONIFY-PATH"
                        leaving only a small amount of related management
                        information in memory.
                        If  this  option is switched off, or the iconise-path
                        directory has not been set, the whole of the picture
                        data is retained in memory.

  "Small Windows      ^S"
  
                      - This defines the mode in which the windows will be
                        opened.
                        Switched off,the routine is identical to that in
                        GEM-View Versions 1.xx. i.e. the windows are opened
                        in a maximum size fitted into the upper lefthand
                        corner.
                        Switched on, the routine conforms to Version 2.0x
                        of GEM-View where the windows are opened in a
                        staggered stack. I personally prefer the style
                        of Version 2.0x especially when, with "Selectric",
                        more pictures can be loaded simultaneously.
                        Besides, the window with '*' on the numberblock can
                        be switched immediately to the maximum size.

  "Color Reset        ^T"
  
                      - When this option is switched on the color palette
                        of the 'TOPPEN' (brought to the foreground ) of the
                        picture window will be adopted without enquiry.
                        If it is switched off then on a change of color
                        ( e.g. by the control panel ) you will be asked
                        whether the original color should be restored or
                        the changed color adopted.

  "Auto iconify       ^Y"
  
                      - If this is switched on the picture is automatically
                        iconised when you close a window. You can
                        subsequently reload this picture under the name 
                        "$_UNDO_$" with "Menu/FILE/OPEN ICON".

  "####    ####    ####"
  
                      - If the picture is smaller than the available area in
                        the display window, then a frame is placed round the
                        picture. With these three switches one can choose
                        whether the picture should be drawn with a white,
                        a grey or a black frame.



"Window"  Menu
""""""""""""""
 -Here the first 16 open windows are shown.
  Choosing  a  window  from this menu brings that window to the foreground.
  When you click on the window name in the window menu, the special keys
  listed below are defined to the indicated action:

            1.<SHIFT> Identical with the  Fuller.

            2.<CNTRL><ALT>Identical with the Closer.

            3.<SHIFT><CNTRL> ( Not effective with the GEM-View window )
            Closes the window without losing the contents; this effect is
            shown  in  the  menu  by a closer symbol in front of the window
            name.
            Depending on the setting of  the "External" flag, the picture
            data will either be stored on disk in the directory pointed to
            by the "Iconify Path" with only  minimal management data being
            retained  in  memory  or  the  picture  data  will  be retained
            completely in memory.



  The Picture Window
  ==================
  In order to show a picture routinely a normal  GEM window is used.
  Following many requests from a few ATARI TT users, I have decided,
  additionally, to produce a so-called Fullscreen display  in which
  the picture is shown in the whole screen without disturbing picture
  frames. Switching between the  normal and full screen displays is
  effected by pressing the [ESC] key. (Also works under MultiTOS!)

  Position Indication: ( not in the fullscreen display )
  ------------------------------------------------------
  A position indicator is fitted in under the Mover, which gives the
  current cursor position within the picture. The indicator is only
  present when the mouse cursor is positioned inside the window and
  immediately switches off as soon as the window is left. The position
  indicator is also switched off when the picture is enlarged or
  reduced by '+' or '-' ( see below ).

  Scrolling:
  ----------
  Apart from scrolling the picture by the sliders or the window arrows,
  the picture ( in normal or fullscreen display ) can be scrolled in an
  immediately visible and comprehended manner. Press down the right mouse
  button in the inner window and hold it down. Moving the position of the
  mouse will then result in the picture being moved. At the same time the
  slider bar display is altered  appropriately, when the window lies on
  top, to give you an indication of the current position with reference
  to the total picture. Scrolling by means of the right mouse button is
  also possible when the window does not lie uppermost on the Desktop.

  Clipping:
  ---------
  To cut out part of a picture  please press the left mouse button and
  keep it pressed. Now you can trace out and select a rectangle of the
  desired size; the rectangle can be drawn from the right or the left.
  After you have released the mouse button there appears a dialog box (see
  "PICTURE-OPTIONS" ) in which, amongst other things the upper left corner,
  the width and the height of the rectangle are shown.  These values can be
  corrected manually.  But take care that the selection falls within the
  available area when you confirm the dialog process with OK and the
  clipping starts.

  The "Window" menu:( not in the fullscreen display )
  ---------------------------------------------------
  Under the Atari symbol in the picture window ( from Version 2.3 onwards
  under the label "GEM-View") there is a drop-down menu which can be opened
  by a short click with the left mouse button on the symbol( or the label).
  Following  that  a menu item can be selected in a way analagous to  GEM
  menu usage.
  You will note that most of the menu items have a three part arrow on the
  right side. The menu items do not themselves initiate an action after
  being  chosen  but  they serve as summaries of more menu items which are
  found in under menus. Slide the mouse from one of these menupoints to the
  right and the under-menu rolls down, from which you can make your choice.
  If  by  any  chance  the  undermenu should be inadvertently rolled down,
  simply leave  the  limits  of the undermenu. If you want to shut down the
  whole menu then click on a non-selectable menu point or leave the limits
  of the main menu.
  If  you  keep  the  left mouse button pressed down after clicking on the
  Atari symbol  (  from Version 2.30 "GEM-View") then you can choose the
  desired menu item by letting go of the left mouse button over the desired
  menu entry. ( A la Macintosh Menu.)
  This menu can also be activated when the window lies in the background.
  There are  two  methods  to achieve this. In both cases a part of the
  Atari symbol ( since Version 2.3 "GEM-View) needs to be visible.
   o  (First in Version 2.3) Short click on the still visible part of the
      label "GEM-View".  The menu folds down! You can then proceed in the
      way described above.
   o  In the other available method you press and hold down the right mouse
      button while clicking with the left mouse button on the Atari symbol
      (from Version 2.3 "GEM-View") holding that button down as well while
      the menu unrolls. Now you can release the right mouse button (when you
      wish) and activate the desired menu item through releasing the left
      mouse button over it. ( Again a la Macintosh Menu.)

   In the different types of display ( raster images, metafiles, text,
   hex dumps, resource files ) there are different menus. In the following
   notes  all  entries  are  described  which are present in one or several
   menus.




Window Menus for raster images:
-------------------------------

  | Window       >>> |
  | Pic.Size     >>> |
  | Options      >>> |
  | Export       >>> |
  | Colors       >>> |
  | Dither       >>> |
  | ================ |
  | -> HexDump    #H |
  
  " -> HexDump    #H "
          - opens a new window and loads into it the file from which the
            picture  originated.  The display of the file so loaded follows
            either an ASCII mode or a Hexdump mode.


  | Window  | Fullscreen  ESC|
            | ============== |
            | Iconify     #I |
            | ============== |
            | Reload      #Q |
            
  " Fullscreen  ESC"
          - Switches  the  display  of  a  raster  picture  between  the
            Fullscreen and normal display.
  " Iconify     #I "
          - Iconises the picture.
  " Reload      #Q "
          - Loads the current picture anew.



  | Pic.Size| Half        #- |
            | Double      #+ |
            | ============== |
            | Original    #0 |
            
  " Half        #- "
          - Reduces  the  picture  to half size by halving the number of
            pixels. This process can be repeated 3 times. The area chosen
            to be reduced is that positioned around the mouse cursor.
  " Double      #+ "
          - Magnifies the picture to double size by doubling the number
            of pixels.  This process can be repeated twice. The area chosen
            to be enlarged is that positioned around the mouse cursor.
  " Original    #0 "
          - Restores the original size.

  | Options | Global      #G |
            | Raster      #R |
            | ->TrueColor #T |
            | Invert      #V |
            
  " Global      #G "
          - Opens a dialog box for setting general values for the picture
            ( see DIALOG : PICTURE-OPTIONS )
  " Raster      #R "
          - Opens  a  dialog  box  for  setting values pertaining to the
            raster  of  the  picture.  (  see DIALOG : PICTURE-OPTIONS, not
            available with Metafiles.)
  " ->TrueColor #T "
          - Changes a palette color picture with up to 256 colors into a
            TrueColor  picture.  Thereby you can achieve a faster redraw in
            the  HighColor  or TrueColor modes of your graphic card. ( Only
            available in HighColor and TrueColor modes. )

  " Invert      #V "
          - Inverts a monochrome picture. Also color and true-color, now!



  | Export  | Save        #S |
            | Print       #P |
            | Send xAcc   #X |
            
  " Save        #S "
          - Stores  the picture in the format determined in the following
            dialog.
  " Print       #P "
          - Prints out the picture. Not yet active!
  " Send xAcc   #X "
          - Exports the picture by means of xAcc-Messages to a Program or
            Accessory which supports Group 2 xAcc-Messages. ( e.g. SHOW_IMG
            from Peter Seitz ).



  | Colors  | Take Colors #K |
            | Color Map   #A |
            | Color Scale #L |
            
  " Take Colors #K "
          - Adopts  the recently-established  colors  for  the  relevant
            picture.  These  can  be  colors which have been set from other
            programs  or  colors  which have been manipulated by means of a
            CPX in the Control Panel or an Accessory. This function is only
            of  interest  if "Color Reset" is switched off or if the window
            menu is called from a background window.

  " Color Map   #A "
          - Makes  available a dialog box for changing the color palette
            of the chosen picture. This can only be used for a simple color
            picture ( palette color picture).


  " Color Scale #L "
          - Opens  a  dialog  box where the color intensity for each color
            component ( Red, Green,  Blue ) can be set.



  | Dither  | Floyd-St.   #F |
            | JJN-Dither  #J |
            | Stucki      #U |
            | Halftone    #E |
            | Quickdither #D |
            
  " Floyd-St.   #F "
          - Dithers  the  working  picture following the Floyd-Steinberg
            algorithms  (  slow but good ) and presents the result in a new
            window.

  " JJN-Dither  #J "
          - Changes the working picture following the Jarvis-Judice-Ninke
            algorithms  into  a  black-and-white  picture  and  places this
            picture in a new window.

  " Stucki      #U "
          - Dithers The working picture following the Stucki algorithms
            and presents the result in a new window.

  " Halftone    #E "
          - Changes  the  picture  by  a half-tone process and shows the
            result  in  a  new  window. This picture will have a 4x4 matrix
            display  for  each  pixel,  so  that the picture is in total 16
            times  bigger(  4  times  in  the  vertical  and 4 times in the
            horizontal).

  " Quickdither #D "
          - The  result of Quick Dithering, a rapid process that produces
            poor  output, is presented in a new window.




Window Menus for GEM Metafile pictures:
---------------------------------------

  | Window       >>> |
  | Pic.Size     >>> |
  | Pages        >>> |
  | Options      >>> |
  | ================ |
  | -> HexDump    #H |
  
  " -> HexDump    #H "
          - Opens a new window and loads into it the file from which the
            picture  originated.  The display of the file so loaded follows
            either an ASCII mode or a Hexdump mode.


  | Window  | Window Fit  ESC|
            | ============== |
            | Iconify     #I |
            | ============== |
            | Reload      #Q |
            
  " Window Fit  ESC"
          - Switches the display of GEM-Metafiles back and forth between
            WINDOW_FIT and normal.
  " Iconify     #I "
          - Iconises the picture.
  " Reload      #Q "
          - Loads the current picture anew.



  | Pic.Size| Half        #- |
            | Double      #+ |
            | ============== |
            | Original    #0 |
            
  " Half        #- "
          - Reduces the  image  by  the  percentage given in the global
            dialog.  This  function  can  be repeated with GEM Metafiles as
            often as you like.

  " Double      #+ "
          - Magnifies  the  image  by  the percentage given in the global
            dialog.   This  function  can be repeated with GEM Metafiles as
            often as you like.
  " Original    #0 "
          - Loads the current picture anew.


  | Pages   | Prev Page   #P |
            | Next Page   #N |
            
  " Prev Page   #P "
          - With  multi-page  Metafiles,  the  previous  page  will  be
            displayed.
  " Next Page   #N "
          - With multi-page Metafiles,  the next page will be displayed..



  | Options | Global      #G |
            | ->Raster    #R |
            
  " Global      #G "
          - Opens  a dialog box for setting various picture values ( see
            DIALOG: "PICTURE-OPTIONS" )

  " ->Raster    #R "
          - Changes the GEM Metafile into a raster picture. The change
            adjusts  itself  according  to  the  degree  of  enlargement or
            reduction.




Window Menus for Texts/Hexdumps:
--------------------------------

  | Window       >>> |
  | Font Size    >>> |
  | Font Select   #F |
  | ================ |
  | -> HexDump    #H |
  
  | -> ASCII-Text #A |
  
  " -> HexDump    #H "
          - opens a new window and loads into it the file from which the
            ASCII file  originated.  The display of the file so loaded  is
            in the Hexdump mode.
  " -> ASCII-Text #A "
          - Opens a new window and loads into it the file from which the
            Hexdump originated. The display of the file so loaded is in the
            ASCII mode.

  | Window  | Iconify     #I |
            | ============== |
            | Reload      #Q |
            
  " Iconify     #I "
          - Iconises the Text or the Hexdump.
  " Reload      #Q "
          - Loads the current text anew.

  | Font Siz| Smaller     #- |
            | Greater     #+ |
            | ============== |
            | Standard    #0 |
            
  " Smaller     #- "
          - Chooses the next smaller character set that is available.
  " Greater     #+ "
          - Chooses the next larger character set that is available.
  " Standard    #0 "
          - Restores the standard character set.




Window Menus for Resource Files:
--------------------------------

  | Window       >>> |
  | SelectTree   >>> |
  | ================ |
  | -> Raster     #R |
  | -> HexDump    #H |
  
  " -> Raster     #R "
          - Opens  a new window, changes the resource tree into a raster
            image  and  displays it there. The created picture can now be
            stored like any other raster picture.
  " -> HexDump    #H "
          - Opens  a  new window and loads the file which describes the
            resource  there. The display of this loaded file will either
            be in ASCII or Hexdump mode.



  | Window  | Iconify     #I |
            | ============== |
            | Reload      #Q |
            
  " Iconify     #I "
          - Iconises the Resource file.
  " Reload      #Q "
          - Loads the current resource file anew.



  | SelectTr| Prev Tree   #- |
            | Next Tree   #+ |
            | ============== |
            | First Tree  #0 |
            
  " Prev Tree   #- "
          - Chooses from Resource files with more than one resource tree
            the  previous  resource tree and displays it. If the currently
            selected resource tree is the first, branches to the last.

  " Next Tree   #+ "
          - Chooses from Resource files with more than one resource tree
            the  next  resource  tree  and  displays it. If the currently
            selected resource tree is the last, branches to the first.

  " First Tree  #0 "
          - Branches to the first resource tree of the resource file.




Keyboard Support
================
   All  actions  within  GEM-View  can  also be effected by key strokes; in
   addition  there  are  several keys which do not correspond to the menus.
   There  are  different  keyboard  setups  when  no  picture is displayed
   (Without  Picture  Window)  and  when  a  picture has been loaded and is
   displayed  (With  Picture  Window).  In  the latter case additional keys
   become  active.  All  keys  are  available in the Program as well as the
   Accessory.

   Without Picture Window
   ======================
   [UNDO]    - Restores the colors, which were present before pictures were
               loaded i.e. at the start of the program.

   [CNTRL]'A'- ("Open  Application  ^A")  Opens  a  previously  iconised
               application.  The position and order of windows will also be
               restored.

   [CNTRL]'B'- ("Break   ^B")  Interrupts,  after  a  security enquiry,the
               action  currently  in  progress  (picture  being  loaded,
               converted  ...).  If no action is currently in progress, the
               program will be ended, after a security enquiry.

   [CNTRL]'C'- ("Icon  Application    ^C")  Iconises the total application.
               This  means  that  all windows (both picture windows and the
               Log  window) are closed but they are not removed from memory
               and  the  position  and  sequence  of  the  windows are also
               stored.  In  order  to  show  that  the application has been
               iconised  a small window with an icon is opened. This window
               is  put  into  the top righthand corner of the screen or, if
               the  Icon Manager is installed, in a position ordered by the
               Icon Manager.

   [CNTRL]'D'- ("Saving  Dflt   ^D")   Presents  a  dialog for setting the
               default destination formats. In the dialog the formats to be
               adopted  for Mono, Color and TrueColor saving can be chosen.
               These  destination  formats will then be used for storage in
               the  command line version when the options,
               -savemono  <name>,-savecolor  <file>,  savetruecolor <file>
               and -saveall{mono|color|truecolor} are used.

   [CNTRL]'E'- ("External    ^E")  Selecting this has the effect that, when
               an  application  is  iconised, picture data is stored in the
               directory  specified  under  "ICONIFY-PATH"  leaving  only a
               small amount of related management information in memory.
               If  this  option  is  switched  off,  or  the  iconise-path
               directory has not been set, the whole of the picture data is
               retained in memory.

   [CNTRL]'F'- ("Presetting  ^F")   This  opens  a  dialog  box for setting
               several picture options which will then act as default values
               in loading pictures.

   [CNTRL]'G'- ("Globals     ^G")   This  opens  a dialog box for choosing
               various  globally-valid  options.  A  button  enables  the
               adoption  of  the current settings or the restoration of the
               original settings/configuration.

   [CNTRL]'I'- ("Identify  ^I")  This opens a  File Selection Box to allow
               the  choice of a picture. The picture is examined and, if it
               is  in a known picture format, the picture type and size are
               reported.

   [CNTRL}'J'- ("Graphic Mode   ^J")
               Here the current setting of the apparatus-specific picture
               format is displayed in a dialog box. As a rule there is the
               statement "palette-mode (xx colors)" to be found.
               When using the various graphics cards  one can check whether
               GEM-View has correctly established the resolution by a screen
               demonstration. With HighColor or TrueColor cards it is
               obvious  whether the correct order of pixels  i.e. bytes is
               effective.
               If, against expectations, GEM-View  fails to run correctly
               in HighColor or TrueColor modes please compare the data in
               the dialog box with that shown in your Graphic Card handbook.
               For a more detailed account see under GEMVIEW.INF/GraphicMode
               and 'CHANGES'.

   [CNTRL]'L'- ("Open Log-Window ^L")  Opens the Console-(LOG)-Window from
               GEM-View  or  brings  it  to the foreground if it is already
               open.

   [CNTRL]'N'- ("Convert  Image     ^N")   For  the  first  time  (2.30) a
               convenience  function  is available which corresponds to the
               <ALT>LOAD  function with automatic engagement of the "Do Not
               Show"  option.   In  the  next  version  you  will  find  a
               window-orientated conversion function.

   [CNTRL]'O'- ("Load Image   ^O")  This also opens a File Selection Box to
               choose  the picture to be loaded.  At the same time the icon
               is  lightened  to  indicate  that  no  other  picture can be
               loaded concurrently.

   [CNTRL]'Q'- ("Quit        ^Q")   Closes  all open windows and ends the
               program.  The operation of the closer button in the GEM-View
               window only brings the program to an end if the menu-line in
               a  multi-tasking  system  has  been  switched  off.
               ( cf GEMVIEW.INF-File.)

   [CNTRL]'R'- ("Resort  Windows  ^R")  Stacks the windows in the order in
               which they were loaded.

   [CNTRL]'S'- ("Small  Windows   ^S")  This defines the mode in which the
               windows  will  be  opened.  Switched  off, the  routine  is
               identical  to  that  in  GEM-View  1.xx i.e. the windows are
               opened  in a maximum size and fitted into the upper lefthand
               corner. Switched on, the routine conforms to Version 2.0x of
               GEM-View where the windows are opened on a staggered stack.
               I  personally  prefer  the  style of Version 2.0x especially
               when,  with  "Selectric",  more  pictures  can  be  loaded
               simultaneously.   Besides,  the  window  with the '*' on the
               numberblock can be switched immediately to the maximum size.

   [CNTRL]'T'- ("Color  Reset   ^T")   When this option is switched on the
               color  palette  of the "TOPPEN" of the corresponding windows
               will  again  be  correctly set. When this option is switched
               off  you will be asked whether the colors should be set anew
               or whether the set colors should be adopted for the picture.

   [CNTRL]'U'- ("Close Window ^U")  Shuts the top window when it belongs to
               GEM-View.  If  GEM-View  is running as an Accessory, and the
               GEM-View  window  is  uppermost, then the picture window and
               the  GEM-View window will be closed and the operation of the
               Accessory  ended.  If  GEM-View  is  running  as  a Program,
               [CNTRL]U  will  only  close  the  window  but  not close the
               program. For that only [CNTRL]Q is effective.

   [CNTRL]'V'- ("About  GEM-View   ^V")  Opens a dialog box containing the
               copyright  notice  and  minor information. To leave this box
               clip on it with either mouse button.

   [CNTRL]'W'- ("Cycle Window      ^W")
               When GEM-View is   running as a program this changes
               the sequence of windows cyclically and will extend to
               the windows called by  AV protocol. When GEM-View is
               running as an  Accessory  the window cycle is passed
               on to the main application when AV protocol dominates;
               otherwise the windows are self regulated by GEM_View.

   [CNTRL]'X'- ("Close All Windows ^X")
               Close all open picture windows!

   [CNTRL]'Y'- ("Auto Iconify      ^Y")
               If this is switched on the picture is automatically
               iconized when you close a window. You can subsequently
               reload this picture under the name "$_UNDO_$"  with
               "Menu/FILE/OPEN ICON".

   [CNTRL]'Z'- ("Install path...   ^Z")
               Allows  the setting of the path where the program stores and
               looks for iconised pictures.

   [ALT]  'C'- ("Clean up...       #C")
               After a security question, deletes all iconised pictures.

   [ALT]  'I'- ("Iconify...        #I")

   [ALT]  'O'- ("Open Icon...      #O")
               Opens a little selection box allowing the choice of iconised
               pictures.





With Picture Window ( Additional )


[HELP]         -Resets  the picture colors anew, in case another Program or
                Accessory  has  altered  the  color  palette. Automatically
                carried out by reference to the "TOPPEN" of the pictures.

[BACKSPACE]    -Performs  a  redraw  of  the  uppermost window if it is a
                picture window.


[ESC]          -(Fullscreen/Normal Display)
                Switches  a  raster picture between a fullscreen and normal
                display.
                Switches  a  GEM-Metafile back and forth between WINDOW-FIT
                and normal display.

[HOME]         -Positions the upper edge of the picture at the top of the
                window.

SFT[HOME]      -Positions The lower edge of the picture at the bottom of
                  the window.

[INSERT]       -Positions the left edge of the picture on the left side of
                the window.

SFT[INSERT]    -Positions the right edge of the picture on the right side
                of the window.

[CRSR-UP]      -Scrolls the displayed area of the picture up one line.


^[CRSR-UP]     -Scrolls the displayed area of the picture up "half a page".


SFT[CRSR-UP]   -Scrolls  the  displayed  area  of the picture up "a whole
                page".

[CRSR-DN]      -Scrolls the displayed area of the picture one line down.

^[CRSR-DN]     -Scrolls  the  displayed area of the picture down "half a
                page".

SFT[CRSR-DN]   -Scrolls  the  displayed  area of the picture down a "full
                page".

[CRSR-LF]      -Scrolls the displayed area of the picture one column to the
                left.

^[CRSR-LF]     -Scrolls the displayed area of the picture "half a page" to
                the left.

SFT[CRSR-LF]   -Scrolls the displayed area of the picture "a whole page" to
                the left.

[CRSR-RT]      -Scrolls the displayed area of the picture a column to the
                right.

^[CRSR-RT]     -Scrolls the displayed area of the picture "half a page"
                to the right.

SFT[CRSR-RT]   -Scrolls the displayed area of the picture "a whole page"
                to the right.

   '*'         -Fits the size of the window to the size of the picture or
                restores the previous size of the window.
                (like the Fuller-Button)


[ALT]   '-' - Raster pics.      : | Pic.Size     >>> | Half        #-
              GEM Metafile Imges: | Pic.Size     >>> | Half        #-
              Texts             : | Font Size    >>> | Smaller     #-
              Resource Files    : | SelectTree   >>> | Prev Tree   #-

[ALT]   '+' - Raster pics.      : | Pic.Size     >>> | Double      #+
              GEM Metafile Imges: | Pic.Size     >>> | Double      #+
              Texts             : | Font Size    >>> | Greater     #+
              Resource Files    : | SelectTree   >>> | Next Tree   #+

[ALT]   '0' - Raster pics.      : | Pic.Size     >>> | Original    #0 |
              GEM Metafile Imges: | Pic.Size     >>> | Original    #0 |
              Texts             : | Font Size    >>> | Standard    #0 |
              Resource Files    : | SelectTree   >>> | First Tree  #0 |

[ALT]   'A' - Raster pics.      : | Colors       >>> | Color Map   #A
              Hexdumps          : | -> ASCII-Text #A |

[ALT]   'D' - Raster pics.      : | Dither       >>> | Quickdither #D

[ALT]   'E' - Raster pics.      : | Dither       >>> | Halftone    #E

[ALT]   'F' - Raster pics.      : | Dither       >>> | Floyd-St.   #F
              Texts/Hexdumps    : | Font Select   #F |

[ALT]   'G' - Raster pics.      : | Options      >>> | Global      #G
              GEM Metafile Imges: | Options      >>> | Global      #G

[ALT]   'H' - Raster pics.      : | -> HexDump    #H |
              GEM Metafile Imges: | -> HexDump    #H |
              Texts             : | -> HexDump    #H |
              Resource Files    : | -> HexDump    #H |

[ALT]   'I' - Raster pics.      : | Window       >>> | Iconify     #I
              GEM Metafile Imges: | Window       >>> | Iconify     #I
              Texts             : | Window       >>> | Iconify     #I
              Resource Files    : | Window       >>> | Iconify     #I

[ALT]   'J' - Raster pics.      : | Dither       >>> | JJN-Dither  #J

[ALT]   'K' - Raster pics.      : | Colors       >>> | Take Colors #K

[ALT]   'L' - Raster pics.      : | Colors       >>> | Color Scale #L

[ALT]   'N' - GEM Metafile Imges: | Pages        >>> | Next Page   #N

[ALT]   'P' - Raster pics.      : | Export       >>> | Print       #P
              GEM Metafile Imges: | Pages        >>> | Prev Page   #P

[ALT]   'Q' - Raster pics.      : | Window       >>> | Reload      #Q
              GEM Metafile Imges: | Window       >>> | Reload      #Q
              Texts             : | Window       >>> | Reload      #Q
              Resource Files    : | Window       >>> | Reload      #Q

[ALT]   'R' - Raster pics.      : | Options      >>> | Raster      #R
              GEM Metafile Imges: | Options      >>> | ->Raster    #R
              Resource Files    : | -> Raster     #R |

[ALT]   'S' - Raster pics.      : | Export       >>> | Save        #S

[ALT]   'T' - Raster pics.      : | Options      >>> | ->TrueColor #T

[ALT]   'U' - Raster pics.      : | Dither       >>> | Stucki      #U

[ALT]   'V' - Raster pics.      : | Options      >>> | Invert      #V

[ALT]   'X' - Raster pics.      : | Export       >>> | Send xAcc   #X





#  T H E  D I A L O G S
=======================


DIALOG   :  "Globals"   (GLOBALS.IMG,GLOBALS1.IMG,GLOBALS2.IMG)
---------------------
This dialog is called either by choosing the "Global" icon or the menu item
"Extras/Globals". In it the Global settings for GEM-View are made.

The buttons "Version" and "Supported" can be selected and,after clicking on
the  "OK"  button,  the requested information will be shown in the GEM-View
window.

"Verbose"/"Quiet"  and  "Correct"/"Original"  are Popup menus which set the
verbosity  of GEMView and the distortion correction of pictures. In certain
resolutions  of  the  ATARI pictures are distorted through an unsymmetrical
pixel.  In  the ATARI ST low resolution the pixels are 10% higher than they
are  wide. In the TT middle resolution the pixels are twice as wide as they
are  high.  The option "Correct" resizes the picture so that the distortion
is eliminated.

The Check button "Bypass(X)IMG" chooses the quicker loading process for IMG
and XIMG pictures. A disadvantage of the process is that only pictures with
a  smaller  or  equal  number  of  colors to  the screen capability can be
loaded  in  this  way.  Furthermore no color matching to the current screen
colors is possible, which sometimes makes reading the menus impossible.

"VDI  Order"  corresponds to the option '-vdicolororder' and interprets the
color of the picture in the sequence of indices of the VDI.
( cf Supported Picture Formats / (X)IMG ).

If  "Clean  Up  ICON's"  is  selected,  then  all  iconised pictures in the
directory  named  in  the  "Instal  Path"  will  be deleted on quitting the
program.

By  de-activating  "RGB  Scaling",  color  valuing is switched off with the
following  consequences.. In  dithering  pictures  red,green  and  blue are
treated  equally  in  brightness  and  their  visual effect. Activating the
switch  has the result that colors are valued according to their brightness
for this purpose.

"Load GDOS-Fonts" loads the GDOS fonts (!) at the beginning of the program.
If,  subsequently, in a GEM Metafile case, the fonts are required they are
already  in  memory.      If this option is not used then one saves memory
but the font must be loaded again for a redraw.

With  "_%  Zoom/Shrink  the magnification can be set which will be utilised
in steps for Metafiles. '0' corresponds here to 100%, i.e. as follows:
100%, 200%, 300%, 400%,... for magnification, and
100%, 50%, 33%, 25%, 20%.. for reduction.
A new calculation of magnifying/reducing factors on the basis of the new
value only made after pressing <ALT>+, <ALT>- .

"Load"  loads  the old settings from the GEMVIEW.INF file and "Save" stores
the adjusted values. From version 2.30 onwards these entries produce a File
Selection Box to choose the .INF file to load or save.



DIALOG   :  "Presetting"  (PRESET.IMG,PRERAST1.IMG,PRERAST2.IMG)
------------------------
This  dialog  can be invoked by the choice of the "Preset" icon or the menu
item  "Preseting...     ^F".  With it one can choose in advance a number of
settings to be effective during the loading of pictures.
Note  that  the  field behind "Window" must be selected when this option is
desired.
The  set  values  can be stored by means of the "Save" button in the dialog
"GLOBAL-OPTIONS".

The  button,  "Color-Dithering"  enables  the setting of color reduction by
means  of  a  color-extended Floyd-Steinberg algorithm. The shadowed button
permits the presetting of the algorithm for changing a color picture into a
black-and-white  one.   Available  for  this  are  "Floyd-Steinberg",
Jarvis-Judice-Ninke",  "Stucki",  "Halftone",  "Quick-Dither"  and "Ordered
Dither".  The  Ordered  Dither process built into GEM-View is very flexible
and  allows a choice of widely-varied dither matrices from a File Selection
Box  which  appears  after  selection  of  this mode.  The dither matrix is
nothing  but  a  16x16  pixel sized picture in which it has been determined
whether  a  pixel  should  be set black or white. The format for the dither
matrices  is  identical  with the format employed by PhotoLab. A more exact
explanation  with  a  program for generating dither matrices follows. Until
then it means using the available .DIT files and a pleasing effect.

If  "No  Dithering"  is  chosen  but  it  becomes  necessary because of the
resolution being used, the Floyd-Steinberg algorithm will be employed.

"RGB Scaling Adjust". See the description of this dialog further down.



DIALOG : "Graphic Mode" (GRAPHIC.IMG, GRAPHIC1.IMG .... GRAPHIC5.IMG)
-----------------------
This  shows  the  established  settings  of  the apparatus-specific picture
format  in  a dialog box. As a rule a statement is found there in the form,
"palette-mode(xx  colors)".  In  HighColor mode 2 bytes are always used for
each pixel, on which the realisation of the Graphic Card driver depends. It
is  possible  here  to utilise the Motorola format or the Intel format - in
the  latter  case  the  two bytes are exchanged.  In TrueColor mode one can
differentiate   between   Motorola and Intel formats and between 24 bit and
32  bit.  In  Motorola  format the colors red, green and blue are stored in
that  order  (  always  as  bytes  ); in Intel format the sequence is blue,
green, red.
e.g.  xRRRRRGG|GGGBBBBB  :  the  top  bit  is  not  used in this format,the
following  5  bits  determine  the  red  content, the next 5 bits the green
content  and  the  lowermost  5  bits the blue content. In addition, in the
Intel format the two bytes are changed round.
      RRRRRGGG|GGGBBBBB  :   The  5  highest  value  bits determine the red
content of the pixel, the next 6 the green content and the lowermost 5 bits
the  blue  content.   In  addition,  in  the Intel format the two bytes are
still changed round.
      RRRRRGGG|GG?BBBBB    :   The  5  highest value bits determine the red
content  of  the  pixel,  the  next  5  or,  as appropriate  6, the green
content  (  depending  on the number of color planes indicated in the VDI )
and the lowermost 5 bits the blue content.
      Should the HighColor format of the FALCON030 be like this !?
In addition, in the Intel format the two bytes are still changed round.
      GRRRRRGG|GGGBBBBB   :  Here  the  top bit represents the lowest value
green  bit.   This means that a change of this value (bit) causes the least
alteration  to  the  green content. ( cf in this connection the 4 bit color
palette  of  the STe/TT.)  The remaining bits are used in a fashion similar
to  that  described  in  the  preceding example.  In addition, in the Intel
format the two bytes are still changed round.

For the SPEKTRUM 1HC/TC Graphic Card the following setting is laid down:-
      HC-Mode Intel/xRRRRRGG|GGGBBBBB
      TC-Mode Intel/RR GG BB

For  the  Graphic  Card - MegaVision 300 from SANG the following setting is
laid down:-
      HC-Mode Motorola/xRRRRRGG|GGGBBBBB
      TC-Mode Motorola/RR GG BB xx

For  the Card - CyRel 16M-1280 from Cybercube the following setting is laid
down:-
      TC-Mode Motorola/RR GG BB xx

For the Falcon the following setting is laid down:-
      (15) HC-Mode Motorola/RRRRRGGG|GGxBBBBB
      (16) HC-Mode Motorola/RRRRRGGG|GGGBBBBB



DIALOG : "Open Icon" (OPEN.IMG)
--------------------
This   dialog   can   be  called   by clicking on the "OPEN" icon, the menu
items "File/Open". Here a choice of the pictures to be opened can be made. 



DIALOG  : "Iconify"  (ICONIFY.IMG)
-------------------
This  dialog  can be called from the menu item "Iconify...   I" in the main
menu.  Here  you  should give the name under which the iconised image will
be  dealt  with.    In  the  case  of a name conflict,  you will be asked
whether  you  wish to abandon the action, enter a new name or overwrite the
existing picture.



DIALOG  :  "RGB Scaling Adjust" (RGBSCALE.IMG)
-------------------------------
The  choices  of  setting  in this dialog have effect upon the color values
(RGB)  in  dithering  and  in  the  display of a color picture. Setting the
intensity  is  only  effective  on  pictures  which  are  dithered  and  in
calculating  grey  values.   The settings for red, green and blue come into
effect  when  leaving  the  dialog for the corresponding color picture. The
information  on  color  manipulation  is  thus  used  separately  for  each
picture.The  course and the presentation of the curves (line drawings) show
clearly  the  adjustments  to the colors. In the presentation of these line
drawings there are various modifying elements:
   '+' increases the number of points supporting the line by 1. (max.3)
   '-' diminishes the number of support points by 1.
   with  the  arrow  keys  '->'  and  '<-'  the  active  support points can
   be chosen, to which the following operations relate;
the  active  support  points are indicated by a filled-in circle, the other
points  are simple (hollow) circles.  Next to the line drawings there are 3
further  effective  elements,  '^','v'  and  'o'.  The  little  upwards and
downwards  pointing  arrows  move  the active support points one step up or
down. The button ('o') puts the active support point into the middle.
Let's  use as an example the setting and interpretation of the line drawing
for  the  red color content. In the horizontal delineation the intensity of
the color in the original picture is shown, starting from the left ( no red
color  content ) and going up to the right ( full red color content ). From
the  vertical  delineation  one  can  determine  the intensity of the color
content  which  is  used  for  the  picture.   The  line  drawing shows the
relationship  between  the  original  colors  and  the  adopted  colors. By
choosing a color intensity from the horizontal base line, going straight up
until  meeting  the  line drawing and then moving horizontally to the left,
the  point  reached  shows the intensity of the color content ( vertical )
chosen, by reference to the original ( horizontal starting point ).
A  straight  line from lower left to upper right means that every intensity
depicted produces its own value so that, in the final effect, there is no
change.   If  the curve hangs downwards then that color is weakened. If the
curve bends upwards that color is strengthened.
A picture says more than a thousand words: so........ try it out !!!!!



DIALOG  : SAVING DEFAULT (SAVEDFLT.IMG,SAVEP{MON,COL,TRU}.IMG)
------------------------
"Format......"      The target formats can be set against  "Mono", "Color"
 and  "TrueColor".  The  target  formats for saving can be specified in the
 command  line  version  by the options -savemono <name>, -savecolor <file>
 and  -saveall  {mono|color}. In the next version of GEM-View there will be
 a built-in, convenient, window-supported picture conversion facility.



DIALOG  :  PICTURE-OPTIONS (PICTURE.IMG,PICTURE(1,2).IMG,SCREEN.IMG)
--------------------------
This  dialog  can  be  accessed  from  the  'concealed'  menu  at  item
Options|Global.  Here global picture settings can be chosen.

"Format.....".At the side of  the  buttons, "Mono", "Color" and "TrueColor"
the target  formats for saving are displayed.  These are set in advance and
become active when storage in  the  categories  "Mono", "Color" or
 "TrueColor" is wanted. From top to bottom:
     Storage   Monochrome Format,
               Color Format and
               TrueColor Format.

Please  note  the  following way in which the algorithm works .This
process  was  chosen for this reason , because a previous identification of
picture  types  by  the  user  is  too complicated.
- As an  example  imagine  that  all  storage  formats  have  been  put
  separately from each other:
                     Mono:   "IMG"
                    Color:   "GIF"
                TrueColor:   "TIFF (like pic.)"

-  You  choose  <ALT>"Load  Image....     ^O"  or "Convert image..  ^N"
   and choose the storage format TrueColor.

-  If  one deals with the chosen picture as a monochrome or a simple color
   picture,  it is stored in the same form ( mono picture or color picture)
   in the chosen storage format ( TIFF ).
   In the case of a monochrome picture, you obtain a mono TIFF picture.
   In the case of a simple color picture you obtain a TIFF color picture.
   If,  on  the  other  hand,  you  had  chosen "TIFF (TrueColor)" against
   "TrueColor",  then  you  would  have  obtained a TrueColor Tiff picture
   from a color picture  and    a  monochrome picture furthermore from a
   monochrome picture.

"SAVE  COLOR"  saves the loaded picture with the full range of colors. This
means  that  in each resolution a chosen picture can be transformed into an
(X)IMG picture with as many colors as you like.
Example  -  a 256 color GIF picture.
Hold  down  the  ALTERNATE  key  while  clicking  on the window Load button,
choosing the "Load...."  entry in the menu or pressing [CNTRL] O.
If,  additionally, you choose another option e.g. "Color-Dither", "Rotate",
"Brighten",  "Colors"  or  "Zoom",   then  this option will be effected
before  storage.   i.e.  the  work  on  the  picture  (  color  reduction,
magnification,.... ) is saved.

"SAVE  MONO"   dithers  the  picture using the Floyd-Steinberg algorithm if
nothing  else  has  been indicated. Just as immediately above, the options,
"Color-dither",  "Rotate",  "Brighten",  "Colors"  and "Zoom", are effected
before saving.

"LOAD HEX"  loads the file, irrespective of its contents,as a hexdump. When
this  button  is not chosen, a file will nevertheless be loaded as a hexdump
if nothing in it is recognized as a picture.

"NOT SHOW"  If this option is chosen the picture will not be displayed. Its
only  sensible  use,  if  chosen  with "MONO", "COLOR" or "TrueColor",is to
undertake a clear conversion without loss of quality.

The  choice  of the Fullscreen button rolls down a further dialog (SCREEN),
in  which  the  size of an actual screen can be shown.  This value is taken
from  the GEMVIEW.INF file and is also stored by means of the "Save" button
in the GLOBAL OPTIONS menu.



DIALOG  : RASTER-OPTIONS (RASTER.IMG,PRERAST1.IMG,PRERAST2.IMG)
------------------------
This  dialog can be accessed by the menu item Option->->-> Raster. Here one
can  choose  raster-specific  settings.  You  must make sure that the field
behind  "Clipping"  is  selected,  if  this  option  is required. Otherwise
compare the settings with the options from "GEM-View as GTP".
The button "Color-dithering" provides the set option for color reduction by
means of an enlarged Floyd-Steinberg algorithm.
The  shaded  button  provides  the choice of algorithm for changing a color
picture  to  a  black  and white one. Available here are "Floyd-Steinberg",
"Halftone",  "Quick-Dither"  and "Ordered Dither".  In GEM-View the Ordered
Dither  process  has  great flexibility built in and allows the choice of a
wide  variety  of  dither  matrices  from  a File Selector Box.  The dither
matrix  is  really  nothing  more than a 16x16 pixel sized picture in which
each  pixel  is either black or white.  The format for the dither matrix is
identical with  that used by PhotoLab. A precise explanation follows with a
program  for  generating dither matrices. Until then use the existing .DIT
files and see what effect pleases you.



DIALOG : SAVE-PICTURE (SAVEPMON.IMG, SAVEPCOL.IMG, SAVEPTRU.IMG)
---------------------
In  this  dialog  the  target  format  can be chosen which will be used for
storing  pictures.   One  has to differentiate between monochrome pictures,
color pictures and TrueColor pictures.

For monochrome pictures the following formats are supported:
    o "GEM-Image"         | "*.IMG"
    o "Enhanced Simplex"  | "*.ESM"
    o "GIF 87a Image"     | "*.GIF"
    o "IFF Imagefile"     | "*.IFF"
    o "MS Window Bitmap"  | "*.BMP"
    o "Targa Image"       | "*.TGA"
    o "TIFF Image"        | "*.TIF"

For color pictures the following formats are supported:
    o "GEM-XImage"        | "*.IMG"
    o "Enhanced Simplex"  | "*.ESM"
    o "ESM (TrueColor)"   | "*.ESM"
    o "GIF 87a Image"     | "*.GIF"
    o "IFF Imagefile"     | "*.IFF"
    o "MS Window Bitmap"  | "*.BMP"
    o "Targa Image"       | "*.TGA"
    o "TIFF (packed)"     | "*.TIF"
    o "TIFF (8 BPS)"      | "*.TIF"
    o "TIFF (TrueColor)"  | "*.TIF"

For TrueColor pictures the following formats are supported:
    o "GEM-XImage"        | "*.IMG"
    o "Enhanced Simplex"  | "*.ESM"
    o "ESM (TrueColor)"   | "*.ESM"
    o "MS Window Bitmap"  | "*.BMP"
    o "Targa Image"       | "*.TGA"
    o "TIFF (like pic.)"  | "*.TIF"
    o "TIFF (TrueColor)"  | "*.TIF"



DIALOG : METAFILES -> RASTER (GEMRASTE.IMG)
----------------------------
The  dialog  for the conversion of GEM vector files to raster images offers
several  setting  possibilities,  which  are  taken  into  account in those
changes:

"Transfer  TEXT     "  -  Transfers texts into the raster picture when this
                          option has been chosen.


"Transfer   PATTERN"   -  Filled patterns are transferred if this option is
                          switched  on  or  the areas are shown as unfilled
                          areas if it is switched off.

"SOLID  PATTERN"  -  If  the option "Transfer PATTERN" is switched off, the
                     choice  can  be made here whether the relevant area is
                     transferred  as  an outlined hollow (switched off ) or
                     as a solidly filled in area.(switched on.)


"Preset  Clip  rect"  -  Switches  on  clipping  over  the total area to be
                         changed.  This  option should preferably always be
                         switched  on!  However, if it should happen that a
                         part  of  the  picture  is  missing, switch it off
                         experimentally and start the conversion again.



DIALOG  :  COLOR MAP  (COLOR.IMG)
--------------------

Offers  a simple dialog for altering the colors of the picture. The setting
of  "RGB-Scaling-Adjust" is taken into account.  The value after "Set: " is
the  original  value  (without  considering  the "RGB-Scaling-Adjust ); the
reported value after "Scale: is the displayed value.
The  color  which  is  to be changed is indicated by marking left and upper
arrows.   The indicated color can be changed by moving the sliders or using
the arrows in the lower part of the dialog.




Special Features.
=================

WILDCARDS
---------
A  series  of  files which conform to a given pattern can be specified by
using the so-called "Wildcards".
The  entry  '*.IMG'  -  in the File Selector Box - chooses all files in the
current directory which have the ending '.IMG'.
A short summary:

            '*.*'    :All files.
            '*'      :All files without an extender.
            '*.IMG'  :All files with the extender 'IMG'.
           'F*.GIF'  :All 'GIF' files, where the first character is 'F',
                     :followed by any chosen letters (can include '0').
           'F?.IFF   :All 'IFF' files, where the first character is 'F',
                     :followed by only one but freely-chosen character.
        'G???*.*     :All files with at least 3 characters following 'G'.



AUTOMATIC CONVERSION OF FILES IN A DIRECTORY.
---------------------------------------------
You should proceed as follows to automatically convert a series of pictures
from a directory (folder):
   - Put the target formats you want in the "Saving dflt  ^D" dialog
     against the respective base formats - Monochrome picture, Palette Color
     picture and TrueColor picture.
   - Choose "Not show" in the "File" menu. In this way "Save all" will
     be automatically activated.

Choosing  "  Load  Image..  ^O"  will  now result in all the pictures being
converted into the correct target formats without further enquiry.
When  "Save  all" is chosen, but not "Not show", the pictures will first be
converted  and  then  subsequently  changed  and  displayed.  The  order of
proceedings is as follows:-
All the target storage formats are installed differently from one another,
e.g.           Mono  :  IMG,
               Color :  GIF,
            TrueColor:  Targa.
- Loading a monochrome picture you obtain a nonochrome IMG picture.
- Loading a simple color picture you obtain a GIF color picture,
- Loading a TrueColor picture you obtain a TrueColor TARGA picture.
- With  the help of the Preset dialog ("Preseting") further transformation
  factors can be defined in advance which are effected before the storage
  of the pictures.
- The process can be interrupted by using " Break..   ^B".
- By  using  Wildcards  it is now possible to convert a number of pictures
  automatically.  If  you use the "Selectric" File Selector Box, you can
  deal with all the desired files together by means of a <SHIFT>-Click.

Example:  You want to change all IMG pictures to monochrome GIF pictures.
- Enter under "Saving Dflt...  ^D",  "GIF" as the mono target format.
- In  the  Preset dialog choose a dither process with the shaded button by
  the word "Colors..". e.g. "Floyd Steinberg".
- Choose  "Not  show"  or "Save All".  This depends on whether viewing is
  wanted or not.  For a large number of pictures the available windows may be
  insufficient so I would recommend "Not show".
- From the "File" menu now choose "Load Image.. ^O" giving as the filename
  '*.IMG' and clicking on "OK".
- You can now follow the progress of the converting process in the GEM-View
  window.



Environment Variables:
======================

 o GVW_PATH
   

A  path  can  be  entered  here, where GEM-View will look for pictures,if a
complete  path  has not been provided. As soon as a place holding the
relevant file  is found  this  is  used  and  further  search  is stopped.
Separation markers between the paths can be ' ', ';' or ','.
As an example
"GVW_PATH=D:\BILDER D:\PAINTER.PIC E:\PICS F:\GVW\PICS" is entered.
Following that, pictures having the names shown will be looked for in the
indicated places.....

 "BILD1.IMG"
 
   1. Current Directory (Marking '.'): .\BILD1.IMG
   2. D:\BILDER\BILD1.IMG
   3. D:\PAINTER\PIC\BILD1.IMG
   4. E:\PICS\BILD1.IMG
   5. F:\GVW\PICS\BILD1.IMG

 "IMAGES\BILD2.GIF"
 
   1. Current Directory (Marking '.'): .\IMAGES\BILD2.GIF
   2. D:\BILDER\IMAGES\BILD2.GIF
   3. D:\PAINTER\PIC\IMAGES\BILD2.GIF
   4. E:\PICS\IMAGES\BILD2.GIF
   5. F:\GVW\PICS\IMAGES\BILD2.GIF

 "C:\IMAGE.S\BILD3.JPG"
 
   1. C:\IMAGE.S\BILD3.JPG





The Drag and Drop Protocol.

The "DRAG and DROP" protocol is supported by MultiTOS. If a Desktop icon or
name from a Desktop window is dragged onto a window of an application, the
application  is sent a message. GEM-View evaluates such a message and loads
the  file represented by the icon.  The subsequent display is in accordance
with the contents 0f the file.



The View protocol ( see enclosed documentation )

This protocol has been produced by Peter Seitz with help from me and offers
a  straightforward  means  of  loading stored pictures into the so-called
Viewer  and  then  displaying  them.  A  development  permitting the direct
transfer of pictures in any format is being worked on.
For  further  and  more  detailed  information  please  read  the  provided
documentation, "VIEW.TXT"!



The AV Protocol {see GEMINI Documentation}

Besides  running  as an accessory, GEM-View also runs as the main program.

As the main application it will understand messages of the following kind:
'AV_SENDKEY', 'AV_ACCWINDOPEN', and AV_ACCWINDCLOSED.
Windows announced with AV-ACCWINDOPEN will operate with the Window-cycle.

As an   ACCessory   'VA_START',  'VA_DRAGACCWIND' will be supported.
That  means that you can, for example, load pictures by draging an GEMINI-
icon-file onto the GEM-View window.



The xACC Protocol. { See documentation  xAcc from Konrad Hinsen }

GEM-View,  since  version  2.30,  supports  the  xAcc2 protocol. Since that
version  GEM-View  can  receive  (X)IMG  pictures,  GEM Metafiles and ASCII
texts  and transmit (X)IMG pictures.



GEM-Show {(c) Dieter Fiebelkorn }

This  is  a  small  program  that  can  be  called  as  a file viewer under
MultiTOS.  All  requests  are  passed on to GEM-View and if necessary first
loaded.  See, in this connection, GEM.CFG also!

-------------------------------------------------------------------------
# SHSHOW       - full path for desktop view file utility
# Desktop's show
setenv SHSHOW=C:\MINT\GEMSHOW.PRG   # for Desktop
setenv GEMVIEW=C:\BIN\GEMVIEW.PRG   # for GEMSHOW
-------------------------------------------------------------------------




GEM-xAcc {(c) Dieter Fiebelkorn }

Is  a  small  program which demonstrates the sending and receiving of xAcc2
messages.  Since version 2.30  GEM-View  can  receive  (X)IMG  pictures,
GEM Metafiles and ASCII texts  and transmit (X)IMG pictures.



GEM-VIEW { (c) Dieter Fiebelkorn }

Demonstrates   the  sending  of  messages  under the VIEW protocol. See the
accompanying documentation.



The File Selector "Selectric" {(c) Stefan Radermacher }

GEM-View  supports  the  multiple-selection  of  the  File  Selection  Box,
"Selectric".



VDI-Fix {(c) Karsten Isakovic }

This  additional  program is included on the disk- one that corrects a flaw
in  the  VDI.  In  so  far  as  you are not using NVDI then it is earnestly
suggested  that  you  copy  this  program into your AUTO folder as GEM-View
is  based  on an orderly functioning of the VDI. Further information can be
obtained from the enclosed descriptive matter on VDI-Fix.



WINX 2.0 {(c) Martin Osieka }

A  second  additional  program is included on the disk, which increases the
number of available windows to 40. Further information will be found in the
accompanying descriptive matter on WINX.



MultiDialog 1.02  { (c) Helmut Neukirchen }


MultiDialog   anchors itself onto the o/s and makes sure that  any
GEM applications that those dialogs become dealt with complete in windows.
Under  a multitasking GEM other applications can keep on running unhindered
from  there.  Such dialogs perhaps know from other newer applications where
dialog boxes already standard/in production in windows can be found.

MultiDialog does the same,  only with any GEM application.
- The dialog boxes need not necessarily appear in the middle.
- The dialog boxes appear in windows!
- MultiDialog therefore makes FlyDials superfluous!
- During the dialog processing the multitasking continues!

The concept 'any GEM applications' must be a relative one; in reality there
are  many  programs  where  MultiDialog  has no effect. If this is the case
with   a   program,  then  the  corresponding  dialog  will carry on in its
accustomed  way, with the consequence that the Multitasking is brought to a
standstill.



GEM-View as GTP  ( GEM Takes Parameters )

If  GEM-View  is started as a GTP program ( preferably from a shell ), many
parameters  can  be  handed  over  to the program. They can be divided into
global  and picture-orientated options. The global options can stand in any
position in the parameter list, always refer to all pictures and constitute
a  base  position.  The picture-related options take effect from the moment
they  appear  and  refer  to  the next presented picture. Some options have
effect for more or all subsequent pictures unless the setting of the option
is  varied.  These  are:  -brighten,  -colors,  -dither, -halftone. -xzoom,
-yzoom, -zoom.
When  transferring  parameters  by  either  the  xArg  process  or the ARGV
process, the treatment of overlong parameters is supported.
For  METAFILES   only  -fullscreen,  -noshow,  -zoom,  -xzoom,  -yzoom  are
observed.

Developed Treatment of Parameters:

GEM-View permits the treatment of parameter lines in the form:
  "GEMVIEW C:\DIR1\A.IMG,B.IMG,C.IMG D:\DIR2\D.IMG F:\DIR3\E.IMG,F.IMG"
This  means  that  the  pictures A.IMG, B.IMG, and C.IMG from the directory
C:\DIR1\ will be loaded.  i.e. the files ( with complete path names )--
C:\DIR1\A.IMG, C:\DIR1\B.IMG und C:\DIR1\C.IMG.
The picture D.IMG will be loaded out of the folder -  D:\DIR2\
The pictures E.IMG und F.IMG will be taken from Directory F:\DIR3\ .

In its working this is identical with the following form of parameter line:
  "GEMVIEW C:\DIR1\A.IMG C:\DIR1\B.IMG C:\DIR1\C.IMG D:\DIR2\D.IMG
           F:\DIR3\E.IMG F:\DIR3\F.IMG"




GLOBAL  Options:

bypass            -load (X)IMG file directly into GEM format

This  option  causes an (X)IMG picture to be loaded directly in the form of
the  current screen resolution.  Most importantly, lots of time is saved in
conversion  calculations  which  are no longer necessary. A disadvantage is
that  only  pictures with  a  smaller number of colors than, or an equal
number of colors to, the screen  resolution can be loaded in this fashion.
Furthermore no color matching  to  the  current  screen  colors is carried
out,  which sometimes makes reading the menus impossible.


correct           -straighten out the displayed image ( default )

Pictures  can  be  distorted  according  to  the resolution of the ATARI by
reason  of  an unsymmetrical pixel size. In the ATARI ST low resolution the
pixel  is 10% taller than it is wide. In the TT middle resolution the pixel
is  twice as wide as it is tall.  This option magnifies the pictures in the
dimension that will eliminate the distortion.


fullscreen        -use entire screen width and height for zoom
                  -display full METAFILE inside the window

The  given  picture  is, if possible, magnified in such a way that it fills
the screen in the current screen resolution.
In  the  case  of  Metafile  images  this option means that the Metafile is
enlarged  or  reduced  in such a way that it can be completely displayed in
the current window. The factors change when the size of the window changes.

fullzoom WxH      -use width and height for zoom
The  given  picture is, if possible, magnified in such a way that the given
values correspond.

fullrepeat WxH    -use width and height for repeating image
The  given picture will be repeated horizontally and vertically as often as
the height and width values reached.


identify          -identify given images

Try  to  identify the following given picture with the help of the extender
and  the file header. If it is recognised as a supported picture type, then
the picture format as well as the size of the picture is reported. If it is
not a recognised format then an appropriate notice appears.


norgbscale        -don't scale RGB colors

During  the  dithering of a picture a default evaluation according to color
is  used  (blue is darker than red is darker than green ). By means of this
option the evaluation is switched off.


noshow            -don't stop to show the pictures

With  this  option  GEM-View  adopts  a  batch  working  mode  in which the
calculated  pictures  are  not  shown.  This  is  helpful  when a number of
pictures   of a "foreign" format are being converted to IMG pictures with a
specified number of colors and stored.


original          -use original pixels for displaying image

Opposite  to  -correct;  paints  a  pixel  on the screen for a pixel in the
picture and ignores any resultant distortion.


quiet             -silence is golden

Suppresses  the multitude of messages which are shown during the processing
of the picture. Instead only the type and size of the picture are reported.


saveall {mono|color|truecolor} -save all followed images...-files

Saves  all  the  given pictures as monochrome pictures or as color pictures
under the name of the source picture with the appropriate extender from the
SAVING-DEFAULT  stated  picture  formats.  Very  useful in conjunction with
-noshow.


supported         -show supported image types

Gives a list of all supported picture formats in the GEM-View window.


tonescale r,g,b,i -tone scale (red,green,blue,intensity)
                  in dithering and display colormap.

During  the  dithering  of  a  picture, correction of the color contrast is
effected  according to default values.  By means of this option the sort of
correction  for  each  color singly and for the calculated greyscale values
can be set between 1 (lightening) and 7(darkening).
With  color  pictures  the  red,  green and blue values will be adopted to
correct the corresponding color content.

Value  1        lightens  dark  grey values very strongly or diminishes the
specified  color component very strongly.

Value  2         lightens dark grey values or diminishes the specified color
component strongly.

Value  3        lightens  dark  grey  values weakly or diminishes the
specified color component correspondingly.

Value  4      does  NOT  change  the  grey values  nor the specified color
component.

Value   5          darkens light grey values very slightly or increases the
specified color component very slightly.

Value  6        darkens light grey values or increases the specified color
component strongly.

Value   7          darkens light grey values very strongly or increases the
specified color component very strongly.


vdicolororder     -loading XIMGs with VDI-Color-Order

Through  this  option the colors in the header of a saved XIMG picture will
be interpreted in the VDI indices sequence.


verbose           -whistle while you work (default)

The  opposite  of -quiet. Displays notices on the progress of all stages of
picture processing in the GEM-View window.


version           -show version and patch level

Displays  the  current version, the patch level and the Copyright notice in
the GEM-View window. Follows automatically at thr start of a program.




PICTURE RELATED Options

at X,Y               - load image at location

Specifies the starting position of the following picture in relation to the
previously loaded picture. Only effective in connection with -merge.


brighten percentage  - specify brightness multiplier

Brightens  up a picture or darkens a picture, according to the statement of
the  brighten  factor.  If  it  is  more than 100% then the picture will be
lightened; less than 100% and it will be darkened.


clip X,Y,W,H         - use clipped portion of image

Cuts  out a rectangle from the following picture at the position (x,y) with
the width w and the height h.


colordither number   -switch on or off the color dithering
                     (-10...  0... 10)

This  option has the result that by using the original Atari color palette
(b.e. with  16  colors) and simulated more than the existing colors on
screen. Because the human eye can see more colors as really exist.
If the picture is being dealt with as a greyscale picture then the number
of grey scales resulting from the color dithering is as shown below.
Pictures  produced  in  this  way  are  substantially  better than through
a color reduction, (cf -colors), because the impression created for the
human eye is of more than 16 or 256 colors.
Furthermore  one  is  not  tied  to  the  limited  possibilities  of choice
presented by the color settings.
This option has  precedence  over the  option "-colors"; so that if this
option is set in the GEMVIEW.INF file, then the middle "-colordither 0" must
be  explicitly  switched   before a color reduction with -colors can be
carried out.

  0 - Switches the color dithering off.
Color dithering always undertaken
  1 - Color dithering to 4 Colors.
  2 - Color dithering to 8 Colors.
  3 - Color dithering to 16 Colors.
  4 - Color dithering to 64 Colors.
  5 - Color dithering to 256 Colors.
  6 - Color dithering to 4 Grey Shades.
  7 - Color dithering to 8 Grey Shades
  8 - Color dithering to 16 Grey Shades.
  9 - Color dithering to 64 Grey Shades.
 10 - Color dithering to 256 Grey Shades.
Color dithering  only carried out where the number of colors in the picture
is greater than the number of colors in the screen:
 -1 - Color dithering to 4 Colors.
 -2 - Color dithering to 8 Colors.
 -3 - Color dithering to 16 Colors.
 -4 - Color dithering to 64 Colors.
 -5 - Color dithering to 256 Colors.
 -6 - Color dithering to 4 Grey Scales.
 -7 - Color dithering to 8 Grey Scales.
 -8 - Color dithering to 16 Grey Scales.
 -9 - Color dithering to 64 Grey Scales.
-10 - Color dithering to 256 Grey Scales.


colors number     -specify maximum number of RGB colors

This  gives  the  maximum number of colors which the picture may have after
the  processing.   It  makes sense if fewer colors are to be presented than
the  current resolution allows or in batch working, to reduce the colors to
a presentable measure.


dither            -dither color image to bitmap image

Changes  a  color  picture,  by  means  of  an  alternating Floyd-Steinberg
algorithm into a monochrome picture.


halftone          -halftone a color image to bitmap image

Changes a color picture into a black and white picture in which every color
pixel is represented by a 4x4 monochrome matrix.


merge             -merging following picture to loaded picture

Overlays  the  following  picture  in  such  a  way that the already loaded
picture  constitutes  the  background;  the  following picture replaces the
hitherto  presented  picture in the stated position (-at) and in the stated
size  (-clip).  If the picture becomes larger in consequence of the merger,
then  the picture size conforms automatically. The command '-merge' relates
only to the next following picture.

rotate degrees    -rotate an image by a 90 degree angle
Turns  the  picture  in  90  degree  steps.  The turning always takes place
clockwise. A turning of 270 degrees means the same thing as a turning of 90
degrees anti-clockwise.


savemono name     -save monochrome picture

Stores the picture as a monochrome picture with the name 'name'.


savecolor name    -save color picture

Stores the picture as a color picture with the name 'name'.


savetruecolor name-save truecolor picture

Stores the picture as a TrueColor picture with the name 'name'.


xzoom percentage  -zoom the X axis by a percentage

Enlarge  the  following  picture  in  the  horizontal  by  the given factor
percent.  A  value  greater  than 100% results in enlargement; a value less
than 100% a reduction.
By  employing the -correct option the possibility of a necessary horizontal
enlargement  (  ST  low  resolution  )  is  introduced.     This means that
'-correct   -xzoom 200' in the ST low resolution has the result that a true
horizontal enlargement of 220% ensues.


yzoom percentage  -zoom the Y axis by a percentage

Enlarge  the following picture in the vertical by the given factor percent.
A  value greater than 100% results in enlargement; a value less than 100% a
reduction.
By  employing  the  -correct option the possibility of a necessary vertical
enlargement  (  TT  middle resolution ) is introduced.      This means that
-correct  -yzoom 200 in the TT middle resolution has the result that a true
vertical enlargement of 400% ensues.


zoom percentage   -zoom the image by a percentage

Corresponds  to  a horizontal and vertical enlargement by the given factor.
Here also a necessary correcting enlargement may be introduced.




Examples:
"""""""""

gemview bild1.gif bild2.img bild3.tny

Loads  the pictures with the names BILD1.GIF, BILD2.IMG and BILD3.TNY one
after the other and displays them in a window.

gemview -noshow -colors 16 -saveall color a.gif b.gif c.gif d.gif

Loads  the pictures A.GIF, B.GIF, C.GIF and D.GIF sequentially, reduces the
color  palette to 16 colors and saves the pictures in XIMG format under the
names  A.IMG,  B.IMG,  C.IMG  and  D.IMG  when XIMG format is entered under
'DfltSavingColor'.  Otherwise  the  different  saving  format  entered as a
default  would  be  used. (e.g.GIF87a)  When all pictures have been loaded,
processed  and  stored,  then  GEM-View reports back in the GEM-View window
with a 'READY'.

gemview pic -merge -at 100.50 -clip 100.50.320.160 -brighten 150 pic

Load  the  picture with the name 'pic' and overlay it at the point (100,50)
by a cutting of width 320 and height 160 of the same picture which has been
brightened by 150%.

gemview  -savecolor pic.out pic -merge -at 160,100 -brighten 150 pic

Load  the picture with the name 'pic' and overlay it at the point (160,100)
by  the  same  picture  which has been lightened by 150%. On the assumption
that  the  size  of the picture is 320x200 pixels, then we obtain a picture
sized  480x300 [(320+160)x(200+100)]. That picture is then stored under the
name 'pic.out' as a color picture, having the target format specified under
'DfltSavingColor'  (  see GEMVIEW.INF ) appropriate to the entrance format.
Subsequently  the  picture is fitted and displayed using the current screen
resolution.

gemview -noshow -savecolor pic.out pic -merge -at160,100 -brighten......

Suppresses the fitting to the current screen resolution and display.

gemview -saveall color pi1 -merge -at 160,100 -brighten 150 pi2

Load  the picture with the name 'pi1' and overlay it at the point (160,100)
by  the  picture  'pi2' which has been lightened to 150%. On the assumption
that  the  size  of the picture is 320x200 pixels, the outcome is a picture
sized  480x300   [(320+160)x(200+100)].  That  picture  will  afterwards be
stored  under the name 'pi1.<extender>'. The extender employed will be that
appropriate  to  the  target format which has been set by "DfltSavingColor"
(see GEMVIEW.INF ).
A  "gemview  -noshow  -savecolor  pic  ...'  suppresses  the fitting to the
current  screen  resolution and the display.
"gemview -noshow -saveall color pi1 -merge -at 160,100 -brighten 150 pi2"
suppresses the fitting to the current screen resolution and the display.

gemview pi1 -merge -at 160,100 pi2 pi3

Load  the picture with the name 'pi1' and overlay it at the point (160,100)
with  the  picture  'pi2'.  The  picture thus created will be fitted to the
current  screen resolution and displayed. Following this the picture pi3 is
loaded  in  the  current  screen  resolution  and displayed. As a result we
obtain two displayed pictures.





The GEM-View INF file.
""""""""""""""""""""""
The  GEMVIEW.INF  file  will  be first looked for in the current directory,
then  in  the  directory from which GEM-View was started; afterwards in all
paths  which are entered in the Environment Variables "PATH=". According to
standards  this  is  only  in  the  boot  drive directory. This Environment
Variable  can  be set under GEMINI or MultiTOS. If the file cannot be found
there the search will transfer to the root directory of the boot drive.
If  then  no  INF file for GEM-View is available, standard settings will be
utilised.




%GemView Config 2.0
 640  400                                                      FullScreen
   5  490                                                      BigLogWindow
 700  300                                                      SmallLogWindow
   0    0                                                      ZoomingDefault
   0                                                           BrightenDefault
   0                                                           ColorsDefault
   0                                                           DitherDefault
   0                                                           ColDitherDefault
   1                                                           PatternFill
   0                                                           VdiColorOrder
   0                                                           VdiTransform
   1                                                           RGBScaleAdjust
   0                                                           IconifyClean
   0                                                           LoadGDOSFonts
   1                                                           AutoColorReset
   0                                                           AutoIconify
   1                                                           DisplayMenu
   1                                                           AutoOpenLog
   0                                                           AutoMaxWindow
   1                                                           ExternalIconify
  10                                                           MetaFactor
C:\CLIPBRD\                                                    IconifyPath
 1 4 0 0                                                       ToneScaleRed
 1 4 0 0                                                       ToneScaleGrn
 1 4 0 0                                                       ToneScaleBlu
 1 4 0 0                                                       ToneScaleAdj
GIF 87a Image                                                  DfltSavingMono
GIF 87a Image                                                  DfltSavingColor
GEM-XImage                                                     DfltSavingTC
M15 rrrrrggg ggxbbbbb                                          GraphicMode
M16 rrrrrggg gggbbbbb                                          GraphicMode
M24 rrrrrrrr gggggggg bbbbbbbb                                 GraphicMode
M32 rrrrrrrr gggggggg bbbbbbbb xxxxxxxx                        GraphicMode
>Big<
>Verbose<
>Original<
>Bypass<




Fullscreen:

Height  and  Width  of  the virtual screen as it can be set in the dialog -
"PICTURE-OPTIONS".

BigLogWindow:

(X/Y) position of the large GEM-View window.

SmallLogWindow:

(X/Y) position of the small GEM-View window.

ZoomingDefault:

Factors  for  the  horizontal and vertical magnification of pictures, which
can  be  set  in the dialog "Preseting". cf "GEM-View as GTP/ -xzoom,-yzoom
                                                               and -zoom."
'0'   '0' means not employed.

Brighten Default:

Brightness of the screen, which can be set in the dialog -"Preseting".
  cf " GEM-View as GTP / -brighten"

ColorsDefault:

Setting  for  the  maximum  number  of  colors in which the picture will be
displayed.  cf "GEM-View as GTP  / -colors
'0'    '0' means not employed.

DitherDefault:

Setting  of  the converting algorithm. If none is indicated and a monitor
with a monochrome display is connected, the dither algorithm is used.

ColDitherDefault:

0     - Switches color dithering off.
>0    - Color dithering always carried out.
<0    -  Color  dithering  where  the  number of colors in the picture is
         greater than the number of screen colors.

PatternFill:

Defines  the  filling sample for the unused extent of the pictures when the
picture is smaller than the area of the window.
0     -  White surround
1     -  Grey surround
2     -  Black surround.

VdiColorOrder:

Switches  the  interpretation  of the sequence of colors in the XIMG Header
between the sequence of the bit coding and the sequence of the VDI indices.

VdiTransform:

Switches on and off  the VDI function for changing from standard format to
the  machine  dependent  format  for  monochrome  pictures.  As a rule this
function  is  not necessary for the ATARI and actually creates graphic card
problems.

RGBScaleAdjust:

Switches  on  and  off  the color assessment in dithering.  When displaying
color  pictures  the  contrast correction of individual color components is
switched on and off.

IconifyClean:

Setting  which  determines  whether  iconified  pictures  should be lost or
retained at the end of the program.
'0'   means  preserve
'1'   means  kill.

LoadGDOSFonts:

Indicates  whether  all  GDOS  fonts  should  be loaded at the start of the
program. This is recommended if GEM-Metafiles with texts are to be loaded.

AutoColorReset:

Switches the option "AUTO-COLOR-RESET"  in or out.

AutoIconify:

This setting determines whether, on shutting a window,the displaced picture
is iconised under the name "$_UNDO_$" or not.

DisplayMenu:

In  program  mode switches off the menu line when GEM-View has been started
under a multi-tasking system, when the value is set to '0'.

AutoOpenLog:

When the value is set to '1',opens the GEM-View window automatically at the
start  of  the program. Opened also if GEM-View is started as a program and
the menu line is switched off.

AutoMaxWindow:

This  defines  the  manner  in  which  windows  are  opened. Set to '1' the
behaviour  is  identical  to  that  in  GEM-View 1.xx, i.e. the windows are
opened  in the maximum size and fitted into the top left hand corner. A '0'
produces behaviour corresponding to that in versions 2.0x of GEM-View where
the  open  windows  are  staggered.  I  personally  prefer  the method from
versions  2.0x  particularly  when,  with "Selectric", more pictures can be
simultaneously  loaded.  Moreover  the picture with '*' on the number block
can be immediately switched to maximum size.

ExternalIconify:

Stores  the  relevant  picture  data  in  the  directory  pointed  to  by
"ICONIFY-PATH",  when  an application is iconised. Only a smaller amount of
management  information  remains  in  memory.  If the option is switched to
'0',  or the designated directory has not been set, all the picture data is
retained in memory.

MetaFactor:

"MetaFactor" sets, in steps, the enlargement used with Metafiles.
'0'  corresponds  to  100%  so  that  a  resulting  100%,  200%,
300%,400%,....magnification and 100%,50%,33%,25%,20%.... reduction obtains.

IconifyPath:

Identifies the path for storing iconified pictures.

ToneScaleRed:

ToneScaleGrn:

ToneScaleBlu:

ToneScaleAdj:

Specifies  the  values  in  dithering for the colors red, green and blue as
well as for total intensity.

DfltSavingMono:

DfltSavingColor:

DfltSavingTC:

Sets  the  target  formats  for  saving  monochrome,  color  and  TrueColor
pictures: e.g. "GIF 87a Image", "GEM-XImage".
These  settings  are  used  for  the  command  line  version in the options
-savemono  <name>,  -savecolor  <file>,  -savetruecolor  <file>  and
-saveall{mono|color|truecolor}.
In  the  next  version  of GEM-View there will be a more convenient, window
supported picture converter built in.

GraphicMode:

These  new  entries for the GEMVIEW.INF are optional and operate to set the
HighColor  and  TrueColor  modes  when GEM-View cannot provide an automatic
setting. ( see also "Graphic mode..." )

  o For Falcon (not necessary)
      'M15 rrrrrggg ggxbbbbb                               GraphicMode'
      'M16 rrrrrggg gggbbbbb                               GraphicMode'
  o For Crazy Dots (necessary), Spectrum (not necessary)
      'I15 xrrrrrgg gggbbbbb                               GraphicMode'
      'I16 rrrrrggg gggbbbbb                               GraphicMode'
      'I24 rrrrrrrr gggggggg bbbbbbbb                      GraphicMode'
  o For Mega Vision 300 (? necess.), Fr CyReL 16M-1280 (not necessary)
      'M32 rrrrrrrr gggggggg bbbbbbbb xxxxxxxx             GraphicMode'

  [I == Intel, M == Motorola][nn == #planes] [Description of the bytes]

When information is found in the .INF file it will be used.
When  information  is  not  available  an  attempt  is  made  to  fix  it
automatically.

         !!!!! Try it out first without these entries !!!!!


>Big< / >Small<

Determines  whether the GEM_View window which opens on the first call as an
Accessory is "large" or "small".

>Verbose< / >Quiet<

State how many the program should "say" ;-)

>Original< / >Correct<

Statement whether a correction of distortion should be carried out or not.

>Bypass<

State  whether  IMG  and  XIMG  pictures should be loaded directly. If this
statement  is  absent  then  these  two  picture  formats are loaded as all
others.


My Address:
"""""""""""

  Dieter Fiebelkorn
  Grner Weg 29a
  D-45768 Marl(Germany)
  BLZ: 426 610 08
  Ktn: 607 984 800


Please send a formatted disk and two cri's (coupon response international).




 NOTE:   Since  version  1.1 ( in contrast to earlier versions ) this has
         been a Shareware program.
         For registration of GEMVIEW 2.3x costs MUST paid the shareware fee!
         Updates  only  available  if you send a stamped addressed
         envelope, a disk  and DM 10,-.
         In the case of those who have already paid DM 40,- in  respect
         of   versions   <2.30,   the update can be obtained by sending a
         two CRI's and a disk. 


Thanks:

  Thanks  to  all,  who  with  their  support,  advice, suggestions and
  bug-reports, have contributed to the success of these programs.

Representative  names, not in significant order, are listed below. To these
and all others unnamed, "Many thanks!"

          "Stefan Becker"
          "Wilfried Behne"
          "Oliver Bentler"
          "Alexander Clauss"
          "J. Bruce Cook"
          "Ralf Dwich"
          "Charles Edwards"
          "Derk Hndel"
          "Stefan Hintz"
          "Karsten Isakovic"
          "Christian Krger"
          "Volker Laut"
          "Georg Schwarz"
          "Peter Seitz"
          "Markus Thne"
          "Guido Vollbeding"
