home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / gfx / show / superview-lib / docs / superview-lib_eng.doc < prev    next >
Text File  |  1994-07-04  |  18KB  |  490 lines
  1.  
  2.                       superview.library V6.5
  3.  
  4.                            - FREEWARE -
  5.  
  6.              © 1993-94 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.               This program was written under OS V3.00 and is therefore
  9.               fully compatible. It needs OS V2.04+.
  10.  
  11.               Release Date : 04.07.1994
  12.  
  13.  
  14.     Copyright :
  15.     ===========
  16.  
  17.     The program superview.library V6.5 and its documentation files are
  18.     (C)opyright 1993-94 by Andreas R. Kleinert. All rights reserved.
  19.  
  20.     The usage of the "superview.library" for own program projects, no
  21.     matter if commercial or non-commercial, is allowed without any
  22.     restrictions.
  23.  
  24.  
  25.     Disclaimer :
  26.     ============
  27.  
  28.     The author takes no responsibility for any results of the use of this
  29.     program.
  30.     This software is provided "AS IS" and there is no warranty of any kind,
  31.     so that you use this software at your own risk.
  32.  
  33.  
  34.     Functions :
  35.     ===========
  36.  
  37.     The "superview.library" is used in many of my programs and it consists of
  38.     many functions, which make displaying, saving and converting of
  39.     various picture formats (IFF-ILBM, IFF-ACBM, PCX, ...) much easier.
  40.     External Viewer-Libraries (svobjects) and Graphic Card Drivers (svdrivers)
  41.     allow highest possible flexibility and easy to do expansions.
  42.  
  43.     Just send me your own SVObjects and SVDrivers if you want to have them
  44.     added to the main distribution archive or onto the developer disk.
  45.  
  46.  
  47.     Installation :
  48.     ==============
  49.  
  50.     Just use the supplied Installer-Script, or "by hand"-copy
  51.     "superview.library" and "superviewsupport.library" to your "LIBS:"-
  52.     Directory, the svobjects to "LIBS:svobjects/" and the svdrivers to
  53.     "LIBS:svdrivers/" !
  54.  
  55.     "datatypes.library" V39+ is only needed, if OS V3.00+ DataTypes
  56.     are wished to be supported.
  57.     Please take care, which libraries are also additionally needed
  58.     by the single SVObjects.
  59.  
  60.     "AddBuffers"-Values for the used Drives should at least be
  61.     around 25.
  62.  
  63.     You may set the following environment variables at the location
  64.     "ENV:superview-library". SuperViewPrefs can be used for this.
  65.  
  66.     Name                  Content
  67.  
  68.     Default.svdriver      Name of default-ScreenDriver. Read by superview-
  69.                           library at first opening. MUST NOT contain any
  70.                           extra characters (spaces, tabs, etc.).
  71.  
  72.  
  73.     SVObjects :
  74.     ===========
  75.  
  76.     Available SVObjects (as far as known) :
  77.  
  78.      SVObject            Type  Read-Support           Write-Support
  79.  
  80.      IFF-ILBM            EXT   (system-dependent)     (system-dependent)
  81.      IFF-ACBM            EXT   (system-dependent)     (system-dependent)
  82.      OS V3.00+ DataTypes INT   all Pictures           -
  83.      PCX upto V3.0       EXT   upto 256 Colors        upto 256 Colors
  84.                              + 24 Bit Files
  85.      SVO upto V1.0       EXT   (system-dependent)     (system-dependent)
  86.                              + 24 Bit Files         + 24 Bit Files
  87.      GIF upto 89a        EXT   upto 256 Colors        upto 256 Colors
  88.      BMP (Windows)       EXT   upto 256 Colors        upto 256 Colors
  89.                              + 24 Bit Files         + 24 Bit Files
  90.      FBM (Unix)          EXT   upto 256 Colors        upto 256 Colors
  91.      C64 (Koala, Doodle) EXT   upto  16 Colors        -
  92.      IMG (GEM/Ventura)   EXT   upto 256 GreyScales    -
  93.      TIFF (V5.0)         EXT   upto 256 Colors        upto 256 Colors
  94.                              + 24 Bit Files
  95.      Targa               EXT   upto 256 Colors        upto 256 Colors
  96.                              + 24 Bit Files         + 24 Bit Files
  97.      WPG (WordPerfect)   EXT   upto 256 Colors        -
  98.      SunRaster (RAS)     EXT   upto 256 Colors        upto 256 Colors
  99.                              + 24 Bit Files         + 24 Bit Files
  100.      Pictor/PCPaint/PIC  EXT   upto 256 Colors        -
  101.      MAC (MacPaint)      EXT   upto   2 Colors (b&w)  -
  102.      JPEG (JFIF)         EXT   24 Bit as 256 Colors   as 24 Bit
  103.                              + 24 Bit as 24 Bit
  104.  
  105.      JPEG.svobject is available in a separate archive (writing possible
  106.      since V2.3).
  107.  
  108.     Planned SVObjects (no guarantee !) :
  109.  
  110.      - PBM/PGM/PNM/PPM
  111.      - RIFF
  112.      - MTV
  113.      - SGI
  114.      - RLE
  115.      - and more
  116.  
  117.  
  118.     Available SVDrivers (as far as known) :
  119.  
  120.      SVDriver      Requirements                   BITPLANE    ONEPLANE
  121.  
  122.      ECS           ECS, OS V2.04+ (V37), 68000+   (system)     8        Bit
  123.      AGA           AGA, OS V3.00+ (V39), 68020+   (system)     8        Bit
  124.                                                             + 24 as   8 Bit
  125.      EGS-System    EGS-Graphic-Libraries          8 Bit        8 and 24 Bit
  126.  
  127.  
  128.     Support :
  129.     =========
  130.  
  131.     The following programs are currently supporting the "superview.library" :
  132.  
  133.      - SuperView
  134.      - SimpleView (superview.library Example Program)
  135.      - MicroView (superview.library Example Program)
  136.      - KFracPlus
  137.      - SIP (for examinations)
  138.      - DRAFU (unreleased Beta-Version)
  139.      - ...
  140.  
  141.  
  142.     Thanks and greetings to :
  143.     =========================
  144.  
  145.     in alphabetical order :)
  146.  
  147.     Alex    Carbin      (TuC / PowerBrei Red.)
  148.     Fred    Fish        (AmigaLibDisks)
  149.     Gerd    Frank       (BerndsPD)
  150.     Stefan  Grad        (GPD)
  151.     Stefan  Kremer      (TuC / PowerBrei Red.)
  152.     Alex    Lange       (Time PD-Serie)
  153.     H.P.    Lattka      (Franz PD-Serie)
  154.     Andreas Manewaldt   (Taifun PD-Serie)
  155.     Axel    Melzener    (Game Object Design)
  156.     Michael Petrikowski (Amiga Szene)
  157.     Steve   Quartly     (Australia)
  158.     Martin  Schulze     (SaarAG / AmiNet)
  159.  
  160.     and all I forgot !
  161.  
  162.  
  163.     Correspondence :
  164.     ================
  165.  
  166.     If you like, you may send me some money. Perhaps this will motivate me
  167.     to continue programming such programs or just making updates of
  168.     this one. Send bug-reports, money or whatever to :
  169.  
  170.        Andreas R. Kleinert,
  171.        Grube Hohe Grethe 23,
  172.        D-57074 Siegen,
  173.        Germany.                        email : Fido 2:2457/345.10
  174.                                                (checked weekly)
  175.  
  176.  
  177.     History :
  178.     =========
  179.  
  180.     Please note the version-dependencies :
  181.  
  182.     superview.library      SVObjects      SVDrivers      SVOperators
  183.  
  184.     Version 1              -              -              -
  185.     Version 2              Version 1      -              -
  186.     Version 3-6            Version 1,2    Version 1      -
  187.  
  188.  
  189.      V6.5 (04.07.1994) :
  190.      -------------------
  191.  
  192.       - includes superviewsupport.library V4.1
  193.       - moved "reference"-docfiles to "Programmers/Docs"-directory
  194.       - added more detailed description of SV_GfxBuffer structure
  195.         to <superview/superview.h>
  196.       - added ".fd"-files to "Programmers/fd", which might be useful
  197.         for Basic programmers (".bmap" generation) or for generating
  198.         Link-Libraries
  199.       - Env-Variable is "Default.svdriver", not "SVDriver.ascii" !!
  200.       - included SunRaster.svobject (RAS). Already with full write-support.
  201.       - improved/bug-fixed SVObjects : SVO, Targa, ...
  202.       - improved/bug-fixed SVDrivers : AGA, ...
  203.       - last not least : I'm now reachable via EMail
  204.         (Fido : 2:2457/245.10)
  205.  
  206.  
  207.      V6.4 (13.06.1994) :
  208.      -------------------
  209.  
  210.       - revised Example-Programs
  211.       - AGA.svdriver now at least needs 68020+
  212.         (there are no AGA machines, which do not have one ...)
  213.       - strongly improved and enhanced SVObjects : BMP, Targa
  214.       - attention : new JPEG.svobject (V2.3) now also is able to
  215.                     write JPEGs !
  216.       - included Pictor.svobject (PCPaint). Read only yet.
  217.  
  218.  
  219.      V6.3 (06.06.1994) :
  220.      -------------------
  221.  
  222.       - small bug-fixes
  223.       - in all of the supplied SVObjects with write-support there are now
  224.         also the flags for indicating GfxBuffer-Support set
  225.  
  226.  
  227.      V6.2 (03.06.1994) :
  228.      -------------------
  229.  
  230.       - improved GIF.svobject in some ways
  231.       - revised TIFF.svobject and fixed some bad bugs
  232.         (also added some new features, which have not been largely tested
  233.          yet)
  234.       - fixed bad bug in ILBM.svobject (concerned saving of odd-width
  235.         Pictures). There's perhaps the same bug in ACBM.svobject, but
  236.         why making it incompatible wit