home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-3 / Tools / screen / backspace / old / Slideshow.README < prev    next >
Encoding:
Text File  |  1996-11-09  |  3.5 KB  |  123 lines
  1.  
  2. SlideShow 1.0 - A BackSpace module for displaying multiple images.
  3.  
  4. ------------------------------
  5.  
  6. Directory hierarchy:
  7.  
  8. .:
  9.     SlideShow files, containing source for SlideShow and its 
  10.     optional preferences panel nib/controller.  Note that the 
  11.     Thinker.h supplied here is slightly modified from the original.
  12.  
  13. PATCHES:
  14.     Patches that are to be applied to the original BackSpace source, 
  15.     as found on the Purdue NeXT archives:
  16.         -rw-r--r--  1 archiver  305490 Sep 30 09:14 BackSpace.tar.Z
  17.     See PATCHES/README.Patches for details.
  18.  
  19. ------------------------------
  20.  
  21. SlideShow install;  example assumptions:
  22.  
  23.     - BackSpace.app is installed in /LocalApps,
  24.     - You have a /LocalLibrary/Images/ directory containing tiff images
  25.  
  26. Install the module:
  27.  
  28.     % cp SlideShowView.o /LocalApps/BackSpace.app
  29.  
  30. Build the Filelist:
  31.  
  32.     % cd /LocalLibrary/Images
  33.     % ls `pwd`/*.tiff > .list
  34.     % dwrite SlideShow Filelist `pwd`/.list
  35.  
  36. If you do not have write permission in the BackSpace.app directory, ask your
  37. sysadmin to install SlideShow,  or,  given that BackSpace is in /LocalApps:
  38.  
  39.     % mkdir ~/Apps/BackSpace.app
  40.     % cd /LocalApps/BackSpace.app
  41.     % foreach i (*)
  42.     ? ln -s `pwd`/$i ~/Apps/BackSpace.app/$i
  43.     ? end
  44.     % cp SlideShowView.o ~/Apps/BackSpace.app
  45.  
  46.     % (build Filelist as shown above)
  47.  
  48. ------------------------------
  49.  
  50. Summary of SlideShow defaults:
  51.  
  52.     SlideShow Filelist /LocalLibrary/Images/.list
  53.     SlideShow FadeDelta 0.05
  54.     SlideShow Waittime 2000
  55.     SlideShow Steptime 50
  56.     SlideShow Randomize NO
  57.     SlideShow Fancy NO
  58.     SlideShow Slide NO
  59.     SlideShow Debug 0
  60.  
  61. Filelist: string
  62. Location of file containing a list of tiff filenames,  one per line, 
  63. each must be an absolute (starting with a /) pathname.  Blank lines
  64. are permitted,  and lines starting with a '#' are ignored.
  65.  
  66. FadeDelta: float
  67. Fraction between 0.0 and 1.0 that specifies how much of the image will be
  68. composited to the screen upon each iteration.  Note,  the delta must be 
  69. greater than 0.0 otherwise nothing will happen.
  70.  
  71. Waittime: int
  72. Number of milliseconds to pause between each image.
  73.  
  74. Steptime: int
  75. Number of milliseconds to pause between each dissolve composite.
  76.  
  77. ( [enabled] := {"YES", "ON", nonzero integer} )
  78.  
  79. Randomize: string
  80. If [enabled],  frames are selected randomly;  otherwise frames are displayed 
  81. sequentially in the order given in the filelist.
  82.  
  83. Fancy: string
  84. If [enabled],  the next frame is faded-in while the current frame is faded-out.
  85.  
  86. Slide: string
  87. If [enabled],  the image will slide around the screen,  much like the 
  88. SlidingImageView behaves.
  89.  
  90. Debug: int
  91. If nonzero,  debugging information is printed on the standard output,  or
  92. in the console window if BackSpace is started from the Workspace.
  93.  
  94. ------------------------------
  95.  
  96. Thanks to:
  97. Sam Streeper,  for writing BackSpace app,
  98. Lennart Lovstrand,  for the FadingImageView on which SlideShow was based,
  99. Ron Blanford,  for the code in GlobeView which opens multiple images, and
  100. to the whole NeXT community who make their source code available for all to
  101. learn from.
  102.  
  103. If you like SlideShow,  send me a postcard.
  104. If you don't like it,  improve it,  email the fixes,  and send me a postcard.
  105.  
  106. Hints:
  107.  
  108. Large images fade visibly.  Use small images.
  109.  
  110. The Escher images,
  111. nova.cc.purdue.edu:/pub/next/graphics/Images/tiff/Escher.tar.Z,
  112. look neat when Fancy=YES, FadeDelta=0.1
  113.  
  114. To duplicate the action of GlobeSaver or IvoSaver,  build the Filelist
  115. accordingly,  and set Fancy=YES, Slide=YES, FadeDelta=1.0
  116.  
  117. Bugs:
  118. When using the Globe.anim files on a monochrome NeXT,  the corners are white.
  119.  
  120. -- 
  121. Bill Carson / brighton@pixar.com / brighton@phuket.nbn.com
  122. PO Box 10009, San Rafael, CA 94912, USA
  123.