home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 21 / CD_ASCQ_21_040595.iso / dos / graphic / nview14c / readme.nv < prev    next >
Text File  |  1995-02-08  |  46KB  |  1,037 lines
  1.    ╔═════════════════════════════════════════════════════════════┐
  2.    ║      The NOMSSI Viewer  Release 1.4c               (8.2.95) │
  3.    ║      Graphics file Viewer for SuperVGA                      │
  4.    ║                                                             │
  5.    ║ Copyright 1994,95 by NOMSSI NZALI Jacques Hubert Christian  │
  6.    ║ All Rights Reserved.                                        │
  7.    └═════════════════════════════════════════════════════════════┘
  8.  
  9. Welcome !
  10.  
  11.     This is a graphics file viewer that reads raster images stored
  12.     within files and displays them using the extended modes of VGA
  13.     graphics adapters.
  14.     The Windows and OS/2 2.x BMP, GIF, IFF/LBM/HAM, PCX, TIFF, TGA
  15.     and JFIF/JPEG graphics file formats are supported with most of
  16.     their particular extensions. Available SuperVGA graphics modes
  17.     up to 32 bits/pixel are autodetected and used.
  18.  
  19.     This file contains the following information:
  20.  
  21.     Introduction
  22.      - System requirements
  23.      - Some features
  24.      - Acknowledgements
  25.      - Licensing agreement
  26.      - Availability
  27.     Getting started
  28.      - Setting up The NOMSSI Viewer
  29.      - Command line parameters
  30.      - A quick tour
  31.      - Notable Informations
  32.      - Problems
  33.     Appendix
  34.      - Keyboard commands
  35.      - Disclaimer
  36.      - Revision Notes
  37.  
  38.     Feel free to report any comments, problems, suggestions for
  39.     improvements concerning the program, its documentation, its
  40.     licensing agreement or any part of its presentation to
  41.  
  42.        NOMSSI NZALI Jacques Hubert Christian
  43.        Thueringer Weg 3/435
  44.        09126 Chemnitz, Germany
  45.  
  46.        Internet:  nomssi@physik.tu-chemnitz.de
  47.  
  48.  
  49.   SYSTEM REQUIREMENTS
  50.  
  51.     The NOMSSI Viewer Release 1.4 should run under DOS 3.3 or higher
  52.     (DR DOS, MSDOS, NOVELL DOS, OS/2 or Windows DOS session) on any
  53.     IBM PC compatible with 640 Kb memory, 80286 processor and VGA
  54.     adapter or better. The JPEG decoding routines require a 80386SX
  55.     processor or better.
  56.     The NOMSSI Viewer for DPMI (NVX) requires extended memory.
  57.  
  58.   SOME FEATURES
  59.  
  60.      "I just got your Nviewer version 1.30/22-8-94 thru a
  61.       recommandation in one of those newsgroups in usenet.
  62.       Frankly, the only thing I like about it is that it's just
  63.       as good as the other viewers I use, it has more features
  64.       than the other viewers I use, it has a very nice user
  65.       interface, it has nice options, it is very  easy to setup
  66.       and run, it does not need any complicated configuration
  67.       to start using, and lastly--but most important--it is
  68.       probably the only viewer that recognized that my video
  69.       card has 2 megs and can do 16M colors ("wow").  I like it."
  70.     (user quote).
  71.  
  72.     The NOMSSI Viewer is very easy to install, your machine confi-
  73.     guration is autodetected, the available ressources are used,
  74.     including
  75.     - mouse with microsoft compatible driver
  76.     - extra memory: UMB, EMS, XMS or disk space are used as image
  77.       buffer for slideshow or image transforms like rotate, scale
  78.       or catalog and for overlay management.
  79.     - The VGA chipset families
  80.          Acumos, Ahead, ATI, Avance Logic, Chips&Tech, Cirrus,
  81.          Compaq, Everex, Genoa, HMC, MXIC, MGA, NCR, Oak,
  82.          Paradise, Poach, PRIMUS, Realtek, S3, Trident, Tseng,
  83.          UMC, Video7, Weitek, Yamaha
  84.       and the VESA BIOS extensions are supported. The VGA chipset
  85.       (about 180 unique chipsets), video memory, available 8, 15,
  86.       16, 24 and 32 bits video mode (256 color, 32K or 64K HiColor
  87.       and 16M TrueColor) are autodetected and used.
  88.  
  89.  
  90.     The NOMSSI Viewer supports seven graphics file formats with most
  91.     of their particular extensions, including OS/2 Bitmap arrays,
  92.     IFF HAM coding and PBM FORMs, PCX CGA/EGA images, many TIFF 6.0
  93.     extensions (planar, tiled, CMYK, YCbCr images, extra samples).
  94.  
  95.     Graphics are loaded to a buffer on EMS, XMS and disk, and then
  96.     displayed. The buffer management unit can buffer a single image
  97.     on all available buffer media. This allows to pan over very
  98.     large images in any video mode and to perform simple image
  99.     transforms (flip/mirror/rotate/wallpaper/center/shrink) and
  100.     color editing (brightness/contrast/gamma correction/grayscale).
  101.  
  102.     The NOMSSI Viewer offers a palette of dithering and quantization
  103.     algorithms. These are used to reduce the color depth of the
  104.     image (the maximum number of unique colors in the image) with
  105.     minimal degradation of the image quality. Fast-but-inaccurate
  106.     methods can be used for preview. The better methods are slower
  107.     and/or need more system memory. The quality/speed ratio and all
  108.     other parameters can be customized at run-time in dialog. All
  109.     changes take effect immediatly, with no need to restart.
  110.  
  111.     A group of files can be selected and viewed in turn (slideshow).
  112.     Up to 81 (9x9) images can be displayed simultaneously in any
  113.     supported graphics mode.
  114.     The User controls the file ordering, the video mode, the delay
  115.     between images, the catalog layout. He can pause on any image,
  116.     edit the image, resume the slideshow, return to previous images.
  117.     The pictures can be saved as palette color files in the BMP,
  118.     GIF, TGA or TIFF formats.
  119.  
  120.     The command line is processed at startup with all path names,
  121.     files, file masks and script files specified.
  122.  
  123.     The user interface is event-oriented, with mouse support, pull-
  124.     down menus, mouse support, context sensitive help (english and
  125.     german help texts), 'screen saver', file manager sort/copy/
  126.     rename/delete/find functions, text and binary browser, execute
  127.     function for .EXE, .COM and .BAT files.
  128.     The NOMSSI Viewer seamlessly launches external applications to
  129.     handle associated data-files. Mark Stehr's viewer (special
  130.     edition) with .FLI/.FLC, .ICO and PhotoCD support demonstrates
  131.     this feature. Links between applications and data-files are
  132.     defined and edited with the association editor.
  133.     The file finder recursively scans directories and identifies the
  134.     file format by parsing all files. All file dialogs (file load,
  135.     file finder, directory tree) are non-modal, multiple instances
  136.     can  coexist, allowing i.e. slideshow with different directories
  137.     and drives.
  138.  
  139.     The NOMSSI Viewer possesses an event recorder with the ability
  140.     to save every user action during a session and auto-replay the
  141.     whole session later.
  142.  
  143.   ACKNOWLEDGEMENTS
  144.  
  145.     This program uses
  146.      - The VGADOC package version 3,
  147.        Copyright (c) 1994 by Finn Thφgersen
  148.      - The JPEG Unit, Copyright (c) 1993 by TBH-Softworx
  149.      - The STREAMS package version 1.6,
  150.        Copyright (c) 1993,94 by D.J. Murdoch.
  151.      - The OVRUMB Unit 1.2, by Jean-Marc Lasgouttes
  152.      - The HelpFile patch in TVTOYS, by Far Niente Productions
  153.      - The ShowApp Unit by K. Strobel & A. Olbrich
  154.     The NOMSSI Viewer is written using Borland Turbo Pascal 7.0(TM).
  155.     The two pass quantization routine are ported from C:
  156.      - The median cut code from the Independant JPEG Group source,
  157.      - The octree quantization code from the PoV source,
  158.      - The Neuralnet quantization from A. H. Dekker code/paper.
  159.  
  160.     The VIEWER.EXE utility is is Copyright 1994,1995 by Mark Stehr,
  161.     included with kind permission of its author.
  162.  
  163.  
  164.   LICENSING AGREEMENT
  165.  
  166.     It is requested that all users comply with the following
  167.     licensing provisions:
  168.  
  169.     The NOMSSI Viewer is distributed as ShareWare, the user fee is
  170.     DM 36,- or US$29 (see REGISTER.FRM). Should you find this
  171.     program useful, register. You will get the latest release. You
  172.     *must* register if you use The NOMSSI Viewer on a regular basis.
  173.  
  174.     You may copy and distribute verbatim UNMODIFIED copies of this
  175.     Software, in any medium, as long as it remains in its complete
  176.     form with all support files, documentation files, this license
  177.     agreement and the disclaimer of warranty.
  178.  
  179.     You may charge a distribution fee for the physical act of
  180.     transferring a copy. You may not copy, sublicense, distribute or
  181.     transfer The NOMSSI Viewer except as expressly provided under
  182.     this License Agreement.
  183.  
  184.     Any attempt otherwise to copy, sublicense, distribute or
  185.     transfer The NOMSSI Viewer is void and your rights to use the
  186.     program under this License agreement shall be automatically
  187.     terminated. However, parties who have received computer software
  188.     programs from you with this License Agreement will not have
  189.     their licenses terminated so long as such parties remain in full
  190.     compliance.
  191.  
  192.  
  193.   AVAILABILITY
  194.  
  195.     The NOMSSI Viewer is released as a ZIP archive with the name
  196.     NVIEWnnn.ZIP, 'nnn' stand for the version number, like
  197.     NVIEW140.ZIP for release 1.4.
  198.     PKUNZIP ver 2.04g or higher is needed to 'uncompress' the
  199.     archive. Be aware it may be repacked to some other archivers by
  200.     other sites.
  201.  
  202.     The archive file contains:
  203.  
  204.        NV.EXE               ;  The executable
  205.        NV.HLP               ;  Online help texts
  206.        NVGER.HLP            ;  German help texts. Rename to NV.HLP
  207.        README.NV            ;  This text file
  208.        FILE_ID.DIZ          ;  Brief description
  209.        RECORD.BAT           ;  Start NV.EXE in record mode
  210.        PLAY.BAT             ;  Start NV.EXE in play-back mode
  211.        REGISTER.FRM         ;  Register form
  212.        REGISTER.GER         ;  German register form
  213.  
  214.        DEMO.BAT             ;  Run the demo file
  215.        DEMO.NVD             ;  Sample NV-Demo file
  216.        LOGOS.SLD            ;  Sample slide show script file
  217.        NV.EXT               ;  Sample association file
  218.  
  219.        NVIEW.GIF            ;  Image file, 640x480
  220.        NVLOGO.JPG           ;  Image file
  221.        ICON.GIF             ;  Image file 256x256
  222.  
  223.        All the following programs are FreeWare, distributed under
  224.        the scope of the disclaimer of warranty.
  225.  
  226.        VOCPLAY.EXE          ;  Plays VOC files on SoundBlaster
  227.        FASTANSI             ;  Displays ANSI files
  228.        NVINTRO.EXE          ;  Uses ICON.GIF required
  229.  
  230.        This program is Copr. 1994,1995 by Mark Stehr, included with
  231.        kind permission of its author.
  232.  
  233.        VIEWER.EXE           ;  Command line viewer for many file formats
  234.  
  235.  
  236.     The most recent version of The NOMSSI Viewer may be obtained at
  237.  
  238.     SPECIAL-Box, Chemnitz/Germany, Sysop Jens Hofbauer
  239.  
  240.     +49-371-2176173   14400bps            24h
  241.     +49-371-2176175   64000bps, X75/V110  2:00-7:00 CET
  242.  
  243.     FidoNet     : 2:2480/410
  244.     GerNet      : 21:494/4080
  245.     GeoholicsNet: 54:493/1560
  246.  
  247.     via World Wide Web using the following URL:
  248.  
  249.     http://www.tu-chemnitz.de/~nomssi
  250.  
  251.     Major releases are available via ftp from SimTel, the Coast to
  252.     Coast Software Repository. The primary mirror site is
  253.  
  254.      OAK.Oakland.Edu  (141.210.10.117)
  255.      location: SimTel/msdos/graphics/nviewnnn.zip.
  256.  
  257.     The list of systems that offer SimTel files by FTP can be
  258.     downloaded from OAK.Oakland.edu,
  259.      file: /SimTel/msdos/filedocs/download.inf
  260.  
  261.  
  262.   SETTING UP THE NOMSSI VIEWER
  263.  
  264.     - Create a target directory for The NOMSSI Viewer on your hard
  265.       drive. REMOVE THE OLD CONFIGURATION FILE NV.CFG from the
  266.       target directory prior to any update from a previous release.
  267.  
  268.     - Set the environment variable TEMP to a list of directories
  269.       with enough free disk space for temporary files (i.e. insert
  270.  
  271.       SET TEMP=C:\TEMP;D:\
  272.  
  273.       in your AUTOEXEC.BAT and reboot to let the changes take
  274.       effect). The current directory is used if this variable
  275.       does not exist.
  276.  
  277.     - PKUNZIP ver 2.04g or higher is needed to unpack the original
  278.       archive, a .ZIP file. Copy all files to the target directory
  279.       on your hard drive.
  280.  
  281.     - You can use The NOMSSI Viewer as a shell for any command line
  282.       utility. You might want to edit the sample association file
  283.       NV.EXT or use your own association file.
  284.  
  285.  
  286.     - Type NV.EXE at DOS prompt to start The NOMSSI Viewer.
  287.  
  288.     - Select Option\Display or press F9 to open the display dialog.
  289.       Verify that your machine configuration is correctly reported
  290.       and that the available video modes with 256, 32K, 64K and 16M
  291.       colors are enabled.
  292.  
  293.       1.3i Notes:
  294.       * The 32-bits modes item is hidden, with only an open bracket
  295.         "(" on screen.
  296.       * HiColor and TrueColor may not be used if your DAC isn't
  297.         recognized properly. Try the /DAC command line parameter
  298.  
  299.         NV /DAC   (assumes you have a TrueColor DAC)
  300.  
  301.     - Check the "[X] Uses VESA" item to force the use of the VESA
  302.       interface. Verify that the available VESA modes are
  303.       recognized.
  304.  
  305.       You may have to install a driver to use VESA modes. Check The
  306.       Universal VESA VBE, a stand alone program Copyright 1993 by
  307.       Kendall Bennett. It is available via ftp from the above-
  308.       mentioned SimTel mirrors as /SimTel/msdos/graphics/UVESAxx.ZIP
  309.  
  310.       The file NV.CFG is automatically written or updated with the
  311.       current settings when you leave the Options\Display dialog.
  312.  
  313.     - Press Ctrl+F9 to open the Preferences dialog box. Use the TAB
  314.       and SHIFT+TAB keys to navigate through the various items and
  315.       select your defaults. Each option is explained with a short
  316.       hint in the statusline at the bottom of the screen. The F1 key
  317.       opens a help screen with more informations about the current
  318.       field. The menu item Options\Save writes your defaults to the
  319.       NV.CFG file.
  320.  
  321.     - Press Alt+X to exit The NOMSSI Viewer. At this point, you can
  322.       start the demo by keying
  323.  
  324.       DEMO.BAT
  325.  
  326.       Press ESC at any time to abort and Alt+X to exit the demo.
  327.       The batch files RECORD.BAT and PLAY.BAT can also be used to
  328.       start NV.EXE.
  329.  
  330.   COMMAND LINE PARAMETERS
  331.  
  332.     The NOMSSI Viewer handles command line parameter of four types
  333.     in any order:
  334.  
  335.     - Graphics file names. File mask are allowed. All files in the
  336.       active directory that matches the file mask are load and
  337.       displayed.
  338.  
  339.     - Directory names (Paths). You may first specify a path, so the
  340.       subsequent file names in the list will not need to be complete
  341.       with path. Relative paths are allowed.
  342.  
  343.     - Slideshow files. Check the sample LOGOS.SLD script file.
  344.       Script file are specified with the leading '@' character.
  345.  
  346.     - The Quit parameter /Q forces The NOMSSI Viewer to exit after
  347.       processing the last command line parameter. The quit parameter
  348.       is stated in a slideshow script file as :QUIT.
  349.  
  350.     The following examples assumes you have installed The NOMSSI
  351.     Viewer in the C:\NOMSSI directory on your harddisk.
  352.  
  353.       C:\NOMSSI>NV C:\PCXLIST\image1.pcx C:\PCXLIST\image2.pcx
  354.  
  355.     displays the two files in turn. The current display parameters
  356.     and slideshow options are used.
  357.  
  358.       C:\NOMSSI>NV C:\IMAGES\TIF\*.*
  359.  
  360.     displays all files in the C:\IMAGES\TIF\ directory
  361.  
  362.       C:\NOMSSI>NV .
  363.  
  364.     specify a startup directory, overwrites the default.
  365.  
  366.       C:\NOMSSI>NV NVIEW.GIF VGALOGO.RLE /Q
  367.  
  368.     will show the two graphics files and exit.
  369.  
  370.       C:\NOMSSI>NV *.TGA /Q C:\IMAGES\NVIEW\ N*.TIF @NVLOGOS.SLD
  371.  
  372.     will display all .TGA files in the current directory, change to
  373.     the C:\IMAGES\NVIEW\ directory, display all .TIF files starting
  374.     with N in this directory, run then slideshow script file
  375.     NVLOGOS.SLD and exit The NOMSSI Viewer.
  376.  
  377.  
  378.   A QUICK TOUR
  379.  
  380.  
  381.     The NOMSSI Viewer is menu-driven and intuitive, you may already
  382.     be using it. You have a desktop with as many dialog boxes as you
  383.     like.   Many Dialog boxes are non-modal, meaning that you can
  384.     leave them without closing or canceling, and switch to another
  385.     dialog box at any time. Some operations can even be performed
  386.     concurrently, i.e. loading a graphics file while scanning the
  387.     whole drive for image files. Each dialog box is a tool with a
  388.     given functionality. You, the user, are the one to decide which
  389.     tool you need to solve your problem.
  390.  
  391.     The "Load an image file" dialog box is the most powerfull tool
  392.     for image viewing. Also use the directory tree (Shift+F3 or
  393.     Windows\Directory) or the File\Search dialog. The latest only
  394.     handles files in the supported graphics file formats.
  395.  
  396.     Press F3 to open a new "Load an image file" dialog box. You can
  397.     now locate graphics file on disk and press Enter or click the
  398.     Load-button to load and display the selected file. Press SHIFT+
  399.     Enter to browse a text file or CTRL+Enter to display an hex-dump
  400.     of the file. Executable files with .EXE, .BAT or .COM extension
  401.     are started with optional parameters.
  402.     The NOMSSI Viewer checks the association list (File\Association
  403.     menu) and load the associated application if the file format is
  404.     not recognized. Otherwise the "Reading" message box pops up,
  405.     providing image informations while the graphics file is decoded
  406.     to a buffer.
  407.     Thereafter, a graphics mode is initialized and the image is
  408.     displayed.
  409.  
  410.     While viewing the image, you dispose about a few but powerfull
  411.     tools to edit the brightness and contrast, scale, flip or pan
  412.     trough the image and save it to a new graphics file. Press F1
  413.     for a help screen. You can now press Enter to load and display
  414.     the next file in the file list or cancel the viewing with ESC.
  415.  
  416.     The NOMSSI Viewer can perform operations like copy, erase or
  417.     slideshow on a group of file. Press the space bar or click the
  418.     name with the right mouse button to add/remove the currently
  419.     selected (highliten) file in the list to the group files. The
  420.     tag character '√' appears. Also check the File\Group select
  421.     menu for selecting tools.
  422.  
  423.     The slideshow button is disabled at startup and automatically
  424.     enabled as soon as at least two files are selected. Press F8 or
  425.     click on this button to setup the slideshow parameters and
  426.     start a slideshow of the selected group of file.
  427.  
  428.     The NOMSSI Viewer gives you full control over the running
  429.     slideshow even with the mouse: the images are displayed exactly
  430.     in the selection order, the current image is selected when you
  431.     cancel the slideshow, reverse the sequence of slides with TAB,
  432.     click once on the right mouse button or press the space bar to
  433.     freeze the slideshow on any image. You can still use the image
  434.     editing tools. Press Enter or click the left mouse button to
  435.     resume or click the right mouse button again or press ESC to
  436.     cancel. A slideshow from a script file with individually timed
  437.     graphics file is possible.
  438.  
  439.     You may want to try the File\Search feature. It lists all
  440.     graphics file in a directory subtree.
  441.  
  442.     Press the F1 key or click the Help field in the statusline at
  443.     any time to open a help screen, with a description of the
  444.     current context. The help system provides online information
  445.     for almost all topics. The statusline displays a short context
  446.     sensitive short hint.
  447.  
  448.  
  449.   NOTABLE INFORMATIONS
  450.  
  451.     - Graphics file formats
  452.  
  453.     There are many graphics file formats, designed with different
  454.     goals. Most of the application specific image data storage is
  455.     device-dependent, optimized for loading speed. Rich format are
  456.     needed to take advantage of the varying capabilities of imaging
  457.     devices. Image compression reduces the storage requirements of
  458.     pictorial data and the time required for access to and
  459.     transmission of an image.
  460.     The NOMSSI Viewer supports the following raster image file
  461.     formats with most of their particular extensions:
  462.  
  463.     * Windows and OS/2 Device-Independent Bitmaps DIB
  464.  
  465.       Bitmaps are used under Windows 3.x and OS/2 to store bi-level,
  466.       palette color and full color images (1,4,8 and 24 bits/pixel).
  467.       The NOMSSI Viewer reads both uncompressed .BMP and compressed
  468.       .RLE (4 bits and 8 bits RLE) bitmap files. OS/2 2.x bitmaps
  469.       may include several pictures, which are shown in turn.
  470.  
  471.       The NOMSSI Viewer writes uncompressed, palette color Windows
  472.       3.x BMP files with 8 bits/pixel.
  473.  
  474.     * Compuserve Inc. Graphics Interchange Format GIF
  475.  
  476.       GIF files are widely used for image data transmission, because
  477.       of the smaller file size. The format specification limits the
  478.       number of colors/pixel to 256, selectable from a wider palette.
  479.       The GIF89a specification allows GIF files to store text and
  480.       commands for animations. The NOMSSI Viewer ignores some GIF89a
  481.       extensions like comments and pauses, but support multi-images
  482.       GIF files.
  483.  
  484.       Compatibility: The NOMSSI Viewer writes GIF89a graphics file
  485.       with a local color map. Older releases (prior 1.2c) are unable
  486.       to handle these valid image files.
  487.  
  488.     * Truevision TGA file format
  489.  
  490.       The TGA file format was the first TrueColor file format widely
  491.       available. The current TGA file specification defines the TGA
  492.       file types 1,2,3, 9,10 and 11 (color mapped, TrueColor and
  493.       grayscale uncompressed and run-length encoded files).
  494.       The NOMSSI Viewer reads all these file types, right-to-left
  495.       data ordering. The ".TGA" suffix should be the only one used.
  496.  
  497.       The NOMSSI Viewer writes color-mapped (type 1) TGA files with
  498.       32 bits/color map entry and 8 bits/pixel. The pixel data
  499.       ordering is left-to-right and bottom-to-top.
  500.  
  501.     * Adlus tag-based file format TIFF
  502.  
  503.       TIFF is a rich file format for storing and interchanging bi-
  504.       level, grayscale, palette-color and full color raster image
  505.       data in several color spaces. TIFF is tag-based and designed
  506.       to be extensible.
  507.       The NOMSSI Viewer supports the current Baseline TIFF 6.0
  508.       definition and many, many TIFF 6.0 Extensions (CCITT 1D and
  509.       LZW Compression, tiled, planar, YCbCr, CMYK/seperated images,
  510.       extra samples).
  511.       Not supported are:
  512.        - LZW strips/tiles with more than 65527 bytes
  513.        - TIFF FAX G4
  514.        - TIFF/JPEG compression
  515.       Pixel data ordering other as left-to-right and top-to-bottom
  516.       are ignored.
  517.  
  518.       The NOMSSI Viewer writes palette-color TIFF files.
  519.  
  520.     * ZSoft PC Paintbrush Format PCX
  521.  
  522.       The PCX image file format is in widespread use on the PC.
  523.       The NOMSSI Viewer handles PCX-files with 1..8 and 24 bits per
  524.       pixel. Some 256 color PCX files are written without color map
  525.       table, a grayscale map is assumed.
  526.       Pictures with 2 or 4 colors are displayed using the CGA color
  527.       map. SHIFT+F9 switchs to the standard EGA color map, which is
  528.       sometimes assumed.
  529.  
  530.     * The Interchange File Format IFF
  531.  
  532.       IFF is a file format for storing and interchanging data (text,
  533.       images, music and more). It is in widespread use on the Amiga.
  534.       IFF stores data in so-called FORMs.
  535.       The NOMSSI Viewer reads IFF ILBM (Interleaved Bitmap) with
  536.       1..8 and 24 bits/pixel and PBM (Packed Bitmap) forms, which
  537.       contains image data, offering support for run-length and HAM
  538.       encoding.
  539.  
  540.     * JPEG File Interchange Format
  541.  
  542.       The Joint Photographic Expert Group (JPEG) has created an
  543.       international standard for digital compression of continuous-
  544.       tone still images. The widely used baseline JPEG process is
  545.       lossy, it gives up some image quality to achieve very high
  546.       compression ratios.
  547.  
  548.       The JPEG standard doesn't specify a graphics file format, it
  549.       defines the JPEG Interchange Format.
  550.       The JPEG File Interchange Format (JFIF) is a minimal file
  551.       format which enables JPEG bitstreams to be exchanged between
  552.       a wide variety of platforms and applications. It is entirely
  553.       compatible with the standard JPEG interchange format.
  554.  
  555.       The JPEG decoding routines require a PC with 80386SX processor
  556.       or better. The maximum image width is 4000 pixel.
  557.  
  558.  
  559.     - NVX
  560.  
  561.     The NOMSSI Viewer for DPMI (NVX) is a protected mode port of The
  562.     NOMSSI Viewer. NVX requires a PC with 80286 processor and
  563.     extended memory. The performance is improved for large images.
  564.     NVX will refuse to run (Error in Stream) if it cannot locate the
  565.     ressource file NVX.NVR.
  566.     NVX can make use of a swap file to allocate more memory. You can
  567.     specify the size of the ~NVX.$$$ file with /F command line
  568.     parameter:
  569.         NVX /F1000000
  570.     uses 1,000,000 bytes of the start-up directory as swap file. The
  571.     heap viewer in the menubar should report the change.
  572.  
  573.     - Panning
  574.  
  575.     The NOMSSI Viewer can use hardware and software panning (Option\
  576.     Preferences\Hardware scroll). Hardware panning is extremly fast,
  577.     even on the slowest machines. The image is truncated if it does
  578.     not fit in the available video memory.
  579.     Software scrolling does not have this size limitation, image
  580.     tiles are reloaded from the buffer medium (Memory, EMS, XMS or
  581.     disk). The scrolling is fast enough for EMS or XMS storage, but
  582.     loading from disk is usually slow.
  583.     Note(1.3i): The scrolling is slower when two pass quantization
  584.                 methods are used (Median-Cut, Octree or Neural-net).
  585.  
  586.     - Quantization
  587.  
  588.     The extended SuperVGA modes with 24 bits/pixel (16,777,216
  589.     colors) provide the best representation of a color image for
  590.     human eyes, they are refered to as "TrueColor" modes.
  591.     but they consume excessive space (3 bytes of storage per pixel)
  592.     and require large and expensive video memory. Many SuperVGA can
  593.     display only in 8 bits/pixels modes, the color values in the
  594.     video memory are used as indexes in a look-up table (LUT) to
  595.     select the real RGB data. With that, one have 256 distinct
  596.     colors for each picture at disposal, which can be selected from
  597.     a much larger palette. To display an image with more colors than
  598.     the current display capabilities, one either uses dithering or
  599.     color quantization or both.
  600.  
  601.     Dithering is the use of more than one pixel to represent a color
  602.     value, giving up some spatial resolution. Our visual system
  603.     performs spatial integration (averages) if we view a small area
  604.     from a sufficiently large distance. Dithering is fairly fast and
  605.     produces quite good looking color images in high resolution
  606.     video modes.
  607.     A dithered image seems to contains noise in low resolution modes
  608.     or on enlarged images. It will not compress very well.
  609.  
  610.     Color quantization is reducing the number of colors of an image
  611.     in such a way that the degradation of the image quality is
  612.     minimal. One must first select the best table of colors for the
  613.     given image. Each pixel is then replaced with the most similar
  614.     color in the table. The image colors can then be coded with the
  615.     table indexes, lowering the storage requirement.
  616.  
  617.     The NOMSSI Viewer offers a palette of quantization methods with
  618.     different quality/speed ratios (Options\Display\Quantization).
  619.  
  620.     * Grayscale (only for JPEG images)
  621.       The luminance component is used to control the grayshade.
  622.     * Pattern dithering
  623.       A 2x2 dither matrix is used for Red and Green, a 4x4 matrix is
  624.       used for Blue.
  625.     * Floyd-Steinberg error diffusion method
  626.       The method distribute the dithering error on the the current
  627.       pixel over its neighbors.
  628.     * Median-Cut
  629.       This method builds and uses a 3D-histogram to divise the image
  630.       color space in subboxes, allowing to select accurately 256
  631.       best representative colors for a given image.
  632.       The NOMSSI Viewer uses Floyd-Steinberg error diffusion in the
  633.       second pass (mapping RGB colors to the most similar palette
  634.       colors).
  635.     * Oct-tree
  636.       This method uses oct-trees to recursively divise the RGB-cube,
  637.       using normally less memory than a 3D-histogram. Dithering is
  638.       not used, the obtained images will compress better.
  639.     * Kohonen Neural-network
  640.       This method compute the optimal palette for a given image
  641.       using a neural net with a "learning phase". A dithering step
  642.       is added if there is enough memory available.
  643.       The neural net quantization option cannot be selected with the
  644.       mouse.
  645.  
  646.     - Video mode selection algorithm
  647.  
  648.     With "Options\Display\Mode auto" checked, The NOMSSI Viewer uses
  649.     the currently selected color depth (Options\Display\Colors) as
  650.     the maximal value and seeks the video mode with the lowest
  651.     available color depth, that still provides enough colors for the
  652.     image.
  653.     This means a GIF file (256 colors) will not be loaded in a
  654.     TrueColor mode if a 256 color mode is available, even if the
  655.     24 bits/pixel color depth is selected.
  656.  
  657.     - Gamma correction
  658.  
  659.     The primary purpose of gamma correction is to let color images
  660.     appear identical on different output devices. The image color
  661.     values are corrected to match the physical properties of the
  662.     output device, that is your monitor. Press Alt+F9 to see how it
  663.     works.
  664.  
  665.     Note:
  666.      * Gamma-correction doesn't work in HiColor modes.
  667.      * The exponential transfer function used is not accurate for
  668.        color LCD displays.
  669.      * All three RGB components use the same correction curve.
  670.      * A user-defined gamma near 1,8 works well for many monitors
  671.  
  672.     - Color Editing
  673.  
  674.       While altering the brigthness or constrast, the colors can
  675.       be modified over a larger range than usual.
  676.  
  677.     - Event Recorder
  678.  
  679.     The NOMSSI Viewer can save every single action of yours in a
  680.     file and later *automagically* replay it. Start the DEMO.BAT
  681.     file as an example for this unique feature.
  682.     The NOMSSI Viewer uses environment variables "listen" and "play"
  683.     to control recording/playback, the RECORD.BAT and PLAY.BAT files
  684.     are ready-to-use batch files for this purpose.
  685.  
  686.     - Association Editor
  687.  
  688.     The Association Editor (File\Associate) allows to define and
  689.     edit links between data files and the appropriate applications.
  690.     Select a valid file name in the file list box (dialog box
  691.     "Load an image file") or this menu item will be disabled. The
  692.     sample NV.EXT file shows how to specify associations from a
  693.     text file.
  694.  
  695.     Data files are recognized by the file name extension, like
  696.     .VOC, .WAV or .MOD for sound files. The associated applications
  697.     are specified using a command line with the complete path and
  698.     other extra parameters. Do not forget the file name extension
  699.     (I often do).
  700.  
  701.        Extension  Command line
  702.  
  703.        .TXT       COMMAND.COM /C TYPE
  704.        .MPG       C:\GO32.EXE D:\IMAGES\VIDEO\VMPEG
  705.        .MOD       D:\MISCELL\MUSIC\PLAY.EXE
  706.        .FLI       VIEWER.EXE -s4
  707.        .VOC       VOCPLAY.EXE
  708.        .ANS       FASTANSI.EXE
  709.  
  710.     Trying to load an "associated" data file (i.e. a text file or
  711.     a sound file) will automatically start the linked application.
  712.     Therefore you can edit a text file or play back a sample from
  713.     within The NOMSSI Viewer. The user-defined command line is
  714.     used to start the application seamlessly, handing over the
  715.     data file as the last command line parameter. DOS Error codes
  716.     are reported if Option\Preferences\Confirmations is checked.
  717.  
  718.     - Catalogs
  719.  
  720.     Best quality is catalog are saved from 8 bits (256 color) modes.
  721.     The NOMSSI Viewer then uses two pass Median-Cut quantisation.
  722.     Catalog are saved in the current directory.
  723.  
  724.   PROBLEMS
  725.  
  726.     You will not be able to view some images if you are low on
  727.     memory, or if your TEMP disk drive is full. Check your system
  728.     configuration and the option menu, some quantization algorithms
  729.     require a lot of free memory.
  730.     The NOMSSI Viewer shows an error code (Status) when you press
  731.     F1 in graphics mode. As for release 1.4, Status 4E0B stand for
  732.     "Memory Overflow", this is subject to change without notice.
  733.  
  734.     Other problems:
  735.  
  736.      - The information panel shows false color informations for
  737.        ILBM/HAM and TGA color maped files
  738.      - The bar gauge is not updated correctly on PCX files
  739.      - Hardware scrolling doesn't work in VGA-mode 320x200 on some
  740.        chipsets
  741.      - ET4000 TrueColor modes selection problems (status ?)
  742.      - Disabled video modes are not saved to NV.CFG. 
  743.        (work around exist, see manual)
  744.      - Hardware scrolling in 24 bit modes may shift the colors
  745.      - The graphics isn't always restored correctly after a help
  746.        screen from graphics mode
  747.      - soft scrolling
  748.      - Weitek P9000 problems
  749.  
  750.     Feel free to report any difficulties you experienced with The
  751.     NOMSSI Viewer via email. Please include a valid return path and
  752.     the program release you have been using, actually The NOMSSI
  753.     Viewer 1.4.
  754.  
  755.   KEYBOARD COMMANDS
  756.  
  757.     General
  758.       Alt + Letter     select an active Option. Press left Alt-key
  759.                        *together* with the lit letter.
  760.                        (i.e. Alt + S for "SlideShow", Alt + A for
  761.                        "Scan", Alt + N for "Name").
  762.       Alt+F3           Close window
  763.       ESC              Cancel the current operation.
  764.       Enter            Confirm a valid input/selection
  765.       TAB              select (highlight) the next field in a
  766.                        dialogbox.
  767.  
  768.     Help: F1           Open Helpwindow
  769.       Alt+F1                Previous Help screen
  770.       F5               Zoom/restore size of the active helpwindow
  771.       Ctrl+F5          Change the size and/or position of the active
  772.                        window
  773.       Enter            Pick a topic
  774.       ESC              Close Help
  775.  
  776.     File: F3           Open dialogbox "Load an image file"
  777.       Space bar        select (tag/reverse tag) file. Needed for
  778.                        Slideshow or for group copy
  779.       Gray +           tag all files
  780.       Gray -           clear all tags
  781.       Gray x or *      reverse all tags
  782.       F10              go to the menubar
  783.       F7               copy file(s)
  784.       Alt+F7           Scan directory trees
  785.       F8               slide show
  786.  
  787.     Options: F9        Open dialogbox "Options"
  788.  
  789.     Tools
  790.       F1               Help screen with file and graphic mode
  791.                        informations and a short description of
  792.                        the available commands.
  793.       Ins/Del          Brightness control (+/-)
  794.       Home/End         Contrast control (+/-)
  795.       Gray * or x      Cycle palette colors
  796.       Gray ÷ or /      Cycle colors backward
  797.  
  798.       F2               Save image in BMP, GIF, TGA or TIF format
  799.  
  800.       Shift+F9         Set standard EGA Palette
  801.       Ctrl+F9          Set uniform quantization palette (3-3-2)
  802.       F9               Convert the palette colors to gray shades
  803.       Alt+F9           Gamma correction, set the active monitor gamma
  804.                        (Standard 2,2)
  805.       F10              Restore original palette
  806.       Ctrl+PgUp/PgDn   special effect (test)
  807.       Ctrl+Ins/Del
  808.       Ctrl+Home/End
  809.       Alt+Space
  810.  
  811.       Ctrl+PgUp/PgDn   special effect (test)
  812.       Ctrl+Ins/Del
  813.       Ctrl+Home/End
  814.       Alt+Space        full scan of large image
  815.  
  816.       F3               scale down (half)  (EMS/XMS/disk needed)
  817.       F4               scale to fit page  (EMS/XMS/disk needed)
  818.       F5               flip the image vertically (up/down)
  819.       F6               flip left/right (mirror)
  820.       Shift+F6         rotate counterclockwise 90°
  821.       F7               copy current image to buffer
  822.       F8               restore image from buffer
  823.  
  824.       PgUp/PgDn        scroll up/down (slow)
  825.       Direction keys   scroll up/down/left/right (fast)
  826.  
  827.       Gray +           Switch to higher graphic resolution (Zoom out)
  828.       Gray -           Switch to lower graphic resolution  (Zoom in)
  829.  
  830.     Slideshow: F8
  831.       Space bar        freeze image, stop   (Mouse right button)
  832.       Enter            continue, next image (Mouse left button)
  833.       TAB              reverse slideshow direction
  834.       ESC              cancel slide show, end (Mouse right button)
  835.  
  836.  
  837.   DISCLAIMER
  838.  
  839.     Except when otherwise stated in writing, NOMSSI NZALI Jacques
  840.     Hubert Christian, refered hereafter as "The author" and/or other
  841.     parties provide "The NOMSSI Viewer" "as is", without warranty of
  842.     any kind, either expressed or implied, including, but not limited
  843.     to, the implied warranties of merchantability and fitness for a
  844.     particular purpose. The entire risk as to the quality and
  845.     performance of "The NOMSSI Viewer" is with you.
  846.  
  847.     In no event unless required by applicable law will The author and/
  848.     or any other party who may redistribute "The NOMSSI Viewer" as
  849.     permited above be liable to you for damages, including any lost
  850.     profits, lost monies, or other specials, incidental or
  851.     consequential damages arising out of the use or the inability to
  852.     use "The NOMSSI Viewer" (including but not limited to loss of data
  853.     or losses sustained by third parties or a failure of the program
  854.     to operate with any picture or any other programs), even if The
  855.     author and/or other party has been advised of the possibility of
  856.     such damages, or for any claim by any other party.
  857.  
  858.     Mere aggregation of another unrelated program with this program on
  859.     a volume of a storage or distribution medium does not bring the
  860.     other program under the scope of these terms.
  861.  
  862.  
  863. TRADEMARKS
  864.  
  865.     The Graphics Interchange Format(c) is the Copyright property of
  866.     CompuServe Incorporated.  GIF(sm) is a Service Mark property of
  867.     CompuServe Incorporated.
  868.  
  869.     PC, PC/AT are trademarks, IBM, OS/2 are registered trademarks
  870.     of International Business Machines Corporation.
  871.  
  872.     All other products or services mentioned in this manual and
  873.     in the on-line help texts, including:
  874.  
  875.     Acumos, Ahead, ATI, Avance Logic, Chips&Tech, Cirrus, Compaq,
  876.     Everex, Genoa, HMC, MXIC, MGA, NCR, Oak, Paradise, Poach, PRIMUS,
  877.     Realtek, S3, Trident, UMC, Video7, Weitek, Yamaha, VGA, Tseng
  878.     Labs, MS-DOS, PC-DOS, PCX, Windows, Novell, PC Paintbrush,
  879.     GIF, Compuserve, TIFF
  880.     are trademarks, registered trademarks, service marks, or
  881.     registered service marks of their respective companies or
  882.     organizations.
  883.  
  884.     We state that we are using the other trademarked names only in
  885.     an editorial fashion, with no intention of infringement of the
  886.     trademark.
  887.  
  888. REVISION NOTES
  889.  
  890.   8.2.95 1.4c - beta test release
  891.                 Save User tools, minor changes
  892.   6.2.95 1.4b - Ctrl+Enter = Software Zoom in graphics mode
  893.                 ! Hardware Panning must be on
  894.               - User menu, Add your own utilities
  895.                 Use ~x~ to highlight. Select a key (Shift+F1..Shift+F4)
  896.         (Window\Directory is now Ctrl+F3)
  897.               - Some internal changes
  898.  16.1.95 1.4a - YCbCr TIFF fix
  899.               - Slideshow reset tags fix
  900.  11.1.95 1.40 - 5th public release
  901.          - prices revised
  902.          - external utilities added
  903.          - fixed new preferences/slideshow dialogs, DOS shell,
  904.          - documentation, help files, bar gauge step
  905.            Layout of File\Search, Options\Preferences, Collection range
  906.            error, Slideshow\Options changed with new functions
  907. 31.12.94 1.3j - new: faster (idle) soft scrolling, Gamma correction
  908.          in TrueColor modes, more Association options, enhanced
  909.          command line handling (files, file masks, paths, script
  910.          file handling) Layout of File\Search, Options\Preferences,
  911.          Slideshow\Options changed with new functions
  912.          Select files from all directory on drive for
  913.          Slideshow/Catalog.
  914.          Incremental search is now possible from all file lists.
  915.          - bugs fixed: TIFF ExtraSamples/palette, TGA 16-bits file
  916.            rename, directories, LBM scan line size JFIF resolution,
  917.            Catalog save problems
  918.          - many internal changes (executable is smaller and uses less
  919.            memory).
  920.  5.12.94 1.3i - bugs fixed
  921.                 Added extension and slideshow demo file.
  922.  2.12.94 1.3h - graphics card support enhanced, directory tree
  923.                 revised, save in current directory.
  924.  9.11.94 1.3g - 32 bits mode support tested
  925.          1.3f - bug fixed:
  926.                 Slideshow dialog mxn could be deleted with DEL
  927.          - command line parameters, to fix some problems with
  928.              HiColor/TrueColor modes:
  929.              /DAC - assume HiColor/TrueColor DAC
  930.              /ATI - assume ATI.
  931.            Should fix some Graphics Ultra Pro problems. not tested
  932.          - bug fixed: VESA modes were not used if the corresponding
  933.                       native color depth was disabled.
  934.          - TIFF CMYK support
  935.          - better IFF HAM test
  936.          - TIFF multi images catalog fixed
  937.          1.3e - 32 bit modes (couldn't test it yet)
  938.          - vgatest utility
  939.          - Software scrolling is now used,
  940.          - Hardware Cursor support on some chipsets
  941.          - Save catalogs with higher quality, using median-cut
  942.            quantisation.
  943.          - New directory dialog! (Shift+F3) with a directory tree to
  944.            navigate trough the drive, some network drives support.
  945. 17.10.94 1.3d - File search dialog revisited, sort by extensions, ET4000
  946.          TrueColor mode swap, bug fixed, first NVX beta
  947.          - Brand new NVX ! the DPMI viewer (no public release)
  948.          - Command line option handling: load all files on the command line,
  949.            and quit if command /Q specified
  950.          - Modified the ressource file for Tseng 4000 HiColor mode
  951.          - fixed problem with saving catalog in HiColor and TrueColor modes.
  952.            The complete fix will be to save as TrueColor files, but...
  953.          - Catalog without frames can be selected from the preference dialog
  954.          - revised dialog search for images file. You can now load a file
  955.            while scanning the whole drive for image
  956.  7.10.94 1.3c - fixed Auto Change Drive problem, fixed problems with
  957.          slideshow, IFF, flip/mirror problem, overlay management improved
  958.  22.8.94 4th public release 1.3
  959.          TIFF YCbCr and information panel revisited
  960.   8.8.94 revision 1.2h  - The NOMSSI Viewer is one year old !
  961.          new setup dialog, mouse panning,
  962.          changed mouse settings, mosaic
  963.          fixed HAM decoding, associations
  964.  18.7.94 beta 1.2g, should have the functionallity of 1.2f,
  965.          rewritten from older backups after source for rev. 1.2f
  966.          lost in a harddisk crash,
  967.          (TrueColor support and file associations).
  968.          Neural-net quantization rewritten.
  969.  13.6.94 revision 1.2f - beta release - posted to a.b.p.u
  970.          true color support, file associations
  971.   2.5.94 revision 1.2e - internal beta
  972.  25.3.94 revision 1.2d
  973.          EMS problem fixed, comand line parameter,
  974.          event recorder, Use of resource-file, RLE4 bug fixed,
  975.          enter do slideshow, Helpscreen from graphics mode
  976.  11.3.94 revision 1.2c
  977.          Save as GIF, GIF bug fixed (older release cannot read
  978.          the saved files). Added release test in NV.CFG, one do not
  979.          need to erase it anymore
  980. revision 1.2b - JFIF problem
  981.   3.3.94 Slideshow new look, Dithering problem fixed, Added file
  982.          delete
  983.  24.2.94 release 1.2a
  984.          Problem with slideshow when no graphic modes available,
  985.          Auto save now won't be cyclic nor work w/o cataloguing
  986.          Added F1 Help in graphics mode (still needs some work)
  987.          Heap display formated, corrected help file erratum,
  988.          TGA file, Software version
  989.  22.2.94 Third public release 1.2
  990.            fixed: DEL-Key problem in 1.1l, aspect scale in Slideshow
  991.                   Directories count (Search for files), Validation
  992.                   errors, Prefix error, ESC cancel w/o buffering,
  993.                   JFIF GetInfos error, View as Hex width
  994.            updated: help, documetation, license agreement
  995.  16.2.94 release 1.1l - beta
  996.            fixed severe JFIF problem in 1.1k, Save as TGA,
  997.            Slideshow with all open windows
  998.  14.2.94 release 1.1k - beta
  999.            bugs fixed, i.e. Fit to screen, minor changes in user
  1000.            interface (options), Directory as parameter to NV.EXE
  1001.            allowed, Delete a supported graphics resolution with DEL
  1002.   ?.2.94 1.1j
  1003.   7.2.94 release 1.1i - beta
  1004.            some 1.1h bugs fixed: VESA support, Flyod-Steinberg.
  1005.            Setup dialogbox revised, controlbox while loading,
  1006.            Save as BMP
  1007.   1.2.94 release 1.1h - beta
  1008.            SuperVGA support extended, better LZW error check,
  1009.            JPEG display options, Color cycling, some bug fixes,
  1010.            internal changes (overlay)
  1011.   18.1.94 release 1.1g - beta - submitted to the c.b.i.p newsgroup
  1012.            revisited: GIF error checking, PCX 4 colors, TIFF YCbCr,
  1013.            TrueColor dithering, c&t450, non-modal setup dialog
  1014.   ?6.1.94 release 1.1f - beta Catalog size can be entered
  1015.    3.1.94 release 1.1e - beta
  1016.            better scaling (Catalog, Fit page, standard VGA).
  1017.            JFIF load process can be easily canceled.
  1018.  23.12.93 release 1.1d - beta some JFIF bugs fixed
  1019.  
  1020.  15.12.93 release 1.1c, small changes made
  1021.          (large files, slideshow w/o buffer)
  1022.  13.12.93 The second public release 1.1
  1023.          Extended file format support:
  1024.            - OS/2 Bitmaps (1.3, 2.x Bitmap Arrays)
  1025.            - IFF/LBM with HAM and IFF/PBM
  1026.            - TGA file type 3,11
  1027.            - PCX 1..8 Bit/Pixel
  1028.            - JFIF support
  1029.          Slideshow with image array, antialiasing
  1030.          edit image: scale to fit page, flip, mirror, rotate,
  1031.          uses EMS/XMS/disk, more file management/options,
  1032.          some internal changes, speed up
  1033.  
  1034.          bugs fixed: Auto detect, video switch after 50 lines mode,
  1035.                      TV bugs, GIF, TIFF bugs, VESA support
  1036.          new bugs
  1037.  4.8.93  first public release