@database HappyDT.guide
@master Dev:MPL/distribution/HappyDT.guide
@node "Main" "HappyDT Guide"
                          @{b}@{u}HappyDT V3@{ub}@{uu}

                 @{i}Copyright ©1996-98 by Christophe Sollet@{ui}
                        All rights reserved

                         @{"Shareware" link "Distribution" 14} 

    @{"Einführung" link "Introduction" 0}

    @{"Lizenz" link "Distribution" 0}

    @{"Autor" link "Auteur" 0}

    @{"Minimale Konfiguration" link "Conf" 0}

    @{"Installation" link "Install" 0}

    @{"Anwendung" link "Usage" 0}

    @{"Voreinstellungen" link "Prefs" 0} (Preferences)

    @{"Danke" link "Thank" 0}

    http://altern.org/cfc/HappyDT

@endnode

@node "Introduction" "Einführung"

                        @{b}Einführung@{ub}

  Mit Hilfe der Datatypes kann ein Anwendungsprogramm Dateien, (z.B.
  Bilder) laden, ohne irgend etwas über ihre Art und ihren Aufbau zu
  wissen. Es kann GIF-, JPEG- oder PNG-Bilder laden, ohne einen dafür
  geeigneten Programmcode zu besitzen.

  Aber nur wenige (ältere) kommerzielle Programme verwenden diese
  Möglichkeit, die mit der Workbench 3.0 eingeführt wurde.

  Das ist Zweck und Ziel von HappyDT: HappyDT wirkt einfach wie ein
  Filter zwischen den Programmen und den zu ladenden Dateien. Wenn eine
  Anwendung eine Datei unbekannten Typs zu laden versucht, verwandelt
  HappyDT sie mit Hilfe der Datatypes in eine temporäre IFF-Datei.
  Dadurch kann die Anwendung die Datei verarbeiten, als ob es eine IFF-
  Datei wäre. Darüberhinaus kann sich HappyDT auch in den
  Speichervorgang einklinken und so das Format der zu speichernden Datei
  ändern.

  Zusätzlich kann HappyDT eine mit Xpk oder Xfd gepackte Datei entpacken.
  In der derzeitigen Version unterstützt HappyDT die Datatypes für Bilder,
  Töne (Sounds) und Animationen.

@endnode

@node "Distribution" "Lizenz"

  Das gesamte HappyDT-Paket ist Copyright © 1998 by Christophe Sollet.

  Ohne eine schriftliche Genehmigung durch den Autor

     · ist jede kommerzielle Nutzung oder jeder Verkauf streng
       verboten,
     · ist es streng verboten, dieses Archiv in irgend eine
       Software-Sammlung aufzunehmen, außer in Aminet Fileserver oder
       auf Aminet-CDs.
     · Alle Teile dieser Ausgabe müssen in ihrer originalen Form
       unverändert zusammenbleiben.


  @{b}THIS SOFTWARE IS PROVIDED "AS IS". NO REPRESENTATIONS OR
  WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY, RELIABILITY,
  PERFORMANCE, CURRENTNESS, OR OPERATION OF THIS SOFTWARE, AND ALL USE
  IS AT YOUR OWN RISK !@{ub}

  @{b}DIESE SOFTWARE WIRD SO, "WIE SIE IST", ZUR VERFÜGUNG GESTELLT.
  ES WERDEN KEINE VORGABEN GEMACHT ODER GARANTIEN GEGEBEN, DIE SICH
  AUF DIE RICHTIGKEIT, ZUVERLÄSSIGKEIT, AKTUALITÄT ODER
  BETRIEBSFÄHIGKEIT DIESER SOFTWARE BEZIEHEN. JEDE BENUTZUNG
  UNTERLIEGT DEM EIGENEN RISIKO DES ANWENDERS!!@{ub}


  @{u}Mitteilung über Shareware@{uu}

  Seit Version 2 ist HappyDT nun Shareware.
 
  Die unregistrierte Version ist wirklich brauchbar! Kein Requester,
  keine Zeitbegrenzung. Nur neue Eigenschaften der Version 2 sind
  ausgeschaltet (Task tracking, datatypes filter, sound & anim datatypes
  and save support [Ladeprogrammsuche, Datatypes für Ton und
  Animationsdateien und Unterstützung beim Speichern]). Alle Eigenschaften
  zukünftiger Versionen werden aber den registrierten Benutzern
  vorbehalten bleiben.

  Alle registrierten Benutzer der Version 1 sind registriert für Version
  2 und zukünftige (Sie sollten Ihr Keyfile inzwischen mit eMail erhalten
  haben. Wenn nicht, bitte melden Sie Sich!) Mit der Veröffentlichung
  der Version 2 ist die eMail-Registrierung nicht mehr möglich.

  NEU IN DER VERSION 3:

  Task tracking (Ladeprogrammsuche) ist nun auch in der unregistrierten
  Version möglich.


  Um sich registrieren zu lassen, müssen Sie FF100 (Französische Franc)
  an den Autor senden.

  Das ist möglich mit:
  - einer französischen Überweisung,
  - Bargeld (Französische Franc oder einen gleichwertigen Betrag einer
    Währung der Europäischen Union),
  - US-Dollars oder Schweizer Franken,
  - Überweisung aus der Europäischen Union (nur in Französischen Franc).

  An:
    Christophe Sollet
    21, rue de Villers
    14260 Aunay/Odon
    France

    Im Gegenzug erhalten Sie das Keyfile mit der Post oder durch eMail.

@endnode

@node "Auteur" "Autor"

  HappyDT von Christophe Sollet
  Amiga 1200/68030/68882 - 16mb fast.

  Wenn Sie Vorschläge, Probleme oder sonst etwas für mich haben,
  können Sie mir das brieflich oder über eMail mitteilen.

  Wenn Sie die ganze Ausgabe (Katalog oder doc.) oder auch nur einen
  Teil davon übersetzen wollen, setzen SieSich mit mir in Verbindung!


  email: cfc@iname.com

  Christophe Sollet
  21, rue de Villers
  14260 Aunay/Odon
  France

  Übersetzungen:

    Espagnol:

      Dámaso D. Estévez
      eMail: amidde@arrakis.es

    Italiano:

      Saul Bertuccio
      Via Consolazione, 15
      98122 Messina
      ITALY
      eMail: saulbertuccio@usa.net

    Deutsch:

      Gernod Schomberg
      Weinbrennerstr. 77
      D 76185 Karlsruhe
      eMail: g.schomberg@t-online.de

    Polski:

      Îukasz Jodîowski

      eMail: ljodlo@ucku4.uck.pk.edu.pl

    Ruski:

      Boris Kondratyev
      eMail: ambartsumian@glas.apc.org

@endnode

@node "Conf" "Minimale Konfiguration"

  Software: Workbench 3.0 (datatypes !)
            datatype.library V45+

  Hardware: Keine Minimal-Konfiguration (aber erwarten Sie keine
            Wunder mit einem JPEG-Bild auf einem 68000 bei 7Mhz !!!)

  HappyDT bietet zwei Versionen: eine für 68000 und eine für 68200 und
  höher. Da in Wirklichkeit die Datatypes die Hauptarbeit verrichten,
  werde ich keine speziellen Versionen für andere Prozessoren machen.

@endnode

@node "Install" "Installation"

  Verwenden Sie das Installations-Script !


  Anmerkung:

    Es ist möglich, die Commodity und das Einstell-(prefs)-Programm
    im gleichen Verzeichnis einzurichten.


    Wenn Sie den Installer von Commodore nicht haben, können Sie zu
    Fuß installieren:

    docs/            : Enthält die Dokumentation.
    exe/00/HappyDT   : Version 68000 der Commodity.
    exe/20/HappyDT   : Version 68020 der Commodity.
    prefs/00/HappyDT : Version 68000 des Prefs-Programms.
    prefs/20/HappyDT : Version 68020 des Prefs-Programms.
    locale/catalog/  : Locale-Katalog.

@endnode

@node "Usage" "Anwendung"

  HappyDT ist eine Commodity. Sie können sie aus der Shell oder von
  der Workbench starten.

  Sie können es mit einem Ctrl-C oder über Exchange ausschalten. Wenn
  Sie, auch über Exchange, HappyDT ausschalten, wird der Patch entfernt.

  Wenn Sie den Knopf "Show Interface" (bei deutscher Lokalisierung
  "Anzeige sichtbar") in Exchange drücken, erscheint ein kleines
  Fenster mit folgenden Knöpfen:

  @{b}Entfernen (Flush)@{ub}: Alle HappyDT-Temp-Dateien @{"löschen" link "Edit" 0})
  @{b}Verbergen (Hide)@{ub} : Dieses Fenster verbergen
  @{b}Ende (Quit)@{ub} : HappyDT beenden
  @{b}Vorgaben@{ub}: Das @{"Einstellprogramm" link "Prefs" 0} (Preferences) starten

  Das ist alles! @{"Konfigurieren" link "Prefs" 0} (Vorgaben einstellen) und vergessen!

@endnode

@node "Prefs" "Einstellungen"

  Die Liste im ersten Fenster zeigt die Programme, die HappyDT verwenden
  können. Wenn Sie eine neue Anwendung einfügen wollen, verwenden Sie den
  Knopf @{"Zufügen" link "Edit" 0}. Um die Einstellung für eine Anwendung zu ändern, klicken
  Sie doppelt auf ihren Namen oder wählen Sie sie aus (sie wird dadurch
  nicht markiert!) und verwenden den Knopf @{"Bearbeiten" link "Edit" 0}.

  Um die Einstellungen einer Anwendung zu entfernen, wählen Sie sie aus und
  klicken auf "Entfernen".

  Sie können im Feld "Temp.:" wählen, wohin HappyDT die temporären Dateien
  schreiben soll. Falls Sie nur wenig RAM haben, sollten Sie dafür ein
  Verzeichnis auf der Festplatte wählen. Vorgegeben ist "T:".


  @{b}Speichern (Save)@{ub}: Speichert die Einstellungen auf der HD.
  @{b}Benutzen (Use)@{ub}: Die neuen Einstellungen werden verwendet.
  @{b}Abbruch (Cancel)@{ub}: Ende, die Einstellungen werden verworfen.

  Anmerkung: Nach Änderung der Einstellungen braucht HappyDT nicht neu
  geladen zu werden. HappyDT wird automatisch unterrichtet und holt sich
  die neuen Vorgaben ab.

@endnode

@node "Edit" "Bearbeiten"

  Im Bearbeitungsfenster können Sie die Vorgaben für jede einzelne
  Anwendung auswählen.

  (Anm. d.Übers.: Es gibt Programme, die das Laden der Bilder usw. mit
  getrennten Routinen ausführen. Der Einfachheit (und Kürze) halber wird
  dafür der im Englischen übliche Ausdruck "Task" (= Aufgabe) verwendet.)

  Schreiben Sie in das Feld @{b}Programmname:@{ub} den Namen der Anwendung und
  in das Feld @{b}Task-Name:@{ub} den Namen des Unterprogramms, welches das Bild
  lädt (verwenden Sie den Knopf @{b}Ermittle Task@{ub} dafür).

  Sie können Jokerzeichen im Namen der Task im Falle von "MultiTask"-
  Anwendungen benützen.
 

  Knopf @{b}Ermittle Task (Identify task)@{ub}.
  Verwenden Sie ihn, um den Task-Namen eines Programms zu ermitteln.
  Dabei muss HappyDT laufen.

  - Klicken Sie auf den Knopf "Ermittle Task"
  - Starten Sie das Programm.
  - Laden Sie die Datei "RAM:HDTTARGET" (die von HappyDT dort abgelegt wurde)
    in das Programm genau so, wie eine Datei üblicherweise geladen wird.
    Beachten Sie Warnmeldungen nicht, klicken Sie sie einfach weg!
  - Das ist Alles! Das Feld "Task-Name" enthält nun die Laderoutine.


  @{b}Infofenster (Info window)@{ub}
  Wenn Sie dieses Feld markieren, zeigt HappyDT während der Umwandlung ein
  Informationsfenster.

  @{b}Xpk aktivieren (Enable XPK)@{ub}
  Wenn dieses Feld markiert ist, versucht HappyDT Dateien zu entpacken und
  zu laden.

  @{b}Temp.-Datei nach Gebrauch löschen (Delet temp. after use)@{ub}
  Wenn Sie dieses Feld markieren, löscht HappyDT die temporären Dateien
  der Umwandlung unmittelbar, nachdem das Programm sie geladen hat. Bei
  bestimmten Programmen sollten sie diese Option nicht wahrnehmen, da
  z.B. DPaint eine Datei zweimal lädt: einmal, um das Format zu bestimmen
  und einmal, um das Bild selbst darzustellen. Wenn bei Programmen dieser
  Art das Feld markiert ist, wird die Datei zweimal geladen und umgewandelt!
  Wenn die Markierung fehlt, merkt sich HappyDT die zuletzt geladene Datei
  und wandelt sie nicht ein zweites Mal.
 
  @{b}Speicher-Requester (Save Requester)@{ub}
  Wenn Sie diese Option markieren, zeigt HappyDT einen Requester jedesmal,
  wenn das Programm eine Datei zu speichern versucht. Sie können dann das
  Dateiformat wählen.

  WARNUNG! der Requester zeigt alle Datatypes, die zum Typ der Datei
  passen, die gespeichert werden soll. Das heißt aber nicht, dass Sie
  jeden Datatype Ihrer Wahl benutzen können. Nicht alle Datatypes haben
  eine Kodierer in das gewünschte Format. Sie erfahren das erst, wenn Sie
  es versuchen!

  @{b}Ausschlussliste (Exclude List)@{ub}
  Viele Programme können intern andere Dateitypen als IFF laden. Ein
  Programm kann z.B. IFF- und GIF-Bilder laden. Wenn Sie HappyDT für dafür
  einsetzen, weil Sie damit alle anderen Typen laden können, sollten Sie
  GIF in die Ausschlussliste eintragen. Damit überlässt HappyDT die
  Bearbeitung von GIF-Dateien dem Programm: Sie sparen Zeit und Speicherraum.

  Zufügen eines Typs zur Liste: Klicken Sie auf den Knopf "Zufügen" und
  wählen Sie den Typ, den Sie ausschließen wollen.

  @{b}Dateityp (File type).@{ub}
  Sie können bestimmen, ob ein Programm Bilder, Klänge (Sounds), Animationen
  oder alle diese Dateitypen laden soll.
  
@endnode

@node "Thank" "Danke"

  Vielen Dank an alle, die mir eMails mit Verbesserungsvorschlägen und
  Fehlerberichten geschickt haben:

  Christian Johansson, Eric, Fabien Connus, Geoff Milnes, Lukasz Jodlowski,
  Michael D. Lewis, Mike Ash, Odd H. Sandvik, Randall Blank, TANGRAM Art,
  Timo Ronkko, Ward C. Martin, Larry McGahey, Alessandro Basso, Karin Madlener,
  Marie Laure Couek.

@endnode
