====================================================== | vorl„ufige Dokumentation zu | | GEM-View 2.32 | | ---------------------- | | GEM-View ist SHAREWARE | | ---------------------- | | | | ˝ 1990/91/92/93 by | | | | Dieter Fiebelkorn | | Grner 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: -`-', -`+' and -`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 R". That can then be saved in the usual way with "Export|SaveS". 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 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 , -savecolor , -savetruecolor 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. Identical with the Fuller. 2.Identical with the Closer. 3. ( 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 ,-savecolor , savetruecolor 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 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 +, - . "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 , -savecolor 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 "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 -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.'. 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 , -savecolor , -savetruecolor 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.), Fr 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 Grner 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 D”wich" "Charles Edwards" "Derk H„ndel" "Stefan Hintz" "Karsten Isakovic" "Christian Krger" "Volker Laut" "Georg Schwarz" "Peter Seitz" "Markus Th”ne" "Guido Vollbeding"