home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / FALKMAG / FKMBERCY.ZIP / FKMBERCY / TOOLS / 1STGUIDE.GER < prev    next >
Text File  |  1996-04-20  |  25KB  |  569 lines
  1. 1STGUIDE-Hinweise                               Halle, den 20.04.1996
  2.  
  3.     Copyright (C) 1990-1996 Guido Vollbeding <guivol@esc.de>
  4.  
  5.  
  6.     Neuerungen:
  7.     -----------
  8.  
  9. - Schnellere und kürzere PNG-Routinen (genauer: zlib-"inflate"-
  10.   Optimierungen): insgesamt etwa 10 bis 20 % schnelleres Laden
  11.   (und über 2 KByte Code gespart :-).
  12.  
  13. - JPEG (alle Varianten): Besseres Verhalten bei 'corrupted' oder
  14.   'truncated' Files (sollte jetzt insbesondere unter keinen
  15.   Umständen mehr zu Abstürzen führen, nehme ich jedenfalls an :-).
  16.  
  17. 10.01.1996:
  18.  
  19. - Multiscan/Progressive JPEG Support eingebaut.
  20.   Dank wie immer an den unermüdlichen Tom Lane und IJG JPEG V6(a).
  21.   Leider noch nicht per DSP mit JPEGD verfügbar (kommt Zeit, ...).
  22.  
  23. - TIMG Support eingebaut (TrueColor/Grau/Alpha IMG Erweiterung).
  24.   Siehe erweitertes XIMGTOOL für Sourcen, Tool und
  25.   Konvertierungsmodule.
  26.   Herzlichen Dank an Jens Brüggemann für die Anpassung des
  27.   SNAPPER, womit nun in wirklich jeder Grafikauflösung IMG-Snaps
  28.   gemacht werden können. Und Dank an Udo Steinbach für die
  29.   Ersterstellung des SNAPPER sowie an Ulrich Kaiser für die
  30.   Tests auf seiner Grafikkarte.
  31.  
  32. 29.08.1995:
  33.  
  34. - PNG (Portable Network Graphics) eingebaut (puh...).
  35.   Dank an Guy Eric Schalnat für die "libpng reference library",
  36.   Jean-loup Gailly und Mark Adler für die "zlib general purpose
  37.   compression library" sowie Thomas Boutell, Mark Adler und Lee
  38.   Daniel Crocker für die Spezifikation (siehe unten).
  39.  
  40. - IMG-Level-3-Decoder (erlaubt höhere Packraten) eingebaut.
  41.   Siehe XIMGTOOL-Paket für Konvertierungen und Sourcecodes.
  42.  
  43. - MPEG-System-Layer-Support integriert (Video+Audio kombiniert,
  44.   Audio wird dabei z.Zt. übersprungen). MPEG-Audio-Unterstützung
  45.   ist in Vorbereitung. DSP-MPEG-Treiber ist in Arbeit.
  46.  
  47. - Bei Benutzung des (DSP-)JPEG-Treibers wird nun endlich kein
  48.   temporärer Speicher für das komplette TC-Bild mehr benötigt,
  49.   so daβ auch das Laden gröβerer Bilder bei weniger Speicher
  50.   gelingt, solange das Bild in der aktuellen Auflösung in den
  51.   Speicher paβt. Die Geschwindigkeit ist dabei unverändert.
  52.   Die Geschwindigkeit des internen JPEG-Loadings konnte um
  53.   etwa 10 % gesteigert werden.
  54.  
  55. 27.07.1994:
  56.  
  57. - Die Registriergebühr beträgt nun definitiv 50,- DM.
  58.   Bereits mit geringerem Betrag registrierte Anwender können
  59.   selbstverständlich zum Differenzbetrag updaten.
  60.   Ein besonders herzlicher Dank geht an dieser Stelle an jene
  61.   Anwender, die bereits mit 50,- DM zum Gelingen der vorliegenden
  62.   Version mit der neuen MPEG-Unterstützung beigetragen haben.
  63.  
  64. - Leider sah ich mich noch nicht in der Lage, die Dokumentation zu
  65.   überarbeiten, daher erfolgen an dieser Stelle die nötigen Hinweise.
  66.  
  67. - MPEG-Einbindung:
  68.   Zunächst geht mein herzlicher Dank an Ralf Dunkel für die Beschaf-
  69.   fung des umfangreichen Materials (Sourcen sowie jede Menge Test-
  70.   files). Weiterhin gebührt der Berkeley Plateau Research Group
  71.   (siehe unten) Dank für ihre MPEG-Decoder-Sourcen (Versionen 1.x
  72.   bis 2.0), die zwar alles andere als portabel waren und fast
  73.   komplett umgestrickt werden muβten, aber nichtsdestotrotz
  74.   eine unverzichtbare Grundlage meiner Arbeit bildeten.
  75.  
  76.   Es wird soweit wie möglich der vollständige MPEG-1-Video-Standard
  77.   unterstützt, inclusive P- und B-Frames mit (forward/backward/bidi-
  78.   rectional) Motion Compensation bei Ausschöpfung der vollen syntak-
  79.   tischen Möglichkeiten und nicht notwendigerweise Beschränkung auf
  80.   Constrained Parameter Bitstreams, was z.B. bei den meisten Hard-
  81.   warelösungen noch der Fall ist.
  82.  
  83.   Es können theoretisch beliebig viele MPG-Movies gleichzeitig
  84.   abgespielt werden (praktisch nur durch System begrenzt: offene
  85.   Fenster / offene Files). Filegröβe und Framezahl spielen keine
  86.   Rolle, da jeweils ein Puffer (80 KByte) zum Nachladen der Daten
  87.   benutzt wird.
  88.  
  89.   Die optionale Graustufendarstellung läβt die Movies aufgrund der
  90.   entfallenden aufwendigen Farbauswertung deutlich schneller laufen.
  91.   Allerdings fehlt dann halt die Farbinformation.
  92.  
  93.   Falls ein Movie vollständig unsichtbar ist, weil es etwa
  94.     a) durch andere Fenster vollständig verdeckt ist oder
  95.     b) auβerhalb der Bildschirmfläche (z.B. ganz nach unten)
  96.        geschoben wird oder
  97.     c) durch das WindowShade-Feature von WINX >= 2.3 'eingeklappt'
  98.        ist,
  99.   so wird es automatisch angehalten. Im Unterschied zur "Pause"-
  100.   Option (siehe Popup) wird es dabei aber nicht aus der Timerliste
  101.   ausgehängt und wird automatisch fortgesetzt, sobald es wieder auch
  102.   nur teilweise sichtbar wird.
  103.   Durch das Anhalten mittels "Pause" wird das System in keiner Weise
  104.   mehr zusätzlich belastet, und das Verhalten entspricht etwa einem
  105.   normalen Bildfenster, mit dem 'kleinen' Unterschied, daβ der Zoom
  106.   'etwas' anders wirkt (von HC/TC-Modi abgesehen - ausprobieren!).
  107.   Hierbei gibt es noch ein neues allgemeines Feature: Hält man beim
  108.   Fullen eine Shift-Taste gedrückt (also Shift-Control-F oder Shift-
  109.   Klick auf Fuller), so wird das Fenster nicht auf den Bildschirm
  110.   ge'fulled', sondern auf die aktuelle Dokumentgröβe, was halt
  111.   besonders nach einer Zoom-Operation sinnvoll ist. Diese Option
  112.   gilt aber auch für alle anderen 1stGuide-Fenster!
  113.  
  114.   Wundern Sie sich bitte nicht, daβ der "Restart" erst ab dem über-
  115.   nächsten Frame (Step) zur Wirkung kommt. Das hängt mit der wegen
  116.   der Backward Prediction notwendigen und nicht ganz trivialen
  117.   Display-Logik zusammen.
  118.   In diesem Zusammenhang sind mir leider auch schon MPG-Files vorge-
  119.   kommen, die diesbezüglich nicht korrekt kodiert waren. Hierbei
  120.   kann es dann teilweise zu Bildverwürfelungen kommen. Hält man beim
  121.   Laden die RECHTE SHIFT-TASTE gedrückt, so werden P- und B-Frames
  122.   übersprungen, so daβ nur die I-Frames angezeigt werden, bei denen
  123.   zumindest keine Prediction-Probleme auftreten können. Allerdings
  124.   enthalten die meisten der gegenwärtig in Umlauf befindlichen
  125.   MPG-Files ohnehin nur I-Frames (von manchen auch als "Motion-JPEG"
  126.   bezeichnet) wegen des deutlich geringeren Kodieraufwandes.
  127.  
  128.   Bei genügend Resonanz sähe ich mich in der Lage, auch einen MPEG-
  129.   Encoder zu programmieren, da mir entsprechendes Material (MPEG-2-
  130.   Encoder- und Decoder-Sourcen) zur Verfügung steht. Allerdings muβ
  131.   ich nach den bisherigen Erfahrungen befürchten, ein solches auf-
  132.   wendiges Projekt wegen mangelnder Resonanz nicht in Angriff nehmen
  133.   zu können. Man bedenke aber, daβ MPEG-2 als DER Standard für
  134.   zukünftiges Digital-TV gilt und man daher früher oder später
  135.   damit sicherlich auf breiter Front konfrontiert werden wird.
  136.  
  137. 16.03.1994:
  138.  
  139. - Umstellungen bei den Image-Optionen:
  140.   Der Punkt "0 Ditherfarben" (war schon ziemlich seltsam, hatte aber
  141.   entwicklungstechnische Ursachen) ist jetzt in die Ditheroption
  142.   "Niemals" gewandert. Bei "Bedarf" werden Bilder nur dann gedithert,
  143.   wenn sie mehr Farben enthalten als die aktuelle Auflösung hergibt.
  144.   Anderenfalls muβ die Farbpalette von Hand (Popup/Shortcut)
  145.   eingestellt werden.
  146.   Stellt man den Schalter auf "Immer", so werden Bilder mit ent-
  147.   haltener Farbpalette immer gedithert, also auch dann, wenn die
  148.   Auflösung eigentlich zur korrekten Darstellung ausreichen würde
  149.   (Ausnahme: High-/True-Color-Modi).
  150.     Vorteile:
  151.       o Es braucht keine Palette mehr umgeschaltet zu werden;
  152.       o Mehrere Bilder werden gleichzeitig farbtreu dargestellt.
  153.     Nachteile:
  154.       o Nicht optimale Darstellung (da Umrasterung auf fixe Palette);
  155.       o Höherer Rechenaufwand -> Längere Wartezeit beim Laden.
  156.   Einfach mal ausprobieren! Wer in High-/True-Color-Modi arbeitet,
  157.   braucht sich um diese Einstellung keine Gedanken zu machen, da
  158.   hier die Farbpalette immer optimal ins Raster umgesetzt wird!
  159.   Auβerdem ist diese Option grundsätzlich nur für XIMG/IFF-Bilder
  160.   von Bedeutung, nicht für JPG/PNG/TIMG.
  161.  
  162.   Durch Aufspaltung der bisherigen Ditherfarben-Einstellung in
  163.   "Farbmodell" und "Farbstufen" sind nun in Auflösungen mit
  164.   mindestens 256 Farben auch echte Graustufendarstellungen bei
  165.   Farbbildern möglich. Besonders bei JPG-TrueColor-Bildern kann
  166.   dabei u. U. deutlich Rechenzeit gespart werden.
  167.  
  168.   Übrigens: In HighColor-Modi (32K, 64K Farben) hat die Floyd-
  169.   Steinberg-Einstellung eine Bedeutung, wenn JPG-TrueColor-Bilder
  170.   geladen werden. In diesem Falle wird ein speziell zugeschnittener
  171.   FS-Algorithmus verwendet, um die aus der geringeren Farbauflösung
  172.   resultierenden "Artefakte" zu vermeiden, die sich z.B. bei Motiven
  173.   mit sanften Farbübergängen als störende "Farbtreppen" bemerkbar
  174.   machen. Zum Vergleich schalte man den FS mal ab, dann wird
  175.   einfach gerundet, was natürlich schneller ist.
  176.  
  177. 15.12.1993:
  178.  
  179. - Erweiterte Help-Message: Es ist nun möglich, eine spezielle Index-
  180.   datei zusätzlich zum zu suchenden Schlüsselwort mit anzugeben, auf
  181.   die sich die Suche dann bezieht. Diese kann von Programmierern ge-
  182.   nutzt werden, um programmspezifische Hilfesysteme anzusprechen,
  183.   ohne daβ der Anwender diese in 1stGuide vorgeben oder mehrere
  184.   Indexdateien "concatenieren" muβ.
  185.  
  186.     #include <aes.h>
  187.     ...
  188.     #define AC_HELP          1025
  189.     #define HELP_FILE_MAGIC  0x1993
  190.  
  191.     int  my_apid;            /* my own id from appl_init */
  192.     char helpname[] = "1STGUIDE";
  193.  
  194.     int send_help( char *keyword, char *indexfile )
  195.     {
  196.       static int msg_buff[8];
  197.       int help_id;
  198.  
  199.       if ((help_id = appl_find( helpname )) >= 0)
  200.       {
  201.         msg_buff[0] = AC_HELP;
  202.         msg_buff[1] = my_apid;
  203.         msg_buff[2] = 0;
  204.         *(char **)(msg_buff + 3) = keyword;
  205.         msg_buff[5] = HELP_FILE_MAGIC;
  206.         *(char **)(msg_buff + 6) = indexfile;
  207.         appl_write( help_id, 16, msg_buff );
  208.       }
  209.       return help_id;
  210.     }
  211.  
  212.   Diese Lösung benutzt die noch freien Stellen im Message-Buffer, um
  213.   die Indexdatei zu referenzieren. Das HELP_FILE_MAGIC dient zur Ge-
  214.   währleistung der Verträglichkeit mit der alten Message. Der Index-
  215.   file-Zeiger wird von 1stGuide nur benutzt, wenn das Magic stimmt,
  216.   der Indexfile-Zeiger kein Null-Pointer ist und wenn er nicht auf
  217.   eine leere Zeichenkette zeigt. Auszug aus meinem Source dazu:
  218.  
  219.     void hndl_message( int *pipe )
  220.     {
  221.       switch (pipe[0])
  222.       {
  223.     ...
  224.     case AC_HELP:
  225.       find_index( *(char **)(pipe + 3),    /* keyword */
  226.               pipe[5] == 0x1993 &&     /* Magic */
  227.               *(char **)(pipe + 6) &&  /* Non-Null-Pointer */
  228.               **(char **)(pipe + 6)    /* 1st char != 0 */
  229.               ? *(char **)(pipe + 6)   /* OK, take it! */
  230.               : par.indexfile );       /* Default-Index */
  231.       break;
  232.     ...
  233.     } }
  234.  
  235.   Diese Lösung ist auch "abwärtskompatibel", d.h. man kann in jedem
  236.   Falle die eigene Indexdatei mit angeben, ältere 1stGuide-Versionen
  237.   ignorieren sie dann halt. Es genügt also ein Hinweis zur Installa-
  238.   tion, daβ man bei älteren 1stGuide-Versionen selber die Indexdatei
  239.   einstellen bzw. "mergen" muβ, während das bei neueren Versionen
  240.   (ab 3.Nov.1993) eben entfällt.
  241.  
  242.   Alle Programmierer, die in ihren Programmen schon von AC_HELP Ge-
  243.   brauch machen, sollten zur absoluten Sicherheit dafür Sorge tragen,
  244.   daβ die unbenutzten Message-Elemente mit Null belegt sind, wenn sie
  245.   von der Erweiterung  zunächst keinen Gebrauch machen wollen. Es
  246.   würde schon genügen, das Magic auf 0 zusetzen (also etwa Zeile
  247.   "msg_buff[5] = 0;" einfügen, falls nicht ohnehin ein eigener stati-
  248.   scher Messagebuffer wie im obigen Beispiel verwendet wird, wo das
  249.   automatisch gewährleistet wäre), oder man könnte  beispielsweise
  250.   obige Funktion send_help mit einem Null-Pointer als Indexfile auf-
  251.   rufen, falls die voreingestellte Indexdatei benutzt werden soll.
  252.  
  253.  
  254.     Lieferumfang:
  255.     -------------
  256.  
  257. Das 1stGuide-Komplettpaket umfaβt folgende Archive:
  258.  
  259.     - 1STGUIDE.ZIP, enthält die Programmdatei 1STGUIDE.ACC
  260.             sowie die vorliegende Textdatei 1STGUIDE.GER
  261.             auf deutsch und 1STGUIDE.ENG auf englisch;
  262.  
  263.     - GUIDHELP.ZIP, enthält eine umfassende Programmbeschreibung
  264.             sowie TOS/GEM-Betriebssystem-Dokumentation
  265.             in Hypertextform;
  266.  
  267.     - GUIDTOOL.ZIP, enthält Hilfsprogramme zu 1stGuide, eine
  268.             in TeX verfaβte Anleitung als DVI-Datei
  269.             sowie 1stView einschlieβlich Quellen;
  270.  
  271.     - GUIDDOSE.ZIP, enthält Programmversionen für's PC-GEM.
  272.  
  273. Weiterhin gibt es folgende Zusatzpakete:
  274.  
  275.     - JPEG_DSP: enthält DSP-JPEG-Decode-Treiber für den Falcon;
  276.  
  277.     - JPEG_GVS: enthält JPEG-Speichermodul für GEM-View 3.x;
  278.  
  279.     - MPEGDSP.TTP: DSP-MPEG-Player-Demoprogramm für den Falcon;
  280.  
  281.     - MPEG_SYS: enthält Tool für MPEG-1-System-Layer-Streams;
  282.  
  283.     - XIMGTOOL: Sourcen/Tool/Module für (X/T)IMG-Level-1/2/3.
  284.  
  285. Zur  Weitergabe  ist  MINDESTENS  das  Archiv  1STGUIDE.ZIP oder sein
  286. Inhalt (1STGUIDE.ACC, 1STGUIDE.GER, 1STGUIDE.ENG) notwendig, der Rest
  287. ist OPTIONAL!
  288. Das  Komplettpaket  ist  automatisch  nach  erfolgter   Registrierung
  289. erhältlich. Falls Sie NICHT HD-Disketten lesen können, geben Sie dies
  290. bitte  bei der Registrierung an.  Unter diesem Umstand müssen  einige
  291. Zusätze entfallen. Standardmäβig verschicke ich HD-Disketten!
  292.  
  293.  
  294.     Registrierung:
  295.     --------------
  296.  
  297. Bei 1stGuide handelt es sich um SHAREWARE!! Das heiβt, daβ nach einer
  298. dem  Benutzer  nach  eigenem  Ermessen  zugestandenen  Testphase eine
  299. Registrierung  mit  Zahlung  einer  Gebühr  an den Autor fällig wird,
  300. falls  man  das  Programm  regelmäβig  benutzen  möchte  und an einer
  301. Weiterentwicklung interessiert ist.
  302.  
  303. Die Shareware-Gebühr für 1stGuide beträgt 50,- DM.  Dieser Betrag ist
  304. an  folgende Adresse zu senden (Bar/Scheck) oder auf  das  angegebene
  305. Konto zu überweisen:
  306.  
  307.     Guido Vollbeding
  308.     Turmstraβe 61
  309.     D-06110 Halle (Saale)
  310.     Deutschland
  311.  
  312.     Bankverbindung: Stadt- u.
  313.     Saalkreissparkasse Halle
  314.     Blz.: 800 537 62
  315.     Kto.: 486 260 725
  316.  
  317. Dadurch  erhält  man automatisch das aktuelle Komplettpaket auf einer
  318. "Originaldiskette"  zugesandt  und  kann  in  Zukunft jederzeit durch
  319. Einsendung  eines Schreibens mit einer Diskette und einem frankierten
  320. Rückumschlag die aktuelle Version anfordern.
  321.  
  322. Wer 1stGuide benutzt, ohne zu zahlen, verletzt geltendes Recht und
  323. verstöβt gegen die Regeln anständigen Verhaltens!
  324.  
  325. Noch ein  Hinweis:  Geben  Sie  bitte  bei  Überweisungen  immer Ihre
  326. vollständige  Adresse  mit an, sonst kann ich keinen Kontakt zu Ihnen
  327. auf- bzw. keine Zuordnung vornehmen!
  328.  
  329.  
  330.     Ultra-Kurzbeschreibung:
  331.     -----------------------
  332.  
  333. Mit 1stGuide kann man sich folgende Standard-Dateiformate in GEM-Fen-
  334. stern auf allen Atari-Rechnern,  unter allen  Betriebssystemversionen
  335. und in allen Auflösungen und Farbtiefen  (von 1 Bit Monochrom bis  32
  336. Bit TrueColor) anschauen (bzw. -hören):
  337.  
  338.     .IMG    GEM-(X/T)-Image Rastergrafiken, Level-1/2/3
  339.         (1 Bit Monochrom bis 12 Bit RGB XIMG Colormap,
  340.         RGB-TrueColor/Grau/Alpha TIMG direct pixel)
  341.     .IFF    Interchange File Format: ILBM - Interleaved Bitmaps
  342.         (1 Bit Monochrom bis 12 Bit RGB Colormap)
  343.     .GEM    GEM-Vektorgrafiken
  344.         (mit Bezierkurven bei fähigem VDI, z.B. NVDI >= 2.12)
  345.     .RSC    GEM-Resource-Dateien
  346.         (einfache bis 64 K und erweiterte > 64 K)
  347.     .PNG    Portable Network Graphics, alle 'Spielarten'
  348.         entsprechend aktueller Spezifikation
  349.     .JPG
  350.     .JPE
  351.     .JPEG   Joint Photographic Experts Group - Rastergrafiken:
  352.         JPEG/JFIF-Standard (24 Bit TrueColor, 8 Bit Grau),
  353.         Baseline/Multiscan/Progressive Support
  354.     .MPG
  355.     .MPE
  356.     .MPEG   Moving Picture Experts Group - Videosequenzen:
  357.         MPEG-1-Video-Standard (24 Bit TrueColor),
  358.         MPEG-1-System (Video+Audio interleaved)
  359.     .SAM
  360.     .SND
  361.     .AVR    Sound-Sample-Dateien
  362.         (zur Zeit nur 8 Bit Mono)
  363.     .DOC
  364.     .OUT
  365.     *       Textdateien (einschlieβlich Schriftattribute)
  366.  
  367. Weiterhin  können  hypertextartige Verzweigungen zwischen Dateien auf
  368. einfache  Weise definiert werden, womit man umfangreiche Hilfesysteme
  369. anlegen  kann, durch die man interaktiv mit 1stGuide navigieren kann.
  370. Alles weitere entnehme man der umfassenden Programmbeschreibung.
  371.  
  372.  
  373.     Installation für Atari ST(E)/TT/Falcon etc.:
  374.     --------------------------------------------
  375.  
  376. 1. Kopieren Sie die Datei 1STGUIDE.ACC in Ihr Boot-Verzeichnis.
  377.    Falls Sie über 1stGuide drucken möchten, muβ GDOS installiert
  378.    sein.
  379.  
  380. Die folgenden Punkte gelten nur für das Komplettpaket:
  381.  
  382. 2. Wenn Sie eine Festplatte bzw. bei groβem Arbeitsspeicher eine
  383.    genügend groβe RAM-Disk besitzen, legen Sie dort einen neuen
  384.    Ordner an (z.B. "1STGUIDE"), und kopieren Sie den gesamten
  385.    Disketteninhalt dort hinein (falls nicht schon beim Auspacken
  386.    geschehen).
  387.  
  388. 3. Starten Sie Ihren Computer neu, klicken im Desk-Menü des Desktops
  389.    den Punkt "1st Guide" an und wählen in der darauf erscheinenden
  390.    Datei-Auswahlbox die Datei "1STGUIDE.HLP" im entsprechenden
  391.    Datenträger/Ordner aus. Dort erhalten Sie weitere Benutzungs-
  392.    Informationen.
  393.  
  394. Zusätzlich  kann  man in die DESKTOP.INF bzw. NEWDESK.INF Datei  etwa
  395. folgende Zeile VOR allen anderen Anwendungen einfügen:
  396.  
  397. #G 03 04 C:\1STGUIDE.ACC@ *.*@
  398. bzw.
  399. #G 03 04 000 C:\1STGUIDE.ACC@ *.*@ @
  400.  
  401. Man  erhält  dann  nie mehr die Meldung "Anzeigen/Drucken/Abbrechen".
  402. Fügt man danach noch die Zeile
  403.  
  404. #G 03 FF *.AC*@ @
  405. bzw.
  406. #G 03 FF 000 *.AC*@ @ @
  407.  
  408. ein,  so  kann  man 1STGUIDE (und bestimmte andere, auch inaktivierte
  409. Accessories)  direkt  als  Programm  starten.  Alternativ  dazu  kann
  410. 1STGUIDE  auch  in  .PRG,  .APP oder .GTP umbenannt werden, um es als
  411. Programm zu benutzen.
  412.  
  413. Anstelle  von  1STGUIDE  kann  auch  das  kleine  Programm   CALLGUID
  414. installiert  werden  (siehe TOOLS-Ordner),  um im 'normalen'  Desktop
  415. die  Anzeigefunktion  zu  ersetzen.  Herzlichen Dank an Dirk Haun für
  416. dieses Utility.
  417.  
  418. Auβerdem   finden   Sie   im   Ordner  \TOOLS\1STVIEW  das  Accessory
  419. 1STVIEW.ACC,  aus  welchem  1stGuide  ursprünglich entstanden ist und
  420. das  eine  Untermenge  der  Funktionalität  von  1stGuide bietet. Für
  421. interessierte  Programmierer  habe  ich dazu den kompletten Quelltext
  422. beigelegt (im Ordner \TOOLS\QUELLEN).
  423. 1stView  war  ursprünglich dazu gedacht, die Verbreitung von 1stGuide
  424. zu fördern.  Dieses Konzept hat sich  aber  insofern  nicht  bewährt,
  425. als es viele Leute von einer Registrierung abgehalten hat.
  426. Die  Konsequenz  ist  nun  die,  daβ  1stView  sowie  die zugehörigen
  427. Sourcen  vorläufig  "eingefroren"  sind,  d.h. nicht gepflegt werden.
  428. Ansonsten  bleibt  alles beim Alten, d.h. 1stView ist als Freeware zu
  429. betrachten,   und   der   Inhalt   des  Ordners  \TOOLS\1STVIEW  darf
  430. unabhängig von 1stGuide weitergegeben  werden.  Der geneigte 1stView-
  431. Anwender   darf   sich   nun   nur  nicht   wundern,   wenn  aktuelle
  432. Entwicklungen  (z.B.  Betriebssystemerweiterungen  wie  WINX oder die
  433. neuen Dateiformate) nicht entsprechend unterstützt werden.
  434.  
  435. Wer  auf  eine  ansprechende  gedruckte  Anleitung  Wert legt, findet
  436. auβerdem   die   Datei   1STGUIDE.DVI,   die   mit  einem  TeX-System
  437. ausgedruckt werden kann.
  438.  
  439. Sie  können  1stGuide  und  1stView  auch unter MSDOS-GEM nutzen.  Im
  440. Ordner \MSDOS finden Sie die entsprechenden Programme, welche aus der
  441. Übersetzung der Quellen mit der MSDOS-Version von Turbo-C  entstanden
  442. sind  (unter  Nutzung  der  hier dokumentierten GEM-Einbindung).  Die
  443. Installation ist ähnlich der ST-Version.  Das jeweilige Accessory ist
  444. in den Ordner  \GEMBOOT  (GEM 2.x)  bzw.  \GEMAPPS\GEMBOOT  (GEM 3.x)
  445. zu  kopieren  und  man  kann die DESKTOP.INF-Datei etwa  um  folgende
  446. BEIDEN Zeilen erweitern (VOR allen anderen Applikationen):
  447.  
  448. #G0828 E:\PROGRAMM\1STGUIDE\1STGUIDE.APP@ *.*@
  449. #G0828 *.APP@ @
  450.  
  451. Achtung!  Im  Gegensatz  zur  ST-Version  kann  das  Accessory  nicht
  452. einfach  umbenannt werden, um es als Programm zu starten. Man muβ die
  453. jeweilige Programmversion benutzen.
  454.  
  455.  
  456.     Erklärung:
  457.     ----------
  458.  
  459. 1stGuide ist ein Shareware-Programmpaket von:
  460.  
  461.     Guido Vollbeding
  462.     Turmstraβe 61
  463.     D-06110 Halle (Saale)
  464.     Deutschland
  465.  
  466.     Bankverbindung: Stadt- u.
  467.     Saalkreissparkasse Halle
  468.     Blz.: 800 537 62
  469.     Kto.: 486 260 725
  470.  
  471. Für  irgendwelche  Schäden,  einschlieβlich aber nicht beschränkt auf
  472. materielle  oder  finanzielle,  die  direkt  oder  indirekt durch die
  473. Benutzung  oder Nichtbenutzung der Programme und/oder Dokumentationen
  474. oder  Teilen  davon oder durch die Untauglichkeit derselben für einen
  475. bestimmten  Zweck  entstehen,  kann  ich, Guido Vollbeding, keinerlei
  476. Haftung übernehmen.
  477.  
  478. Eventuelle  Ähnlichkeiten der vorliegenden Software mit existierenden
  479. oder  geplanten  Produkten namhafter oder unbekannter Hersteller sind
  480. nicht beabsichtigt, sondern wären rein zufällig.
  481.  
  482. -!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-
  483. This  software is based in part on the work of the  Independent  JPEG
  484. Group, Copyright (C) 1991-1996, Thomas G. Lane.  All Rights Reserved.
  485. The authors accept NO LIABILITY for damages of any kind.
  486. -!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-!-
  487.  
  488. ~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~
  489. This  software supports the DSP-JPEG-Decoder from Brainstorm, France,
  490. for  Atari  Falcon  computers,  which  is  copyright (C) 1992-1993 by
  491. Brainstorm & Atari Corporation.
  492. ~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~!~
  493.  
  494. -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-
  495. The MPEG part of this software is based in part on the work of
  496.  
  497.             Lawrence A. Rowe, Ketan Patel, and Brian Smith
  498.      Computer Science Division-EECS, Univ. of Calif. at Berkeley
  499.  
  500. Copyright (C) 1995 The Regents of the University of California.
  501. All rights reserved.
  502.  
  503. IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY
  504. FOR DIRECT,  INDIRECT, SPECIAL, INCIDENTAL,  OR CONSEQUENTIAL DAMAGES
  505. ARISING  OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION,  EVEN
  506. IF  THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE  POSSIBILITY
  507. OF SUCH DAMAGE.
  508.  
  509. THE  UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY  WARRANTIES,
  510. INCLUDING,   BUT   NOT   LIMITED  TO,   THE  IMPLIED  WARRANTIES   OF
  511. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.   THE  SOFTWARE
  512. PROVIDED  HEREUNDER  IS ON AN "AS IS" BASIS,  AND THE  UNIVERSITY  OF
  513. CALIFORNIA  HAS  NO  OBLIGATION  TO  PROVIDE  MAINTENANCE,   SUPPORT,
  514. UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  515. -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-
  516.  
  517. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
  518. The PNG part of this software is based in part on the work of
  519.  
  520.   Guy Eric Schalnat, Group 42, Inc., Copyright (c) 1995-1996
  521.   Contributing Authors:
  522.     Guy Eric Schalnat
  523.  
  524.   The PNG Reference Library is supplied "AS IS". The Contributing
  525.   Authors and Group 42, Inc. disclaim all warranties, expressed or
  526.   implied, including, without limitation, the warranties of
  527.   merchantability and of fitness for any purpose. The Contributing
  528.   Authors and Group 42, Inc. assume no liability for damages,
  529.   direct or consequential, which may result from the use of
  530.   the PNG Reference Library.
  531.  
  532. and the 'zlib' general purpose compression library:
  533.  
  534.   Copyright (C) 1995-1996 Jean-loup Gailly and Mark Adler
  535.  
  536.   This software is provided 'as-is', without any express or implied
  537.   warranty.  In no event will the authors be held liable for any
  538.   damages arising from the use of this software.
  539.  
  540. PNG Spec. 1995 by Thomas Boutell, Mark Adler, and Lee Daniel Crocker.
  541. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
  542.  
  543. Alle  Rechte  an  den  vorliegenden Programmen liegen beim Autor. Das
  544. Programmpaket  darf  ausschlieβlich  FREI  weitergegeben werden, eine
  545. kommerzielle  Verbreitung  in  jeder  Form  (PD-Sammeldisketten o.ä.)
  546. sowie  die  Beilage  zu kommerziellen, Shareware- oder Public-Domain-
  547. Programmen   ist   nur   mit   meiner   ausdrücklichen  schriftlichen
  548. Genehmigung  gestattet.  Zur  Weitergabe  von mir autorisiert ist der
  549. PD-Service  des  Atari-Journals  (schlieβlich  hat  sich dieses Blatt
  550. auch   in  der  Ausgabe  4/92  zu  einem  Testbericht  über  1stGuide
  551. herabgelassen).  Christoph  Bartholme ist die Beilage von 1stGuide zu
  552. seinem Shareware-Programm IdeaList erlaubt. Entsprechende Konditionen
  553. können  beim Autor erfragt werden.  Falls Sie spezielle Wünsche  oder
  554. Vorstellungen haben:  Registrieren Sie sich bitte ERST persönlich und
  555. tragen Sie DANACH Ihr Anliegen vor!
  556.  
  557. Die  oben  angegebenen  Archive bzw. enthaltenen Dateien müssen immer
  558. vollständig   (jeweils   auf  das  Archiv  bezogen)  und  unverändert
  559. weitergegeben  werden.  Unsachgemäβe  Änderungen  oder Eingriffe sind
  560. nicht erlaubt. Daher merke:
  561.  
  562.     Wer 1stGuide-Programme nachmacht oder verfälscht oder
  563.     nachgemachte oder verfälschte 1stGuide-Programme sich
  564.     verschafft und in Verkehr bringt, wird mit System-Ab-
  565.     stürzen nicht unter 2 Bomben bestraft.
  566.  
  567. Ansonsten  viel Spaβ mit 1stGuide, und möge der Atari immer mit Ihnen
  568. sein!
  569.