superview.library V6.3 - FREEWARE - © 1993-94 by Andreas R. Kleinert. All rights reserved. This program was written under OS V3.00 and is therefore fully compatible. It needs OS V2.04+. Release Date : 06.06.1994 Copyright : =========== The program superview.library V6.3 and its documentation files are (C)opyright 1993-94 by Andreas R. Kleinert. All rights reserved. The usage of the "superview.library" for own program projects, no matter if commercial or non-commercial, is allowed without any restrictions. 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. Functions : =========== The "superview.library" is used in many of my programs and it consists of many functions, which make displaying, saving and converting of various picture formats (IFF-ILBM, IFF-ACBM, PCX, ...) much easier. External Viewer-Libraries (svobjects) and Graphic Card Drivers (svdrivers) allow highest possible flexibility and easy to do expansions. Just send me your own SVObjects and SVDrivers if you want to have them added to the main distribution archive or onto the developer disk. Installation : ============== Just use the supplied Installer-Script, or "by hand"-copy "superview.library" to your "LIBS:"-Directory, the svobjects to "LIBS:svobjects/" and the svdrivers to "LIBS:svdrivers/" ! "datatypes.library" V39+ is only needed, if OS V3.00+ DataTypes are wished to be supported. Please take care, which libraries are also additionally needed by the single SVObjects. "AddBuffers"-Values for the used Drives should at least be around 25. You may set the following environment variables at the location "ENV:superview-library". SuperViewPrefs can be used for this. Name Content SVDriver.ascii Name of default-ScreenDriver. Read by superview- library at first opening. MUST NOT contain any extra characters (spaces, tabs, etc.). SVObjects : =========== Available SVObjects (as far as known) : SVObject Type Read-Support Write-Support IFF-ILBM EXT (system-dependent) (system-dependent) IFF-ACBM EXT (system-dependent) (system-dependent) OS V3.00+ DataTypes INT all Pictures - PCX upto V3.0 EXT upto 256 Colors upto 256 Colors + 24 Bit Files SVO upto V1.0 EXT (system-dependent) (system-dependent) GIF upto 89a EXT upto 256 Colors upto 256 Colors BMP (Windows) EXT upto 256 Colors upto 256 Colors FBM (Unix) EXT upto 256 Colors upto 256 Colors C64 (Koala, Doodle) EXT upto 16 Colors - IMG (GEM/Ventura) EXT upto 256 GreyScales - TIFF (V5.0) EXT upto 256 Colors upto 256 Colors + 24 Bit Files WPG (WordPerfect) EXT upto 256 Colors - MAC (MacPaint) EXT upto 2 Colors (b&w) - JPEG (JFIF) EXT 24 Bit as 256 Colors - + 24 Bit as 24 Bit JPEG.svobject is available in a separate archive. Planned SVObjects (no guarantee !) : - PC Paint/PIC - and more Available SVDrivers (as far as known) : SVDriver Requirements BITPLANE ONEPLANE ECS ECS / OS V2.04+ (V37) (system) 8 Bit AGA AGA / OS V3.00+ (V39) (system) 8 Bit EGS-System EGS-Graphic-Libraries 8 Bit 8 / 24 Bit Support : ========= The following programs are currently supporting the "superview.library" : - SuperView - SimpleView (superview.library Example Program) - MicroView (superview.library Example Program) - KFracPlus - DRAFU (unreleased Beta-Version) - ... Thanks and greetings to : ========================= in alphabetical order :) Alex Carbin (TuC / PowerBrei Red.) Fred Fish (AmigaLibDisks) Gerd Frank (BerndsPD) Stefan Grad (GPD) Stefan Kremer (TuC / PowerBrei Red.) Alex Lange (Time PD-Serie) H.P. Lattka (Franz PD-Serie) Andreas Manewaldt (Taifun PD-Serie) Axel Melzener (Game Object Design) Michael Petrikowski (Amiga Szene) Steve Quartly (Australia) Martin Schulze (SaarAG / AmiNet) and all I forgot ! Correspondence : ================ If you like, you may send me some money. Perhaps this will motivate me to continue programming such programs or just making updates of this one. Send bug-reports, money or whatever to : Andreas R. Kleinert, Grube Hohe Grethe 23, D-57074 Siegen, Germany. History : ========= Please note the version-dependencies : superview.library SVObjects SVDrivers SVOperators Version 1 - - - Version 2 Version 1 - - Version 3-6 Version 1,2 Version 1 - V6.3 (06.06.1994) : ------------------- - small bug-fixes - in all of the supplied SVObjects with write-support there are now also the flags for indicating GfxBuffer-Support set V6.2 (03.06.1994) : ------------------- - improved GIF.svobject in some ways - revised TIFF.svobject and fixed some bad bugs (also added some new features, which have not been largely tested yet) - fixed bad bug in ILBM.svobject (concerned saving of odd-width Pictures). There's perhaps the same bug in ACBM.svobject, but why making it incompatible with older versions ? There might be more of these "word-padding bugs" in other SVObjects, but not in all cases the specifications of the file formats are as clear about this as this is the case with IFF-ILBM ... - added FAQ-like documentation (NotesAndHints.guide) - removed example-program "ReadGfxBuffer", because since V6.1 this is also included in "SimpleView"'s source-code V6.1 (28.05.1994) : ------------------- - FIXED BAD BUG : SVL_SetGfxBuffer() plus SVL_SuperWrite() FAILED always, which was (again) caused by a very simple bug, not worth to mention - with all of the supplied SVObjects with write-support it is now possible to save not only Screens, but also GfxBuffers : all their internal write routines have been completely rewritten, so that supplied Screens are transferred to GfxBuffers before saving. BitPlane AND OnePlane Buffers upto 8 Bit are supported : they are converted to each other by using the appropriate functions of superviewsupport.library V3+. - this great enhancement - I was working on it since the introducion of superview.library V3+ - has been the reason, why the version number increased to 6 ! You may use this feature with the supplied version of SimpleView or with SuperView V2.5+ ! - added four new functions for simple allocation and delocation of simplified forms of SVObject and SVDriver lists. This will make accessing of superview-library's write-functions much more easier for custom applications. - added full (reference-like) documentation for SVObjects and SVDrivers as such - a JPEG.svobject is available since V5.2 (separately) - and more ... V5.2 (22.05.1994) : ------------------- - superviewsupport.library now contains four new functions to allow support of the new ControlPad-FileFormat for SVObject/SVDriver/... Configuration Files. (See Docs/SVSupport-Docs) These Files are almost similar to Tooltype-Lists. - removed one totally WRONG paragraph from Reference_ENG.doc, which concerned the SVL_InitHandleAsClip() function (the remark still referred to the unrealeased beta version 3.9, which was incompatible) - included Targa.svobject with 24 Bit-Support. Read only yet. - bug-fixed and enhanced 24 Bit-Support of PCX.svobject. - improved AGA.svdriver slightly (nearly a bug-fix) V5.1 (18.05.1994) : ------------------- - FIXED BAD BUG : SVL_ReadGfxBuffer() failed ALWAYS, which was caused by a very simple bug, not worth to mention (Murphys Law ?) - there was also a bug in checking the SVObjects's versions for using the GfxBuffer-Functions : we checked for V3+ instead of V2+ - fixed bug in ACBM.svobject - fixed some Doc-Files V4.1 (15.05.1994) : ------------------- - because of changing/extending specifications : Jumping to V4 - included MAC.svobject. Read-Only yet. - all NON-DISK loading and saving, e.g. from/into ClipBoard DID NOT WORK ANY LONGER since V2.4. Before ILBM.svobject and ACBM.svobject had been externalized, this feature worked, but only with these. After externalization (with this version) this bug was detected and fixed. Specifications had to be changed slightly - in a compatible way - to re-arrange READING to work again (see Reference_ENG.doc, SV_InitHandleAsClip-Function). For WRITING only superview-Library had to be changed. V3.8 (12.05.1994) : ------------------- - use of SAS/C V6.51 - created new "superviewsupport.library", which is used by superview.library and all supplied SVObjects and SVDrivers. This saves between 500 and 1600 Bytes for each svobject and also results in 1000 Bytes for superview.library. superviewsupport.library itself only needs about 3000 Bytes, so there's a great gain left. V3.7 (01.05.1994) : ------------------- - this version includes all "last minute bug-fixes" to V3.6 and more - improved some SVObjects a lot : PCX, TIFF, ... - improved some SVDrivers a lot : EGS - slightly improved SuperViewPrefs - changed Installer-Script to create "ENVARC:Default.svdriver", for people who forget to use SuperViewPrefs V3.6 (18.04.1994) : ------------------- - this version includes all "last minute bug-fixes" to V3.5 and more - included TIFF.svobject. Read-Only yet. (first version already included as bug-fix to V3.5) - included WPG.svobject. Read-Only yet. - improved some SVObjects a lot : IMG, TIFF, GIF, ... - improved some SVDrivers a lot : AGA, EGS - added 24 Bit-Support (ONEPLANE-RGB) to AGA- and EGS-SVDriver V3.5 (27.03.1994) : ------------------- - new Example-Program : MicroView ! - Datatypes-Support now just for PICTURES : everything else will be rejected - updated Include-Files to reflect V3.5, made some changes - all supplied SVObjects do no longer have a default SVDriver integrated : this saves about 1600 Bytes diskspace, which we need for future expansions - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one. This saves again about 1800 Bytes. - now using Utility-Library for integer operations (activated SAS/C's UTILLIB option) : this increases 68000-codesize a little bit, but increases speed on 68020+ systems (should also decrease codesize, but does not ...) V3.4 (25.03.1994) : ------------------- - this version includes all "last minute bug-fixes" to V3.3 and more - included IMG.svobject (GEM). Read-Only yet. - added write-support to FBM.svobject (Unix). - made MANY changes to ALL SVDrivers and SVObjects V3.3 (22.03.1994) : ------------------- - improved Example-Sources (SimpleView, ListSVOs, ListSVDs) : - no longer dependent on "ak_gen0.library", removed dead code - improved internal printf-replacement routine - included FBM.svobject (Unix). Read-Only yet. - fixed LibID : superview.library was actually not created in 2994, but in 1994 ;) V3.2 (17.03.1994) : ------------------- - this version includes all "last minute bug-fixes" to V3.1 and more - added EGS.svdriver to distribution (very first beginning for support of the EGS graphic system, 8-Bit only yet) - included C64.svobject (Koala, Doodle). Read-Only. That's NOT a joke ! V3.1 (11.03.1994) : ------------------- - Beta-Versions : V2.7 (Parameter-BugFix in SVO_SetWriteSubType() : pragmas put it into D1 instead of A2) - integration of the SVDrivers - fixed small bug im memory management routines - several important fixes and improvements inside the Version2-SVObjects - bug-fix in superview.library : a call to SVL_WindowIDCMP, SVL_WindowFlags or SVL_ScreenType resulted in default-values, if an external SVObject was used for this (forget to set these values inside SVL_SuperView again for the SVObject) - V39-DataType-Displaying now with correct Colors - more and detailed information of V39-DataTypes - all currently included SVObjects (except DataTypes) now allow Reading (to Screen or Buffer) and Writing (from Screen) of Graphics V2.6 (13.02.1994) : ------------------- - small enhancements V2.5 (24.01.1994) : ------------------- - included BMP.svobject (read-only) - little improvements V2.4 (22.01.1994) : ------------------- - recompilation : use of SAS/C V6.5 - again : fixed bad bug in SVL_FreeHandle(), external SVObjects would never be closed - "externalized" IFF-ILBM and IFF-ACBM as ILBM.svobject and ACBM.svobject V2.3 (16.01.1994) : ------------------- - improved speed with writing IFF-ILBM and IFF-ACBM - fixed bug inside SVL_FreeHandle() : SVO_FreeHandle() was not called, but SVO_CloseDisplay() and SVO_FreeResources() - fixed bug in Includes (was APTR * instead of APTR sometimes) V2.2 : ------ - included GIF.svobject (upto GIF89a, read-only) - improved speed with displaying IFF-ILBM and IFF-ACBM V2.1 : ------ - Beta-Versions : V1.2, V1.3 - integration of the svobjects - Library may be used by anybody for anything - complete internal revision - added DataType-Support (read-only) - fixed bug in ScreenMode Validation Routine for IFF-ILBM/-ACBM - new "Best ScreenMode"-Routine for IFF-ILBM/-ACBM und PCX.svobject (different behaviour under OS V37+ and OS V39+) - included PCX.svobject - included SVO.svobject plus SourceCode V1.1 : ------ - First Version. FREEWARE. Copyrights : ============ Some of the mentioned names or products above may be copyrighted by companies or trademarks of companies.