home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computing 68 / ac068a.adf / take2.lzh / SPlayer.doc < prev    next >
Text File  |  1992-01-07  |  9KB  |  198 lines
  1.                       *********************************
  2.    20/12/91           *                               *
  3.                       *  S C E N E P L A Y E R  V1.0  *
  4.                       *                               *
  5.                       *********************************
  6.  
  7.  
  8.     Sceneplayer V1.0 is written by G. Vergauwe (alias Flipper from STORMS)
  9.  
  10.  
  11.     General information
  12.     -------------------
  13.  
  14.     Sceneplayer is Public Domain and may be freely spread(on condition that
  15.     this text is always included and only a nominal fee is asked for it).
  16.  
  17.     ScenePlayer is conceived as a utility to allow users of the 'Take 2'-
  18.     package to distribute their animations without violating any software
  19.     copyrights. It can be used without the 'Take 2' software by creating
  20.     the scriptfiles, normally output by the program, manualy in any ASCII
  21.     texteditor. It is obvious that this method is more errorprone and has
  22.     to be tested by trial and error, rather than in an interactive way
  23.     which is one of the strong points of the 'Take 2' software...
  24.  
  25.  
  26.     About TAKE 2
  27.     -------------
  28.  
  29.     Take-2 is an animation program that runs on all Amiga models.
  30.     Its main purpose is to create animations from several elements, made
  31.     within the program or imported from another, in a very flexible way.
  32.     The concept is modeled after the procedure followed in a traditional
  33.     animationstudio, and it can therefore be used to simulate such work-
  34.     method. You could say it is an animationstudio at home.
  35.     You can digitize your drawnings from within the program (rostrumcamera),
  36.     create and edit the timing (exposuresheet), use multiple layers (cells)
  37.     synchronize sound (editingtable) and view your animation (projection)
  38.     in real time. Many professional animators and animationstudents contri-
  39.     buted to the concept, making it the most animator tailored program on
  40.     any personal computer.
  41.  
  42.     It is programmed by Geert Vergauwe (a professional animator himself),
  43.     distributed by Rombo, Scotland and costs around £100. For more infor-
  44.     mation look for the advertisements from Rombo in the Amiga magazines.
  45.  
  46.  
  47.     Preparing a Scene
  48.     -----------------
  49.  
  50.     What is a Scene ?
  51.  
  52.     A Take-2 scene is a collection of all files needed to play an ani-
  53.     mation. All files need to be in the same directory, in order to be
  54.     found. The name of this directory is the name of the Scene.
  55.     A Scene consists of an .xsht-file, all pictures used in it, and an
  56.     optional .trck-file. Samples may be stored in another directory.
  57.  
  58.     The .xsht file:
  59.  
  60.         This is an ASCII textfile, containing the name of the pictures
  61.         to be shown in each level for every frame. The end of a frame is
  62.         marked by a linefeed character (ENTER or RETURN key). Thus the
  63.         next frame starts on a new line.
  64.         Each frame will be displayed 1/25th of a second. You must there-
  65.         fore repeat imagenames on succesive lines to have them displayed
  66.         longer on screen. Most often this will be 2 or 3 times.
  67.         If you use more than one picture on a frame (layer/unionskin),
  68.         you must separate each picturename by spaces or tabs.
  69.         The .xsht-extension is required for the file to be recognized.
  70.  
  71.         example: pic_1A  pic_1B  pic_1C     > 3 levels of animation
  72.                  pic_1A  pic_1B  pic_1C     > repeat image for 1/25"
  73.                  pic_2A  pic_2B  pic_2C     > next layered image
  74.  
  75.     The picturefiles:
  76.  
  77.         All pictures used in the .xsht-file must have the same resolution
  78.         and reside in the scene-directory. If a picture is not found, the
  79.         previous image in the same level will be displayed to keep the
  80.         timing and sound synchronisation correct.
  81.         Only standard IFF-ILBM pictures, as are used by almost all graphics
  82.         packages for the Amiga, can be loaded. All current Amiga resolutions,
  83.         including HAM and EHB, are supported.
  84.         No special extension is required for these files to be recognized.
  85.  
  86.     The .trck-file:
  87.   
  88.         This is also an ASCI textfile, which can be created and altered in
  89.         any texteditor or wordprocessor. It consists of keywords followed
  90.         by parameters. Two keywords are used (SMP,SND) which must be at the
  91.         start of a new line, but may be proceeded by spaces or tabs.
  92.         All parameters must be separated by one or more spaces or tabs.
  93.         The .trck-extension is required for the file to be recognized.
  94.  
  95.         The SMP keyword must be followed by the name of a sample on disk,
  96.         which will be loaded in memory. This sample will be used by the
  97.         following SND keys, until another SMP key is used.
  98.         Use absolute disknames (such as Demo:) rather than logical device-
  99.         names (such as DF0:) to be sure that the samples can be located on
  100.         any system.
  101.  
  102.         example: SMP DemoDisk:Samples/effect
  103.  
  104.         The SND keyword must be followed by 6 nummeric parameters, separated
  105.         by spaces or tabs, in a defined order, as described hereafter.
  106.         Each SND will use the last loaded sample for data and calculations.
  107.  
  108.         the required parameters are:
  109.         1. frame:   The position in 25ths/second where the sound should start.
  110.         2. channel: Which of the four Amiga soundchannels should be used.
  111.         3. length:  How long in 25ths of a second it must be played, at most.
  112.         4. pitch:   At witch speed it must be played (depends on the sample).
  113.         5. volume:  How loud it must be played (64 is maximum volume).
  114.         6. repeat:  How many times the sound should be repeated (0=until next)
  115.  
  116.         example:     SMP Stormsdemo:Stormssound/Cat.smp
  117.                      SND   25 1   16  300   32    1
  118.                      SND  128 2   13  250   64    3
  119.  
  120.         first SND:   starting image   =  25
  121.                      channel          =   1
  122.                      number of images =  16
  123.                      pitch            = 300
  124.                      volume           =  32
  125.                      number of repeat =   1 time
  126.         second SND:  starting image   = 128
  127.                      channel          =   2
  128.                      number of images =  13
  129.                      pitch            = 250
  130.                      volume           =  64
  131.                      number of repeat =   3 times
  132.  
  133.     NOTE: The TAKE 2 software generates .xsht and .trck files automaticaly !
  134.  
  135.  
  136.     Using the ScenePlayer
  137.     ---------------------
  138.  
  139.     The sceneplayer can be started for the CLI or from the Workbench.
  140.     Although it will mostly be used to create standalone animation disks,
  141.     and thus be launched from the startup-sequence (CLI), a Workbench
  142.     interface has been provided, mainly for aiding the preparation of such
  143.     an animation disk.
  144.  
  145.     From WorkbBench: 
  146.     Simply doubleclick on the ScenePlayer icon to start the program from
  147.     WorkBench. A window will appear, allowing to type in the name of the
  148.     Scene in a stringgadget and to set any desired options with the toggle-
  149.     gadgets. Pressing ENTER in the stringgadget or clicking on PROCEED will
  150.     load and display the Scene.
  151.  
  152.     From CLI/Shell/startup-sequence:
  153.     Type ScenePlayer followed by the scenename and parameters (optional) to
  154.     start from CLI or a batchfile. All parameters must be separated by spaces
  155.     or tabs and are preceded by a '-' character. You may use Run or Runback
  156.     to launch the program and allow the batchfile to proceed.
  157.  
  158.     Options:
  159.  
  160.     Once:   Play the Scene once and quit (otherwhise it loops until stopped).
  161.     Turbo:  Play the Scene as fast as possible (depends on processor).
  162.     Dbuff:  Use double-buffering to get rit of screentrashing (filty images). 
  163.     Slide:  Wait for mouseclick for each frame (LMB=forward/RMB=backward).
  164.     NoPtr:  Hide mousepointer while playing the Scene.
  165.     Flter:  Disable the audiofilter to obtain clearer sound.
  166.  
  167.     Use the first letter of the option preceeded with '-' to use options as
  168.     parameters when using the CLI or a batchfile.
  169.  
  170.         example: SYS:ScenePlayer StormsDemo:SmallStorms -d -p -f
  171.                  launch program        scenename         options
  172.  
  173.     An aditional option is available when using ScenePlayer from CLI.
  174.     The -e parameter will cause the animation to be played forever. It can
  175.     then only be stopped by resetting or turning of the computer. This fea-
  176.     ture has been added to allow stores to display demos, without them being
  177.     stopped by customers pushing keys or mousebuttons.
  178.  
  179.  
  180.     Last important notes
  181.     --------------------
  182.  
  183.     * Some parameters don't go together, for example -s and -t.
  184.  
  185.     * Press any key or mousebutton to exit (only keys while using s-option).
  186.  
  187.     * When using sceneplayer V1.0, all pics and sounds are loaded in memory.
  188.       Keep in mind that pictures are usualy compressed when stored on disk
  189.       and take up more space when held in memory !
  190.  
  191.  
  192.     Text written by Ratt and Flipper
  193.  
  194.     Our adress: STORMS
  195.                 PB 24
  196.                 9032 WONDELGEM
  197.                 BELGIUM  
  198.