home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CopyPRGS / XCOPY-94.DMS / in.adf / Guides / PPShow.doc < prev    next >
Encoding:
Text File  |  1977-12-31  |  16.6 KB  |  393 lines
  1. PPShow 1.2 Benutzungsanleitung
  2.  
  3. 28. September 1991
  4.  
  5. Vorwort
  6. =======
  7.  
  8. Die Programme und Dateien in dieser Distribution sind frei verteilbar,haben
  9. jedoch das Urheberrecht von (c) Nico François. Sie können frei verteilt
  10. wArden, solange nicht mehr als eine nominale Gebühr zur Deckung @pn Zeit-
  11. und Kopierkosten erhoben wird.
  12.   Kommerzielle Verwendung ist solange untersagt, wie keine schriftliche
  13. Erlaubnis des Autors vorliegt. Veränderungen der Distribution sind untersagt,
  14. die Originalzusammenstellung ist zu wahren.
  15. Obenstehendes ist i.a. als »Freeware« bekannt.
  16.  
  17. Wenn Sie Vorschläge oder Bemerkungen zu diesem Programm haben, oder wenn
  18. Sie Fehler finden, lassen Sie es mich bitte wissen.
  19.  
  20. Schreiben Sie zur folgenden Adresse:
  21.  
  22.      Fido:  2:292/603.10 (Nico Francois)
  23.  
  24.      UUCP:  Nico.Francois@p10.f603.n292.z2.FidoNet.Org
  25.  
  26.      Mail:  Nico Francois
  27.             Corbielaan 13
  28.             B-3060 Bertem
  29.             BELGIUM
  30.  
  31.   Bei Verwendung von E-Mail werden Anfragen etc. schneller als per Post
  32. bearbeitet!
  33.  
  34.   PPShow 2.3 benötigt AmigaDOS Release 2 (Kickstart & Workbench 2.0) oder
  35. höher.
  36.  
  37. Inhalt
  38. ======
  39.  
  40. 1. Einführung
  41.  
  42. 2. Benutzung
  43.  
  44. 3. Vorzüge
  45.  
  46. 4. Zum Komprimieren
  47.  
  48.  
  49. 1. Einführung
  50. =============
  51.  
  52. PPShow wurde zur Ergänzung eines meiner anderen Programme, PowerPacker
  53. ( einem Programm- und Datenkomprimierer) geschrieben. Es zeigt normale,
  54. mit dem PowerPacker komprimierte IFF ILBM - Dateien an. Dekomprimierung
  55. geschieht automatisch, es muß nicht bekannt sein, ob eine Datei komprimiert
  56. ist.
  57.  
  58.   PPShow verwendet die 'powerpacker.library' und die  'reqtools.library',
  59. diese müssen im LIBS:-Verzeichnis vorhanden sein. Zur automatischen
  60. Installation braucht 'Install_libs' nur zweimal angeklickt werden.
  61.  
  62.   Ist der PowerPacker nicht verfügbar, fehlt natürlich ein Hauptvorteil
  63. dieses Programms. Der PowerPacker ist als Shareware (bis Version 2.3b) oder
  64. als kommerzielles Programm (Version 4.0a). Die kommerzielle Version vefügt
  65. über einige Verbesserungen wie 40 - 50fache Komprimiergeschwindigkeit,
  66. bessere Komprimierung, Unterstützung von Overlays und einer AREXX-
  67. Schnittstelle.
  68.  
  69. 2. Benutzung
  70. ============
  71.  
  72.   PPShow kann auf vier verschiedene Arten verwerdet werden:
  73.  
  74. - Zunächst einmal über das CLI:
  75.  
  76.   Mit 'PPShow ?' aufgerufen erscheint eine Benutzungsschablone:
  77.  
  78.    PPShow {{file}|<dir>|-c} [LO] [HI] [SHI] [PROD] [L=LACE] [NL=NOLACE]
  79.           [HAM] [TIME s] [NOCYCLE] [NO=NOOVERSCAN] [A2024 [15Hz]]
  80.           [PAL] [NTSC] [VGA] [LOOP] [NOFLICKER]
  81.  
  82.   Über 'PPShow ??' wird eine erweiterte Information ausgegeben.
  83.  
  84.   Das Programm lädt die ILBM-Datei und zeigt sie an. Ist die Datei mit dem
  85. PowerPacker 2.0 oder höher komprimiert, wird sie zuerst dekomprimiert. Ist
  86. sie verschlüsselt, wird zunächst nach dem Password gefragt.
  87.   Wird PPShow ohne Parameter aufgerufen, erscheint ein Filerequester. Ist
  88. ein Verzeichnis angegeben, wird ein Filerequester für dieses Verzeichnis
  89. geöffnet.
  90.  
  91.   Über die Option "-c" als Dateiname kann das Clipboard, wenn es ein ILBM
  92. enthält, angesehen werden.
  93.  
  94.   Stellt PPShow fest, daß die Datei im GIF-Format vorliegt, wird ein externes
  95. GIF-Anzeigeprogramm aufgerufen, standardmäßig das sehr schnelle TurboGIF.
  96. In der Environment-Variable GIFVIEWER kann jedoch ein beliebiges GIF-
  97. Anzeigeprogramm angegeben werden, inclusive Optionen. Beispiel:
  98. ' SetEnv GIFVIEWER "TurboGIF -k7" '. Das GIF-Anzeigeprogramm muß im
  99. AmigaDOS-Pfad vorhanden sein.
  100.  
  101. Es existieren folgende Kommandozeilenparameter:
  102.  
  103.      LO         : LORES        Screen
  104.      HI         : HIRES         ''
  105.      SHI        : SUPERHIRES    ''
  106.      PROD       : PRODUCTIVITY  ''
  107.      LACE       : Interlace-Darstellung.
  108.      NOLACE     : Non-Interlace-Darstellung
  109.      HAM        : Dieswird zur Erzwingung des HAM-Modus verwendet, sollte
  110.                   kein CAMG-Chunk vorhanden sein. Ohne diese Option nimmt
  111.                   PPShow an, daß es sich um einen 6 Bitplane tiefen
  112.                   EHB-Screen handelt. Ist ein CAMG-Chunk vorhanden, wird dessen
  113.                   Einstellung verwendet!
  114.      TIME s     : Anzeige der Bilder für 's' Sekunden.
  115.      NOCYCLE    : Kein automatisches Cycling.
  116.      NOOVERSCAN : Kein Overscan.
  117.      LOOP       : Fortlaufende Anzeige aller Bilder, Abbruch mit CTRL-D oder Esc.
  118.      PAL        : Verwendung von 'pal.monitor'.
  119.      NTSC       : Verwendung von 'ntsc.monitor'.
  120.      VGA        : Verwendung von 'multiscan.monitor'.
  121.                   Bei Verwendung einer VGA stellt LO EXTRALORES-, HI LORES- und
  122.                   SHI PRODUCTIVITY-Modus (entspricht PROD) ein.
  123.      A2024      : Verwendung von 'a2024.monitor'.
  124.      15Hz       : A2024 monitor mit 15Hz, statt 10Hz.
  125.      NOFLICKER  : Nur mit Kickstart 3.0. Wenn möglich, wird ein Non-Intelaced-
  126.                   Monitor-Modus verwendet ('DoublePAL.monitor' oder
  127.                   'DoubleNTSC.monitor').
  128.  
  129.   PPShow kann mit c:Resident resident gemacht werden. Es ist nicht möglich,
  130. PPShow resident zu machen, wenn es komprimiert ist! PPShow ist reentrant,
  131. so daß es von verschiedenen CLI's gleichzeitig verwendet werden kann. (Nicht daß
  132. dies besonders sinnvoll wäre, aber es ist möglich :-D)
  133.  
  134.      Beispiele:
  135.  
  136.     o PPShow dh0:pics/HAMpicWithoutCAMG.pic HAM
  137.  
  138.     o PPShow dir/#?.pic TIME 5 LOOP
  139.  
  140.       Anzeigen aller im Verzeichnis 'dir' enthaltenen ILBM-Dateien für
  141.       jeweils fünf Sekunden.
  142.  
  143.     o PPShow PICS:~(#?.info) NOOVERSCAN
  144.  
  145.        Anzeige aller Dateien in 'PICS:', die NICT auf '.info' enden.
  146.        Kein Overscan.
  147.  
  148.  
  149. - Über die Workbench:
  150.  
  151.   Es gibt drei verschiedene Möglichkeiten, PPShow über die Workbench zu
  152. starten: Es kann das Default-Tool des Bildes auf 'PPShow' gesetzt werden,
  153. es kann das PPSow-Icon einmal und das Bild-Icon zweimal angeklickt werden
  154. oder PPShow kann gestartet werden und der Dateiname im erscheinenden String-
  155. Gadget eingegeben werden.
  156.   Das Default-Tool wird gesetzt, indem das Icon selektiert wird und mittels
  157. 'Info' aus dem Workbench-Menu der Name ':ppshow' in das entsprechende Gadget
  158. eingesetzt wird. Hierzu sollte PPShow im Hauptverzeichnis der Diskette
  159. vorhanden sein. Ist es z.B. im System-Verzeichnis, sollte ':system/PPShow'
  160. eingegeben werden. Mit dem 'Save'-Gadget wird die veränderte Einstellung
  161. gespeichert.
  162.  
  163. Folgende Tooltypes werden von PPShow erkannt:
  164.  
  165.      HAM        : Siehe CLI Option.
  166.      TIME=s     : Bild für 's' Sekunden anzeigen.
  167.      NOCYCLE    : Kein automatisches Cycling.
  168.      NOOVERSCAN : Kein Overscan.
  169.      NOFLICKER  : Nur mit Kickstart 3.0. Wenn möglich, wird ein Non-Intelaced-
  170.                   Monitor-Modus verwendet ('DoublePAL.monitor' oder
  171.                   'DoubleNTSC.monitor').
  172.  
  173.  
  174. Bemerkung: -  Für eine einfache Slideshow erstellt man ein Script mit
  175.               einer Zeile wie folgt: 'PPShow #?.pic TIME 10 LOOP'. Das
  176.               Default Tool wird c:IconX, toolypes sind 'WINDOW=CON://///AUTO'.
  177.               Ist das Script in einem Verzeichnis untergebracht, das Bilder
  178.               endend auf '.pic' enthält, werden diese angezeigt. Die Slideshow
  179.               kann mit einem einfachen Doppelklick auf das Script-Icon gestartet
  180.               und mit CTRL-D oder Esc beendet werden.
  181.            -  PPShow hängt '.pp' an den Dateinamen an, wenn die
  182.               entsprechende Datei nicht gefunden wurde. Dies ist recht
  183.               nützlich für die Workbench-Umgebung: Es kann ein Icon für
  184.               'house.pic' erstellt werden, die Datei kann jedoch
  185.               'house.pic.pp' heißen. Die Workbench zeigt also ein Icon
  186.               namens 'house.pic', angezeigt wird jedoch die Datei
  187.               'house.pic.pp' (Solange keine Datei 'house.pic' im aktuellen
  188.               Verzeichnis vorhanden ist!)
  189.            -  Im Monitors-Verzeichnis sollten soviele Monitor-Icons
  190.               vorhanden sein, wie der Monitor darstellen kann. Hiermit
  191.               können eine maximale Anzahl an Darstellungsmodi verwendet
  192.               werden.
  193.  
  194. 3. Vorzüge
  195.  
  196. ==========
  197.  
  198.   - Volle Unterstützung des 16,8-Millionen- und des HAM8-Farbmodus des
  199.     AA (AGA)-Chipsatzes der Amiga 4000 oder 1200.
  200.  
  201.   - Verlassen werden kann PPShow mit den Tasten 'Q', CTRL-C und der rechten
  202.     Maustaste.
  203.  
  204.   - PPShow unterstützt Overscan, PAL, NTSC, VGA und A2024.
  205.  
  206.   - Übergroße Bilder können mit gedrücker linker Maustaste gescrollt werden.
  207.     Hierbei wird der Mauszeiger angezeigt.
  208.     Der Screen selbst kann mit der in 'IControl' festgelegten Taste und der
  209.     linken Maustaste verschoben werden.
  210.  
  211.   - PPShow kann als einfaches Slideshow-Tool benutzt werden. Dazu verhilft
  212.     insbesondere die Unterstützung von Wildcards.
  213.  
  214.   - Deluxe-Paint-Colorcycling wird unterstützt. Es werden maximal acht Cycles
  215.     unterstützt ( DPaint III verwendet nur sechs ). Mit der Taste <TAB> wird
  216.     das Colorcycling (de-)aktiviert.
  217.  
  218.   - Mit der Taste <P> kann der Screen ausgedruckt werden. Während des Druckens
  219.     ist der Mauszeiger sichtbar. Um überhaupt drucken zu können, muß im devs:-
  220.     Verzeichnis das Printer.device vorhanden und eine korrekte system-
  221.     configuration eingestellt sein.
  222.  
  223.   - Der Mauszeiger wird entfernt. Mit der Taste 'M' kann dies ein/ausgeschaltet
  224.     werden.
  225.  
  226.   - Mit der Taste <L> kann ein anderes Bild geladen werden, es wird nach dem
  227.     Dateinamen gefragt.
  228.  
  229. 4. Zum Komprimieren
  230. ===================
  231.  
  232.   Viele IFF ILBM-Dateien sind mit dem ByteRun1-Algorithmus komprimiert.
  233. Der PowerPacker komprimiert diese noch weiter, jodoch wird das Ergebnis nicht
  234. so stark komprimiert sein wie bei nicht vorkomprimierten Dateien. IFF-ILBM-
  235. Dateien sollten also unkomprimiert (z.B. mit PixMate) abgespeichert werden,
  236. auf diese Weise werden die besten Kompressionsraten erzielt.
  237.  
  238.   Wie immer hoffe ich, daß dieses Programm von Nutzen ist.
  239.  
  240.  
  241.                               PROGRAM HISTORY:
  242.  
  243. *****************************************************************************
  244. VERSION 1.0
  245.  
  246.      First release.
  247.  
  248. *****************************************************************************
  249. VERSION 1.1
  250.  
  251.      Decrunching is about 40% faster (accidently used slow decruncher in 1.0)
  252.      Screen now pops to front when picture is ready to be viewed, not before.
  253.      File requester used when arp.library is available.
  254.      'L' command added to load other pictures without restarting PPShow.
  255.  
  256. *****************************************************************************
  257. VERSION 1.1a
  258.  
  259.      The Guru isn't with me lately, after using a slow decruncher in 1.0
  260.        by accident I now used a fast but faulty decruncher in 1.1. It
  261.        sometimes didn't decrunch correctly, this has now been fixed. The
  262.        decruncher is still 40% faster than the 1.0 one. (and it's 2 bytes
  263.        shorter :^D )
  264.  
  265. *****************************************************************************
  266. VERSION 1.2
  267.  
  268.      Rewrote cycling routine in assembly, so less overhead when cycling.
  269.      Uses the all new powerpacker.library => shorter code.
  270.      Starting PPShow from the CLI with a directory as an argument now puts
  271.        up the requester positioned in that directory. Extremely useful once
  272.        you get used to this :^)
  273.      If you are running Workbench 2.0 PPShow will use the asl.library
  274.        instead of the arp.library (for the file requester).
  275.      Fixed serious bug: memory wasn't freed when an IFF error occured.
  276.      No longer tries to display small brushes (intuition doesn't like very
  277.        small screens :( )
  278.  
  279. *****************************************************************************
  280. VERSION 2.0
  281.  
  282.      PPShow requires Kickstart 2.0 to run.  Sorry to all the 1.2 and 1.3
  283.        users, just consider this program as another reason to upgrade :-)
  284.  
  285.      File requester from arp.library is no longer supported.
  286.      PPShow now uses reqtools.library (also by moi) for its requesters.
  287.        Among other things this means a much better file requester than
  288.        before (with a buffer).  Asl is no longer used, sorry Commodore :-)
  289.      Printing of screen removed, has anybody ever used this ? :-)
  290.      Improved command line format, follows AmigaDOS standard. (old option
  291.        '-h' is no longer supported!).
  292.      IFF decrunching rewritten in assembly: much faster and shorter.
  293.      Shows pictures saved in DPaint with stencil on. In other words: supports
  294.        IFF picture masking.
  295.      No longer quits when you press any key, you have to press 'Q', CTRL-C,
  296.        or right mouse button; CTRL-D aborts PPShow and breaks scripts.
  297.      Color cycling is now automatically switched on (except for brushes).
  298.      Mouse pointer visibility can be toggled.
  299.      Possibility to automatically stop displaying after a specified number
  300.        of seconds.
  301.      Many new command line options: change display resolution, switch off
  302.        overscan, disable auto-cycling, etc.
  303.      Several options may be set using Workbench tooltypes.
  304.      From Workbench, if you single-click PPShow and shift double-click a
  305.        drawer icon, PPShow will open up the file requester in that drawer.
  306.      If you use 'PPShow <file>' or extend-select <file> from Workbench and
  307.        you invoke the file requester, it will be positioned in the directory
  308.        <file> is in.
  309.      The file requester will appear on the picture screen if possible.
  310.      Canceling the file requester no longer quits PPShow.
  311.      The file requester will filter out the .info files.
  312.      Can be used as a simple slideshow program: supports wildcards and
  313.        multiple files on command line, also possible to loop the slideshow.
  314.        Picture switching is double buffered.  Multiple extended selection
  315.        from Workbench is also supported.
  316.      Overscan now done using Kickstart 2.0 display clips.
  317.      Supports all new ECS display modes (ECS Denise only) and all monitors.
  318.      Will switch to PAL or NTSC monitor automatically (ECS Agnus only).
  319.      PPShow will now show very large screens without problem, AUTOSCROLL is
  320.        switched on so the screen automatically scrolls when you move the
  321.        mouse pointer off the edge.
  322.      Screen no longer has an invisible dragbar.  Use meta-dragging (left
  323.        Amiga key + mouse) to drag the screen.
  324.      Directories are expanded to their full pathnames on startup.
  325.      PPShow now returns a returncode of 20 in case of an error or if ended
  326.        by CTRL-D.
  327.      Error reporting improved: when started from CLI, errors are printed
  328.        on the console; when started from Workbench, a requester is used.
  329.      All these great new features and PPShow grew only about 1K in size :-)
  330.  
  331.      Release 12-Jan-92
  332.      ~~~~~~~~~~~~~~~~~
  333.      Now distributed with release 1.0c of reqtools.library.
  334.      Install script fixed.
  335.  
  336. *****************************************************************************
  337. VERSION 2.1
  338.  
  339.      Uses Workbench 2.0's iffparse.library for best IFF support.
  340.      Displays SHAM (Sliced HAM), DHAM (Dynamic HAM) and DRES (Dynamic Hires,
  341.        DigiView 4.0 and MacroPaint) files.
  342.      Executes TurboGIF (by Steve Borden) or any other GIF viewer (set by var
  343.        ENV:GIFVIEWER) if it encounters a GIF file.
  344.      Will hunt for ILBM pictures in all IFF files.  E.g. shows first picture
  345.        of animation files.
  346.      Is able to show the contents of the clipboard (if filename is "-c").
  347.      Allows you to scroll big pictures by holding down the left mouse button
  348.        and dragging.  This also works for SHAM, DHAM and DRES pictures.
  349.        PPShow will update the copper list these pictures require while
  350.        scrolling.
  351.      PPShow will no longer abort upon encountering a file that is not IFF, or
  352.        not IFF ILBM.  It will try to show the next file in the wildcard/list.
  353.      When using a wildcard directories will be ignored, instead of bringing
  354.        up the file requester.
  355.  
  356. *****************************************************************************
  357. VERSION 2.2
  358.  
  359.      Version number skipped because of a fake 2.2 version of PPShow.
  360.  
  361. *****************************************************************************
  362. VERSION 2.3
  363.  
  364.      Support added for Kickstart 3.0 and the new graphics modes of the AA
  365.        chip set.  PPShow fully supports palettes of up to 16.8 milion colors
  366.        and the HAM8 mode.  Color cycling in 16.8 million colors is not yet
  367.        supported.
  368.      On Kickstart 3.0 and pictures with enough colors PPShow will pick four
  369.        colors for the GUI (file requester).  If not enough colors are
  370.        available or on Kickstart 2.0 the palette will be temporarily reset
  371.        when needed.
  372.      Maximum overscan used is now OSCAN_MAX instead of OSCAN_VIDEO.  This is
  373.        much more system friendly.
  374.      New switch added for Kickstart 3.0 users: NOFLICKER.  Will try to use a
  375.        non-interlaced display mode to show the picture (DBLPAL or DBLNTSC).
  376.      Release 2.0c of reqtools.library included.
  377.  
  378. *****************************************************************************
  379.  
  380. PPShow 2.3 written by Nico François (Yes, Nico is my first name :-)
  381.            thanks to Ives Aerst for all the suggestions and beta-testing.
  382.  
  383.  
  384. "Sometimes people can be oh so dense" - Pixies
  385.  
  386.  
  387. (c) 1991/1992 Nico François
  388.  
  389.                                    //
  390.                        Thanks to \X/ Amiga for being the best computer ever!
  391.  
  392.  
  393.