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 >
Encoding:
Text File  |  1994-07-04  |  17.2 KB  |  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 with older versions ?
  237.         There might be more of these "word-padding bugs" in other SVObjects,
  238.         but not in all cases the specifications of the file formats are
  239.         as clear about this as this is the case with IFF-ILBM ...
  240.       - added FAQ-like documentation (NotesAndHints.guide)
  241.       - removed example-program "ReadGfxBuffer", because since V6.1 this
  242.         is also included in "SimpleView"'s source-code
  243.  
  244.  
  245.      V6.1 (28.05.1994) :
  246.      -------------------
  247.  
  248.       - FIXED BAD BUG : SVL_SetGfxBuffer() plus SVL_SuperWrite() FAILED
  249.                         always, which was (again) caused by a very simple
  250.                         bug, not worth to mention
  251.       - with all of the supplied SVObjects with write-support it is now
  252.         possible to save not only Screens, but also GfxBuffers :
  253.         all their internal write routines have been completely rewritten,
  254.         so that supplied Screens are transferred to GfxBuffers before saving.
  255.         BitPlane AND OnePlane Buffers upto 8 Bit are supported : they are
  256.         converted to each other by using the appropriate functions of
  257.         superviewsupport.library V3+.
  258.       - this great enhancement - I was working on it since the introducion
  259.         of superview.library V3+ - has been the reason, why the version
  260.         number increased to 6 !
  261.         You may use this feature with the supplied version of SimpleView
  262.         or with SuperView V2.5+ !
  263.       - added four new functions for simple allocation and delocation
  264.         of simplified forms of SVObject and SVDriver lists.
  265.         This will make accessing of superview-library's write-functions
  266.         much more easier for custom applications.
  267.       - added full (reference-like) documentation for SVObjects and
  268.         SVDrivers as such
  269.       - a JPEG.svobject is available since V5.2 (separately)
  270.       - and more ...
  271.  
  272.  
  273.      V5.2 (22.05.1994) :
  274.      -------------------
  275.  
  276.       - superviewsupport.library now contains four new functions to allow
  277.         support of the new ControlPad-FileFormat for SVObject/SVDriver/...
  278.         Configuration Files. (See Docs/SVSupport-Docs)
  279.         These Files are almost similar to Tooltype-Lists.
  280.       - removed one totally WRONG paragraph from Reference_ENG.doc,
  281.         which concerned the SVL_InitHandleAsClip() function (the remark
  282.         still referred to the unrealeased beta version 3.9, which
  283.         was incompatible)
  284.       - included Targa.svobject with 24 Bit-Support. Read only yet.
  285.       - bug-fixed and enhanced 24 Bit-Support of PCX.svobject.
  286.       - improved AGA.svdriver slightly (nearly a bug-fix)
  287.  
  288.  
  289.      V5.1 (18.05.1994) :
  290.      -------------------
  291.  
  292.       - FIXED BAD BUG : SVL_ReadGfxBuffer() failed ALWAYS,
  293.                         which was caused by a very simple bug, not
  294.                         worth to mention (Murphys Law ?)
  295.       - there was also a bug in checking the SVObjects's versions for
  296.         using the GfxBuffer-Functions : we checked for V3+ instead of V2+
  297.       - fixed bug in ACBM.svobject
  298.       - fixed some Doc-Files
  299.  
  300.  
  301.      V4.1 (15.05.1994) :
  302.      -------------------
  303.  
  304.       - because of changing/extending specifications : Jumping to V4
  305.       - included MAC.svobject. Read-Only yet.
  306.       - all NON-DISK loading and saving, e.g. from/into ClipBoard
  307.         DID NOT WORK ANY LONGER since V2.4.
  308.         Before ILBM.svobject and ACBM.svobject had been externalized,
  309.         this feature worked, but only with these.
  310.         After externalization (with this version) this bug was detected
  311.         and fixed.
  312.         Specifications had to be changed slightly - in a compatible way -
  313.         to re-arrange READING to work again (see Reference_ENG.doc,
  314.         SV_InitHandleAsClip-Function).
  315.         For WRITING only superview-Library had to be changed.
  316.  
  317.  
  318.      V3.8 (12.05.1994) :
  319.      -------------------
  320.  
  321.       - use of SAS/C V6.51
  322.       - created new "superviewsupport.library", which is used by
  323.         superview.library and all supplied SVObjects and SVDrivers.
  324.         This saves between 500 and 1600 Bytes for each svobject and
  325.         also results in 1000 Bytes for superview.library.
  326.         superviewsupport.library itself only needs about 3000 Bytes, so
  327.         there's a great gain left.
  328.  
  329.  
  330.      V3.7 (01.05.1994) :
  331.      -------------------
  332.  
  333.       - this version includes all "last minute bug-fixes" to V3.6 and more
  334.       - improved some SVObjects a lot : PCX, TIFF, ...
  335.       - improved some SVDrivers a lot : EGS
  336.       - slightly improved SuperViewPrefs
  337.       - changed Installer-Script to create "ENVARC:Default.svdriver",
  338.         for people who forget to use SuperViewPrefs
  339.  
  340.  
  341.      V3.6 (18.04.1994) :
  342.      -------------------
  343.  
  344.       - this version includes all "last minute bug-fixes" to V3.5 and more
  345.       - included TIFF.svobject. Read-Only yet.
  346.         (first version already included as bug-fix to V3.5)
  347.       - included WPG.svobject. Read-Only yet.
  348.       - improved some SVObjects a lot : IMG, TIFF, GIF, ...
  349.       - improved some SVDrivers a lot : AGA, EGS
  350.       - added 24 Bit-Support (ONEPLANE-RGB) to AGA- and EGS-SVDriver
  351.  
  352.  
  353.      V3.5 (27.03.1994) :
  354.      -------------------
  355.  
  356.       - new Example-Program : MicroView !
  357.       - Datatypes-Support now just for PICTURES : everything else will
  358.         be rejected
  359.       - updated Include-Files to reflect V3.5, made some changes
  360.       - all supplied SVObjects do no longer have a default SVDriver
  361.         integrated : this saves about 1600 Bytes diskspace, which we
  362.         need for future expansions
  363.       - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
  364.         This saves again about 1800 Bytes.
  365.       - now using Utility-Library for integer operations (activated
  366.         SAS/C's UTILLIB option) : this increases 68000-codesize a little
  367.         bit, but increases speed on 68020+ systems
  368.         (should also decrease codesize, but does not ...)
  369.  
  370.  
  371.      V3.4 (25.03.1994) :
  372.      -------------------
  373.  
  374.       - this version includes all "last minute bug-fixes" to V3.3 and more
  375.       - included IMG.svobject (GEM). Read-Only yet.
  376.       - added write-support to FBM.svobject (Unix).
  377.       - made MANY changes to ALL SVDrivers and SVObjects
  378.  
  379.  
  380.      V3.3 (22.03.1994) :
  381.      -------------------
  382.  
  383.       - improved Example-Sources (SimpleView, ListSVOs, ListSVDs) :
  384.          - no longer dependent on "ak_gen0.library", removed dead code
  385.          - improved internal printf-replacement routine
  386.       - included FBM.svobject (Unix). Read-Only yet.
  387.       - fixed LibID : superview.library was actually not created in 2994,
  388.                       but in 1994 ;)
  389.  
  390.  
  391.      V3.2 (17.03.1994) :
  392.      -------------------
  393.  
  394.       - this version includes all "last minute bug-fixes" to V3.1 and more
  395.       - added EGS.svdriver to distribution (very first beginning for
  396.         support of the EGS graphic system, 8-Bit only yet)
  397.       - included C64.svobject (Koala, Doodle). Read-Only.
  398.         That's NOT a joke !
  399.  
  400.  
  401.      V3.1 (11.03.1994) :
  402.      -------------------
  403.  
  404.       - Beta-Versions : V2.7
  405.         (Parameter-BugFix in SVO_SetWriteSubType() :
  406.          pragmas put it into D1 instead of A2)
  407.       - integration of the SVDrivers
  408.       - fixed small bug im memory management routines
  409.       - several important fixes and improvements inside the
  410.         Version2-SVObjects
  411.       - bug-fix in superview.library :
  412.         a call to SVL_WindowIDCMP, SVL_WindowFlags or SVL_ScreenType
  413.         resulted in default-values, if an external SVObject was used
  414.         for this (forget to set these values inside SVL_SuperView again for
  415.         the SVObject)
  416.       - V39-DataType-Displaying now with correct Colors
  417.       - more and detailed information of V39-DataTypes
  418.       - all currently included SVObjects (except DataTypes) now allow
  419.         Reading (to Screen or Buffer) and Writing (from Screen) of
  420.         Graphics
  421.  
  422.  
  423.      V2.6 (13.02.1994) :
  424.      -------------------
  425.  
  426.       - small enhancements
  427.  
  428.  
  429.      V2.5 (24.01.1994) :
  430.      -------------------
  431.  
  432.       - included BMP.svobject (read-only)
  433.       - little improvements
  434.  
  435.  
  436.      V2.4 (22.01.1994) :
  437.      -------------------
  438.  
  439.       - recompilation : use of SAS/C V6.5
  440.       - again : fixed bad bug in SVL_FreeHandle(),
  441.                 external SVObjects would never be closed
  442.       - "externalized" IFF-ILBM and IFF-ACBM as ILBM.svobject and
  443.         ACBM.svobject
  444.  
  445.  
  446.      V2.3 (16.01.1994) :
  447.      -------------------
  448.  
  449.       - improved speed with writing IFF-ILBM and IFF-ACBM
  450.       - fixed bug inside SVL_FreeHandle() : SVO_FreeHandle() was
  451.         not called, but SVO_CloseDisplay() and SVO_FreeResources()
  452.       - fixed bug in Includes (was APTR * instead of APTR sometimes)
  453.  
  454.  
  455.      V2.2 :
  456.      ------
  457.  
  458.       - included GIF.svobject (upto GIF89a, read-only)
  459.       - improved speed with displaying IFF-ILBM and IFF-ACBM
  460.  
  461.  
  462.      V2.1 :
  463.      ------
  464.  
  465.       - Beta-Versions : V1.2, V1.3
  466.       - integration of the svobjects
  467.       - Library may be used by anybody for anything
  468.       - complete internal revision
  469.       - added DataType-Support (read-only)
  470.       - fixed bug in ScreenMode Validation Routine for IFF-ILBM/-ACBM
  471.       - new "Best ScreenMode"-Routine for IFF-ILBM/-ACBM und PCX.svobject
  472.         (different behaviour under OS V37+ and OS V39+)
  473.       - included PCX.svobject
  474.       - included SVO.svobject plus SourceCode
  475.  
  476.  
  477.      V1.1 :
  478.      ------
  479.  
  480.       - First Version. FREEWARE.
  481.  
  482.  
  483.     Copyrights :
  484.     ============
  485.  
  486.     Some of the mentioned names or products above may be copyrighted by
  487.     companies or trademarks of companies.
  488.  
  489.  
  490.