@DATABASE SViewNG.guide
@WIDTH 80

## $VER: SViewNG.guide V6.00 (3.3.97)
##
## For reading this file you may use:
##
##  Program-Name    available at
##
##  - AmigaGuide    (various Packages)
##  - MultiView     (Workbench)
##  - PowerGuide    (Aminet CDs)
##

@NODE MAIN "SViewNG_Documentation"

                       SViewNG V6.00 (3.3.1997)

                              - SHAREWARE -

      © 1993-97 by Andreas Ralph Kleinert. All rights reserved.

                    A PerSuaSiVe SoftWorX PRODUCT.

        Needs Kickstart V2.04. Kickstart release 3.x compatible.
        GUI created with StormWizard 1.0

                            @{"REGISTER NOW" SYSTEM "ED Register"}

                             @{"Copyrights"           LINK Copyrights}
                            @{"Distribution"          LINK Distribution}
                        @{"Author/Correspondence"     LINK Correspondence}
                        @{"The program's purpose"     LINK Purpose}
                          @{"How to install it"       LINK Installation}
                     @{"Where to obtain Updates from" LINK UpdateNote }
                            @{"How to use it"         LINK Usage}
                       @{"Evaluation restrictions"    LINK EvaluationRestr}
                    @{"Known bugs and program limits" LINK Bugs}
                           @{"Program history"        LINK History}
                     @{"Possible future enhancements" LINK Future}
                         @{"Credits and Support"      LINK Credits_and_Support}

                          _
                       _ //
                  Only \\X/ Amiga makes it possible.


                             Please visit:

                           SuperView WWW Sites
             http://home.t-online.de/home/Andreas_Kleinert/
                http://www.amigaworld.com/support/sview/

                  Simon Edward's Image Engineer WWW Site
                    http://yallara.cs.rmit.edu.au/~sbe/
           (Image Processing program produced by Simon Edwards)

@ENDNODE

@NODE "Purpose"

SViewNG is a program that has been designed for the purpose, to display,
convert and process any kind of bitmapped graphics as fast and as
comfortable as possible.

Fast means not only fast in reading and displaying but also in calling
and using the program.

Highest possible flexibility is implemented via a native modularian system,
consisting of the superview.library, the SVObjects, SVDrivers and
SVOperators.

These intentions resulted in a bundle of features and options
you have access to when using SViewNG and installing it to your System:

 - licensed "SuperView-Library" (see directory SuperViewLibrary)
 - intensive use of many special OS V2.04+ and OS V2.1+ capabilities
 - support of many OS V3.x+ and AGA graphics features,
   as e.g. support of interleaved BitMaps
 - support of external Fileformat-Libraries (SVObjects):

     - IFF-ACBM         - Windows,OS/2 BMP   - PNM (PBM,PGM,PPM)
     - IFF-ILBM         - JPEG (JFIF v6)     - IMG (GEM Graphics)
     - IFF-DEEP         - PhotoCD            - WPG (WP Bitmaps)
     - IFF-PBM          - TIFF               - MacPaint MAC
     - IFF-RGB8         - PCX                - EPS (Header/PS)
     - IFF-YUVN         - Atari Degas        - C64 (Koala, Doodle)
     - FBM              - Windows Icon       - CDR-Previews
     - QRT/POV Raytrace - Mac PICT-2         - SGI
     - SVG              - Targa              - Pictor/PCPaint
     - SunRaster        - UtahRLE            - PNG

     as well as all OS3-Datatypes
     and 24 Bit DataTypes (picture.datatype V43).

     Many formats with 24 Bit-Support.
     Reads XPK- and PP20-packed data via Unpack.svobject.

     Writes C-Sourcecode in chunky/RGB notation.

     Together with external third party programs also the
     following file formats seamlessly can be embedded:

       File Format        needs program   also needs support for
       ---------------------------------------------------------
     - AMF                MetaView        (ILBM)
     - DXF/AutoCAD (tm)   MetaView        (ILBM)
     - FIG                AmiFIG          (Postscript)
     - CGM                GPlot           (Postscript)
     - IFF-DR2D           MetaView        (ILBM)
     - Limbo              Limbo 4.0       (PNM)
     - Postscript (TM)    Ghostscript     -
     - WPG-Vector         MetaView        (ILBM)
     - WMF                MetaView        (ILBM)

 - support of external periphal devices (DEVICE-access SVObjects):

     - Scanner (scanner.device of ScanQuix)
     - Printer (printer.device support; uses own 24 Bit dithering)

 - support of external display drivers (SVDrivers):

     - ECS              - AGA                - EGS7
     - OpalVision       - Retina             - CyberGraphX
     - PicassoII        - Merlin

       (Picasso96 yet via CyberGraphX or PicassoII API)

 - Support of external operators (SVOperators):

     - Dither24Bit      - 24BitToHAM         - HilbertDither256
     - ExtractRed       - ExtractGreen       - ExtractBlue
     - XOR              - ExtractGrayScales  - TopToBottom
     - LeftToRight      - Rotate             - Scale50
     - AnyTo24Bit       - Crop               - CallPNM
     - OptimizePalette  - RotateFree         - PaletteDither

       plus the following from Steve Quartly:

     - SQBentley        - SQTiling           - SQThreshold
     - SQOilPaint       - SQMosaic           - SQEmboss
     - SQSlicing        - SQDiffuse          - SQContrast
     - SQSharpen        - SQBlur             - SQDeep_Press
     - SQMotion_Blur    - SQHighPass

 - "Screen-Grabbing"
 - Commodity   (optional)
 - ARexx-Ports (optional)
 - AppIcon     (optional)
 - AppMenu     (optional)
 - AppWindow   (optional)
 - Clipboard reading and writing
 - Support of Devices, like e.g. Scanners
 - Localization for OS V2.1+
 - AmigaGuide OnLine-Help for OS V2.04+ (asynchroneous & localized with 2.1+)
 - detailed configuration via Config-File, Cli-Options and
   Workbench-Tooltypes
 - Graphical User Interface (GUI) for Workbench-Users (optional)
 - conversion of the supported File-Formats
 - information about the displayed graphics via Requester,
   selectable via GUI-Menu
 - and more

And via the SVObjects for IFF-ILBM, IFF-ACBM, IFF-YUVN,
IFF-DEEP and IFF-PBM:

 - use of "iffparse.library" for reading and writing
 - reading and writing of 32 Bit viewmodes (OS2 CAMG)
   and AGA 8 Bit Colormaps (OS3 CMAP)
 - intelligent CAMG-Chunk replacement routine
   (if CAMG is supported)
 - and more


  @{i}GIF is obsolete - you neither should use nor support it any longer. If
  you are doing WWW design, use PNG and JPEG instead. It's important !@{ui}

@ENDNODE

@NODE "Installation"

Even if you use the supplied Installer-Script, you should read the following
notes. If you do not own the standard Installer-Program you should read
them even more carefully and follow the instructions given.

Note: Should after starting the installer script appear an error message
      "Can't find program 'Installer'" (or similar), you have to enter
      the correct path to your Installer program via the Workbench menu
      Icon/Information. Please do also not forget, to install the library
      fromout its directory (own script at sub-directory 'SuperViewLibrary').

If you own a KeyFile, place it to "S:", or place it elsewhere and change
the environment variable "KEYPATH" to the corresponding directory.

The SuperView-Library has to be installed seperately, anyway !

   Needed Workbench Resources

HardDisk-Users won't perhaps have to install any additional Workbench
Resources to their HardDisk.
Disk-Users will have to copy the following libraries into their
"LIBS:"-Directory, if these not already do residate in ROM (may depend
on the version of the operating system):

  - gadtools.library    V37+
  - iffparse.library    V37+
  - asl.library         V37+
  - commodities.library V37+
  - utility.library     V37+
  - workbench.library   V37+
  - icon.library        V37+

Users of OS V2.04 or greater should also install the following
libraries:

  - amigaguide.library  V34+
    (please avoid using V34 - it's known to cause problems)

Users of OS V2.1 or greater should also install the following
libraries:

  - locale.library      V38+


   Other needed Resources

You will also have to copy the following libraries to your
"LIBS:"-Directory (plus SVObjects, SVDrivers and SVOperators):

  - superview.library          V15+
  - superviewsupport.library   V7+

GUI has been designed with StormWizard, so this program needs
"wizard.library" V37+ (you can find a copy in the StormC Demo
archive or the Wizard Demo package located on Aminet under
"biz/demo/StormWIZARD1_0.lha").


   Installing the Main Program

Copying SViewNG to your "WBStartup"-Drawer is perhaps one possible
solution, but installing it in any other directory will suffice anyway.
You should also install an appropriate Config-File in one of the supported
paths (e.g. "ENV:" or "S:").

Please note, that the standard icon tooltypes cause SViewNG to
open the GUI and a file requester straight after startup - don't forget
to change that, if you dislike it.

@ENDNODE

@NODE "UpdateNote"

 General
 ~~~~~~~
 Although the SViewNG archive does contain any of the needed parts,
 you might wish to get updates sometimes.

 The newest version usually can be found under
 Aminet:gfx/show/SViewNG.lha

 Also, there may occur several additional archives, contaning more
 optional SVObjects/SVDrivers or SVOperators (usually named this
 way: "sv******.LHA").


 FTP
 ~~~
  AmiNet
  ------
 You might try to search under pub/aminet/gfx/show at
 ftp.doc.ic.ac.uk, ftp.wustl.edu or ftp.uni-paderborn.de
 where the complete archive is available.

 When using gopher also ftp.wustl.edu may be accessed
 (search at 1/pub/aminet/...).

 Of course you may also take a look at the various CD-ROMs containing
 material from AmiNet (Fred Fish-CDs, AmiNet, etc.)


  =======================================
  Official SuperView Online Support Sites
  =======================================

     *** COB ***

     - Running on AMIGA 4ooo TOWER / 040 25Mhz / 18MB / 5.4 GB HD -

     Sysop:  Jens Loreck
     Online: 00.00h - 24.00h
     Data:   +49-2774-92064     V34/ISDN       (33.6k/64k bps)
             +49-2774-92065     V32terbo/ISDN  (19.2k/64k bps)
     UseNet: SYSOP@COB.wwbnet.de

     Guest-Account for downloads (user "GAST", no password).
     This includes SuperView Support as well as Aminet area access.

  This Box is AmBos-based, you may easily browse through the BBS areas.
  SViewNG is stored at "Box Inhalt/Support/SuperView".
  (For AmBos, use ANSI/VT220 and 16 Colors.)

@ENDNODE

@NODE "Usage"

How To Use SViewNG: An Introduction

 @{"1.0 SViewNG's Construction" LINK Construction}

     1.0.1 The Workbench Interface
     1.0.2 The Graphical User Interface (GUI)
     1.0.3 The CLI Interface
     1.0.4 The Commodity Support
     1.0.5 The ARexx-Ports
     1.0.6 The App-Features
     1.0.7 Configuration Commands

 @{"2.0 Controlling And Using SViewNG" LINK Control}

     2.0.1 Options for Configuration and ARexx
     2.0.2 GUI and WB-App Handling
     2.0.3 Controlling the Display-Screen

 @{"3.0 Information about the supported Gfx Formats" LINK Gfx-Formats}

     3.0.1 IFF-ILBM
     3.0.2 IFF-ACBM
     3.0.3 Other File Formats

@ENDNODE

@NODE "EvaluationRestr"

 This is the evaluation version of SViewNG, which is SHAREWARE.

 To remind you to register, every time you start or leave the program,
 an appropriate Requester will appear.
 Also, ARexx-Ports are no longer available in the evaluation version
 and only saving of ILBM CmpByteRun1 is possible.

 All in all:   - Requester at startup and when leaving
               - no ARexx-Ports
               - saving of file formats other than
                 IFF-ILBM CmpByteRun1 is NOT possible

 After you've received and installed your Keyfile these restrictions
 will disappear.

@ENDNODE

@NODE "Construction"

 1.0 SViewNG's Construction

     SViewNG bases on several interfaces, of which almost any can be
     activated/deactivated and accessed separately.
     These are:

      - The Workbench Interface
      - The Graphical User Interface (GUI)
      - The CLI Interface
      - The Commodity Support
      - The ARexx-Port
      - The App-Features
      - Configuration Commands

   1.0.1 The Workbench Interface

     The Workbench interface is just a standard WB-Interface, which means
     that it supports sevaral Tooltypes for program configuration, of
     which nearly any are also available via ARexx and the ConfigFile.

     It is supported to use SViewNG as a DefaultTool for Project Icons
     via the Workbench "Information" Menu as well as displaying pictures
     via "multiple selection" as described in the Workbench manual.

     See @{"2.0.1" LINK Control} for more details on configuration.

   1.0.2 The Graphical User Interface (GUI)

     As many other programs SViewNG gives the user the possibility to
     control most activities via a Graphical User Interface, based on
     the standard Intuition elements as Gadgets, Menus and Windows.

     @{"SViewNG's GUI" LINK Control} allows to reach nearly all of the program's features
     and also provides even more of them.

     This GUI is not necessarily opened automatically, because SViewNG is
     also designed to run as a Commodity in the Background (see 1.0.4),
     where a GUI often is not actually needed.

     The GUI may be activated via Configuration options (see @{"2.0.1" LINK Control}),
     which either have to be placed in the Config-File, as Icon-
     Tooltypes or as CommandLine-Options (see 1.0.3).
     When running SViewNG as a Commodity the GUI can also be opened
     via the standard WB-Program "Commodity Exchange" (see 1.0.4).
     If an AppIcon or AppMenu is installed, it also will let the GUI
     pop up (see 1.0.6).

   1.0.3 The CLI Interface

    The CLI Interface provides nearly all possibilies as the GUI does
    (except Screen Saving/Gfx Converting), so that CLI users are completely
    integrated into the program's idea of concept.
    Allowed configuration options can be parsed via CommandLine by
    simply adding an "-" to their front (see @{"2.0.1" LINK Control}).

   1.0.4 The Commodity Support

    Only one of the currently running copies of SViewNG at a time
    has the possibility to install itself as a Commodity which can be
    controlled via the standard WB-Program "Commodity Exchange".
    Special options (see @{"2.0.1" LINK Control}) allow to set the HotKey, the Priority
    and can specify, if the GUI should pop up or not.

    Via the HotKey (default: alt esc) SViewNG is present everywhere
    it is needed and even the GUI can appear anywhere as fast as possible,
    because of the "Commodity Exchange", which allows it to pop up just
    by pressing the specific button there.

   1.0.5 The ARexx-Port

    The ARexx-Port is another feature, which strenghtens the interactive
    capabilities of SViewNG, because it allows to contact the SViewNG
    Process from nearly anywhere at nearly any time to tell it to do a
    specific task.
    Most of the ARexx-Commands are also available as configuration
    options, so they are described there (see @{"2.0.1" LINK Control}).

    The default of the ARexx-Port is "SViewNG.rx".
    Only one SViewNG Process will allow such a port at a time,
    but by specifying different names (see configuration section),
    more ARexx-ported tasks are possible.

   1.0.6 The App-Features

    Another interactive feature of SViewNG allows you to install
    an AppIcon, AppMenu and/or AppWindow.
    All these are each optionally.

    The AppIcon is placed on the Workbench and allows direct activation
    of SViewNG, as via ARexx or "Commodity Exchange" (Requester).

    The AppMenu just works like the AppIcon.

    The AppWindow only takes place, when the GUI is opened, so that any
    pictures of which you drop an Icon into the GUI Window will be
    displayed immediately.

   1.0.7 Configuration Commands

    Because of those many options and features is has perhaps to be
    explained which order takes place when configuring the program at
    startup time or later. Here's a table:

     - Default Options (integrated in SViewNG)
     - ConfigFile      (read from Disk, if available)
     - a) Tooltypes    (read from Icon(s) at WB-Start)
       b) CLI-Options  (supplied via CommandLine at CLI-Start)
     - ARexx-Command   (received while the program is running)

@ENDNODE

@NODE "Control"

 2.0 Controlling And Using SViewNG

     As described before, SViewNG can either be controlled via
     Workbench, CLI, "Commodity Exchange", ARexx or its GUI.

     The Commands, which are available for configuration and
     interactive ARexx use follow (2.0.1).
     After that the handling of the GUI is described more detailed (2.0.2).

   2.0.1 Options for Configuration and ARexx

     The letter after the specific command tells you from where it can be
     reached:

      C       [ Config-File                         ]
      T       [ Workbench-Tooltypes, CLI-CommandLine]
      A       [ ARexx                               ]


      Command                    Function                       Usage

      ALREADY_KNEW_ABOUT         Then you need no About-Reqs    [ C T A ]
                                 (registered version only)
      QUIT                       Leave SViewNG                [     A ]
      HELP                       Load AmigaGuide DataBase       [ C T A ]
      REQUEST                    Request for displaying a Gfx   [ C T A ]
      SHOW=<FileName>            Display a specific Gfx         [ C T A ]
      LOAD=<FileName>            Load a specific Gfx            [ C T A ]
      UNSHOW                     End Displaying / Close Display [     A ]
      SAVE_TYPE=<SVObject-ID>    Set new Save-Type for "SAVE"   [ C T A ]
                                 (does not affect GUI settings)
      SAVE=<FileName>            Save current Gfx as SAVE_TYPE  [     A ]
      SVDRIVER=<SVDriver-ID>     Set Default-SVDriver by ID     [ C T A ]
      SVOPERATOR=<SVOperator-ID> Set Default-SVOperator by ID   [ C T A ]
      ACTION                     Do SVOperator action           [     A ]
      OPTION_LOAD=<DISK|CLIP     Disk or ClipBoard loading ?    [ C T A ]
                   |DEVICE>
      OPTION_SAVE=<DISK|CLIP     Disk or ClipBoard saving  ?    [ C T A ]
                   |DEVICE>
      SCREENSAVEDELAY=<1/50 sec> Delaytime before saving screen [ C T A ]
      ICONPATH=<DosPath>         Location of DefaultIcons       [ C T A ]
      ASLFR_LEFT=<value>         FileRequester Initial LeftEdge [ C T A ]
      ASLFR_TOP=<value>          FileRequester Initial TopEdge  [ C T A ]
      ASLFR_WIDTH=<value>        FileRequester Initial Width    [ C T A ]
      ASLFR_HEIGHT=<value>       FileRequester Initial Height   [ C T A ]
      ERROR_REPORT=<YES|NO>      "NO" Will e.g. suppress any
                                 Requesters, which may cause
                                 ARexx-Scripts to wait for user
                                 activity. Supresses them also
                                 when working with the GUI, so
                                 use it carefully.              [ C T A ]
      LOGFILE=<CON/FileDesc>     Where to put a logfile ?       [ C T A ]
      REJECT_ICONS=<YES|NO>      Reject Icons in FileRequester? [ C T A ]
      PUT_ICONS=<YES|NO>         Put Icons when writing Files ? [ C T A ]
      INSTALL_CX=<YES|NO>        Install as a Commodity ?       [ C T   ]
      INSTALL_AREXX=<YES|NO>     Provide an ARexx-Port ?        [ C T   ]
      AREXXPORTNAME=<Name>       Name of ARexxport (<=63 chars) [ C T   ]
      INSTALL_APPWINDOW=<YES|NO> Provide an AppWindow ?         [ C T A ]
                                 (only together with OPEN_GUI
                                  or CX_POPUP=YES)
      INSTALL_APPICON=<YES|NO>   Provide an AppIcon ?           [ C T   ]
      INSTALL_APPMENU=<YES|NO>   Provide an AppMenu ?           [ C T   ]
      OPEN_GUI                   Open the GUI immediately       [ C T A ]
      CLOSE_GUI                  Close the GUI immediately      [     A ]
      CX_POPKEY=<key key ...>    Standard CX_POPKEY command     [ C T   ]
      CX_POPUP=<YES|NO>          Standard CX_POPUP command.     [ C T   ]
                                 CX_POPUP=YES is equivalent
                                 to OPEN_GUI.
      CX_PRIORITY=<-128..127>    Set Priority of SViewNG      [ C T A ]
                                 Process and the Commodity
                                 Broker. If called via ARexx
                                 only the process priority is
                                 set new.

      The default name of the ARexx-Port is "SViewNG.rx".


   2.0.2 GUI and WB-App Handling

     The GUI mainly consists various areas which are marked
     by specific gadgets:

         Picture Gadgets

         @{"Slide View" LINK GADGET_View}

         @{"Load"       LINK GADGET_Load}
         @{"Save"       LINK GADGET_Save}
         @{"View"       LINK GADGET_ViewBuf}
         @{"Action"     LINK GADGET_Action}
         @{"ViewMode"   LINK GADGET_ScreenMode}

         @{"Medium"     LINK GADGET_Medium}

         SVObject/SVDriver/SVOperators Gadgets

         @{"SV-Switch"   LINK GADGET_SVGad}
         @{"SV-ListView" LINK GADGET_SVList}

         @{"SVInfo"      LINK GADGET_SVInfo}
         @{"Add"         LINK GADGET_SVAdd}
         @{"Remove"      LINK GADGET_SVRemove}

         Screen Gadgets

         @{"Screen-ListView" LINK GADGET_ScreenList}

         @{"Update"          LINK GADGET_ScrUpdate}
         @{"Info"            LINK GADGET_ScrInfo}
         @{"Save"            LINK GADGET_ScrSave}

     More options are available via the "Project" Menu, where you can
     select between the following actions:

         @{"FileInfo" LINK MENU_FileInfo}
         @{"Help"     LINK MENU_Help}
         @{"About"    LINK MENU_About}
         @{"Hide"     LINK MENU_Hide}
         @{"Quit"     LINK MENU_Quit}

     By pressing HELP while selecting a Menu, or by selecting a Gadget after
     turning on the Gadget-Help via pressing HELP you may enter the
     context-sensitive documentation.

   2.0.3 Controlling the Display-Screen

     SViewNG opens for each graphic, which has to be displayed, a
     suitable Screen.
     This Screen and the attached Window are usually pushed to the
     Foreground automatically und become activated, just right after the
     graphic has been loaded.

     After that you have the possibility, to control the program's
     behaviour via the following actions:

     Mouse control:

      - left Button quits the display

      When displaying OS3-Datatypes via "Slide View":

      - left Button within the graphic, while moving the mouse
        scrolls the graphic.
        (see relating note in the Screen-Titlebar)

     Keypad control:

      - Key "L"  : Load new graphic
      - Key "Q"  : Quit display
      - Key "X"  : Quit display and leave program
      - Key "H"  : Open GUI (GUI-Screen still in Background)
      - HELP-Key : Open GUI (GUI-Screen still in Background)
      - ESC-Key  : Quit display and leave program
                   (naleûy trzymaê naciôniëty przez ok. 1-2 sekundy)

@ENDNODE

@NODE "Gfx-Formats"

  @{i}GIF is obsolete - you neither should use nor support it any longer. If
  you are doing WWW design, use PNG and JPEG instead. It's important !@{ui}


 3.0 Information about the supported Gfx Formats

   3.0.1 IFF-ILBM

     IFF-ILBM is the standard Gfx FileFormat for the Amiga.
     Currently there do exist two versions of this Format:

      - IFF-ILBM, unpacked
      - IFF-ILBM, CmpByteRun1 encoded

     The difference is, that the second one contains data, which is
     encoded with the CmpByteRun method, while the data of the first
     is unencoded.
     The reason, why both methods are included, is that sometimes it may
     be more efficient to let the IFF-ILBM file unpacked and then
     pack it with an other packer instead encoding it with CmpByteRun.
     Also there may exist some older - actually VERY old - programs,
     which do not support the packed format.

     IFF-ILBM graphics may contain Amiga-specific color cycling (CRNG)
     and ViewMode (CAMG) information.


   3.0.2 IFF-ACBM

     IFF-ACBM is the standard Gfx FileFormat for AmigaBASIC.
     Currently there only does exist one version of this Format:

      - IFF-ACBM, unpacked

     The reason, why the data is unpacked is nearly the same, why
     IFF-ILBM is not used here:
     From Basic programmes it is not easy to read packed data anyway
     and it would slow down the program enormously.
     Data in an IFF-ACBM is saved BitPlane for BitPlane, to increase the
     speed of reading.

     If you use an automatically packing FileSystem or a patched DOS
     it might be useful to use IFF-ACBM, because the speed of displaying
     pictures dos not increase only with AmigaBASIC programs, but also
     with SViewNG.
     And if you use such a method of background packing you will not
     even need more HardDisk space, which is in fact needed if converting
     from IFF-ILBM (CmpByteRun) to IFF-ACBM.
     On the other hand needed space is nearly the same as for unpacked
     IFF-ILBM graphics - but the speed is higher.


   3.0.3 Other File Formats

     SuperView-Library supports many different graphics file formats,
     of which some can be both, read and written, some only read
     or maybe some only written.
     It also does support reading of all OS3-Datatypes.

     Please refer to the SuperView-Library documentation for
     further information.

     See also paragraph: @{"About the program's abilities" LINK Purpose}.

@ENDNODE

@NODE "MENU_FileInfo"
      - FileInfo

        Gives information about the currently loaded Gfx, as width, height
        or color-depth.
@ENDNODE

@NODE "MENU_Help"
      - Help

        Starts this Online-Help.
@ENDNODE


@NODE "MENU_About"
      - About

        Informs about SViewNG.
@ENDNODE

@NODE "MENU_Hide"
      - Hide

        Closes the GUI of SViewNG (which when in Commodity-Mode, not
        necessarily means to quit SViewNG itself).
@ENDNODE

@NODE "MENU_Quit"
      - Quit

        Closes the GUI of SViewNG and exits the program.
@ENDNODE

@NODE GADGET_View
      - Slide View

        When clicking on this gadget, any old Display will be closed,
        a FileRequester will appear and the selected picture - if of
        a known File-Type - will be displayed immediately and replace
        the old display.
@ENDNODE

@NODE GADGET_Load
      - Load

        When clicking on this gadget, a FileRequester will appear and the
        selected picture - if of a known File-Type - will be loaded
        and held in the Memory for multiple saving (e.g. in different
        file-formats).

        If the speficic SVObject (e.g. Datatypes-SVObject) does not support
        exporting Buffers, a Screen will be opened in the Background to
        keep the picture.

@ENDNODE

@NODE GADGET_Save
      - Save

        The stored Buffer will be saved as a picture in the desired
        file-format, as selected in the ListView-Gadget.
        (Select "SVInfo" Gadget for more information on the speficic
         FileFormats).
@ENDNODE

@NODE GADGET_ViewBuf
      - View

        Allows to take a quick view on the currently loaded buffer.
        Functionality is _not_ the same as with "View".

        Here you'll just take a short look onto the picture and then
        click it right out of the way.
@ENDNODE

@NODE GADGET_Action
      - Action

        Modifies the currently loaded SV_GfxBuffer in a way, which depends
        on the currently selected SVOperator.

        After that you may save or display the result of the operation
        via the selected SVObject/SVDriver.
@ENDNODE

@NODE GADGET_ScreenMode
      - ViewMode

        Opens a ViewMode requester where - depending on the selected
        SVDriver - a screen mode for the currently loaded SV_GfxBuffer
        my be selected.
@ENDNODE

@NODE GADGET_Medium
      - Medium

        This gadget switches the Input/Ouput medium between Disk, Clipboard
        and Device.
        This affects loading and saving of graphics.
        You may e.g load a graphic from ClipBoard, then switch to Disk and
        save it to there.

        If disk access is selected, a FileRequester will appear before loading
        and saving anything, otherwise just the first clipboard unit will
        be used.
        More about clipboard use perhaps can be found in your computer's
        manual.
@ENDNODE

@NODE GADGET_SVGad
      - SVObject/SVDriver switch Gadget

        This gadget switches the @{"SVListView-Gadget" LINK GADGET_SVList}
        between SVObject/SVDriver Mode.
@ENDNODE

@NODE GADGET_SVList
      - SVObject/SVDriver ListView Gadget

        This gadget is for selection of the SVObject/SVDriver, which should be
        the source for the actions, which can be performed via  @{"View" LINK GADGET_View},
        @{"Load" LINK GADGET_Load} or @{"Save" LINK GADGET_Save}.
@ENDNODE

@NODE GADGET_SVInfo
      - SVInfo

        This gadget displays more detailed information on SVObjects/
        SVDrivers/SVOperators.
@ENDNODE

@NODE GADGET_SVAdd
      - Add

        This Gadget adds new SVObjects/SVDrivers/SVOperators to the system,
        which can be selected via FileRequester.
        Don't try to selecting other libraries than those, which have
        a name ending with ".svobject",".svdriver" or ".svoperator" !

        Removing is possible via @{"Remove" LINK GADGET_SVRemove}.
@ENDNODE

@NODE GADGET_SVRemove
      - Remove

        This Gadget removes unusede SVObjects/SVDrivers/SVOperators from
        the system.
        This is only possible, if the current SViewNG-Task is the only
        program, which accesses SuprView-Library at the time.
        Otherwise the action will result in nothing.

        Adding is possible via @{"Add" LINK GADGET_SVAdd}.
@ENDNODE

@NODE GADGET_Prefs
      - ?

        This gadget allows edition of Controlpad settings of the currently
        selected SVObject/SVDriver/SVOperator from the GUI (just like
        with the SVPrefs program).
@ENDNODE

@NODE GADGET_ScreenList
      - ScreenListView Gadget

        This gadget is for selection of the Screen, which should be the
        source for the actions, which can be performed via  @{"Update" LINK GADGET_ScrUpdate},
        @{"Info" LINK GADGET_ScrInfo} or @{"Save" LINK GADGET_ScrSave}.
@ENDNODE

@NODE GADGET_ScrUpdate
      - Update

        If the list of selectable Screens is not up-to-date an update
        can be forced by pressing this Gadget.

@ENDNODE

@NODE GADGET_ScrSave
      - Save

        The Save-Gadget in the Screen area allows you to save the marked
        Screen in the selected graphics file format.
@ENDNODE

@NODE GADGET_ScrInfo
      - Info

        This Gadget presents various information on the currently
        selected Screen.

@ENDNODE

@NODE "Bugs"

Known Bugs and program limits:

 Limits
 ------
 - When trying to create some kind of a "slide show", you have to decide how
   long the user should see a picture displayed, because a mouse click by the
   user will end displaying as well as sending an ARexx/Commodity/Tooltype
   command to SViewNG, which immediately will cause it to display
   the new picture. This is not a real bug, this is just because of
   interactive message receiving while a picture is displayed.
   Multiple picture displaying is only possible when starting different
   SViewNG Tasks, which then all have to be "quit"ted by a mouse click.

   When creating a Slide Show you may better use "SuperSlide" which
   fits those needs well (can be cound in the "Tools" directory).

@ENDNODE

@NODE "History"

SuperView is NOT related to the program with the same name from AmigaLib
Disk 367, about which I read late _after_ I began programming it.
It also has NOTHING to do with that same-called display interface system.

V6.00 (3.3.97):

  - MAJOR REVISION
  - now, what many people requested, has finally been done:
    the GUI has been written completely.
    It is now been designed with with StormWizard in the most important
    parts and has become fully font-sensitive and re-sizeable in these parts.
    This results in the following changes:

       - the program and its related files are now called
         "SViewNG" ("next generation" or "new gui" - as you like it),
         so that you optionally can use the old and new version
         synchroneously
       - all related catalogs, guide files etc. now are named
         "sviewng", too
       - there are now again two catalogs altogether, only the one
         of the main program could kept its content, thus there's
         again need for new translations of the GUI catalogs
       - this program now needs "wizard.library" V37+
         (you can find a copy in the StormC Demo archive or the Wizard Demo
          package located on Aminet under "biz/demo/StormWIZARD1_0.lha").
       - Menu help does not work as usual
       - and more

****************************************************************************
Version history before V6.00 no longer included
****************************************************************************

@ENDNODE

@NODE "Future"

Possible future enhancements _might_ be:

 - more and smarter functions for image processing
 - 8 Bit or HAM preview screens for any graphics
 - holding more than one graphic in memory (multi-handle accesses)
 - and more

@ENDNODE

@NODE "Correspondence"

                           SuperView WWW Sites
             http://home.t-online.de/home/Andreas_Kleinert/
                http://www.amigaworld.com/support/sview/


   _________________________________________________________
  |      You may reach me the following way.                |
  |    Send bug-reports, money or whatever to:              |
  |---------------------------------------------------------|
  |        * SuperView Development & Registration *         |
  |          * DRAFU Development & Registration *           |
  |       * Image Engineer Registration Site Europe *       |
  |                                                         |
  |                                                         |
  |                  PerSuaSiVe SoftWorX                    |
  |                                                         |
  |                  Andreas R. Kleinert                    |
  |                  Sandstrasse 1                          |
  |                  D-57072 Siegen                         |
  |                  Germany, Europe                        |
  |                                                         |
  | Any snail mail to the old address will still be routed. |
  |                                                         |
  |                  Phone:  +49-271-22869 also FAX + AM    |
  |                          +49-271-22838                  |
  |                                                         |
  |                  Weekdays after 17.00h.                 |
  |                                                         |
  |         When calling via phone you may leave a message, |
  |         if I'm not available - but don't expect me      |
  |         calling back to USA, Australia, ... since       |
  |         german phone rates are HIGHLY expensive.        |
  |_________________________________________________________|

  EMail:

        Please send binaries via ARK@COB.wwbnet.de, and keep
        them smaller than 16 KB. Please think twice before
        sending them - my postbox is not unlimited in size.

        * Do not send binaries via Fido or Fido-Gates ! *

           - Fido   Andreas Kleinert 2:2457/350.18
           - Usenet
                    ARK@superview.ftn.neckar-alb.de  (Fido-Gate)
                    Andreas_Kleinert@t-online.de     (T-Online)
                    ARK@COB.wwbnet.de                (Z-Netz)
                    ARK@amigaworld.com               (AmigaWorld)

           - If nothing else works, try one of these public
             Fido-Usenet gateways:

               In Germany:
                 Andreas_Kleinert@p18.f350.n2457.z2.fido.sub.org

               From USA or elsewhere:
                 Andreas_Kleinert@p18.f350.n2457.z2.fidonet.org


When reporting any bugs, please don't forget to include a detailed
description of the bug and tell me, if it is reproduceable or not.
Please also mention the version number of SViewNG you used and describe
your system configuration (Amiga model 500/.../4000T-060, Kickstart/OS,
RAM, HardDisk, special configurations).

If you want to get a newer - and maybe debugged - version of SViewNG
do not forget to register as an user of SViewNG with the included
registration form.
Nevertheless unregistered users are as welcome to report bugs as
users who decide(d) to register.

@ENDNODE

@NODE "Credits_and_Support"

I perhaps have to thank many persons, but I won't list them all up here,
since many of them are already mentioned in the documentation to
"SuperView-Library" (so read it, please).

Thanks go to (in alphabetical order):

 - Jan van den Baard

   ... for his great tool GadToolsBox, which I formerly used to
   design the GUI of SuperView.

 - Gerd Frank

   ... for Beta-Testing, Bug-Reports and last not least for his many ideas
   and suggestions, espescially concerning the re-design of SuperView's
   GUI ;-)

 - Roman Patzner

   ... for the nice icons he designed for use with Martin Huttenloher's
   MagicWB (8 Colors minimum) and sent to me for inclusion with SuperView.
   Many thanks for the work he has done on them and for related ideas
   and suggestions.
   Since many people use MagicWB, Roman's Icons are now included as
   the standard set, but please note that these are especially designed
   for an appropriate Workbench environment
   (take a look at "RomIcons" on AmiNet).

 - Martin Schulze

   ... for uploading SuperView onto the AmiNet and including it into
   the SaarAG series, so that it reached more people out there.
   Also for sending and receiving all those mails, which did not find
   their way through the labyrinth of Fido-Gateways ;-)

 - Detlef Winkler

   ...credits and many thanks go to him for the new icon set introduced
   between V4.2 and V4.42, which had been included upto V4.61 as an
   alternative set.
   He has also designed the new SuperView Logo and many Default Icons
   for the various File Formats (see DocFile "Bonus/ReadMe").

 - to the translators

     Francais: Emmanuel REY
     Italiano: Alessandro Basso   (cralex@amiga.dei.unipd.it)
               Luca Giolo         (grifon@vega.unive.it)
     Svenska:  Patrik M Nydensten (nyden@algonet.se)
               Torbjörn Aronsson  (torbjorn.aronsson@mailbox.swipnet.se)

 - and last NOT LEAST

   - all registered users of SuperView for supporting Shareware
   - all people I already mentioned in the documentation to
     SuperView-Library

@ENDNODE

@NODE "Distribution"

    Copyright

The program SViewNG in this version and its documentation files are
(C)opyright 1993-97 by Andreas R. Kleinert. All rights reserved.

The right of using this program is granted to you by paying the
SHAREWARE-fee of 30,- (outside western Europe 40,-) DEM to the author
(20 USD/25 USD).

Together with the registration you also receive your personal KEYFILE.

Should any of the listed terms and clauses within this document not be
valid in conjunction with the law of certain countries this does not
affect the validity of the other clauses.


    Disclaimer

The author takes no responsibility for any results of the use of this
program.
This software is provided "AS IS" and there is no warranty of any kind,
so that you use this software at your own risk.

The author reserves the right to discontinue development of the program.


    Rights

Registered users which paid the SHAREWARE-fee get the rights described
on the registration form.


    Distribution

The REGISTERED version of SViewNG MUST NOT be redistributed.
The Distribution of Keyfiles is FORBIDDEN.

The following only applies to the unregistered evaluation (EL)
version of SViewNG:

The program SViewNG in this version is freely distributable (SHAREWARE).
You may copy it, if the copyright notice is left intact and
all of its parts are included in the distribution.
This program must not be included in commercial packages or commercial
program collections without my written permission.
This program must not be sold in any way, but it is allowed to take
a nominal fee including the costs for copying.

This program may be put on public domain disks or included in public
domain disk libraries.
Special permission hereby goes to Fred Fish's AmigaLib-Disks and
the german series (in alphabetical order):
AmigaSzene, BerndsPD, FRANZ, GPD, SaarAG, TAIFUN and TIME.

This program may also be distributed via electronic mail and may be
put into mailboxes as long as the redistribution conditions are
respected in all points.

By using or distributing this program you automatically agree to
all of the above conditions and terms.

@ENDNODE

@NODE "Copyrights"

    Copyrights

Some of the mentioned names or products above may be copyrighted by
companies or trademarks of companies.

@ENDNODE

@ENDNODE
