home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 68 / af068sub.adf / SuperView / SuperView.DOC < prev    next >
Text File  |  1994-11-23  |  36KB  |  1,014 lines
  1.  
  2. ## $VER: SuperView.guide V4.0 (30.9.94)
  3. ##
  4. ## For reading this file you may use :
  5. ##
  6. ##  Program-Name    available at
  7. ##
  8. ##  - ShowHyp       (e.g. coming with GadToolsBox V2.0c)
  9. ##  - Hyper         (AmigaLibDisks)
  10. ##  - AmigaGuide    (various Packages)
  11. ##  - MultiView     (Workbench)
  12. ##
  13.  
  14.  
  15.  
  16.    SuperView V4.0 (30.9.1994)
  17.  
  18.     - SHAREWARE -
  19.  
  20.    © 1993-94 by Andreas Ralph Kleinert
  21.                 Grube Hohe Grethe 23
  22.                 D-57074 Siegen
  23.                 Germany
  24.  
  25.         EMail : Andreas Kleinert (Fido 2:2457/345.10)
  26.                 Andreas.Kleinert@10.f345.n2457.z2.fido.hotb.sub.org
  27.                 Andreas_Kleinert@345.n2457.z2.fido.sub.org
  28.                 Andreas_Kleinert@10.f345.n2457.z2.fidonet.org
  29.  
  30.    All rights reserved.
  31.  
  32.    Needs Kickstart V2.04. Kickstart release 3.x compatible.
  33.    GUI created under use of GadToolsBox V2.0c.
  34.  
  35. THE PROGRAM'S PURPOSE
  36. ABOUT THE PROGRAM'S ABILITIES
  37. HOW TO INSTALL IT
  38. HOW TO USE IT
  39. KNOWN BUGS AND PROGRAM LIMITS
  40. PROGRAM HISTORY
  41. POSSIBLE FUTURE ENHANCEMENTS
  42. WHERE TO SEND BUG-REPORTS AND DONATIONS
  43. CREDITS AND SUPPORT
  44. DISTRIBUTION LIMITATIONS
  45. COPYRIGHTS
  46.  
  47.  
  48.                      _
  49.                   _ //
  50.              Only \X/ Amiga makes it possible.
  51.  
  52.  
  53.  
  54.  
  55. SuperView in its current phase of development is a program, which has
  56. mainly three purposes :
  57.  
  58.  - Displaying of various Graphic File Formats,
  59.    e.g. IFF-ILBM, IFF-ACBM, PCX, GIF, JPEG, BMP, FBM, TIFF, WPG, IMG,
  60.         MacPaint, Targa, Pictor/PCPaint, SunRaster (RAS), C64, SVO
  61.         and DataTypes (OS V3.00+) !
  62.    Many of them with 24 Bit-Support.
  63.  - Writing/Conversion of most of these Graphic File Formats
  64.  - "Screen-Grabbing", which means saving Screens in most of
  65.    these Graphic File Formats
  66.  
  67.  All this under usage of internal and external Graphic- and
  68.  GraphicCard-Drivers.
  69.  
  70. More about the program's abilities can be found in the specific chapters.
  71.  
  72.  
  73.  
  74.  
  75. SuperView is a program that has been designed for the purpose, to display
  76. any kind of graphic as fast and as comfortable as possible.
  77.  
  78. Fast means not only fast in reading and displaying but also in calling
  79. and using the program.
  80.  
  81. Highest possible flexibility is implemented via the external Driver-System,
  82. consisting of the superview.library, the SVObjects, SVDrivers and
  83. SVOperators.
  84. This allows at the time for example support of IFF-ILBM, IFF-ACBM, PCX,
  85. GIF, BMP and SVO.
  86.  
  87. These intentions resulted in a bundle of features and options
  88. you have access to when using SuperView and installing it to your System :
  89.  
  90.  - own "superview.library" (supplied in separate archive)
  91.  - intensive use of many special OS V2.04+ and OS V2.1+ capabilities
  92.  - support of many OS V3.00+ and AGA graphics features,
  93.    as e.g. support of interleaved BitMaps
  94.  - support of external Viewer-Libraries (svobjects), for
  95.    e.g. IFF-ILBM, IFF-ACBM, PCX, GIF, JPEG, BMP, FBM, TIFF, WPG, IMG,
  96.         MacPaint, Targa, Pictor/PCPaint, SunRaster (RAS), C64, SVO
  97.         and DataTypes (OS V3.00+) !
  98.    Many of them with 24 Bit-Support.
  99.  - support of external GraphicCard-Drivers (svdrivers), e.g. for :
  100.    ECS, AGA, EGS-Cards
  101.  - support of external Operators, as e.g. :
  102.    XOR
  103.  - "Screen-Grabbing"
  104.  - Commodity  (optional)
  105.  - ARexx-Port (optional)
  106.  - AppIcon    (optional)
  107.  - AppMenu    (optional)
  108.  - AppWindow  (optional)
  109.  - Clipboard reading and writing
  110.  - Localization for OS V2.1+ (not all texts yet)
  111.  - AmigaGuide OnLine-Help for OS V2.1+
  112.  - detailed configuration via Config-File, Cli-Options and
  113.    Workbench-Tooltypes
  114.  - Graphical User Interface (GUI) for Workbench-Users (optional)
  115.  - conversion of the supported File-Formats
  116.  - information about the displayed graphics via Requester,
  117.    selectable via GUI-Menu
  118.  - and more
  119.  
  120. And via ILBM.svobject and ACBM.svobject :
  121.  
  122.  - use of "iffparse.library" for reading and writing
  123.  - reading and writing of extended CAMGs (OS V2.04+)
  124.    and AGA-CMAPs (OS V3.00+)
  125.  - intelligent CAMG-Chunk replacement routine
  126.  - and more
  127.  
  128.  
  129.  
  130.  
  131. Even if you use the supplied Installer-Script, you should read the following
  132. notes. If you do not own the standard Installer-Program you should read
  133. them even more carefully and follow the instructions given.
  134.  
  135. The superview.library has to be installed seperately, anyway !
  136.  
  137.    Needed Workbench Resources
  138.  
  139. HardDisk-Users won't perhaps have to install any additional Workbench
  140. Resources to their HardDisk.
  141. Disk-Users will have to copy the following libraries into their
  142. "LIBS:"-Directory :
  143.  
  144.   - gadtools.library    V37+
  145.   - iffparse.library    V37+
  146.   - asl.library         V37+
  147.   - commodities.library V37+
  148.   - utility.library     V37+ (usually in ROM)
  149.   - workbench.library   V37+ (usually in ROM)
  150.   - icon.library        V37+ (usually in ROM)
  151.  
  152. Users of OS V2.1 or greater should also install the following
  153. libraries :
  154.  
  155.   - amigaguide.library  V38+
  156.   - locale.library      V38+
  157.  
  158.  
  159.    Other needed Resources
  160.  
  161. You will also have to copy the following libraries to your
  162. "LIBS:"-Directory (plus SVObjects, SVDrivers and SVOperators) :
  163.  
  164.   - superview.library          V7+
  165.   - superviewsupport.library   V4+
  166.  
  167.  
  168.    Installing the Main Program
  169.  
  170. Copying SuperView to your "WBStartup"-Drawer is perhaps one possible
  171. solution, but installing it in any other directory will suffice anyway.
  172. You should also install an appropriate Config-File in one of the supported
  173. paths (e.g. "ENV:" or "S:").
  174.  
  175.  
  176.  
  177.  
  178. How To Use SuperView : An Introduction
  179.  
  180.  1.0 SUPERVIEW'S CONSTRUCTION
  181.  
  182.      1.0.1 The Workbench Interface
  183.      1.0.2 The Graphical User Interface (GUI)
  184.      1.0.3 The CLI Interface
  185.      1.0.4 The Commodity Support
  186.      1.0.5 The ARexx-Port
  187.      1.0.6 The App-Features
  188.      1.0.7 Configuration Commands
  189.  
  190.  2.0 CONTROLLING AND USING SUPERVIEW
  191.  
  192.      2.0.1 Options for Configuration and ARexx
  193.      2.0.2 GUI and WB-App Handling
  194.      2.0.3 Controlling the Display-Screen
  195.  
  196.  3.0 INFORMATION ABOUT THE SUPPORTED GFX FORMATS
  197.  
  198.      3.0.1 IFF-ILBM
  199.      3.0.2 IFF-ACBM
  200.      3.0.3 Other File Formats
  201.  
  202.  
  203.  
  204.  
  205.  1.0 SuperView's Construction
  206.  
  207.      SuperView bases on several interfaces, of which almost any can be
  208.      activated/deactivated and accessed separately.
  209.      These are :
  210.  
  211.       - The Workbench Interface
  212.       - The Graphical User Interface (GUI)
  213.       - The CLI Interface
  214.       - The Commodity Support
  215.       - The ARexx-Port
  216.       - The App-Features
  217.       - Configuration Commands
  218.  
  219.    1.0.1 The Workbench Interface
  220.  
  221.      The Workbench interface is just a standard WB-Interface, which means
  222.      that it supports sevaral Tooltypes for program configuration, of
  223.      which nearly any are also available via ARexx and the ConfigFile.
  224.  
  225.      It is supported to use SuperView as a DefaultTool for Project Icons
  226.      via the Workbench "Information" Menu as well as displaying pictures
  227.      via "multiple selection" as described in the Workbench manual.
  228.  
  229.      See 2.0.1 for more details on configuration.
  230.  
  231.    1.0.2 The Graphical User Interface (GUI)
  232.  
  233.      As many other programs SuperView gives the user the possibility to
  234.      control most activities via a Graphical User Interface, based on
  235.      the standard Intuition elements as Gadgets, Menus and Windows.
  236.  
  237.      SUPERVIEW'S GUI allows to reach nearly all of the program's features
  238.      and also provides even more of them.
  239.  
  240.      This GUI is not opened automatically, because SuperView is also
  241.      designed to run as a Commodity in the Background (see 1.0.4), where
  242.      a GUI often is not actually needed.
  243.  
  244.      The GUI may be activated via Configuration options (see 2.0.1),
  245.      which either have to be placed in the Config-File, as Icon-
  246.      Tooltypes or as CommandLine-Options (see 1.0.3).
  247.      When running SuperView as a Commodity the GUI can also be opened
  248.      via the standard WB-Program "Commodity Exchange" (see 1.0.4).
  249.      If an AppIcon or AppMenu is installed, it also will let the GUI
  250.      pop up (see 1.0.6).
  251.  
  252.    1.0.3 The CLI Interface
  253.  
  254.     The CLI Interface provides nearly all possibilies as the GUI does
  255.     (except Screen Saving/Gfx Converting), so that CLI users are completely
  256.     integrated into the program's idea of concept.
  257.     Allowed configuration options can be parsed via CommandLine by
  258.     simply adding an "-" to their front (see 2.0.1).
  259.  
  260.    1.0.4 The Commodity Support
  261.  
  262.     Only one of the currently running copies of SuperView at a time
  263.     has the possibility to install itself as a Commodity which can be
  264.     controlled via the standard WB-Program "Commodity Exchange".
  265.     Special options (see 2.0.1) allow to set the HotKey, the Priority
  266.     and can specify, if the GUI should pop up or not.
  267.  
  268.     Via the HotKey (default : alt esc) SuperView is present everywhere
  269.     it is needed and even the GUI can appear anywhere as fast as possible,
  270.     because of the "Commodity Exchange", which allows it to pop up just
  271.     by pressing the specific button there.
  272.  
  273.    1.0.5 The ARexx-Port
  274.  
  275.     The ARexx-Port is another feature, which strenghtens the interactive
  276.     capabilities of SuperView, because it allows to contact the SuperView
  277.     Process from nearly anywhere at nearly any time to tell it to do a
  278.     specific task.
  279.     Most of the ARexx-Commands are also available as configuration
  280.     options, so they are described there (see 2.0.1).
  281.     The name of the ARexx-Port is "SuperView.rx".
  282.     Only one SuperView Process will own such a port at a time.
  283.  
  284.    1.0.6 The App-Features
  285.  
  286.     Another interactive feature of SuperView allows you to install
  287.     an AppIcon, AppMenu and/or AppWindow.
  288.     All these are each optionally.
  289.  
  290.     The AppIcon is placed on the Workbench and allows direct activation
  291.     of SuperView, as via ARexx or "Commodity Exchange" (Requester).
  292.  
  293.     The AppMenu just works like the AppIcon.
  294.  
  295.     The AppWindow only takes place, when the GUI is opened, so that any
  296.     pictures of which you drop an Icon into the GUI Window will be
  297.     displayed immediately.
  298.  
  299.    1.0.7 Configuration Commands
  300.  
  301.     Because of those many options and features is has perhaps to be
  302.     explained which order takes place when configuring the program at
  303.     startup time or later. Here's a table :
  304.  
  305.      - Default Options (integrated in SuperView)
  306.      - ConfigFile      (read from Disk, if available)
  307.      - a) Tooltypes    (read from Icon(s) at WB-Start)
  308.        b) CLI-Options  (supplied via CommandLine at CLI-Start)
  309.      - ARexx-Command   (received while the program is running)
  310.  
  311.  
  312.  
  313.  
  314.  2.0 Controlling And Using SuperView
  315.  
  316.      As described before, SuperView can either be controlled via
  317.      Workbench, CLI, "Commodity Exchange", ARexx or its GUI.
  318.  
  319.      The Commands, which are available for configuration and
  320.      interactive ARexx use follow (2.0.1).
  321.      After that the handling of the GUI is described more detailed (2.0.2).
  322.  
  323.    2.0.1 Options for Configuration and ARexx
  324.  
  325.      The letter after the specific command tells you from where it can be
  326.      reached :
  327.  
  328.       C       [ Config-File                         ]
  329.       T       [ Workbench-Tooltypes, CLI-CommandLine]
  330.       A       [ ARexx                               ]
  331.  
  332.  
  333.       Command                    Function                       Usage
  334.  
  335.       QUIT                       Leave SuperView                [     A ]
  336.       HELP                       Load AmigaGuide DataBase       [ C T A ]
  337.       REQUEST                    Request for displaying a Gfx   [ C T A ]
  338.       SHOW=<FileName>            Display a specific Gfx         [ C T A ]
  339.       LOAD=<FileName>            Load a specific Gfx            [ C T A ]
  340.       UNSHOW                     End Displaying / Close Display [     A ]
  341.       SAVE_TYPE=<SVObject-ID>    Set new Save-Type for "SAVE"   [ C T A ]
  342.                                  (does not affect GUI settings)
  343.       SAVE=<FileName>            Save current Gfx as SAVE_TYPE  [     A ]
  344.       SVDRIVER=<SVDriver-ID>     Set Default-SVDriver by ID     [ C T A ]
  345.       OPTION_LOAD=<DISK|CLIP>    Disk or ClipBoard loading ?    [ C T A ]
  346.       OPTION_SAVE=<DISK|CLIP>    Disk or ClipBoard saving  ?    [ C T A ]
  347.       ERROR_REPORT=<YES|NO>      Report Errors ? Or be quiet ?  [ C T A ]
  348.       INSTALL_CX=<YES|NO>        Install as a Commodity ?       [ C T   ]
  349.       INSTALL_AREXX=<YES|NO>     Provide an ARexx-Port ?        [ C T   ]
  350.       INSTALL_APPWINDOW=<YES|NO> Provide an AppWindow ?         [ C T A ]
  351.                                  (only together with OPEN_GUI
  352.                                   or CX_POPUP=YES)
  353.       INSTALL_APPICON=<YES|NO>   Provide an AppIcon ?           [ C T   ]
  354.       INSTALL_APPMENU=<YES|NO>   Provide an AppMenu ?           [ C T   ]
  355.       OPEN_GUI                   Open the GUI immediately       [ C T A ]
  356.       CLOSE_GUI                  Close the GUI immediately      [     A ]
  357.       CX_POPKEY=<key key ...>    Standard CX_POPKEY command     [ C T   ]
  358.                                  (Don't use "+" as a key)
  359.       CX_POPUP=<YES|NO>          Standard CX_POPUP command.     [ C T   ]
  360.                                  CX_POPUP=YES is equivalent
  361.                                  to OPEN_GUI.
  362.       CX_PRIORITY=<-128..127>    Set Priority of SuperView      [ C T A ]
  363.                                  Process and the Commodity
  364.                                  Broker. If called via ARexx
  365.                                  only the process priority is
  366.                                  set new.
  367.  
  368.       The name of the ARexx-Port is "SuperView.rx" (only one is possible
  369.       at the same time).
  370.  
  371.  
  372.    2.0.2 GUI and WB-App Handling
  373.  
  374.      The GUI mainly consists of three regions which are marked by the
  375.      specific gadgets with the same name :
  376.  
  377.          Picture Gadgets
  378.  
  379.          VIEW
  380.  
  381.          LOAD
  382.          SAVE
  383.          VIEWBUFFER
  384.          ACTION
  385.  
  386.          MEDIUM
  387.  
  388.          SVObject / SVDriver Gadgets
  389.  
  390.          SV-SWITCH
  391.          SV-LISTVIEW
  392.  
  393.          SVINFO
  394.          REMOVE
  395.  
  396.          Screen Gadgets
  397.  
  398.          SCREEN-LISTVIEW
  399.  
  400.          UPDATE
  401.          SAVE
  402.          INFO
  403.  
  404.      More options are available via the "Project" Menu, where you can
  405.      select between the following actions :
  406.  
  407.          FILEINFO
  408.          HELP
  409.          ABOUT
  410.          HIDE
  411.          QUIT
  412.  
  413.      By pressing HELP while selecting a Menu, or by selecting a Gadget after
  414.      turning on the Gadget-Help via pressing HELP you may enter the
  415.      context-sensitive documentation.
  416.  
  417.    2.0.3 Controlling the Display-Screen
  418.  
  419.      SuperView opens for each graphic, which has to be displayed, a
  420.      suitable Screen.
  421.      This Screen and the attached Window are usually pushed to the
  422.      Foreground automatically und become activated, just right after the
  423.      graphic has been loaded.
  424.  
  425.      After that you have the possibility, to control the program's
  426.      behaviour via the following actions :
  427.  
  428.      Mouse control :
  429.  
  430.       - left Button quits the display
  431.       - left Button below the graphic, while moving the mouse simultaneously
  432.         scrolls the graphic : ONLY WITH OS V3.00+ DataTypes
  433.         (see relating note in the Screen-Titlebar)
  434.  
  435.      Keypad control :
  436.  
  437.       - Key "L"  : Load new graphic
  438.       - Key "Q"  : Quit display
  439.       - Key "X"  : Quit display and leave program
  440.       - Key "H"  : Open GUI (GUI-Screen still in Background)
  441.       - HELP-Key : Open GUI (GUI-Screen still in Background)
  442.       - ESC-Key  : Quit display and leave program
  443.                    (keep it pressed about 1-2 seconds)
  444.       - F1..7    : HardCopy with density 1..7
  445.  
  446.  
  447.  
  448.  
  449.  3.0 Information about the supported Gfx Formats
  450.  
  451.    3.0.1 IFF-ILBM
  452.  
  453.      IFF-ILBM is the standard Gfx FileFormat for the Amiga.
  454.      Currently there do exist two versions of this Format :
  455.  
  456.       - IFF-ILBM, unpacked
  457.       - IFF-ILBM, CmpByteRun encoded
  458.  
  459.      The difference is, that the second one contains data, which is
  460.      encoded with the CmpByteRun method, while the data of the first
  461.      is unencoded.
  462.      The reason, why both methods are included, is that sometimes it may
  463.      be more efficient to let the IFF-ILBM file unpacked and then
  464.      pack it with an other packer instead encoding it with CmpByteRun.
  465.      Also there may exist some older - actually VERY old - programs,
  466.      which do not support the packed format.
  467.  
  468.      IFF-ILBM graphics may contain Amiga-specific color cycling (CRNG)
  469.      and ViewMode (CAMG) information.
  470.  
  471.  
  472.    3.0.2 IFF-ACBM
  473.  
  474.      IFF-ACBM is the standard Gfx FileFormat for AmigaBASIC.
  475.      Currently there only does exist one version of this Format :
  476.  
  477.       - IFF-ACBM, unpacked
  478.  
  479.      The reason, why the data is unpacked is nearly the same, why
  480.      IFF-ILBM is not used here :
  481.      From Basic programmes it is not easy to read packed data anyway
  482.      and it would slow down the program enormously.
  483.      Data in an IFF-ACBM is saved BitPlane for BitPlane, to increase the
  484.      speed of reading.
  485.  
  486.      If you use an automatically packing FileSystem or a patched DOS
  487.      it might be useful to use IFF-ACBM, because the speed of displaying
  488.      pictures dos not increase only with AmigaBASIC programs, but also
  489.      with SuperView.
  490.      And if you use such a method of background packing you will not
  491.      even need more HardDisk space, which is in fact needed if converting
  492.      from IFF-ILBM (CmpByteRun) to IFF-ACBM.
  493.      On the other hand needed space is nearly the same as for unpacked
  494.      IFF-ILBM graphics - but the speed is higher.
  495.  
  496.  
  497.    3.0.3 Other File Formats
  498.  
  499.      Library-Versions above V2 of the "superview.library" support displaying
  500.      via SuperViewObjects (SVObjects), which are placed as external drivers
  501.      inside "LIBS:svobjects/".
  502.      Nevertheless you may also make use of OS V3.00+ DataTypes.
  503.      Just select, which one you want to have installed, but please note,
  504.      that SVObjects will cooperate much more better to superview.library.
  505.  
  506.  
  507.  
  508.       - FileInfo
  509.  
  510.         Gives information about the currently loaded Gfx, as width, height
  511.         or color-depth.
  512.  
  513.  
  514.       - Help
  515.  
  516.         Starts this Online-Help.
  517.  
  518.  
  519.  
  520.       - About
  521.  
  522.         Informs about SuperView.
  523.  
  524.  
  525.       - Hide
  526.  
  527.         Closes the GUI of SuperView (which when in Commodity-Mode, not
  528.         necessarily means to quit SuperView itself).
  529.  
  530.  
  531.       - Quit
  532.  
  533.         Closes the GUI of SuperView and exits the program.
  534.  
  535.  
  536.       - View
  537.  
  538.         When clicking on this gadget, any old Display will be closed,
  539.         a FileRequester will appear and the selected picture - if of
  540.         a known File-Type - will be displayed immediately and replace
  541.         the old display.
  542.  
  543.  
  544.       - Load
  545.  
  546.         When clicking on this gadget, a FileRequester will appear and the
  547.         selected picture - if of a known File-Type - will be loaded
  548.         and held in the Memory for multiple saving (e.g. in different
  549.         file-formats).
  550.  
  551.         If the speficic SVObject (e.g. Datatypes-SVObject) does not support
  552.         exporting Buffers, a Screen will be opened in the Background to
  553.         keep the picture.
  554.  
  555.  
  556.  
  557.       - Save
  558.  
  559.         The stored Buffer will be saved as a picture in the desired
  560.         file-format, as selected in the ListView-Gadget.
  561.         (Select "SVInfo" Gadget for more information on the speficic
  562.          FileFormats).
  563.  
  564.  
  565.       - ViewBuffer
  566.  
  567.         Allows to take a quick view on the currently loaded buffer.
  568.         Functionality is _not_ the same as with "View".
  569.  
  570.         Here you'll just take a short look onto the picture and then
  571.         click it right out of the way.
  572.  
  573.  
  574.       - Action
  575.  
  576.         Modifies the currently loaded SV_GfxBuffer in a way, which depends
  577.         on the currently selected SVOperator.
  578.  
  579.         After that you may save or display the result of the operation
  580.         via the selected SVObject/SVDriver.
  581.  
  582.  
  583.       - Medium
  584.  
  585.         This gadget switches the Input/Ouput medium between Disk and Clipboard.
  586.         This affects loading and saving of graphics.
  587.         You may e.g load a graphic from ClipBoard, then switch to Disk and
  588.         save it to there.
  589.  
  590.         If disk access is selected, a FileRequester will appear before loading
  591.         and saving anything, otherwise just the first clipboard unit will
  592.         be used.
  593.         More about clipboard use perhaps can be found in your computer's
  594.         manual.
  595.  
  596.  
  597.       - SVObject/SVDriver switch Gadget
  598.  
  599.         This gadget switches the SVLISTVIEW-GADGET
  600.         between SVObject/SVDriver Mode.
  601.  
  602.  
  603.       - SVObject/SVDriver ListView Gadget
  604.  
  605.         This gadget is for selection of the SVObject/SVDriver, which should be
  606.         the source for the actions, which can be performed via  VIEW,
  607.         LOAD or SAVE.
  608.  
  609.  
  610.       - SVObject/SVDriver/SVOperator Information Gadget
  611.  
  612.         This gadget displays more detailed information on SVObjects/
  613.         SVDrivers/SVOperators.
  614.  
  615.  
  616.       - SVObject/SVDriver/SVOperator Add Gadget
  617.  
  618.         This Gadget adds new SVObjects/SVDrivers/SVOperators to the system,
  619.         which can be selected via FileRequester.
  620.         Don't try to selecting other libraries than those, which have
  621.         a name ending with ".svobject",".svdriver" or ".svoperator" !
  622.  
  623.         Removing is possible via REMOVE.
  624.  
  625.  
  626.       - SVObject/SVDriver/SVOperator Remove Gadget
  627.  
  628.         This Gadget removes unusede SVObjects/SVDrivers/SVOperators from
  629.         the system.
  630.         This is only possible, if the current SuperView-Task is the only
  631.         program, which accesses superview-Library at the time.
  632.         Otherwise the action will result in nothing.
  633.  
  634.         Adding is possible via ADD.
  635.  
  636.  
  637.       - ScreenListView Gadget
  638.  
  639.         This gadget is for selection of the Screen, which should be the
  640.         source for the actions, which can be performed via  UPDATE,
  641.         INFO or SAVE.
  642.  
  643.  
  644.       - Update
  645.  
  646.         If the list of selectable Screens is not up-to-date an update
  647.         can be forced by pressing this Gadget.
  648.  
  649.  
  650.  
  651.       - Save
  652.  
  653.         The Save-Gadget in the Screen area allows yoy to save the selected
  654.         Screen in the desired File-Format.
  655.         (Select "Detailed Info" Gadget for more information on the speficic
  656.          FileFormats).
  657.  
  658.  
  659.       - Info
  660.  
  661.         This Gadget presents various information on the currently
  662.         selected Screen.
  663.  
  664.  
  665.  
  666.  
  667. Known Bugs and program limits :
  668.  
  669.  Bugs
  670.  ----
  671.  - two or three people reported me, that SuperView (or the Library,
  672.    one never know) did not startup at all and that there were some
  673.    Enforcer Hits.
  674.    I wasn't able to reproduce these bugs with newer (even older) versions
  675.    of SuperView and the Library, so that these problems might only
  676.    concern _some_ people.
  677.    Nevertheless I will at least try to find and fix this (possible) bug.
  678.  
  679.    On the other hand there are many A1200/3000/4000 users, which reported,
  680.    that everything works fine.
  681.  
  682.    Don't panic.
  683.  
  684.  
  685.  Limits
  686.  ------
  687.  
  688.  - When trying to create some kind of a "slide show", you have to decide how
  689.    long the user should see a picture displayed, because a mouse click by the
  690.    user will end displaying as well as sending an ARexx/Commodity/Tooltype
  691.    command to SuperView, which immediately will cause it to display
  692.    the new picture. This is not a real bug, this is just because of
  693.    interactive message receiving while a picture is displayed.
  694.    Multiple picture displaying is only possible when starting different
  695.    SuperView Tasks, which then all have to be "quit"ted by a mouse click.
  696.  
  697.  - Another point is, that only one currently running SuperView Task
  698.    can be reached interactively via ARexxPort and Commodity Exchange.
  699.    This lies in the nature of SuperView and Commodity Exchange.
  700.    Nevertheless multiple AppIcons and AppMenus - as well as their
  701.    corresponding tasks - are possible, so do not forget to disable this
  702.    feature if you don't want to get a Workbench full of SuperView-Icons ...
  703.  
  704.  
  705.  
  706.  
  707. The SuperView ILBM-Viewer bases on my older program project "KILBM", which
  708. has been designed for usage under older versions of the Amiga OS.
  709. SuperView is _not_ related to the program with the same name from AmigaLib
  710. Disk 367, about which I read _after_ programming it.
  711.  
  712. V4.0 : - added SVOperator-support
  713.        - superview.library V9+ now is needed
  714.  
  715. V3.5 : - added KeyFile-support
  716.        - * ToolType-routines no longer case-sensitive
  717.          * changed way of flag-checking for App-things
  718.          This should (hopefully) fix the problems in switching
  719.          them on/off separately.
  720.        - plus more little improvements
  721.  
  722. V3.4 : - changed Menus from Quit/Exit to Hide/Quit,
  723.          also changed the related shortcuts
  724.        - "evaluation"-requester did not work under V37 :-(
  725.          (because of Locale-Library : aargh !!)
  726.        - Displaying of already loaded (stored) files now is possible
  727.          ("View Buffer")
  728.  
  729. V3.3 : - RAW-Keys (Help, Esc) did not work on display screen, as
  730.          described. Now they do.
  731.        - HardCopy function added (F1..F7)
  732.        - localization of the "ScreenInfo"-Requester texts
  733.  
  734. V3.2 : - This release was only for registered Users (and Beta-Testers)
  735.        - Beta-Versions : V3.2 (20.7.94)
  736.        - german GuideFile slightly changed
  737.        - now requires        superview.library V7+
  738.          and          superviewsupport.library V4+
  739.        - fixed small bug, which caused unknown filetypes to
  740.          be checked twice
  741.        - users of OS V37/38 now also get a Busy-Pointer
  742.        - adding/removing of SVObjects/SVDrivers now is possible without
  743.          any restrictions, by using the functions of superview.library V7+.
  744.          (Only possible, if there's not an other program accessing superview-
  745.          library at the time : OpenCnt-Check)
  746.        - added new - more flexible - ARexx-Commands for saving and
  747.          converting of graphics : "SAVE_TYPE" and "SAVE".
  748.          These replace the old "SAVE_ILBM0", "SAVE_ILBM1" and "SAVE_ACBM",
  749.          which have been removed completely.
  750.        - SVDriver-ListView now also shows right SVDriver at startup.
  751.        - new ARexx-Command for setting Default-SVDriver : "SVDRIVER"
  752.        - added some more example scripts for ARexx, which also demonstrate
  753.          usage of the new commands
  754.        - re-worked ScreenInfo function
  755.        - Config-Menu was accidentally in German, although not localized
  756.        - re-wrote Installer-Script : - localized now (for "intermediate"
  757.                                        and "expert" mode only)
  758.                                      - OS Version now checked
  759.                                      - no longer requires SourceDir to
  760.                                        be available as ":SuperView"
  761.                                      - and more
  762.        - last not least : I'm now reachable via EMail
  763.          (Fido : 2:2457/345.10)
  764.  
  765. V3.1 : - major revision
  766.        - now requires superview.library V6+
  767.          (to prevent us to share the bugs of the previous versions)
  768.        - new GUI, with more and better features (special thanks to
  769.          Gerd Frank for his many ideas and suggestions concerning a new GUI)
  770.        - GUI is font-sensitive now and appears on Public Screen
  771.        - improved AmigaGuide Online-Help
  772.        - now the favorite SVDriver can be selected inside SuperView,
  773.          and also SVObjects can be removed there. SuperViewPrefs now
  774.          is only needed for default settings so far.
  775.        - information on SVObjects and SVDrivers can be found here
  776.        - splittet and re-organized Gadgets for viewing, loading and saving
  777.        - removed Medium selection from Menus and added specific Gadgets :
  778.          internally there are still two variables, but on the GUI those
  779.          are set together for loading and saving. You may use ARexx
  780.          commands to set them different, but when working on the GUI
  781.          you'd just read a file into the buffer and then switch the
  782.          settings.
  783.        - fixed bug, which might have kept SuperView in memory, although
  784.          it was no longer active
  785.        - changed way of loading and saving ConfigFile, in parts now using
  786.          superviewsupport.library's functions for that (loading).
  787.          Now no longer "+" in hot-key descriptions are needed to separate
  788.          single key, but old way still supported (thus don't use "+" as
  789.          a key)
  790.        - added new "LOAD" command, which allows simple conversion of
  791.          graphics (to ILBM) via ARexx-Scripts (see Example-Script)
  792.        - and more
  793.  
  794. V2.5 : - we no longer use fscanf/fprintf for ConfigFile reading, but
  795.          FGets/VFPrintf of Dos V37+ instead now : this saves about
  796.          6900 Bytes Codesize and is as effective as before !
  797.        - fixed History : superview.library V3.9 was released as V4.1
  798.        - supports direct writing of GfxBuffers with superview.library V6+
  799.          (a buffer-Screen is no longer needed). Includes fall-back option
  800.          for versions below V6 or SVObjects without GfxBuffer-Support.
  801.          Conversion of large pictures will now be possible with less memory
  802.          usage in most cases.
  803.  
  804. V2.4 : - use of SAS/C V6.51
  805.        - now again supporting amigaguide.library V38 (own risk)
  806.        - changed/updated documentation
  807.        - AmigaGuide stuff might not have been closed/removed
  808.        - removed memory management routines : if needed, we will take
  809.          them from superviewsupport.library (introduced with
  810.          superview.library V3.8)
  811.        - OS version is checked earlier now (>= V37)
  812.        - the AppIcon now also accepts dropping Icons of Pictures on it,
  813.          as one would expect
  814.          (mentioned by Gerd Frank)
  815.        - SuperView no longer crashes, when started with question mark ("?")
  816.          from CLI/Shell
  817.        - removed "anchor window" for the FileRequester
  818.        - ClipBoard feature did not work with superview.library releases
  819.          V2.4 to V3.8. You must use V4+ (and the bug-fixed SVObjects)
  820.          for enabling this again.
  821.          This was not a bug of SuperView.
  822.  
  823. V2.3 : - SuperView crashed without locale.library, although it shouldn't
  824.          have been able to do so.
  825.          (fixed as a result of former bug-reports by Gerd Frank,
  826.           see amigaguide-fixed in V2.1 and V2.2)
  827.        - fixed bug in handling underscored Gadgets
  828.        - added Underscore to "*"-Gadget
  829.        - added possibility to get information on Screens ("i"-Gadget)
  830.          (mentioned by Gerd Frank)
  831.        - completely reworked internal ScreenList creation and handling
  832.          (also reported by Gerd Frank).
  833.          Besides, this saves some memory and diskspace.
  834.  
  835. V2.2 : - fixed bug (Guru), which occured, when selecting Help-Menu, while
  836.          amigaguide-Library V39+ was not available.
  837.          (mentioned by Gerd Frank)
  838.        - new "Exit"-Menu, which leaves the program - other than "Quit"
  839.          completely
  840.          (mentioned by Gerd Frank)
  841.  
  842. V2.1 : - now under OS V3.00+ the Busy-Pointer is set while calling
  843.          superview.library
  844.        - fixed bug (Guru), which occured when calling HELP while amigaguide-
  845.          Library V39+ was not available (mentioned by Gerd Frank)
  846.        - accidentally asked for amigaguide.library V38+ instead V39+
  847.        - added support for "ESC"aping and "HELP"ing while displaying
  848.  
  849. V2.0 : - needs superview.library V3+ with SVDriver-Support
  850.        - fixed small bug in memory management routines
  851.        - localization of program texts (except GUI) for OS V2.1+
  852.        - now uppercase (shifted) keys accepted on the Display-Screen
  853.        - each written PicFile now becomes its own Icon
  854.        - fixed possible ChipMem-problem with AppIcon-Data
  855.  
  856. V1.4 : - complete recompilation under use of SAS/C V6.5
  857.        - fixed bug with wrong SaveType (ILBM1 instead of ILBM0, or totally
  858.          wrong, if ILBM not installed)
  859.        - fixed bug in memory usage (not freed)
  860.        - some improvements and bug-fixes
  861.  
  862. V1.3:  - new Library with DataTypes-Support
  863.        - make use of the new concept of external Viewer-Libraries (svobjects)
  864.          of superview.library V2+
  865.  
  866. V1.01 : - forgot to mask BADFLAGS out in CAMG-Write-Routine
  867.         - BitMap-Height and -Depth is under V39+ now checked via
  868.           GetBitMapAttr()
  869.         - improved BODY and ABIT size calculation
  870.         - own "superview.library" V1+
  871.         - and many more improvements
  872.         - forgot GadToolsBox-Note (Sorry, Jan van den Baard !)
  873.  
  874. V1.00 : first version.
  875.  
  876.  
  877.  
  878.  
  879. Possible future enhancements might be :
  880.  
  881.  - more functions for working with SVObjects
  882.  - new features for image processing (still thinking about it)
  883.  - an improved ARexx-Port
  884.  - and more
  885.  
  886.  
  887.  
  888.  
  889. Send donations, bug reports, ideas, etc. to the following address :
  890.  
  891.    Andreas R. Kleinert
  892.    Grube Hohe Grethe 23
  893.    D-57074 Siegen
  894.    Germany
  895.  
  896.    EMail : Andreas Kleinert (Fido 2:2457/345.10)
  897.            Andreas.Kleinert@10.f345.n2457.z2.fido.hotb.sub.org
  898.            Andreas_Kleinert@345.n2457.z2.fido.sub.org
  899.            Andreas_Kleinert@10.f345.n2457.z2.fidonet.org
  900.  
  901.    For _urgent_ calls :
  902.  
  903.    Phone : +49/271/332147    (weekdays later than 18.00h)
  904.  
  905. When reporting any bugs, please don't forget to include a detailed
  906. description of the bug and tell me, if it is reproduceable or not.
  907. Please also mention the version number of SuperView you used and describe
  908. your system configuration (Amiga model 500/1000/.../4000-040, Kickstart/OS,
  909. RAM, HardDisk, special configurations).
  910.  
  911. If you want to get a newer - and maybe debugged - version of SuperView
  912. do not forget to register as an user of SuperView with the included
  913. registration form.
  914. Nevertheless unregistered users are as welcome to report bugs as
  915. users who decide(d) to register.
  916.  
  917.  
  918.  
  919.  
  920. I perhaps have to thank many persons, but I won't list them all up here,
  921. since many of them are already mentioned in the documentation to
  922. "superview-Library" (so read it, please).
  923.  
  924. Thanks go to (in alphabetical order) :
  925.  
  926.  - Jan van den Baard
  927.  
  928.    ... for his great tool GadToolsBox, which I used to design the GUI of
  929.    SuperView.
  930.  
  931.  - Gerd Frank
  932.  
  933.    ... for Beta-Testing, Bug-Reports and last not least for his many ideas
  934.    and suggestions, espescially concerning the re-design of SuperView's
  935.    GUI in V3.x !
  936.  
  937.  - Martin Schulze
  938.  
  939.    ... for uploading SuperView onto the AmiNet and including it into
  940.    the SaarAG series, so that it reached more people out there.
  941.    Also for sending and receiving all those mails, which did not find
  942.    their way through the labyrinth of Fido-Gateways ;-)
  943.  
  944.  - and last NOT LEAST
  945.  
  946.    - all registered users of SuperView for supporting Shareware
  947.    - all people I already mentioned in the documentation to
  948.      superview-Library
  949.  
  950.  
  951.  
  952.  
  953.     Copyright
  954.  
  955. The program SuperView in this version and its documentation files are
  956. (C)opyright 1993-94 by Andreas R. Kleinert. All rights reserved.
  957.  
  958. The right of using this program is granted to you by paying the
  959. SHAREWARE-fee of 30,- (40,-) DM to the author.
  960.  
  961. Together with the registration you also receive your personal KEYFILE.
  962.  
  963.  
  964.     Disclaimer
  965.  
  966. The author takes no responsibility for any results of the use of this
  967. program.
  968. This software is provided "AS IS" and there is no warranty of any kind,
  969. so that you use this software at your own risk.
  970.  
  971.  
  972.     Rights
  973.  
  974. Registered users which paid the SHAREWARE-fee get the rights described
  975. on the registration form.
  976.  
  977.  
  978.     Distribution
  979.  
  980. The REGISTERED version of SuperView MUST NOT be redistributed.
  981. The following only applies to the unregistered evaluation (EL)
  982. version of SuperView :
  983.  
  984. The program SuperView in this version is freely distributable (SHAREWARE).
  985. You may copy it, if the copyright notice is left intact and
  986. all of its parts are included in the distribution.
  987. This program must not be included in commercial packages or commercial
  988. program collections without my written permission.
  989. This program must not be sold in any way, but it is allowed to take
  990. a nominal fee including the costs for copying.
  991.  
  992. This program may be put on public domain disks or included in public
  993. domain disk libraries.
  994. Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  995. the german series (in alphabetical order) :
  996. AmigaSzene, BerndsPD, FRANZ, GPD, SaarAG, TAIFUN and TIME.
  997.  
  998. This program may also be distributed via electronic mail and may be
  999. put into mailboxes as long as the redistribution conditions are
  1000. respected in all points.
  1001.  
  1002. By using or distributing this program you automatically agree to
  1003. all of the above conditions and terms.
  1004.  
  1005.  
  1006.  
  1007.  
  1008.     Copyrights
  1009.  
  1010. Some of the mentioned names or products above may be copyrighted by
  1011. companies or trademarks of companies.
  1012.  
  1013.  
  1014.