home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GR / GR006.ZIP / FLICKER.ARC / FLICKER2.DOC < prev    next >
Text File  |  1988-07-14  |  46KB  |  1,293 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                  F L I C K E R 
  16.                                   Version 2.21
  17.                             ________________________
  18.                            |                        |
  19.                            | A SOFTWARE PACKAGE FOR |
  20.                            | PRESENTATION  GRAPHICS |
  21.                            |________________________|
  22.  
  23.  
  24.                                        by
  25.                                  Brian J. Dooley
  26.  
  27.  
  28.                                -- Documentation --
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.     Copyright 1985, 1986, 1987, 1988 by Brian J. Dooley. All Rights Reserved.
  50.  
  51. FLICKER  Documentation                                       by Brian J. Dooley
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                            I N D E X 
  61.  
  62.             Introduction...............................3
  63.             Previous Versions..........................3
  64.             Overview...................................3
  65.             Starting the Program.......................5
  66.             Processing Modes...........................6
  67.               Command Line.............................7
  68.               Run .....................................7
  69.               Edit Mode................................7
  70.               Work Screen..............................8
  71.             The Commands...............................8
  72.               Controls.................................9
  73.               File Routines...........................11
  74.               Music...................................11
  75.               Screen..................................12
  76.               Screen Write............................14
  77.               Text Entry..............................15
  78.               Wipes...................................16
  79.             Capabilities..............................17
  80.               Use in Different Environments...........17
  81.                 In-Store Displays.....................17
  82.                 Business Presentations................18
  83.                 Training Presentations................19
  84.               Effects.................................20
  85.                 Animation.............................20
  86.                 Banners...............................20
  87.                 Sequence Planning.....................21
  88.                 Presentation Frames...................21
  89.             Care in Preparation.......................22
  90.             Technical Notes...........................22
  91.             User Supported Software...................23
  92.             
  93.             
  94.  
  95.  
  96.  
  97.                                      -- 2 --
  98. FLICKER  Documentation                                       by Brian J. Dooley
  99.  
  100.  
  101.  
  102. I n t r o d u c t i o n 
  103.  
  104. The FLICKER program is a command file processor for graphics presentations. It 
  105. is provided on an as-is basis through the user-supported software concept, as 
  106. described later in this manual. No warranties, either expressed or implied, are 
  107. made regarding the functioning of this product in a given setting. 
  108.  
  109. To use this software, you need the following equipment:
  110.  
  111.      An IBM PC or close compatible
  112.      128K+ memory
  113.      A Graphics Board and suitable monitor
  114.  
  115. The following accessories will make this program more useful:
  116.  
  117.      A word-processing program capable of generating ASCII text
  118.      A graphics creation program capable of creating binary image files.
  119.  
  120.  
  121. P r e v i o u s   V e r s i o n s 
  122.  
  123. Those who have participated in the development of this program will recognize 
  124. it as PRESENT. A name change became necessary when it was found that another 
  125. user-supported software package with that name was being uploaded to BBS 
  126. systems shortly after this program became available. We hope that the name 
  127. change has not caused any confusion.
  128.  
  129. You may also find the new name quite appropriate. Version 2 has been somewhat 
  130. long in coming, due to its ambitious specifications. The first difference that 
  131. you will note is that the program itself is over twice as large! The new, 
  132. interactive edit capability (Edit Mode) makes it much easier to set parameters 
  133. for screen placement and also makes it a treat to build screens with the new 
  134. drawing and text commands; not only can you "unerase", but you can go back and 
  135. alter the drawing commands themselves before creating a file.
  136.  
  137. For the most part, FLICKER is compatible with PRESENT 1. Line numbers may be 
  138. used in place of labels in files, for example. Check your syntax, though. And, 
  139. while you're at it, check out the many new commands.
  140.  
  141.  
  142. O v e r v i e w 
  143.  
  144. The FLICKER program is a graphics command processor. Its primary function is to 
  145. provide a means for creating sequences of images and sound that may be used for 
  146. store displays, for instruction, or for business (or other) presentations. In 
  147. its current form, the program does contain limited facilities for creation of 
  148. image files. These features augment the basic display functions to create 
  149. interesting effects not possible in most "slideshow" presentation systems.
  150.  
  151. FLICKER reads image files which have been created using the popular BSAVE 
  152. format, as specified in Microsoft Basic. Many graphics packages capable of 
  153. creating and saving graphics in this format exist; to date, there have been few 
  154. attempts to create a system for using these files in a sophisticated 
  155.  
  156.                                      -- 3 --
  157. FLICKER  Documentation                                       by Brian J. Dooley
  158.  
  159.  
  160. presentation. FLICKER can also compress files to save space, and these files 
  161. can be read with ordinary processing commands.
  162.  
  163. The functions of FLICKER are more easily understood when compared with a slide 
  164. show. In this context, the ordinary graphics program is the camera--it creates 
  165. a slide, consisting of a single image. FLICKER acts as a projector, allowing 
  166. these slides to be linked together in a single presentation.
  167.  
  168. FLICKER allows you to be creative after your images have been made. Functions 
  169. that are supported include the following:
  170.  
  171.           Interactive Edit--you can create your FLICKER scripts and execute 
  172.           them at the same time.
  173.           
  174.           Limited Animation--rapid movement between screens can make the image 
  175.           appear to be animated.
  176.           
  177.           Zoom Capability--you can zoom in on any area of the screen, enlarging 
  178.           it to 2x its original size.
  179.           
  180.           Windowing--you can shrink an image to half its size and place it on 
  181.           the screen in any location; in fact, you can place as many such 
  182.           reduction windows on a screen as you want.
  183.           
  184.           Merge--you can merge two graphics screens into each other, to create 
  185.           an overlay effect.
  186.           
  187.           Horizontal Scroll--you can scroll left or right to create banner-like 
  188.           effects.
  189.           
  190.           Vertical Scroll--you can scroll up or down to present a continuously 
  191.           rolling "sheet".
  192.           
  193.           Looping--you can create loops of a given number of passes (like FOR--
  194.           NEXT in Basic).
  195.           
  196.           Key Trapping--you can make a given action dependent upon the 
  197.           operator's pressing of a key.
  198.           
  199.           Full Color Flexibility--you can change background colors and 
  200.           foreground palettes at will.
  201.           
  202.           Frame Sequencing--you can create sequences (including action) which 
  203.           can be switched forward and backwards on key.
  204.           
  205.           Reverse--you can reverse the background and foreground colors.
  206.           
  207.           Text entry--from within your command file, or from a separate ASCII 
  208.           text file.
  209.           
  210.           Drawing--you can actually draw lines, circles and boxes on screen 
  211.           from your command file.
  212.           
  213.           
  214.  
  215.                                      -- 4 --
  216. FLICKER  Documentation                                       by Brian J. Dooley
  217.  
  218.  
  219.           Wipes and Patterns--you can create interesting color textures on 
  220.           screen, and have the new screen open out from the sides, top, 
  221.           diagonal, or center.
  222.           
  223.           Cut and Paste--you can cut parts of screens, save them, and paste 
  224.           them onto other screens for animated effects. This can all be done 
  225.           from within your command file.
  226.           
  227.           Chaining, subroutines...and more--now you can keep a library of 
  228.           effects, and draw it into your present program...or reuse effects 
  229.           within your program.
  230.           
  231.           
  232. These effects are all obtainable because FLICKER allows you to create the 
  233. program. It operates on a text "script" that you create by using a simple and 
  234. easily understandable 'language'. The script can easily be changed through the 
  235. interactive edit capabilities provided, or through use of any ASCII text 
  236. editor. The new, interactive edit capability allows you to create screens and 
  237. test them from within the program itself--then write them to command files that 
  238. will run when you run the program. 
  239.  
  240.  
  241. S t a r t i n g   t h e   P r o g r a m 
  242.  
  243. There are several methods for starting and using FLICKER, as described under 
  244. the various available operating modes. The basic method is to call the program 
  245. from DOS. To run the demo, place the FLICKER disk in your A drive. Enter 
  246. FLICKER DEMO at the A> prompt. The demo will run from the Demo command file 
  247. from start to stop, then return to DOS. This this will provide a good overview 
  248. of the program. To create your own command files and screens, however, you need 
  249. to get to the Edit screen.
  250.  
  251. From DOS, enter FLICKER. This will call the "WorkScreen" to apppear. The 
  252. WorkScreen is FLICKER's basic entry screen; it is used to move between edit and 
  253. run modes, and obtain directories. Get the directory of your A drive, and check 
  254. to see that you have FLICKER.HLP available. Now, type E. This will bring you 
  255. into the Edit mode. The Edit mode is easy to recognize because it has a number 
  256. (1, in this case) on the lower left edge of the screen, and a question mark 
  257. followed by a dash on the second last line. This is the command line; the dash 
  258. is a partial cursor.
  259.  
  260. Now, press the F1 key. This will call the help screen. Since no commands have 
  261. been entered, the screen showing the command list and keys will appear. 
  262. Pressing any key will now return you to where you were in the Edit Mode. 
  263.  
  264. Try typing a command such as SHOW PIC1. Press the return (enter) key. The 
  265. FLICKER logo screen will appear, and the instruction pointer in the lower left 
  266. corner will display a two. Now enter WINDOW. Press the F1 key, and you will see 
  267. a complete description of how the WINDOW command is used. Press any key to 
  268. continue.
  269.  
  270. You should now be back in the Edit Mode, with the WINDOW command showing. 
  271. WINDOW is a command that permits use of the Box Edit mode to accurately place 
  272. your images. Press the F4 key. A large rectangle will appear; you can move this 
  273.  
  274.  
  275.                                      -- 5 --
  276. FLICKER  Documentation                                       by Brian J. Dooley
  277.  
  278.  
  279. to the location where you want the image to appear with the cursor keys. When 
  280. you have found a suitable location, press F4 again. Numbers will appear after 
  281. WINDOW, according to the syntax of that command. Press enter, and the current 
  282. screen image will be reduced and placed in that location.
  283.  
  284. Some Box Edit commands (CUT and the drawing commands) require another press of 
  285. the F4 key. In these cases, you select one location by moving the marker to the 
  286. first location, press F4, and move a second marker to a second location. 
  287. Pressing F4 a third time then returns you to the Command Line as before.
  288.  
  289. Press the F9 key--the previous command entered will appear. You can advance to 
  290. the next command with the F10 key. The F7 key deletes the current line; the F8 
  291. key inserts a new line. The F6 key will run your script from start; the F5 key 
  292. will store it in a file. F3 clears the memory, and F2 calls a new file.
  293.  
  294. In using this processor, you will find that the capability to go back a few 
  295. lines and manually change parameters is most helpful. You can also use the 
  296. CHAIN command within edit mode, providing a simple method of maintaining a 
  297. library of drawings.
  298.  
  299. Command files can be read and written within the Edit Mode by using the F6 and 
  300. F2 keys. When you press F2, you will be prompted with a request for a command 
  301. file to be read. Enter Demo. The Demo file will now be in memory. You can work 
  302. with this file, making changes with the bottom function keys (F7,F8,F9,F10) and 
  303. entering new commands. To save the new (changed) file, press the F5 key. You 
  304. will be prompted for the name of the file to be written. Enter demo2. You have 
  305. now created a FLICKER script, which may be used just as you originally called 
  306. the Demo file from DOS; or, you may return to the WorkScreen and run it by 
  307. specifying Run; or, you can run it directly from the Edit Mode by pressing F6. 
  308. F6 is generally used to check command files before writing them to memory, so 
  309. that you can make any necessary changes.
  310.  
  311. To leave the Edit Mode, press the Control key (Ctrl). Withou releasing this 
  312. key, press the END key (the '1' key on the numeric keypad). Since you started 
  313. FLICKER from the WorkScreen, this will return you to the WorkScreen. From the 
  314. WorkScreen, you can return to DOS by typing 'Q'; run a command file by pressing 
  315. 'R'; obtain a directory by entering 'D' followed by the size (s) or time (t) 
  316. parameter; or, you can call a new command file into memory by pressing 'W'.
  317.  
  318.   
  319. P r o c e s s i n g   M o d e s 
  320.  
  321. FLICKER is equipped with a variety of processing modes that provide the user 
  322. with considerable flexibility in creating and executing scripts. The basic 
  323. modes are Command Line, Work Screen, Run and Edit. Command Line processing 
  324. generally provides faster processing, and is suitable for short command 
  325. sequences or to make quick changes in a file. The Work Screen mode is the 
  326. "normal" mode; it permits movement to Run and Edit modes, provides various 
  327. services, and retains files in memory after processing. The Run mode is 
  328. actually a variation of the Command Line mode, and described in that section-- 
  329. it is used for final execution of a program file; it processes the file and 
  330. simply returns to DOS. The Edit mode permits you to change and execute program 
  331. files in memory.
  332.  
  333.  
  334.  
  335.                                      -- 6 --
  336. FLICKER  Documentation                                       by Brian J. Dooley
  337.  
  338.  
  339.  
  340.      Modes 
  341.      
  342.           Command Line
  343.           
  344.           Several processing types can be specified at the command
  345.           line (from DOS) by making entries after the program name:
  346.           FLICKER filename : Runs a command file immediately.
  347.           FLICKER *EDIT    : Opens program in Edit Mode.
  348.           FLICKER *command;command : Executes commands (128 chars).
  349.           -ALL Command Line options return to DOS; no file is created.
  350.           
  351.           
  352.           Run
  353.           
  354.           Run Mode may be specified from the Command Line (FLICKER
  355.           filename) or from the Work Screen. In this mode, the command
  356.           file is simply processed as-is. 
  357.           
  358.           
  359.             File Format 
  360.             
  361.             All FLICKER command files are straight ASCII text. Normally,
  362.             Commands are entered one per line, in upper or lower case
  363.             letters. For files used in the Run Mode, it is also possible
  364.             to separate commands by a semi-colon--except after the
  365.             last entry on a line. This is particularly convenient if
  366.             labels are used (@label; show b:filename).
  367.             
  368.             
  369.             Break Key 
  370.             
  371.             Ctrl-Break key or Control-C halt processing of command file.
  372.             
  373.             
  374.           Edit Mode
  375.           
  376.           Edit Mode permits entry, storage and execution of commands.
  377.           A complete set of function keys is provided for these func-
  378.           tions. From Edit Mode, you can move to Box Edit Mode to
  379.           place picture items on screen (F4). Edit Mode displays a
  380.           command entry line near the bottom of the screen. The number
  381.           of the current line is listed directly below.
  382.           
  383.           
  384.             Edit Keys 
  385.             
  386.             The following keys function only in Edit Mode:
  387.             
  388.             <Return>   : Executes command and moves to next line if not
  389.                           FRAME, ONKEY, or GOSUB.
  390.             <Ctrl-End> : Exits to Work Screen if in Workscreen mode, or
  391.                           to DOS if Edit Mode was entered from DOS.
  392.             <INS>      : Inserts characters without overwrite (toggle).
  393.             
  394.  
  395.                                      -- 7 --
  396. FLICKER  Documentation                                       by Brian J. Dooley
  397.  
  398.  
  399.             <DEL>      : Deletes character at current position.
  400.             cursor right, left : Move edit position on line.
  401.             <Backspace>: Deletes characters backwards.
  402.             C key      : in Box Edit, changes box color on press of        
  403.                cursor keys.
  404.             
  405.             Function Keys
  406.             
  407.             The following function keys are active in Edit Mode:
  408.             
  409.             F1  : Help                      F2  : Read Command File
  410.             F3  : Clear Memory              F4  : Box Edit switch
  411.             F5  : Write Memory to File      F6  : Run File in Memory
  412.             F7  : Delete Current Line       F8  : Insert Line
  413.             F9  : Go to Previous Line       F10 : Go to Next Line
  414.             
  415.             
  416.             Box Edit Mode
  417.             
  418.             Box Edit operates within the Edit Mode, when F4 is pressed
  419.             and the command line contains one of the following: CUT,
  420.             PASTE, WINDOW, ZOOM, BOX, CIRCLE, LINE, T=, TD=, C=. A box
  421.             of the appropriate side appears in the upper left corner.
  422.             This may be moved by cursor keys (including diagonals). For
  423.             some commands, two locations are specified (switch with F4).
  424.               When the location(s) have been marked on the screen, F4 is
  425.             pressed again. This places the appropriate parameters on the
  426.             command line for entry (or further editing) in Edit Mode.
  427.             Only the first part of the command need be typed before
  428.             pressing F4 : t=Flicker <F4> places x/y parameters on
  429.             command line--T=FLICKER 20/20--according location indicated.
  430.             
  431.             
  432.           
  433.           Work Screen
  434.           
  435.           The Work Screen is the normal first screen if FLICKER is run
  436.           without command line parameters. This screen provides direc-
  437.           tory services with size and time (s, t, st, or nothing). If
  438.           Work Screen Mode is on (i.e., you started from this screen),
  439.           termination (end of file, Ctrl-End, or Ctrl-Break) return
  440.           to Work Screen, with current file in memory.
  441.           
  442.           
  443.  
  444. T h e   C o m m a n d s 
  445.  
  446. In all cases, upper or lower case characters may be used. Each command must be 
  447. placed on a separate line, followed by up to two parameters. A single space 
  448. suffices to separate parameters and commands.
  449.  
  450. The FLICKER command set provides a wide variety of functions for use in display 
  451. and creation of presentation graphics sequences. For convenience, these 
  452. commands may be broken down into the following general groups:
  453.  
  454.  
  455.                                      -- 8 --
  456. FLICKER  Documentation                                       by Brian J. Dooley
  457.  
  458.  
  459.  
  460.      Controls:         Commands that provide program flow control, such as 
  461.                        processing halts, delays, subroutines, file chaining, 
  462.                        etc.
  463.  
  464.      File Routines:    Commands used to process files and perform such tasks as 
  465.                        file writing, file 'squeezing' and 'unsqueezing'.
  466.  
  467.      Music:            Commands used to play music files from FLICKER.
  468.  
  469.      Screen:           Commands used for processing screens, such as 
  470.                        directional movement, merge, reverse, etc.
  471.  
  472.      Screen Write:     Commands used to draw boxes, lines and circles and 
  473.                        create patterns on screen.
  474.  
  475.      Text Entry:       Commands used to enter text or characters on the screen,
  476.                        either directly, or from files.
  477.  
  478.      Wipes:            Commands used to bring new screens into old ones in a 
  479.                        wiping motion (i.e., rather than moving the old screen 
  480.                        out).
  481.  
  482. All of these commands and functions are described alphabetically below for 
  483. convenience.
  484.  
  485. ---------------------------------------------------------------------
  486.  
  487. Controls 
  488.  
  489.      @LABEL
  490.      
  491.      Syntax : @label
  492.      
  493.      Used with ONKEY, LOOP, GOSUB commands. A label is placed
  494.      on line to indicate a processing location (@thisplace).
  495.      
  496.      
  497.      CHAIN
  498.      
  499.      Syntax : chain filename
  500.      
  501.      Transfers control to chained command file, then returns
  502.      to next line. This allows previously created routines
  503.      to be called from within command file.
  504.      
  505.      
  506.      WAIT
  507.      
  508.      Syntax : wait n
  509.      
  510.      Halts processing for n milliseconds.
  511.      
  512.      
  513.      
  514.  
  515.                                      -- 9 --
  516. FLICKER  Documentation                                       by Brian J. Dooley
  517.  
  518.  
  519.      FRAME
  520.      
  521.      Syntax : frame
  522.      
  523.      Halts display until + or - keys are hit. The + key continues
  524.      processing at next line; the - key resumes processing at
  525.      line after previous frame command. This command is used to
  526.      create 'slide sequences' (which may include action) that
  527.      can be reviewed or move forward.
  528.      
  529.      
  530.      GOSUB
  531.      
  532.      Syntax : gosub @label
  533.      
  534.      Goes to subroutine referenced by label, and returns to next
  535.      line when RETURN command is encountered.
  536.      
  537.      
  538.      LOOP
  539.      
  540.      Syntax : loop @label n
  541.      
  542.      Actually, a goto statement. Line number may be substituted
  543.      for label. Processing returns to indicated line, n times if
  544.      n parameter is included (otherwise, always).
  545.      
  546.      ONKEY
  547.      
  548.      Syntax : onkey p @label
  549.      
  550.      A line number may be substitute for label. Any ASCII string
  551.      prefaced by @ can be used as a label, and placed on line to
  552.      move to. Default without label or line number holds pro-
  553.      cessing until parameter (letter) key is pressed. With line
  554.      number or label, processing moves to indicated line if
  555.      letter, and there is no hold (i.e., must be used in loop).
  556.      
  557.      
  558.      RETURN
  559.      
  560.      Syntax : return
  561.      
  562.      Returns processing to next line at end of subroutine
  563.      (GOSUB command).
  564.      
  565.      ---------------------------------------------------------------------
  566.  
  567.  
  568.                                     -- 10 --
  569. FLICKER  Documentation                                       by Brian J. Dooley
  570.  
  571.  
  572.  
  573. File Routines
  574.  
  575.      SQUEEZE
  576.      
  577.      Syntax : squeeze filename1 filename2
  578.      
  579.      Compresses file1 (filename1) and places results in file2
  580.      (filename2).
  581.      
  582.      
  583.      UNSQUEEZE
  584.      
  585.      Syntax : unsqueeze filename1 filename2
  586.      
  587.      Takes compressed file1 (filename1) and expands it to normal
  588.      picture file size, placing the result in file2 (filename2).
  589.      All picture file commands (SHOW, LEFT, etc.) recognize
  590.      squeezed files and process them to screen, but there is a
  591.      delay for processing.
  592.      
  593.      
  594.      WRITE
  595.      
  596.      Syntax : write filename
  597.      
  598.      Writes current screen to file indicated by filename.
  599.      
  600.      ---------------------------------------------------------------------
  601.  
  602. Music 
  603.  
  604.      PLAY
  605.      
  606.      Syntax : play filename
  607.      
  608.      Plays music file (filename). Processing does not continue
  609.      while music plays. Files can be created with BLUES public
  610.      domain music program.
  611.      
  612.      If a music file generator is not available, an ASCII file 
  613.      with the following format will do:
  614.      
  615.      1 note per line, followed by a return.
  616.      
  617.       tempo  duration (inverse) 
  618.       / /    //
  619.      12345678901
  620.           \    \\
  621.            \    note, and suffix (A#,Ab)
  622.          octave
  623.           (1-8)
  624.      
  625.      ---------------------------------------------------------------------
  626.  
  627.  
  628.                                     -- 11 --
  629. FLICKER  Documentation                                       by Brian J. Dooley
  630.  
  631.  
  632.  
  633. Screen 
  634.  
  635.      CLEAR
  636.      
  637.      Syntax : clear
  638.      
  639.      Clears current screen and all screen buffers.
  640.      
  641.      
  642.      COLOR
  643.      
  644.      Syntax : color n m
  645.      
  646.      Turns on palette n, background color m. Changes colors of
  647.      current screen.
  648.      
  649.      
  650.      DOWN
  651.      
  652.      Syntax : down filename
  653.      
  654.      Moves the specified file (filename) onto the screen from the
  655.      top while moving the existing screen off the bottom. Useful
  656.      for creating moving banners.
  657.      
  658.      
  659.      LEFT
  660.      
  661.      Syntax : left filename
  662.      
  663.      Moves the specified file (filename) onto the screen from the
  664.      right, while moving the existing screen off the left. Useful
  665.      for creating moving banners.
  666.      
  667.      
  668.      MERGE
  669.      
  670.      Syntax : merge filename
  671.      
  672.      Merges file (filename) into current screen, using logical
  673.      OR statements.
  674.      
  675.      
  676.      REVERSE
  677.      
  678.      Syntax : reverse
  679.      
  680.      Takes current screen and reverses all colors.
  681.      
  682.      
  683.  
  684.                                     -- 12 --
  685. FLICKER  Documentation                                       by Brian J. Dooley
  686.  
  687.  
  688.  
  689.      RIGHT
  690.      
  691.      Syntax : right filename
  692.      
  693.      Moves the specified file (filename) onto the screen from the
  694.      left, while moving the existing screen off the right. Useful
  695.      for creating moving banners.
  696.      
  697.      
  698.      SHOW
  699.      
  700.      Syntax : show filename n
  701.      
  702.      Brings file (filename) onto screen, holding it there for n
  703.      milliseconds in addition to processing time. Default, with
  704.      n not entered, is 2000 (2 seconds).
  705.      
  706.      
  707.      UP
  708.      
  709.      Syntax : up filename
  710.      
  711.      Moves the specified file (filename) onto the screen from the
  712.      bottom, while moving the existing screen off the top. Useful
  713.      for creating moving banners.
  714.      
  715.      
  716.      WINDOW
  717.      
  718.      Syntax : window filename x/y
  719.      
  720.      Shrinks file (filename) to one half its size, and places
  721.      results in quarter of current screen whose upper left hand
  722.      corner is x/y.
  723.      
  724.      window x/y  (no filename) shrinks current screen and places
  725.      it at specific location in current screen.
  726.      
  727.      
  728.      ZOOM
  729.      
  730.      Syntax : zoom filename x/y
  731.      
  732.      Expands the quarter of file (filename) whose upper left
  733.      corner is at location x/y (i.e., 10/20), and writes directly
  734.      to the screen.
  735.      
  736.      zoom x/y (no filename) zooms current screen from location
  737.      specified and writes result to current screen.
  738.      
  739.      ---------------------------------------------------------------------
  740.  
  741.  
  742.                                     -- 13 --
  743. FLICKER  Documentation                                       by Brian J. Dooley
  744.  
  745.  
  746.  
  747. Screen Write 
  748.  
  749.      BOX
  750.      
  751.      Syntax : boxn x1/y1 x2/y2
  752.      
  753.      Writes box on screen in color indicated by n (box1=color 1),
  754.      where x1/y1 is the upper left corner, and x2/y2 is lower
  755.      right corner (360 x 200 matrix).
  756.      
  757.      
  758.      CIRCLE
  759.      
  760.      Syntax : circlen x1/y1 x2/y2
  761.      
  762.      Writes circle on screen in color indicated by n (circle1 =
  763.      color 1) where x1/y1 is the upper left, and x2/y2 is lower
  764.      right end of circle's diameter (360 x 200 matrix).
  765.      
  766.      
  767.      CUT
  768.      
  769.      Syntax : cut filename x1/y1/x2/y2
  770.      
  771.      Cuts a portion from current screen, with upper left corner
  772.      at x1/y1 and lower right at x2/y2. Writes result to file
  773.      (filename). Cut files are retrieved only with PASTE command.
  774.      Uses 80 x 100 matrix.
  775.      
  776.      LINE
  777.      
  778.      Syntax : linen x1/y1 x2/y2
  779.      
  780.      Writes line on screen in color indicated by n (line1 =
  781.      color 1) where x1/y1 is the upper left, and x2/y2 is lower
  782.      right (360 x 200 matrix).
  783.      
  784.      
  785.      PASTE
  786.      
  787.      Syntax : paste filename x/y
  788.      
  789.      Paste file (filename) formerly created with CUT command to
  790.      location pointed to by x/y (upper left corner). Uses 80 x
  791.      100 matrix.
  792.      
  793.      
  794.  
  795.                                     -- 14 --
  796. FLICKER  Documentation                                       by Brian J. Dooley
  797.  
  798.  
  799.  
  800.      PATTERN
  801.      
  802.      Syntax : pattern nnnn mmmm
  803.      
  804.      Writes pattern of colors to screen, where each parameter (m,
  805.      n) is a color between 0 and 3. Patterns are on alternate
  806.      lines, across screen (n above) as follows:
  807.      pattern 1203 3132 = 1203120312031203...
  808.                          3132313231323132... (colors)
  809.      
  810.      ---------------------------------------------------------------------
  811.  
  812. Text Entry 
  813.  
  814.      C=
  815.      
  816.      Syntax : c=n m x/y
  817.      
  818.      Writes ASCII character number n to screen at x/y location
  819.      in color m, at screen location x/y (40 x 25 matrix).
  820.      
  821.      
  822.      T=
  823.      
  824.      Syntax : t=word n x/y
  825.      
  826.      Writes character string (word) to current screen in color n,
  827.      left to right from location x/y (40 x 25 matrix).
  828.      
  829.      
  830.      TD=
  831.      
  832.      Syntax : td=word n x/y
  833.      
  834.      Works like T= command, only text goes down instead of left
  835.      to right.
  836.      
  837.      
  838.      TEXT
  839.      
  840.      Syntax : text filename n
  841.      
  842.      Writes ASCII file (filename) to screen in color n. The
  843.      text file can be created by any editor producing ASCII
  844.      format, and should be no more than 40 characters across
  845.      and 24 lines down.
  846.      
  847.      ---------------------------------------------------------------------
  848.  
  849.  
  850.                                     -- 15 --
  851. FLICKER  Documentation                                       by Brian J. Dooley
  852.  
  853.  
  854.  
  855. Wipes 
  856.  
  857.      CENTEROUT
  858.      
  859.      Syntax : centerout filename
  860.      
  861.      Brings file (filename) into current screen, all directions
  862.      from center.
  863.      
  864.      
  865.      DIAGONAL
  866.      
  867.      Syntax : diagonal1 filename
  868.      
  869.      Works like WIPE command, only files enter from corners and
  870.      move in diagonally. The parameter (p) specifies the corner
  871.      numerically, clockwise from upper left (diagonal1, diagonal2
  872.      diagonal3, diagonal4).
  873.      
  874.      
  875.      DISSOLVE
  876.      
  877.      Syntax : dissolve filename
  878.      
  879.      Dissolves current screen, and writes file (filename) to
  880.      screen.
  881.      
  882.      
  883.      WIPE
  884.      
  885.      Syntax : wipeu filename
  886.      
  887.      Brings file (filename) into current screen, in direction
  888.      indicated by parameter (p). The following parameters may
  889.      be used : U = up, D = down, L = left, R = right (wipeu,
  890.      wiped, wipel, wiper).
  891.      
  892.      ---------------------------------------------------------------------
  893.      
  894.  
  895.                                     -- 16 --
  896. FLICKER  Documentation                                       by Brian J. Dooley
  897.  
  898.  
  899. C a p a b i l i t i e s 
  900.  
  901. USE IN DIFFERENT ENVIRONMENTS
  902.  
  903. FLICKER contains special features for use in specific environments. In writing 
  904. a FLICKER script, you should focus upon the types of effects that will be most 
  905. useful in the intended context.
  906.  
  907. IN-STORE DISPLAYS
  908.  
  909. Store displays using FLICKER can be particularly effective. In this 
  910. environment, the loop command is particularly useful. A complete script can be 
  911. written using the absolute looping function (LOOP 1) at the end. Once the 
  912. presentation is finished, it will then begin again at the first line, and run 
  913. continuously. Within the absolute loop, numbered loops can be used to provide 
  914. animation, or to repeat information screens.
  915.  
  916. An in-store display for a software store, for example, might begin with a 
  917. banner identifying the store:
  918.  
  919.           show file1 0
  920.           left file2
  921.           left file3
  922.  
  923. It might then go on to show a screen depicting the names of popular products 
  924. available in the store:
  925.  
  926.           show file4
  927.           show file5
  928.           
  929. The last screen could be emphasized through rapid shifts through colors and 
  930. backgrounds:
  931.  
  932.           color 5 3
  933.           delay 100
  934.           color 4 2
  935.           delay 100
  936.           color 0 1
  937.           
  938. Pictures of various product types (icons) could be shown in the four quadrants 
  939. of a screen; each quadrant could then be zoomed for emphasis:
  940.  
  941.           show file6
  942.           zoom 0 0
  943.           zoom 40 0
  944.           zoom 0 50
  945.           zoom 40 50
  946.           
  947.  
  948.  
  949.                                     -- 17 --
  950. FLICKER  Documentation                                       by Brian J. Dooley
  951.  
  952.  
  953. An animation effect could then be created to demonstrate, say communications 
  954. between two terminals using a popular communications package:
  955.  
  956.  
  957.           @mark
  958.           show d:file7 0
  959.           show d:file8 0
  960.           show d:file9 0
  961.           loop @mark 3       
  962.           
  963.           (d: is assumed to be a RAM drive, line 16 is the first line in this 
  964.           sequence)
  965.  
  966. This could be followed by a final screen, some concluding music, and a return 
  967. to line1 :
  968.  
  969.           show file10 0
  970.           play starspang
  971.           loop @top
  972.           
  973.           
  974. BUSINESS PRESENTATIONS
  975.  
  976. Business presentation require a somewhat different type of script. Here, the 
  977. primary command used is the Frame command. This is important, because it allows 
  978. review of material covered previously.
  979.  
  980. Most business presentations will also rely heavily upon charts and graphs, 
  981. which may be created by saving screens from integrated programs (Lotus 1-2-3, 
  982. or SuperCalc 3, principally). Other graphics programs may also be used. In many 
  983. cases, it makes good sense to mix the straight analytical graphics of an 
  984. integrated program or business graphics program with straight presentation 
  985. material containing illustrations and/or text.
  986.  
  987. A business presentation may begin with a title screen, followed shortly by an 
  988. extended list of the points to be covered, within a frame context:
  989.  
  990.           frame
  991.            show file1
  992.            up file2
  993.            up file3
  994.           frame
  995.           
  996. In this case, file1 contains the introductory material--who is presenting, and 
  997. what the presentation is about. Files 2 and 3 contain points that are to be 
  998. covered. The presentation begins when the presenter presses the '+' key, and 
  999. stops with file3 on screen until '+' is pressed again.
  1000.  
  1001. Next, the presenter may wish to show a chart of business activities, as created 
  1002. by a business graphics or integrated spreadsheet program. Because these graphs 
  1003.  
  1004.                                     -- 18 --
  1005. FLICKER  Documentation                                       by Brian J. Dooley
  1006.  
  1007.  
  1008. are small, he (or she) may wish to switch to an enlargement--as a separate 
  1009. frame:
  1010.  
  1011.            show file3
  1012.           frame
  1013.            zoom 30,50
  1014.           frame
  1015.           
  1016. This allows the audience to view a selected portion of the chart in greater 
  1017. detail. Next, the presenter may wish to show a frame that contains an extended 
  1018. bar chart--two screens across:
  1019.  
  1020.  show file5
  1021.  left file6
  1022. frame
  1023.  
  1024. The presenter may then wish to reiterate initial points--this time, without the 
  1025. scroll:
  1026.  
  1027.            show file2
  1028.           frame
  1029.            show file3
  1030.           frame
  1031.           
  1032.           
  1033. Of course, colors could be changed during the presentation, specific points 
  1034. could be zoomed in upon (provided they occupied quadrants of the screen), and 
  1035. some animation effects could be used.
  1036.  
  1037. TRAINING PRESENTATIONS
  1038.  
  1039. FLICKER can be particularly useful in training presentations, because it allows 
  1040. actions to be demonstrated on screen, in addition to providing capability to 
  1041. show a set of graphic screens. 
  1042.  
  1043. As with business presentations, training presentations are mainly dependent 
  1044. upon the frame command, which allows switching back and forth between screens. 
  1045. Within training frames, animation effects can be used to demonstrate effects of 
  1046. actions. A helpful feature here is the Onkey command, which allows switching to 
  1047. the next screen--within a frame--either on any key being pressed, or on the 
  1048. pressing of a specific key.
  1049.  
  1050. Therefore, a demonstration of spreadsheet usage may contain 3 screens, each one 
  1051. showing effects of an action. Present's screen creation is very fast, so 
  1052. pressing a key makes it appear as though that key is directly responsible for 
  1053. an entry on the screen:
  1054.  
  1055.           frame
  1056.            show file1 0
  1057.            onkey
  1058.            show file2 0
  1059.            onkey
  1060.            show file3 0
  1061.           frame
  1062.           
  1063.  
  1064.                                     -- 19 --
  1065. FLICKER  Documentation                                       by Brian J. Dooley
  1066.  
  1067.  
  1068.  
  1069. The Onkey command can also be made dependent upon entry of a specific letter, 
  1070. but this feature is only really relevant in special cases--such as in an 
  1071. interactive system, where pressing the letter specifying the correct answer 
  1072. results in continuation of the program.
  1073.  
  1074.  
  1075. EFFECTS
  1076.  
  1077. Many interesting effects are available through creative use of FLICKER 
  1078. commands. Some of these effects are built into the system. Following are sample 
  1079. scripts to produce special effects.
  1080.  
  1081. ANIMATION
  1082.  
  1083. Animation is best done by placing the graphics files that you will be using on 
  1084. a RAM disk; the effect works when floppy or hard disks are used, but it tends 
  1085. to be slow. An animation script appears as follows:
  1086.  
  1087.             @top
  1088.             show file1 0
  1089.             show file2 0
  1090.             show file3 0
  1091.             show file4 0
  1092.             loop @top 10
  1093.             
  1094.             
  1095. The show commands indicate that each file is to be shown for 0 milliseconds; 
  1096. the sequence is then looped through 10 times. Files 1-4 contain images which, 
  1097. when shown rapidly in sequence, create an animation effect. 
  1098.  
  1099. BANNERS
  1100.  
  1101. Interesting banners of any length can be created. To develop a banner, use your 
  1102. graphics program to write large letters on the screen; take the letters as 
  1103. close as possible to the right edge of the screen and continue the banner on 
  1104. the next screen:
  1105.  
  1106.              ______  ______  ______
  1107.             |      ||      ||      |
  1108.             |   GRA||PHICS ||      |
  1109.             | PRESE||NTATIO||N     |
  1110.             |______||______||______|
  1111.             screen  screen  screen
  1112.                1       2       3
  1113.  
  1114. To show the banner, the following script would be used:
  1115.  
  1116.           show file1 0
  1117.           left file2
  1118.           left file3
  1119.           
  1120. This brings up file1 (screen 1) for the minimal period of time, then scrolls in 
  1121. screens (files) 2 and 3 from right to left.
  1122.  
  1123.  
  1124.                                     -- 20 --
  1125. FLICKER  Documentation                                       by Brian J. Dooley
  1126.  
  1127.  
  1128. SEQUENCE PLANNING
  1129.  
  1130. To plan FLICKER sequences, you can write a script that shows several screens at 
  1131. once, through use of the Window command. Thus, the following script:
  1132.  
  1133.           screen off
  1134.           show file1
  1135.           window 0 0
  1136.           show file2
  1137.           window 40 1
  1138.           show file3
  1139.           window 40 50
  1140.           show file4
  1141.           window 0 50
  1142.           
  1143. This short script places the four screens specified at each quadrant of the 
  1144. screen, in clockwise direction. This feature can aid in planning placement of 
  1145. screens within a presentation sequence. The screen off feature is important, 
  1146. because in this case, the show command is used simply to get the required 
  1147. screen. If the screen were on, each show command would overlay the existing 
  1148. screen, and windowing would be lost.
  1149.  
  1150. PRESENTATION FRAMES
  1151.  
  1152. The Frame command is most helpful when it is used to organize presentation 
  1153. material. In writing scripts for a presentation, you will find it best to 
  1154. offset the Frame command slightly from the rest of the commands, for easy 
  1155. identification of sequences:
  1156.  
  1157.           frame
  1158.             show file1
  1159.           frame
  1160.             show file2 0
  1161.             left file3
  1162.             left file4
  1163.           frame
  1164.             clear
  1165.             color 1 3
  1166.             show file5
  1167.           frame
  1168.           
  1169. By allowing movement backwards and forwards between sequences ('+' and '-' 
  1170. keys), the frame command also allows you to go back and review material within 
  1171. a presentation. Such repetition works effectively as an aid to recall (show-
  1172. explain-show).
  1173.  
  1174.  
  1175.                                     -- 21 --
  1176. FLICKER  Documentation                                       by Brian J. Dooley
  1177.  
  1178.  
  1179. C a r e   i n   P r e p a r a t i o n 
  1180.  
  1181. It is important to bear in mind that the FLICKER program is merely a tool. It 
  1182. is easy to get carried away with computer graphics, because they are fun to 
  1183. create and provide many interesting possibilities. FLICKER will contribute to 
  1184. graphics flexibility by providing a powerful projector for image files.
  1185.  
  1186. In preparing a presentation, always remember that you are attempting to make a 
  1187. point--whether it be for sales, for training, or for a business report. The 
  1188. point, not the graphics, must come first. This means that effects should not be 
  1189. used simply to "wow" the audience. There must be a reason for each screen used, 
  1190. and sufficient supporting material to make the point.
  1191.  
  1192. T e c h n i c a l   N o t e s 
  1193.  
  1194. FLICKER uses graphics files that have been created in the BSAVE format used 
  1195. with Microsoft Basic. In this format, the screen is essentially dumped into a 
  1196. file, which is about 16K in length (there are variations). Graphics programs 
  1197. generally permit this as an option, though it may not be their standard method 
  1198. of saving files. To identify a BSAVE file, simply look for a picture file of 
  1199. 16K or more, since BSAVE options tend to create relatively long files of a 
  1200. standard length.
  1201.  
  1202. Although it does tend to take up a lot of space, the BSAVE format was used to 
  1203. speed execution and provide immediate (rather than drawn) screens. This was 
  1204. necessary due to the intensive processing required for many of the FLICKER 
  1205. functions. The built-in file compression functions will enable you to use fewer 
  1206. disks, but unsqueezing a file does take time--so you should continue to use 
  1207. BSAVE files where speed is essential.  All animation sequence files should be 
  1208. kept on a RAM disk. Use of a RAM disk provides negligible speed advantages for 
  1209. other functions, since they are processor dependent.
  1210.  
  1211. The maximum number of command lines that can be included in a FLICKER script is 
  1212. 500; the maximum number of loops is 100; the maximum allowable frames is 100.
  1213.  
  1214. For those who work within an operating system environment such as TopView or 
  1215. Gem, it should be noted that this program writes directly to screen memory. The 
  1216. speed and effects required made this absolutely necessary. T
  1217.  
  1218.  
  1219.                                     -- 22 --
  1220. FLICKER  Documentation                                       by Brian J. Dooley
  1221.  
  1222.  
  1223.                                                            
  1224. USER SUPPORTED SOFTWARE
  1225.  
  1226. FLICKER is distributed under the user supported software concept. This means 
  1227. that you are encouraged to copy and distribute this program to others, with the 
  1228. sole proviso that this message be included. 
  1229.  
  1230. If you find this program useful, we request that you send a check for $25 to 
  1231. the following address:
  1232.  
  1233.                                  BRIAN J. DOOLEY
  1234.                               14 Northgate Village
  1235.                               Burlington, NJ 08016
  1236.  
  1237. A contribution of this amount will entitle you to support, notices of new 
  1238. releases, and insure that development of this much-needed software will 
  1239. continue.  In some cases, source code will also be released.
  1240.  
  1241. To register your copy, complete the following form:
  1242.  
  1243. Name     __________________________________   Phone ____________________
  1244.  
  1245. Company  __________________________________
  1246.  
  1247. Address  __________________________________
  1248.  
  1249. City     ___________________  State ______________   Zip _______________
  1250.  
  1251.  
  1252. To guide us in enhancing this software, please also answer the following 
  1253. questions:
  1254.  
  1255. 1.)  In what setting is FLICKER being used ? (Personal, Institutional)
  1256.      
  1257.      _______________________________________________________________________
  1258.  
  1259. 2.)  What form of presentation is FLICKER supporting ? (training, educational, 
  1260.      in-store display, trade show, etc.)
  1261.  
  1262.      _______________________________________________________________________
  1263.  
  1264. 3.)  What software are you using to create your FLICKER image files ?
  1265.  
  1266.      _______________________________________________________________________
  1267.  
  1268. 4.)  Are you using the music function ?
  1269.  
  1270.      _______________________________________________________________________
  1271.  
  1272. 5.)  What type of plotter/printer do you use?
  1273.  
  1274.      _______________________________________________________________________
  1275.  
  1276.  
  1277.                                     -- 23 --
  1278. FLICKER  Documentation                                       by Brian J. Dooley
  1279.  
  1280.  
  1281.  
  1282. 6.)  Do you use an enhanced graphics card ?  If so, which one ?
  1283.  
  1284.      _______________________________________________________________________
  1285.  
  1286. 7.)  What features do you feel we should add to this program ? 
  1287.  
  1288.      _______________________________________________________________________
  1289.  
  1290.  
  1291. Thank you. We hope that you enjoy FLICKER, and look forward to serving your 
  1292. needs in future.