home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / gfx / misc / MWJpegTool.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  9.7 KB  |  220 lines
  1. Short:        Test/repair/copy JPEGs into user-def. Dirs (german)
  2. Author:       hupsi@trashcan.mcnet.de (Martin Wietfeld)
  3. Uploader:     tom@trashcan.mcnet.de (Thomas Bliesener)
  4. Version:      V1.4 19.12.1996
  5. Type:         gfx/misc
  6. Requires:     OS 3.x
  7. Kurz:         Testet/repariert/kopiert JPEGs in userdefinierte Directories.
  8. Distribution: Aminet- & Fish-Disks/CDs
  9.  
  10.  
  11.  
  12.         Anleitung zu 'MWJPEGTool' V1.4 (c) 19.12.1996 Martin Wietfeld
  13.         -------------------------------------------------------------
  14.  
  15.         Das Programm erkennt JPEG-Files, die dem JPEG-Dateiaufbau
  16.         entsprechen, wobei einige der JPEG-Hunks auf richtige Werte
  17.         abgetestet werden.
  18.         Falls nur der EOI-Hunk ($FFD9) fehlen sollte, so wird dieser
  19.         automatisch angehängt, wenn das Bild sonst heile zu sein scheint.
  20.         Entsprechend dem Prefsfile werden die Bilder in unterschiedliche
  21.         Directories verschoben, falls dieses gewünscht ist.
  22.  
  23.         MWJPEGTool ist SHAREWARE (15 DM). Die Unterschiede der Vollversion
  24.         werden an entsprechender Stelle dieser Anleitung erwähnt.
  25.  
  26.  
  27.         *******************************************************************
  28.         *                                                                 *
  29.         * Die unregistrierte Version (erkennbar am Nichtvorhandensein     *
  30.         * eines Keyfiles) darf NUR PRIVAT UND KOSTENLOS weitergegeben und *
  31.         * benutzt werden. Ein Aufnehmen in PD-Serien (auf Disks, CDs, ..) *
  32.         * bedarf der ausdrücklichen Genehmigung des Autors.               *
  33.         *                                                                 *
  34.         * Für Aminet-Disks/CDs und Fred-Fish-Disks/CDs ist keine extra    *
  35.         * Genehmigung erforderlich.                                       *
  36.         *                                                                 *
  37.         *******************************************************************
  38.  
  39.  
  40.         Aufruf:   MWJPEGTool [JPEGFile(s)] [showinfo]
  41.  
  42.  
  43.         Funktion: Es werden die einzelnen JPEG-Hunks getestet und nur
  44.                   Ausgaben gemacht, falls der Shell-Parameter SHOWINFO
  45.                   angegeben wurde.
  46.                   Ohne 'SHOWINFO' macht das Programm KEINERLEI Ausgaben.
  47.  
  48.         Die Datei 'MWJPEGTool.prefs' enthält einige Möglichkeiten, um
  49.         auf das Verhalten des Programmes Einfluß zu nehmen.
  50.  
  51.         Die Schreibweise der Schlüsselwörter (klein/GROSS oder wIrR) ist egal.
  52.         Es ist nicht nötig eine Reihenfolge der Schlüsselwörter einzuhalten
  53.         oder überhaupt alle Schlüsselwörter zu benutzen.
  54.         Momentan kennt MWTestJPEG folgende Schlüsselwörter:
  55.  
  56.            #Kommentarzeile
  57.            OK <Pfad>
  58.            PACK <Pfad>           [nur in der Vollversion]
  59.            REPAIR <Pfad>         [nur in der Vollversion]
  60.            DEFECT <Pfad>
  61.            FILELIST <[Pfad]File> [nur in der Vollversion]
  62.            XSTEP <Nummer>        [nur in der Vollversion]
  63.            YSTEP <Nummer>        [nur in der Vollversion]
  64.  
  65.         <Pfad> gibt den jeweiligen Pfad an, der für die entsprechende
  66.         Funktion verwendet wird.
  67.         <File> ist ein gültiger Filename einer Datei.
  68.         Zwischen dem Pfad und dem Schlüsselwort muß mind. ein Space,
  69.         ein '=' oder ein TAB sein (oder Kombinationen daraus).
  70.  
  71.         Also ist auch folgendes möglich:
  72.  
  73.            pack=<Pfad>
  74.            ok   <Pfad>
  75.            REPair        <Pfad>
  76.  
  77.         Leerzeilen werden ignoriert, Kommentarzeilen sind noch nicht
  78.         möglich, aber das kann ja noch kommen.
  79.  
  80.         Alle JPEG-Bilder, die heile sind, werden in den Pfad verschoben,
  81.         der in der OK-Zeile angegeben ist. Sollten Kommentar-Hunks entfernt
  82.         worden sein (z.B. 'Adpro...' oder 'Photoshop...'), so landen diese
  83.         Bilder stattdessen im Pfad der in der PACK-Zeile angegeben ist.
  84.         Reparierte Bilder befinden sich nur noch im REPAIR-Pfad, und Bilder,
  85.         die nicht repariert werden konnten (oder gar keine JPEGs sind),
  86.         befinden sich nach Programmende im DEFECT-Pfad.
  87.         Wird einer der Pfade nicht angegeben, so werden die entsprechenden
  88.         Bilder NICHT verschoben, sondern verbleiben im Original-Directory.
  89.         (Während der Laufzeit des Programms liegt das jeweils bearbeitete
  90.         Bild kurzzeitig in T: )
  91.  
  92.         Ab Version 1.3 können auch mehrere Files auf der Kommandozeile
  93.         angegeben werden. An welcher Stelle der SHOWINFO-Parameter steht
  94.         ist vollkommen egal.
  95.  
  96.         Sollen viele Files auf einmal bearbeitet werden, so ist dafür die
  97.         FILELIST-Zeile in der Prefs-Datei vorgesehen.
  98.         Dort kann man ein File (mit Pfad) angeben, das beliebig viele
  99.         Filenamen enthalten darf. Die Filenamen müssen dort jeweils mit 
  100.         komplettem Pfad zeilenweise aufgeführt sein.
  101.  
  102.         Also einfach folgendes eingeben:
  103.  
  104.           list <Bilder-Pfad1> lformat="%s%s" >ram:MeineFileliste
  105.           list <Bilder-Pfad2> lformat="%s%s" >>ram:MeineFileliste
  106.           ...
  107.           list <Bilder-PfadN> lformat="%s%s" >>ram:MeineFileliste
  108.           MWJPEGTool
  109.  
  110.         Dazu muß dann in der Prefs-Datei die folgende Zeile enthalten sein:
  111.  
  112.           filelist ram:meinefileliste (Groß/-kleinschreibung wieder egal)
  113.  
  114.         Sollen mehrere Bilder mit der unregistrierten Version des Programms
  115.         getestet/verschoben werden, so ist in der Shell folgendes einzugeben:
  116.  
  117.           list <Bilder-Pfad> lformat="MWJPEGTool %s%s" >ram:Script
  118.           execute ram:Script
  119.  
  120.         Man muß also für jedes Directory immer ein Extra-Skript erstellen
  121.         lassen. Diese Variante ist ungünstiger als die FILELIST-Lösung
  122.         der registrierten Version, weil für jedes Bild das Programm
  123.         geladen wird und das Prefs-File ausgewertet werden muß.
  124.         Es ist daher deutlich langsamer als die Vollversion.
  125.  
  126.         Die Werte für XSTEP und YSTEP in der Prefs-Datei geben an in
  127.         welchen Schritten man die Directories unterteilen möchte.
  128.         Voreingestellt (und in der unregistrierten Version nicht änderbar)
  129.         sind XSTEP=87 und YSTEP=130.
  130.         Setzt man XSTEP=100 und YSTEP=50, so werden alle Bilder, deren
  131.         Breite größer 100 und kleiner 200 ist, in ein Dir namens 00100x...
  132.         gelegt (für die Punkte ist dann YSTEP zuständig). Bilder, die
  133.         breiter als 200 Punkte und schmaler 300 Punkte sind, landen dann 
  134.         in 00200x... .Man kann natürlich auch XSTEP und YSTEP jweils auf 1
  135.         setzen, dann sind alle Bilder in einem Directory auch exakt gleich
  136.         groß (z.B. in 00322x00480 sind alle Bilder 322 breit und 480 hoch).
  137.         So lassen sich ungefähr gleich große Bilder im selben Directory
  138.         halten, während etwas (oder viel) breitere/höhere woanders landen.
  139.  
  140.         Returncode   Bedeutung bzw. ausgegebener Fehlertext
  141.  
  142.            0(OK)     JPEG-Bild ist OK.
  143.                         -> OK-Pfad oder PACK-Pfad wird benutzt
  144.  
  145.            5(WARN)   Fehlender JPEG-Hunk $FFD9 wurde angefügt
  146.                      oder das JPEG-Bild ist defekt.
  147.                         -> REPAIR-Pfad oder DEFECT-Pfad wird benutzt
  148.  
  149.            10(ERROR) Parameter falsch angegeben.
  150.  
  151.            20(FAIL)  Konnte kein Lock auf <JpegFile> bekommen.
  152.            21        Ohoh, Konnte nichtmal <...> Bytes Speicher bekommen.
  153.            22        Examine auf Datei <JpegFile> fehlgeschlagen.
  154.            23        Konnte nicht <...> Bytes Speicher bekommen.
  155.            24        Datei <JpegFile> ist nicht zu öffnen.
  156.            25        Datei <JpegFile> kann nicht komplett eingelesen werden.
  157.  
  158.            27        Datei <JpegFile> konnte nicht geschrieben werden.
  159.  
  160.            30        Die Datei <JpegFile> konnte nicht kopiert werden.
  161.            31        Die Datei <JpegFile> konnte nicht gelöscht werden.
  162.            32        Das Directory <Dir> konnte nicht erzeugt werden.
  163.            33        Die Datei <JpegFile> konnte nicht erzeugt werden.
  164.            35        Die FileList-Datei <...> konnte nicht gelesen werden.
  165.  
  166.  
  167.         ACHTUNG: Bei Nutzung von FILELIST [nur in der Vollversion] gibt es
  168.                  weniger mögliche Returncodes:
  169.  
  170.            0(OK)     Alle JPEG-Bilder abgearbeitet.
  171.  
  172.            10-35     wie oben
  173.  
  174.         Features der späteren Versionen (kann sich noch ändern):
  175.  
  176.           Eine richtige Anleitung, denn diese ist doch etwas unpraktisch.
  177.           Verwenden von Directorynamen, die der User vorgibt, um z.B.
  178.           Standardauflösungen in andere Directories legen zu lassen.
  179.           Automatische Vergabe von Suffixen und Prefixen für defekte bzw.
  180.           reparierte Bilder.
  181.           Automatische Änderung der Filenamen nach Uservorgaben.
  182.           Begrenzen der Maximalanzahl Bilder in einem erzeugten Directory.
  183.           Andere Bildformate (dann müßte ein neuer Programmname her).
  184.           Unterschiedliches Verhalten für verschiedene Dateilängen.
  185.           Mehrere Prefsdateien.
  186.           Auch englische Fehlermeldungen und englische Anleitung.
  187.           ...
  188.  
  189.         (Was hiervon zuerst realisiert wird hängt auch etwas von den
  190.          registrierten Anwendern und deren Wünschen ab.)
  191.  
  192.         Die Sharewaregebühr kann auf folgendes Konto überwiesen werden:
  193.  
  194.           Martin Wietfeld
  195.           Konto: 578424-307
  196.           BLZ  : 250 100 30
  197.           Postbank Hannover (Germany)
  198.  
  199.  
  200.         Bugreports und Wünsche für spätere Versionen bitte an:
  201.  
  202.           hupsi@trashcan.mcnet.de
  203.  
  204.         oder
  205.  
  206.           Martin Wietfeld
  207.           Am Liesenfeld 15
  208.           D-38271 Oelber am weißen Wege (Germany)
  209.  
  210.  
  211. ============================= Archive contents =============================
  212.  
  213. Original  Packed Ratio    Date     Time    Name
  214. -------- ------- ----- --------- --------  -------------
  215.    17028   10208 40.0% 19-Dec-96 23:38:06  MWJPEGTool
  216.     9057    3374 62.7% 19-Dec-96 23:29:52  MWJPEGTool.LiesMich
  217.      728     413 43.2% 19-Dec-96 23:38:28  MWJPEGTool.prefs
  218. -------- ------- ----- --------- --------
  219.    26813   13995 47.8% 08-Jan-97 00:16:34   3 files
  220.