home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 86 / af086sub.adf / CYBERTOOLS / CSHOW.lzx / CyberShow / CyberShow.ReadMe < prev    next >
Text File  |  1996-05-08  |  47KB  |  934 lines
  1. CyberShow Professional Version 7.0a (c) by Helmut Hoffmann 1995/96
  2. ======================
  3.  
  4. New in V7.0: + Screenmode requester (at program start or by menu function)
  5.          + CV64Patch option to avoid displaying problems w. CyberVisions
  6.          + Alternative transition effect model ("BlackTransition") with
  7.         better quality esp. for palette oriented screens (2-256 col.)
  8.          + Configurable JPeg save quality/optim.
  9. New in V6.x: + BestMode option for automatic selection of suitable screenmode
  10.          + Width and Height options to select screenmode just by size
  11.  
  12.          -> CD-ROM producers: Special editions of CyberShow for CD-ROMs
  13.             are available on appointment at special conditions <-
  14.  
  15. This is an universal shareware picture viewer/slideshow/presentation
  16. program (incl. PhotoCD support, transition effects, zooming ...) and
  17. converter for all Amigas (and Draco!) with OS3.0 and higher which can
  18. display images in windows on the Workbench, on custom screens or public
  19. screens or presentate as slideshow incl. transition effects
  20.  
  21. * in TrueColor/HighColor on CyberGraphX systems (incl. Draco) on such screens
  22. * in reduced color (upto 256 colors) on any screen/Workbench including
  23.   AGA, ECS, OCS and usually WB-Emu graphic board screens (e.g. CybGfx,EGS)
  24.  
  25. It has many special features which make it a flexible, fast and comfortable
  26. multi-purpose tool with flexible format support (over 20 file formats).
  27.  
  28. ------> Special note for CyberVision 64 users: Some CyberVision users have
  29.     reported problems with CyberGraphX 2.12 and up (at least upto 2.15;
  30.     cybergraphics.library V40.62 and 40.64) on 24Bit screens. Such
  31.     problems do not occur with older libs (cybergraphics.library 40.58),
  32.     other screen depths or on other boards. To work around this I have
  33.     now included the option "CV64Patch" which you can try, if such
  34.     problems occur on your setup. As this option can slow down displaying
  35.     slightly and will avoid some effects, it should only be seen as
  36.     a possible intermediate solution. Hopefully newer CyberGraphX
  37.     versions don't contain this bug anymore. <----
  38.  
  39. Warning: I know that illegal/modified keyfiles of CyberShow exist. The use !!
  40.  of such keyfiles ("hhscybershowkey.library") is strictly prohibited and   !!
  41.  can lead to undefined results and problems! For a program which you use   !!
  42.  you should also be willing to pay the shareware fee. Only if enough users !!
  43.  register I will be able to do further improvements or create other graphic!!
  44.  applications. You can also help me by sending me illegal keyfiles of
  45.  CyberShow which you find somewhere.                       !!
  46.  
  47. +-------------------------------------------------------------------+
  48. | By the way:       +-----+-----+-----+-----+-----+-----+-----+---- |
  49. |                   |     |     |     |     |     |     |IFX  |     |
  50. |  Create your own  |  True Color animations...   |with | XiP | ... |
  51. |                   |     |     |     |     |     |     |  Pgs|     |
  52. |                   +-----+-----+-----+-----+-----+-----+-----+---- |
  53. | with ImageFX, XiPaint or Photogenics and my universal loader      |
  54. | modules (FastIFXModules, XiPaintModule, UniversalGIO Modules)     |
  55. | which now all include TrueColor animation savers as well for the  |
  56. | HHsYUVSq animation format... For ImageFX and XiPaint special ARexx|
  57. | scripts are already included which can automate the creation of   |
  58. | TrueColor animations. You can playback the HHsYUVSq anims e.g.    |
  59. | with the freeware CyberTVPlayer 5.x on Workbench or other screens.|
  60. | The fast loading functions (new:incl. downscaling) are the same as|
  61. | in CyberShow Professional (JPeg is missing in FastIFXM.&Univ.GIO).|
  62. | Add-on price (to CyberShow or other orders): 8US$ or 10DM each    |
  63. | Special price for registered CyberShow users: 13US$ or 15DM for   |
  64. | one module; additional further modules available at add-on price  |
  65. +-------------------------------------------------------------------+
  66.  
  67. Supported picture file formats for loading:
  68.  
  69. 1) IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  70. 2) PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit RGB)
  71. 3) JPeg (color and greyscale)
  72. 4) PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  73. 5) QRT (also known as dump format by PD raytracers as POV-Ray)
  74. 6) Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit; incl. interleaved)
  75. 7) PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  76. 8) BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  77. 9) TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  78. 10) EGS7.x window icons
  79. 11) DEEP (compr.&uncompr. IFF-DEEP 24Bit and 32Bit formats)
  80. 12) YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  81. 13) VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  82. 14) RGB (IFF-RGB: RGB8 and RGBN compressed; RGB5 uncompressed)
  83. 15) HHsYUVSq sequence format (sequential or random access)
  84. 16) IFF-PBM (DPII) format
  85. 17) ACBM (IFF-ACBM: 1 to 8Bit, EHB, HAM6, HAM8)
  86. 18) FBM (8Bit grey/Colormap and 24Bit)
  87. 19) Sun raster (uncompressed formats for 1Bit, 8Bit grey/ColorMap and 24Bit)
  88. 20) MacPaint (b&w compressed 1Bit format; datafork only)
  89. 21) HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  90. 22) binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  91. 23) TBCPlus frames&fields
  92.  
  93. and all picture DataType formats (OS3.0 and up) and animation DataType
  94. formats (OS3.1 and up).
  95.  
  96. -> Important! If you have any difficulties viewing certain picture types
  97. -> (e.g. PCX, PhotoCD, DataTypes, JPeg etc.) directly from CD-ROMs (while viewing
  98. -> the same pictures copied to disk works), you have encountered a CD-ROM file
  99. -> system problem. I have heard of difficulties with several third party file
  100. -> systems. I recommend to use only one of the following CD-ROM file systems:
  101. ->    1) Original AmigaDOS OS3.1 CD-ROM file system
  102. ->    2) AmiCD-File System V1.15 or higher (older versions are probably NOT usable)
  103. ->    3) BabelCDROM File System V1.2 or higher
  104. -> see section "Important" below for more details.
  105.  
  106. For animation formats (HHsYUVSq and animation datatypes) the first frame is shown
  107. (for playback of HHsYUVSq animations you can use my freeware program CyberTVPlayer;
  108.  for creation of such animations you can now use my univeral modules for ImageFX,
  109.  XiPaint and Photogenics; see information box above for details...)
  110.  
  111. Please note: The format "GIF" and LZW compressed "TIF" variants are not
  112. internally supported for legal reasons, but due to the DataType support
  113. loading should be possible if you have a suitable DataType (with a fast
  114. GIF or TIF DataType loading is usually still faster than with many other
  115. viewers which directly support theese formats!).
  116.  
  117. Supported picture file formats for saving:
  118.  
  119. 1) IFF-ILBM 24Bit (compressed and uncompressed)
  120. 2) IFF-DEEP 24Bit (uncompressed)
  121.    This format is used e.g. by TVPaint, XiPaint or Photogenics
  122. 3) JPeg (variable compression rates and optimization)
  123. 4) PPM-P6
  124.    This format is used by the PBM image processing software
  125. 5) QRT
  126. 6) Targa 24Bit (compressed and uncompressed)
  127. 7) HHsXRL TC24 format (compressed lossless and lossy)
  128.    This format is esp. designed for raytracing pictures, which should be
  129.    compressed lossless or with nearly invisible losses. Compression is usually
  130.    better than IFF-ILBM or Targa compression.
  131.  
  132. Highlights of CyberShow:
  133.  
  134. + flexible presentation of your pictures in windows or on screens incl.
  135.   slide show function with transition effects, presentation delay etc.
  136.  
  137. + Fast zooming (magnification upto 1:4 and reduction upto 4:1; use + to zoom
  138.   in and - to zoom out; * to go to standard size) and fast scrolling functions
  139.   (cursor keys or scrollbars)
  140.  
  141. + All loading functions (except JPeg: This software is based in part on the work
  142.   of the independent JPeg Group) have been written in Assembler and optimised for
  143.   extremely high speed. Loading will usually be upto 5 times faster than with
  144.   comparable viewers... An exception to this is the JPeg format, which is
  145.   written in C and based on the usual code of the ind. JPeg group.
  146.  
  147. + Automatic preloading: The next picture is loaded while you view the current
  148.   picture; you can now also scroll or zoom the picture or use other functions
  149.   during preloading of the next picture; this reduces waiting time to a minimum
  150.  
  151. + Can view single files, group of files (supporting patterns) and
  152.   even directory trees (automatic search of subdirectories); multiple
  153.   picture arguments can be passed by CLI, Workbench or selected with file
  154.   requester. Images will be shown in alphabetical order (ordered by complete
  155.   path name) or (as option) in random order.
  156.  
  157. + AppWindow function
  158.  
  159. + Optional downscaled loading for faster access and less memory usage
  160.   (selectbale as CLI parameter, WB Tooltype or by menu function)
  161.  
  162. + Can go back to previous images as well
  163.  
  164. + Information window for picture can be opened including name, dimensions,
  165.   file type, file size, file comment and number of frames (for animations)
  166.  
  167. + Fast direct transfer of images to famous image processing and painting
  168.   programs (currently ImageFX, XiPaint and PicoPainter are supported;
  169.   transfers to other programs could be included if more developers/dealers
  170.   would support me and more programs would have sufficient interfaces)
  171.  
  172. + Save function to convert pictures into some 24Bit file formats (JPeg, IFF, ...)
  173.  
  174. + Delete function to delete pictures you don't like ...
  175.  
  176. Using instructions
  177. ==================
  178.  
  179. Configuration of a screen to use:
  180.  
  181. Usually CyberShow will show the pictures in windows directly on
  182. the default public screen (usually the Workbench). To make use of other
  183. screen modes or to use public screens you can configure CyberShow by
  184. CLI parameters, Workbench Tooltypes or by the ENV: variable "CyberShowScreen".
  185. You can also make use of a screenmode requester or use the "BestMode" option
  186. (by CLI or Tooltype). The BestMode option will let CyberShow select a suitable
  187. screenmode by itself. If you specify the Width or Height parameters, a
  188. suitable screenmode will be selected according to thoose dimensions.
  189.  
  190. To use a custom screen:
  191.  
  192. If you want a screen of a fixed mode to be opened for CyberShow you can
  193. set an environment variable with the screenmode, e.g.:
  194.     SETENV CyberShowScreen "NTSC:HighRes Interlace"
  195. You can specify all kinds of screenmodes for Amiga screens, emulation
  196. screens of graphic boards and TrueColor/HighColor screens for Cybergraphics.
  197. In any case the screen will be opened with the max. depth which is available
  198. for that mode. Please note that the screenmode name is case sensitive!
  199. Take a look at the Prefs/Screenmode program's list of screenmode names
  200. to see what is available. If you specify an unknown screenmode name or
  201. the specified screenmode can't be used for some reason the program will
  202. use the default public screen (after an information requester).
  203.  
  204. Alternatively you can specify a CLI parameter "Screenmode": e.g.
  205.     CyberShow Screenmode "NTSC:HighRes Interlace"
  206. This parameter will override the ENV: variable as well as a PublicScreen
  207. parameter. This is also available as tooltype for WB start (e.g.
  208. Screenmode=NTSC:HighRes).
  209.  
  210. You can also use a screenmode requester (by a menu entry). If you want
  211. the screenmode requester to appear after program start, you can use the
  212. option "RequestMode".
  213.  
  214. To use a named public screen:
  215.  
  216. If you want to make CyberShow use a non-default Public Screen, you can
  217. also specify this with the ENV: variable, e.g.:
  218.     SETENV CyberShowScreen "*CoolScreen"
  219. To distinguish between a screenmode and a public screen name the *
  220. character has to be specified before the screen name. To find out the
  221. public screen name of your applications, look into their manuals! The
  222. screen title of the public screens is often NOT the public screen name.
  223. If the named public screen can't be used (if it is not found or private)
  224. then the default public screen is used (after an information requester).
  225.  
  226. Alternatively you can specify a CLI parameter "PublicScreen": e.g.
  227.     CyberShow PublicScreen "CoolScreen"
  228. This parameter will override the ENV: variable. Please note that the *
  229. has not to be specified for the CLI parameter. If you also specify a
  230. Screenmode parameter, the PublicScreen parameter will be ignored.
  231. This is also available as tooltype for WB start (e.g. PublicScreen=...).
  232.  
  233. To save the screenmode or name specification for automatic use after booting,
  234. just copy it from ENV: to ENVARC: (or use the WB Tooltype). If you want to
  235. use the program on the default public screen again, just
  236. SETENV CyberShowScreen "" or delete the variable from ENV: or from ENVARC:
  237. for permanent effect (or delete the Tooltype).
  238.  
  239. Important note: The * character is sometimes ignored as input in CLI/shell
  240.     lines (or misinterpreted as #?). This can happen e.g. with
  241.     screenmode names of certain drivers or with public screen name
  242.     specifications; in such a case you should enter the * character
  243.     twice (**), which will then usually lead to one character * as result.
  244.     This can depend on your configuration. Spaces and case of characters
  245.     are also important in the screenmode names. In case of difficulties
  246.     the options "BestMode", "Width" and "Height" should help...
  247.  
  248. General parameters for CLI usage or start from Workbench:
  249.  
  250. You can specify multiple pathes/pictures/patterns in the CLI command line, e.g.:
  251.   CyberShow ram:#?.jpg tmp:#?.iff "CD1:Photo_CD/Images"
  252. Picture parameters in the CLI can be included in " for better compatibility.
  253. To specify pictures on Workbench start, you can multi-select one or several
  254. pictures or even drawers by holding shift and selecting with the mouse
  255. before double clicking. If no pictures are specified on program start,
  256. a file requester appears, which allows selection of a path, a pattern or
  257. any number of single pictures.
  258.  
  259. Another method is to make icons for the pictures and specify "CyberShow"
  260. complete with it's path as default tool.
  261.  
  262. The CyberShow window is also an AppWindow in which you can drop picture
  263. icons or even drawers or disks of pictures to view them.
  264.  
  265. Tooltype options for start from WB: Many options can be specified in the
  266. Tooltypes of the CyberShow icon; similair options are available as parameters
  267. from CLI start. Take a look at the icon to see the available parameters which
  268. are enclosed in parentheses to make them inactive. If you want to use a tooltype,
  269. remove the parantheses (and add any missing parameter).
  270.  
  271. The tooltypes are:
  272.  
  273.     DefaultPath=path    Provide default path for path/pattern/file
  274.                 requester after startup or for save requester
  275.     Downscale=number    Select downscaling with factor 1:number
  276.                 (number range 1 to 16 supported in increments of 1;
  277.                 some file formats can not be downscaled by all fac-
  278.                 tors; for thoose the next higher factor is used)
  279.     Autoscale        Downscale all pictures to screensize (or smaller)
  280.     NonRecursive        Switch off recursive subdirectory search
  281.     Screenmode=name        Select screenmode name for private screen
  282.                 (Overrides ENV:CyberShowScreen)
  283.     PublicScreen=name    Select named public screen
  284.                 (Overrides ENV:CyberShowScreen)
  285.     RequestMode        Use a screenmode requester to ask for a screen mode
  286.     BestMode        Use private screen and select a suitable
  287.                 screenmode automatically; currently this is
  288.                 only done for the first picture as other pictures
  289.                 will be displayed on the same screen. Internally
  290.                 CyberShow uses 24Bit, thus a screen will be
  291.                 selected by size and opened with max. color depth.
  292.     Width=width        Use bestmode with specified width if possible
  293.     Height=height        Use bestmode with specified height if possible
  294.                 BestMode, Width and Height will override any
  295.                 specified screenmode or public screen options
  296.     Icons            Do not ignore .info files. This is only useful if
  297.                 you have some Icon-Datatype and want to take a look
  298.                 at the icons of files. By default, .info files are
  299.                 now completely ignored. Please note that in
  300.                 addition to this option you might have to remove
  301.                 the ~(#?.info) pattern from the file requester if
  302.                 this is used.
  303.     Request            Show file/path/pattern requester after
  304.                 displaying all files
  305.     PresentWindow        Leave window size unchanged between pictures;
  306.                 window will open at screen size; smaller pictures
  307.                 are shown centered in the window; you can still
  308.                 resize the window manually. On TrueColor/HighColor
  309.                 windows transition effects will be used as default.
  310.                 Use Effects or NoEffects to manually control this.
  311.     SlideShow        Show pictures on screen (no window borders); this
  312.                 works best if you select your own Screenmode. On
  313.                 Workbench or Public screens you will still have
  314.                 a depth arrangement bar on default (you can instead
  315.                 select a backdrop window with another option).
  316.                 As there are no scrollbars, you can only scroll
  317.                 with the cursor keys in this mode. The usual menue
  318.                 functions are still available. On TrueColor/HighColor
  319.                 windows transition effects will be used as default.
  320.                 Use Effects or NoEffects to manually control this.
  321.     BackDrop        Backdrop window for SlideShow on WB or Public Screens
  322.     Black            For small pictures fill unused screen or
  323.                 window areas with the foreground pen (usual
  324.                 black) instead of background (usual grey); in
  325.                 SlideShow mode on private screens black is
  326.                 always used and even specifed as background to
  327.                 make presentations better e.g. for Video recording
  328.     BlackTransition        Show a black screen between all pictures as a
  329.                 transition (very useful for palette oriented
  330.                 screens and in conjunction with the effects option).
  331.     Effects            Select transition effects (default for presentation
  332.                 windows and slideshow on true color screens); use
  333.                 this option to get effects in standard mode or on
  334.                 palette oriented screens (2-256 colors).
  335.     NoEffects        Disable transition effects; if you use this option
  336.                 together with the Effects option, the effects will
  337.                 actually be disabled, but the usual palette locking
  338.                 for 2 to 256 color screens will remain active
  339.     Delay=number        Automatically go to next picture after specified
  340.                 number of seconds; can also be switched on&off by
  341.                 menu (default 8s if switched on without spec. time)
  342.     Loop            Start with first picture again after showing last
  343.                 (useful in conjunction with Delay for automatic
  344.                  presentation at shows etc.)
  345.     IgnoreErrors        Do not show requesters for unreadable files;
  346.                 they will instead be quietly ignored
  347.     PartialFiles        Accept partially corrupt files during loading
  348.                 (at least 50% must be loaded correctly; default
  349.                  is to reject all corrupt files; partial loading
  350.                  is not possible for some formats e.g. Datatypes
  351.                  due to technical reasons; the information
  352.                  requester now contains the % of success, which
  353.                  will be less than 100% for corrupt files)
  354.     JPegQual=quality    JPeg save quality (50..95 in steps of 5)
  355.     JPegOpt            Use JPeg save optimization
  356.     SlowJPeg        Use slower (but slightly better?) JPeg loading
  357.     Random            Display pictures in random order
  358.     CV64Patch        Option which will hopefully avoid some possible
  359.                 displaying problems of CyberGraphX in conjunction
  360.                 with the Cybervision 64. If such problems occur
  361.                 on your setup, you should try this option.
  362.  
  363. The CLI parameters are:
  364.  
  365. Due to the possibility to specify multiple pictures or pathes on the command line
  366. CyberShow should also be suitable for use with directory utilities (I checked it
  367. with DirOpus 4.12A+: E.g. specify CyberShow {F} as DOS command for your CyberShow
  368. button; please note that DirOpus will call CyberShow multiple times if you select
  369. too many files for the CLI command length limit; this can have unpleasant
  370. effects if you want to view many pictures as slideshow from DirOpus).
  371. Many other options are available as CLI parameters as well; they are usually
  372. identical to the above listed ToolType options. Type CyberShow ? in a shell to
  373. see the possible options. Here are the additional parameters (incl. abbreviations):
  374.     DS=Downscale (number)
  375.     AS=Autoscale
  376.     NR=NonRecursive
  377.     SM=Screenmode (name)
  378.     PS=PublicScreen (name)
  379.     RM=RequestMode
  380.     BM=BestMode
  381.     W=Width
  382.     H=Height
  383.     Icons
  384.     Request
  385.     PW=PresentWindow
  386.     SL=SlideShow
  387.     BD=BackDrop
  388.     Black
  389.     BT=BlackTransition
  390.     Effects
  391.     NoEffects
  392.     Delay (number)
  393.     Loop
  394.     IE=IgnoreErrors
  395.     PF=PartialFiles
  396.     JPegQual (number)
  397.     JPegOpt
  398.     SlowJPeg
  399.     Random
  400.     CV64Patch
  401.      -> see WB tooltypes above for detailed explanation
  402.  
  403. If you just start CyberShow without any picture parameters, a file/path/pattern
  404. requester appears. With this you can specify a directory (path) with an optional
  405. pattern or select one or multiple pictures (by holding shift during the selection).
  406. You can select a new file/path/pattern by using the "New Directory" menu entry
  407. at a later time (it will be shown automatically after displaying all files
  408. if you select the Request option) or by dropping icons of pictures, drawers
  409. or even disks into the CyberShow window which is now an AppWindow.
  410.  
  411. In any case subdirectories will be searched automatically if you don't restrict
  412. searching by a pattern to one directory or use the NonRecursive option.
  413.  
  414. Information about additional functions:
  415.  
  416. * Change of screen: You can select a new screenmode and color depths with the
  417.   menu entry "Screenmode requester". CyberShow will then try to open the new
  418.   screen and continue it's displaying there.
  419.  
  420. * Downscaled loading: Default is to load pictures in full size. With the
  421.   "Scaled-Loading" menue or Downscale option you can select to load all
  422.   pictures in reduced size. For many file formats this downscaled loading
  423.   will be significantly faster. Please note that the pictures will be in
  424.   small form in memory, thus save or transfer operations will save or
  425.   transfer the images in small form. This is different from the zooming
  426.   functions. If you load a picture in normal size you can zoom out to get
  427.   it in reduced size as well, but then the image remains in original
  428.   resolution in memory.
  429.  
  430.   Automatic downscaling to screen size is also available as option or
  431.   by menu. This will lead to a downscaled loading which reduces all pictures
  432.   to the screen size or a smaller size, if that is not possible.
  433.   If you specify both BestMode and AutoScale, the first picture will be
  434.   loaded in full size (unless you have manually specified width and height)
  435.   and a screenmode selected for this. Subsequent pictures will be loaded
  436.   downscaled to screen size.
  437.  
  438. * SlideShow and presentation windows: To show pictures as slideshow
  439.   instead of windows, it is best to specify a screenmode as well, e.g.
  440.     cybershow #?.jpg SlideShow ScreenMode "PICCOLOSD64:800x600x16M"
  441.   or use BestMode or Width/Height.
  442.   You can also use the slideshow as backdrop e.g. on the WB screen.
  443.   SlideShows and PresentWindow presentations will by default use transition
  444.   effects on TrueColor/HighColor screens. You can switch them off with
  445.   the NoEffects option or select them with Effects for palette oriented
  446.   screens or standard viewing (automatically resized window). Please note
  447.   that effects on palette oriented screens can be quite slow (due to
  448.   this fact some effects are only available on TrueColor/HighColor
  449.   screens; while zooming is active, some effects are also disabled
  450.   for speed reasons) and that the palette will be locked for all
  451.   pictures, except if you use the BlackTransition option as well.
  452.   Palette locking can lead to reduced displaying quality if you have
  453.   many pictures with different colors. Due to this it is recommended
  454.   to use the BlackTransition option on palette oriented screens. On
  455.   TrueColor/HighColor screens such problems can not occur, but the
  456.   BlackTransition option is usable as well. For automatic presentations
  457.   you can specify a delay time after which the next picture is selected
  458.   automatically and a loop function for endless presentations. You still
  459.   have full manual control with Menu functions or keys (use Esc or Quit
  460.   to exit). The loop function will only be active if at least 2 pictures
  461.   are available. The random option can be used to display pictures in
  462.   random order.
  463.  
  464. * Flipping between pictures: To advance to the next picture use the
  465.   "Next Picture" menu entry (Shortcut Amiga N), press the space bar
  466.   or press the close button of the picture window (the next picture
  467.   will be selected automatically if you have specified a number of
  468.   seconds as a delay time). During displaying the next picture will
  469.   already be loaded. You can now scroll or resize the window or select
  470.   another function while the next picture is preloaded (due to technical
  471.   restrictions of some file formats this is partially not available if
  472.   pictures are not stored line by line, e.g. FBM24, ACBM, DataTypes, vertical
  473.   PCD images, YUV, VLB, HHsYUVSq; during the color conversion phase you can
  474.   still scroll and this phase is often longer than the loading time unless
  475.   you load from floppy disk).
  476.   You can also go back to previous pictures with the "Previous Picture"
  477.   menu entry (Shortcut Amiga P) or by pressing the backspace key.
  478.   If you try to select the next picture (or previous picture) before
  479.   automatic preloading has finished, the window title will inform you about
  480.   the already loaded part of the picture (in percent).
  481.  
  482. * Scrolling: Scrolling can be performed with cursor keys or the scroll bars
  483.   (scroll bars are not available in slideshow mode). You can select
  484.   between different cursor scrolling speeds (use cursor keys with Shift
  485.   for fine scrolling, ALT to scroll upto the border or without other key
  486.   to scroll for one third of the window).
  487.  
  488. * Zooming: Since V5.0 you can zoom in and out to magnify or reduce the
  489.   picture; to zoom in press the + key (max. magnification 1:4); to zoom
  490.   out press the - key (max. reduction 4:1); to go back to standard viewing
  491.   (1:1) press the * key. Zooming functions are also available as menu
  492.   entries. Please note that reduced viewing is different from downscaled
  493.   loading; if you load a picture downscaled, it is kept in memory
  494.   in reduced size and transfers or saves will be in reduced size
  495.   as well. If you just zoom out to reduce a picture, it remains
  496.   in memory in it's full resolution. The zoom stage will be kept even
  497.   if you change to the next picture.
  498.  
  499. * Picture information window: For the currently displayed picture you
  500.   can get an information requester by selecting the "Picture Info"
  501.   menu item (Shortcut Amiga I). It includes the name, dimensions (original
  502.   and loaded), file format, file size, file comment and number of frames
  503.   (for animations). The file format string often includes the color depths
  504.   or other variation informations as well. For pictures loaded with any
  505.   DataType, the file type begins with "DTxx" with xx being the color depth.
  506.   For animations loaded with DataType the file type begins with "DHxx".
  507.   This is followed by the recognition string of the DataType, if available.
  508.   For partially loaded files (use option PartialFiles) the information
  509.   requester contains in percent the part which is loaded correctly. In
  510.   addition the picture number and total number of files are displayed.
  511.  
  512. * Exiting CyberShow: You can quit the program with the "Quit" menu item
  513.   or by pressing the Esc key in the picture window (or screen), by
  514.   pressing Ctrl-C in the CLI or sending a Ctrl-C signal to the task.
  515.  
  516. * Program information: The "About" menu function gives an information
  517.   requester (which includes the personal registration information if
  518.   you are a registered user with a correctly installed keyfile).
  519.  
  520. * Fast direct transfer functions (not in demo version):
  521.   You can directly transfer the image in full 24Bit quality very fast to
  522.   important image processing and painting programs (see transfer menu).
  523.   Currently supported applications: ImageFX, XiPaint and PicoPainter
  524.   For PicoPainter you can transfer the image into a picture
  525.   project window or into a brush.
  526.   Please note that pictures will always be transferred in their loaded
  527.   size. If you have selected the downscaled loading, the pictures will
  528.   be transferred in small form.
  529.  
  530. * Conversion/Saving (not in demo version):
  531.   The same restrictions apply to the save functions which can be used to
  532.   convert the currently loaded image into one of several formats (see
  533.   above for list of supported save formats). All pictures are saved as
  534.   24Bit images. This is not dependent on the screenmode. The size which
  535.   has been used for loading will be the size in which it is saved. For
  536.   JPeg saving you can select the quality between 50% and 95% in steps of
  537.   5% and optional an additional optimization (needs extra memory during
  538.   saving but can lead to slightly smaller files without additional
  539.   loss) by menu functions, WB-Tooltypes or CLI parameters.
  540.  
  541. * Delete function (not in demo version): Registered users can also
  542.   delete the file of the currently visible picture (after confirmation
  543.   requester); the picture will remain in loaded form in memory and can
  544.   thus still be saved afterwards.
  545.  
  546. Important: Please read the following
  547. ------------------------------------
  548.  
  549. -> Problems with loading specific file formats? <-
  550.  
  551. If you have difficulties viewing a picture in one of the supported
  552. file formats (or DataTypes) and you are sure that you have enough
  553. memory left, check the following:
  554.  
  555. a) File systems: Some PD/ShareWare/Commercial add-on or replacement
  556.    file systems (esp. CD-ROM file systems!) are buggy (e.g. they do
  557.    not support some rarely used DOS functions properly). Try to copy
  558.    the picture to a standard device (e.g. RAM:) and to view it from
  559.    there. If this works, you know that your specific file system is
  560.    buggy. I found the following file systems to be usable:
  561.    1) Original AmigaDOS OS3.1 CD-ROM file system
  562.    2) AmiCD-File System V1.15 or higher (older versions are probably NOT usable)
  563.    I also heard that the following works without problems:
  564.    3) BabelCDROM FileSystem V1.2 or higher
  565.    I recommend to only use one of theese CD-ROM file systems.
  566.    Several users e.g. reported problems with "AsimCD-Filesystem 3.0";
  567.    so this seems to be an unsuitable Filesystem (maybe the newer 3.4
  568.    version supports all necessary functions). Typical unimplemented
  569.    or wrong functions in filesystems are: NameFromFH (needed for Datatype
  570.    access) and ExamineFH (needed for several formats, e.g. PCX-VGA).
  571.  
  572. b) DataTypes: Some DataTypes are instable and can crash on certain
  573.    pictures with odd dimensions or incomplete pictures. I have no
  574.    influence on this. If you have difficulties with certain DataTypes,
  575.    look out for newer versions.
  576.  
  577. Requirements
  578. ============
  579.  
  580. Any Amiga (or Draco!) with
  581.  
  582. + OS3.0 or higher
  583. + some memory (about 4MByte Fast-RAM should be enough for normal use)
  584.  
  585. For displaying in TrueColor/HighColor quality you also need
  586.  
  587. + cybergraphics.library V40 or higher and a suitable graphic board
  588.   (Cybergraphics is a Workbench emulation/True color software extension
  589.    which is usable in conjunction with several graphic boards as the
  590.    Cybervision, Piccolo, SD64, Picasso, Retina-BLTZ3, Spectrum, Domino.
  591.    It is Copyright by Thomas Sontowski and Frank Mariak.)
  592.  
  593. Please note: The Draco computer already contains a built in graphic
  594.  board, so that you can use CyberShow in TrueColor without additional hardware.
  595.  
  596. Shareware modalities
  597. ====================
  598.  
  599. The unregistered demo version of CyberShow has an important restriction:
  600.  
  601. All pictures will be shown in greyscale only in the demo version!!!
  602.  
  603. Anyway, I have designed the loading functions so that the speed is the
  604. same as with color loading so that you can check the real speed of my
  605. fast loading functions, but please note: on screens with less than
  606. 15Bit color depths the displaying speed of the greyscale pictures could
  607. be higher than that of color pictures due to the fact that the color pen
  608. allocation is different. I have no influence on this; to see the real
  609. speed, try it on HiColor/TrueColor screens (if you have Cybergraphics),
  610. as no color pens are needed and it makes no difference if a greyscale
  611. or true color image is displayed. If you want to see how the color
  612. allocation works with 2 to 256 colors, take a look at CyberTVPlayer,
  613. my freeware TrueColor animation player for HHsYUVSq animations (which
  614. you can now create with ImageFX, XiPaint and Photogenics; see above).
  615. CyberTVPlayer uses the same color reducing functions as CyberShow.
  616.  
  617. Some other functions are also not available in the demo version (e.g.
  618. direct transfer functions, delete, save functions, AutoScale and AppWindow).
  619.  
  620. Registration for CyberShow Professional:
  621.  
  622.    Shareware fee 30DM (in europe) or 25US$ (outside europe); other
  623.    currencies possible (see registration form).
  624.    Together with CyberShow you can order fast loader/saver modules for
  625.    several programs the add-on price of 10DM or 8US$ each.
  626.  
  627. To register send the filled in and signed registration form (included
  628. in this archive) to my address together with the money as banknotes,
  629. a cheque or international postal money order:
  630.  
  631. My address:             Helmut Hoffmann
  632.             Rubensstrasse 4
  633.             D-41063 Moenchengladbach
  634.  
  635.             Germany
  636.  
  637. Users in germany can also transfer money to my account (No bank transfers
  638. from outside germany!!).
  639.  
  640. You can currently contact me by EMail (no registrations by EMail!):
  641.  
  642.         hhoff@pool.informatik.rwth-aachen.de
  643.  
  644. After registration you will receive a keyfile and the latest version of
  645. this program. The keyfile will enable you to use future demo versions of
  646. this program as full version. The processing of your order can take
  647. some time. Usually it will be very fast (only a few days), but under raw
  648. circumstances it could take some weeks.
  649.  
  650. Registered users might get another advantage: If I decide to port my
  651. picture management software EGSPhotoAlbum for Cybergraphics and standard
  652. Amigas, registered CyberShow users can register for a lower price.
  653. The fast loading functions of CyberShow are the same as thoose in
  654. EGSPhotoAlbum Professional 5.x.
  655.  
  656. Where to find the latest versions
  657. =================================
  658.  
  659. New versions become usually available at least at the following places:
  660.  
  661. 1) FTP and BBSs
  662.  
  663. Aminet sites and mirrors or mirrowing BBSs
  664.  
  665. 2) CD-ROMs
  666.  
  667. New versions will usually be available on Aminet CDs (currently appearing
  668. every two months), Fresh Fish CDs or the ADX-CD.
  669.  
  670. Version history
  671. ===============
  672.  
  673. 1.0 (14th june 95): Initial release (supporting 21 file formats and DataTypes)
  674. 2.0 (19th june 95): Added menu for picture windows offering Quit, About, SaveAs,
  675.             Picture Info, Next/Previous Picture, Transfer, Downscale
  676.             Added fast direct transfer functions to ImageFX, XiPaint
  677.             and PicoPainter
  678.             Added saving functions (7 formats) for picture conversions
  679.             Added function to go back to previous pictures
  680.             Added scrollbars for comfortable scrolling
  681.             Implemented faster scrolling methods
  682.             Functions like scrolling/resizing now already usable
  683.             during the next picture is loaded
  684.             Window position will now be left unchanged for newly
  685.             opened windows if possible; the scroll position will
  686.             be left unchanged between pictures of identical size
  687.             Information requesters for unreadable pictures/problems
  688.             Preloading is suppressed if not enough memory is available
  689.             Support of downscaled loading (1:1, 2:1, 4:1, 8:1)
  690. 3.0 (30th june 95): New reduced color output function which is available with
  691.             OS3.0 and not only with OS3.1; drawing speed increased
  692.             for Amiga screens and certain emulations
  693.             Support of separate screen with screenmode specified in
  694.             ENV:CyberShowScreen
  695.             Added menu function to select a new directory and/or pattern
  696.             Changed menu colors for OS3.x look
  697.             Changed file requester for saving to a save requester with
  698.             picture file name as default for save name as well
  699. 3.1 (7th july 95):  Support of use of named foreign public screen with name
  700.             specified (with a leading *) in ENV:CyberShowScreen
  701.             Information requester if screenmode or public screen can't be
  702.             found or own screen can't be opened
  703.             Fixed bug which could lead to crashes if files couldn't be
  704.             opened after they have been stored in the internal list;
  705.             now you can choose to try the next picture or quit the
  706.             program in case of any difficulties
  707.             Fixed bug which could lead to problems if window couldn't be opened
  708.             Correction of Sun raster 24Bit loading (wrong colors and
  709.             problems with odd sized images)
  710. 3.2 (21st july 95): Support for RLE compressed 8Bit and 1Bit BMP files
  711.             Bug fix for loading function which could lead to crashes if
  712.             certain non-picture files where detected as a picture
  713. 3.3 (24th july 95): Enhanced CLI parameter control incl. multiple picture arguments
  714.             and new parameters
  715.             Added Workbench parameter support for pictures and even drawers
  716.             Added muliple-file-selection support for file/path requester
  717.             Extended information window (now incl. file size, file comment)
  718.             Now ignoring icons (.info files) on default
  719.             Next/previous picture now also selectable with space/backspace keys
  720. 3.4 (27th july 95): Now configurable by Tooltypes for start from WB
  721.             Introduction of "DefaultPath" Tooltype to specify a directory
  722.             as default for the file requester by WB start
  723.             New option "Request" for automatic requesting of new
  724.             path/pattern/files after displaying is finished
  725.             Introduction of Progress indicator which appears in the
  726.             window title if Next/Previous picture is selected before
  727.             the picture is available (preloaded)
  728.             Higher file requester window for easier multi-selection
  729. 4.0 (1st aug. 95):  Introduction of SlideShow and Presentation window features:
  730.             in standard mode window will now be resized instead of
  731.             being closed and opened again if picture size changes;
  732.             in presentation mode window size will be unchanged
  733.             unless changed by the user; in slideshow mode a
  734.             borderless (optional: backdrop) displaying will be
  735.             used for pure presentations, esp. on private screens
  736.             Introduction of transition effects for SlideShows or
  737.             presentation mode
  738.             Changed min. window size and set useful small alternate
  739.             window size on default for zoom gadget
  740.             Introduction of IgnoreError option to skip unreadable
  741.             files quietly (useful if you e.g. have many non-picture
  742.             files like .readmes on a CD you want to scan for
  743.             pictures without getting lots of errors)
  744. 4.0a (2nd aug. 95): Bug fixes for window titles (could lead to corrupt titles)
  745. 4.1 (5th aug. 95):  Changed TIF loader for better compatibility with certain pics
  746.             Extended Targa loader by 15Bit and 16Bit HiColor loading
  747. 4.1a (7th aug. 95): Corrected XiPaint transfer problems (appeared in V3.3)
  748. 4.2 (15th aug. 95): Added 5 new transition effects for slideshow/presentations
  749.             Changed window redraw for scrolling/resizing to be done
  750.             without effects in presentation windows
  751. 4.3 (20th aug. 95): Introduction of automatic advancing to next picture (delay
  752.             option) after specified number of seconds
  753.             Introduction of loop mode (for endless presentations)
  754.             Screen font changed to other font instead system text font
  755. 5.0 (30th aug. 95): Introduction of fast zooming functions for magnified or
  756.             reduced viewing (1:4 upto 4:1)
  757.             Support for new file formats: binary-EPS bitmaps (RGB,CMYK)
  758.             and TBCPlus frames
  759.             Fixed lockup-bug which occured if picture had to be reloaded
  760.             for new downscaling factor but was not accessible anymore
  761.             Added (partial) german documentation file
  762. 5.1 (05th sep. 95): Changed standard viewing mode to support effects as well
  763.             in automatically resized windows
  764.             Changed JPeg loading to use faster decoding method
  765.             (old slower method still available as option)
  766.             Added support for optimized JPeg saving (selectable by menu)
  767.             Added support for partial file loading (corrupt files) as
  768.             option & extended file info requester with status field
  769.             Extended file format information for Datatype loaded pictures
  770.             or animations (includes now DT specific ID if possible)
  771. 5.2 (27th sep. 95): Added multi-stage cursor scrolling functions. Use cursor
  772.             keys without qualifier to scroll as usual (1/3rd of the
  773.             window). Use them with Shift for smooth scrolling and
  774.             with Alt to scroll in one go upto the border.
  775. 5.3 (9th oct. 95):  Extended TIF loader to support "Intel" byte order files and
  776.             more image variants
  777.             Added zooming functions into menu
  778.             AppWindow function for picture window: drop picture icons,
  779.             drawers or whole disks into the window for displaying
  780.             File requester now uses picture path as default
  781. 5.4 (27th oct. 95): Automatic "downscaling to screensize" option
  782.             Fixed slideshow window title bug
  783.             Fixed bugs leading to unprecise automatic delays
  784.             Adapted scrollbars to respect unusual sized size gadgets
  785. 5.5 (15th nov. 95): Improved handling of unreadable pictures if "IgnoreErrors"
  786.             is used; now the next loadable picture is preloaded
  787.             Added menu functions for delay,loop,effects,ignore,partial
  788.             Fixed bug for "PartialFile" loading of IFF-ILBM masks
  789.             Extended IFF loader to accept 0-sized chunks
  790. 5.6 (7th dec. 95):  Delete function to delete current picture file
  791.             "Random" option to display pictures in random order
  792.             Immediate scrolling during use of scrollbars
  793.             Faster smooth cursor scrolling (w. Shift) while zoomed in
  794.             Extended PicInfo requester (loaded size; picture numbers)
  795.             Fixed bug which lead to endless loop if loop mode was
  796.             selected and no pictures where left to display
  797. 6.0 (9th jan. 96):  BestMode option to find screenmode depending on
  798.             picture size etc.
  799.             Width and Height options to specify screenmode by size
  800.             PublicScreens or WB will now be put to front if used
  801.             Fixed bug in JPeg loading which could lead to crashes if
  802.             unsupported variants of JPeg pictures were found
  803.             Extended IFF loader to accept unusual sized color maps
  804. 6.0a (18th march 96): Changed PCX loading for more compatibility
  805.             Bugfixes in scrolling functions for zoomed pictures
  806.             Specified screen title for private screens
  807. 6.0b (26th march 96): Fixed bug (introduced in V6.0a) for zoomed-in pictures
  808.             in presentation windows or slideshow
  809. 6.0c (29th march 96): Extended PCX loading for more compatibility
  810. 7.0 (9th april 96): Screenmode requester function available as menu entry
  811.             Option "RequestMode" for screenmode selection on start
  812.             Option "BlackTransition" for black screens between
  813.             pictures; useful esp. for palette oriented screen
  814.             slideshows in conjunction with "Effects"
  815.             Option "CV64Patch" to try to avoid some CV64/CG problems
  816.             Added Quit-Option in certain Out-of-memory requesters
  817.             Added break check (Ctrl-C) during directory scanning
  818.             Added Tooltypes and CLI parameters for JPeg quality&opt.
  819.             Fixed minor bugs in handling of some menu option switches
  820.             Fixed major bug in memory handling in conjunction with
  821.             changes of the effect option by menu
  822. 7.0a (10th april 96): Fixed bug in handling of effect menu switch
  823.  
  824. Special Thanks
  825. ==============
  826.  
  827. My special thanks go to:
  828.  
  829.  Kermit Woodall from NOVA-Design for providing me with ImageFX.
  830.  Thomas Dorn for providing me with XiPaint.
  831.  Almathera for providing me with Photogenics.
  832.  Cloanto for providing me with PPaint.
  833.  Without this support the fast direct transfer functions or universal modules
  834.   would probably have been impossible.
  835.  Thomas Sontowski and Frank Mariak for making the TrueColor/HighColor
  836.   Workbench possible.
  837.  The "Independent JPEG Group" for providing the portable C source code
  838.   for JPeg compression/decompression. The JPeg functions are based on
  839.   this code (This software is based in part on the work of the independent
  840.   JPeg Group).
  841.  Haage&Partner for providing me with StormC.
  842.  and to all registered users of CyberShow (currently from 18 countries all
  843.   over the world), esp. thoose who reported bugs or made suggestions...
  844.  
  845. The future development of Amiga and CyberGraphX compatible software
  846. depends on YOUR registration...
  847.  
  848. Hard- and Software used for developing
  849. ======================================
  850.  
  851. This program is written in pure Assembler (using the german assembler
  852. O.M.A.). Only the lowlevel JPeg functions have been implemented
  853. in C (based on the portable C source of the Independent JPeg Group)
  854. and compiled with the german MaxonC++ 3.x system.
  855.  
  856. My development system is:
  857.  
  858. Amiga 3000/030/25MHz / 18 Megabytes RAM / OS3.1 (incl. OS3.1 CD file system)
  859.  
  860. 4MByte Piccolo SD64 (64Bit) graphics board (running in Zorro III-mode).
  861.  
  862. This program was tested with enforcer and mungwall running.
  863. This program was also tested on a Draco computer.
  864.  
  865. Disclaimer
  866. ==========
  867.  
  868. This software (program and documentation) is provided "as is" and
  869. comes with no warranty, either expressed or implied.
  870. The author is in no way responsible for any damage or loss that may
  871. occur due to direct or indirect usage of this software. You use
  872. this software entirely at your own risk.
  873.  
  874. Copyright
  875. =========
  876.  
  877. This software (program and documentation) is copyright by
  878.  
  879.                         Helmut Hoffmann
  880.             Rubensstrasse 4
  881.             D-41063 Mönchengladbach
  882.  
  883.             Germany
  884.  
  885. The demo version may be freely distributed and used as
  886. long as the following conditions are met:
  887.  
  888. 1) All files have to be kept together
  889.  
  890. 2) No file may be modified or crunched/packed.
  891.  
  892.    The only official way to distribute this demo packed is the
  893.    original .lha archive.
  894.  
  895.    The program may not be disassembled or analysed. The limitations
  896.    integrated in the demo version may under no circumstance be removed
  897.    or bypassed.
  898.  
  899. 3) Distributors may only charge for the duplication process (including media)
  900.    and not for the software. Theese charges may not exceed the following
  901.    limits: a) Demo on a PD-disk: 8$ (US-dollar) including
  902.               postage&packing (in Germany: 12DM)
  903.        b) Demo on a PD-CD-ROM: 50$ (US-dollar) including
  904.               postage&packing (in Germany: 75DM)
  905.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  906.               callable system: Maximum charge 4$ (US-dollar) (in Germany: 6DM)
  907.               for downloading
  908.    Anyway, it must be made explictly clear to the buyer, that he does not
  909.    pay for the program (demo) itself but only for the duplication service.
  910.  
  911. 4) It is not allowed to distribute the demo with any commercial product
  912.    without a written permission by me. One exception is the distribution of
  913.    the demo version with products not exceeding the above price limits (e.g.
  914.    a cover-disk magazine for 8$ or less).
  915.  
  916.    The following companies have my explicit permission to distribute the
  917.    demo with their products: Almathera, NOVA Design, Ingenieurbüro Helfrich,
  918.    MacroSystem and the distributors of XiPaint and PPaint.
  919.  
  920.    If you want to distribute the demo with your commercial product
  921.    (hardware or software) write to me for details.
  922.  
  923. 5) The registered version (the keyfile) may not be redistributed. It may only
  924.    run on one machine per registration. It is allowed to make a backup copy
  925.    of the original disk. All keyfiles include visible and invisible signs,
  926.    which allow trace back to the user even if the keyfile is modified. It
  927.    is always illegal to use faked/modified keyfiles and any try to do so
  928.    can lead to unpredictable results.
  929.  
  930. 6) Licensed special versions, e.g. for picture-CD-ROMs, can be
  931.    created by appointment for very low prices. Please write to me
  932.    for details.
  933.  
  934.