home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 311.lha / Wipedemo_v4.0 / README < prev    next >
Encoding:
Text File  |  1980-12-10  |  7.1 KB  |  149 lines
  1. ==============================================================================
  2.                                 WIPEDEMO v4.0
  3. ==============================================================================
  4.  
  5.    To show how this program works, I wrote a little script that works with the
  6. DeluxePaint II Art Disk.  From CLI, type WIPEDEMO, or double-click the icon
  7. from Workbench.
  8.    This program displays a series of IFF picture files in sequence using
  9. fadeouts and 45 different screen wipes.  It can also be programmed to wait in
  10. between each picture and to use the narrator device.  The example script,
  11. WIPEDEMO.S, can be changed or rewritten to suit your needs.  Read the script
  12. file to see how the commands work.  This program can now be used to display
  13. files in lo-res, hi-res, interlace, overscan, HAM, and EXTRA_HALFBRITE.  Color
  14. cycling is also possible.  There are four other example scripts, each of which
  15. can be run by typing WIPEDEMO and then the name of the script, or by clicking
  16. on the script file's icon from Workbench.
  17.    I have made two versions of this program, WIPEDEMO and WIPEDEMO2.  WIPEDEMO
  18. uses less memory because it does not save the old picture during each wipe;
  19. it wipes in from black each time.
  20.    This program and its source code is public domain, period.  To show your
  21. appreciation for such generosity, send me $10 or so.  Another way to show your
  22. appreciation is to buy lots of MicroEd educational programs.  Call MicroEd and
  23. ask for the Demo Loop disk.
  24.  
  25.                             Paul Falstad
  26.                             5415 Abbott Place
  27.                             Edina, MN 55410
  28.                             CIS: 70016,1355
  29.                             GEnie: P.FALSTAD
  30.                                                         PLink: HYPNOS
  31.  
  32.                             MicroEd, Inc.
  33.                             P.O. Box 24750
  34.                             Edina, MN 55424
  35.                             (612) 929-2242
  36.  
  37. Other example scripts:
  38.  
  39.    WipeDemo.dgp      Uses pictures from the Digi-Paint disk
  40.    WipeDemo.dv2      Uses pictures from the DigiView 2.0 disk
  41.    WipeDemo.dv3      Uses pictures from the DigiView 3.0 disk
  42.    WipeDemo.dp2      Uses pictures from the DPaint II Art Disk
  43.  
  44. List them to see how they work.
  45.  
  46. ========================================================================
  47.                                 COMMANDS
  48. ========================================================================
  49.  
  50. Run the program as follows:
  51.  
  52.    WIPEDEMO[2] [HIRES] [LACE] [script_file]
  53.  
  54. If [script_file] is not specified, it defaults to WIPEDEMO.S.  You might try
  55. using a CON: window as a script file to test out the wipes.
  56.  
  57. If you want to use hi-res or interlaced pictures, you MUST use one or both
  58. of the HIRES and LACE keywords.  Each script can have pictures all of only one
  59. resolution; for example, you can't mix interlaced pictures with lo-res
  60. pictures.  You can, however, mix HAM pictures and EXTRA_HALFBRITE pictures
  61. with regular ones.
  62.  
  63. To select HIRES or LACE from Workbench, you must make a FLAGS entry in the
  64. Tooltypes list.  To get interlace mode, enter FLAGS=LACE in the tooltypes list
  65. using the INFO menu option from Workbench.  FLAGS=HIRES will get you hires
  66. mode, and FLAGS=HIRES|LACE will get you both.
  67.  
  68. Here are the commands used in the script file:
  69.  
  70.    SHOW <filename>        Shows a picture with wipes
  71.    WAIT <num>             Waits a specified number of seconds
  72.    RANDOM                 Uses random selection of wipes
  73.    SELECT <num>           Select a certain wipe
  74.    FADES ON               Turns on random fadeouts (only works w/WIPEDEMO2)
  75.    FADES OFF              Turns off random fadeouts (only works w/WIPEDEMO2)
  76.    LOOP                   Goes back to beginning of script
  77.    EXCLUDE <num>          Tells random wipe selector not to use a certain wipe
  78.    EXCLUDE ALL            EXCLUDE all 45 wipes (you must then INCLUDE a few)
  79.    INCLUDE <num>          Tells random wipe selector to use a certain wipe
  80.                              previously excluded
  81.    INCLUDE ALL            INCLUDE all 45 wipes
  82.    CYCLE ON               Turns on color cycling
  83.    CYCLE OFF              Turns off color cycling
  84.    #                      Denotes comment
  85.  
  86. If you use your own pictures with this demo, do not make color 1 white.  You
  87. may notice a little white flicker in showing the DPaint II pictures; this is
  88. because of the bright color 1.
  89.  
  90. ========================================================================
  91.                                WIPE NUMBERS
  92. ========================================================================
  93.  
  94.    0   UpAndDownPanel         1   Random
  95.    2   LeftLinePanel          3   Dice
  96.    4   GrowBoxes              5   SideToSide
  97.    6   TwoClock               7   OneClock
  98.    8   RandomOut              9   Spiral
  99.    10  ExpandBox              11  Doors
  100.    12  WipeUp                 13  WipeDown
  101.    14  WipeLeft               15  WipeRight
  102.    16  WipeDiag               17  TwoBox
  103.    18  Shades                 19  RandomShade
  104.    20  SymArr                 21  FourSweep
  105.    22  FourLines              23  HexSweep
  106.    24  DiagSplit              25  Xes
  107.    26  SlideBoxes             27  Cannon
  108.    28  Drip                   29  MovingWindow
  109.    30  Sun                    31  Monolith
  110.    32  Rain                   33  MergeWindows
  111.    34  Slides                 35  RandomDown
  112.    36  Stretch                37  ExpandSlide
  113.    38  SlideSlabs             39  Checkerboard
  114.    40  MiniRandom             41  ConcentricRectangles
  115.    42  Cloverleaf             42  Cloverleaf2
  116.    44  ConcentricRectangles2
  117.  
  118. ============================================================================
  119.                            A NOTE TO PROGRAMMERS
  120. ============================================================================
  121.  
  122.    The development of version 4 of this program has been held up for over
  123. half a year by a pernicious bug.  This bug caused random garbage to appear on
  124. the internal bitmaps, so pictures wiped in would occasionally have a line of
  125. garbage on them.  This bug was the worst possible kind of bug, because it
  126. would suddenly disappear whenever I would check the program with SDB or put
  127. any sort of debugging material in the program whatsoever.  Plus, the garbage
  128. was random, and would appear in a random location on the bitmap.  I managed
  129. to figure out that the SetupMaps() routine was causing it, but I was
  130. completely baffled.
  131.    After pounding my head against a brick wall for several hours, however, I
  132. was granted a vision from God.  The garbage that appeared was remarkably like
  133. garbage that appears on a bitmap after you'd freed up its memory and then
  134. looked at it.  It also appeared to be time-dependent; if I put Delay()s in the
  135. program, the garbage disappeared.  The bug, I discovered was caused by the
  136. BltBitMap() and the free_planes() in the SetupMaps() routine.  The BltBitMap()
  137. takes the bitplanes that have been loaded in from the disk and copies them
  138. to another bitmap.  free_planes() then frees the original copy.  Unfortunately,
  139. BltBitMap() is asynchronous; it doesn't wait for the blit to finish.  So
  140. free_planes() was freeing the memory AS IT WAS BEING COPIED!  A WaitBlit()
  141. cured all my problems; another mystery solved.  I shall now proceed back to
  142. that brick wall and drum out what remains of my sanity.
  143.  
  144. ============================================================================
  145.  
  146. Thanks to Jim Kent for his Public Domain IFF reader!!  -PF
  147.  
  148. ============================================================================
  149.