home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d03xx / d0300.lha / TitleGen / TitleGen.DOC < prev    next >
Text File  |  1989-12-25  |  7KB  |  183 lines
  1.                         TitleGen 1.6 Crawling Titler
  2.                         ----------------------------
  3.                              Copyright (c) 1989
  4.                                by Kevin Kelm.
  5.  
  6.                              S H A R E W A R E
  7.       
  8.    TitleGen is ShareWare.  No guarantee is made, expressed or implied as
  9. to TitleGen's suitability for any application.  Not responsible for the
  10. results of the use (or misuse) of TitleGen.
  11.  
  12. I.    What IS TitleGen?
  13.  
  14.       TitleGen is a program I wrote to title videos through a Genlock
  15. Device using the Amiga.  Like no other Amiga program that I am aware of,
  16. TitleGen implements the bottom-to-top "Rolling Credits" that are used at
  17. the end of productions.  Using a very easy-to-learn script format, you can
  18. generate complex title sequences.
  19.  
  20.       SYSTEM REQUIREMENTS:
  21.  
  22.          - An Amiga computer.  This part is essential!  :-)
  23.          - At least 512K.  256K might work too, but as memory goes,
  24.            the more the merrier!!!
  25.          - a Genlock Device is suggested but not essential.  Production
  26.            without a Genlock would be like programming without a
  27.            language, but hey-- whatever works.
  28.  
  29.  
  30. II.   Ok, Howzit work?
  31.  
  32.       TitleGen is designed to make the most of the CPU as possible.
  33. Therefore, it is NOT designed to work in a multi-tasking environment.  In
  34. fact, TitleGen will take measures to even lock out the workbench screen.
  35. This will render Left-Amiga-M & N useless.
  36.  
  37.       To write a title sequence, you use a standard text editor and type
  38. each line of your sequence in the order you want it displayed.  TitleGen
  39. will use ANY font and it will automatically center the text, so when you
  40. enter the text, left-justify it.  Also, some fonts have problems with the
  41. last character in the line being chopped.  In these cases, put a space or
  42. two at the end of the line.
  43.  
  44.       You could leave it right there with an acceptable output, but TitleGen
  45. has six (6) in-script commands which you can use to spruce up your output.
  46. The command is signalled by a tilde symbol, "~" in the left-most column,
  47. immediately followed by one of these (TitleGen is case-insensitive):
  48. (Upper case denotes an actual character, lower case denotes a numeric
  49. digit in either decimal or hexidecimal)
  50.  
  51.       n : A single digit between 1 and 3, inclusive.  This sets all
  52.           following text to the color number given.  Defaults are:
  53.  
  54.           1 : Bright White
  55.           2 : Medium Grey
  56.           3 : Bright Blue
  57.  
  58.           Color number 1 is the default.  Any other number will generate
  59.           an error in the CLI window.
  60.  
  61.       R : This command signals TitleGen that it should wrap back to the
  62.           beginning of the file and continuously scroll the same text.  All
  63.           lines after this command are completely ignored.  Note that if
  64.           this command is not used, TitleGen will stop after displaying the
  65.           last line of text and wait for the left mouse button to be pressed
  66.           before exiting back to the CLI.
  67.  
  68.      Sn : This command sets the SPEED of the scroll after this line to the
  69.           given number n = (1 to 9) in "pixels per bump."  A speed of 2 is
  70.           the default.
  71.  
  72.   Pnrgb : This is one of the neatest.  It allows you to set you text's color
  73.           Palette.  The "n" is the pen number you want to change (0-3), and
  74.           the single HEXIDECIMAL digits "r," "g" and "b" are the single-
  75.           digit hexidecimal values of the Red, Green and Blue levels that
  76.           the color should be.  The color will be changed immediately and
  77.           until the next change, which may affect visible text displayed
  78.           before this command.  This opens new possibilities if your
  79.           Genlock Device is capable of Luminance Keying.
  80.  
  81.           Note that pen #0 is not actually a text color, but the color of
  82.           the background.  Normally this would be keyed out, but it may
  83.           be usefull in some situations to have a colored background, so
  84.           I said to myself, "Kevin," I said, "What the heck.  Let's do it."
  85.  
  86.      Hn : This is the HOLD command; the display will be frozen for the
  87.           number of HALF seconds listed, n = (1 to 9).  In combination with
  88.           the Palette command, the Speed command and Lum. Keying, you can
  89.           hack up "popping" displays.
  90.  
  91.       B : This command will stop the scrolling and wait for the user to
  92.           click (down-up)áthe left mouse button.  You can use this feature
  93.           to cue actions.
  94. -----------
  95.  
  96.       Neato, huh?  Note that each command must start at column 0 and it
  97. must be on a line of its own.  At this time, TitleGen can handle up to
  98. five-hundred (500) lines of text, including command lines.  Since commands
  99. always begin with a Tilde, it is obvious that you cannot start text lines
  100. with them unless you put a space in front of them.  Since these are usually
  101. proportional fonts, a single space won't much affect the centering.  Got it?
  102.  
  103.  
  104. III.  Ok, I've got it.  Now how do I make TitleGen work?
  105.  
  106.       Easy.  From the CLI, run TitleGen by typing:
  107.  
  108. 1> TitleGen [<font name> #font height#]
  109.  
  110.       Note that the "1>" is just the CLI prompt.  If you leave off the font
  111. name, TitleGen will assume Diamond 20.  Example:
  112.  
  113. 1> TitleGen Sapphire 19
  114.  
  115.       Do NOT type ".font" at the end of the font name!!
  116.  
  117.       After that, whether you specify a new font or not, TitleGen will
  118. display version and Shareware info, then ask you for the name of the input
  119. file.  Type it now with path name.
  120.  
  121.       When all that is done, TitleGen will attempt to load the file
  122. completely into memory.  If it can't, you'll hear about it, believe me.
  123.  
  124.       If successful, Your screen should go black.
  125.  
  126.       TitleGen will then do its stuff.  The text will begin to appear at the
  127. bottom and disappear off the top.  You can click the left mouse button at
  128. ANY POINT and the program will immediately exit.
  129.  
  130.       I suggest that you put TitleGen on its own, bootable disk.  Then
  131. create a mouse pointer where the image is skewed several pixels from the
  132. "hot spot" so that you can push the mouse off the display for clean titling.
  133.  
  134.  
  135. IV.   Hmmm.  Do I need to know anything else?
  136.  
  137.       Nope.  That's it.  Any questions?  Direct them to the author.
  138.       Check out the sample input file, "TitleGen.TTL" to see what cooks.
  139.  
  140.  
  141. V.    Professionals:
  142.  
  143.       For registered permission to use TitleGen in your works, send a
  144. one-time registration fee of $10 to:
  145.  
  146.       Alternate Realities
  147.       c/o Kevin Kelm
  148.       7080 Roaring Springs Avenue
  149.       Colorado Springs, Colorado
  150.       80817
  151.  
  152.       Direct questions/suggestions/rags to Kevin at:
  153.  
  154.       (719) 392-1023
  155.           - or -
  156.       CIS 71071, 2726
  157.  
  158.    ...but I'd rather hear from ya, voice.  The Shareware registration will
  159. help keep me developing new versions for your video pleasure.  How does
  160. interrupt-driven timing sound?  How about 8-color IFF image support?  What
  161. say to multiple fonts?  What do you think of programmable Left-Center-
  162. Right-Custom justification?  And what about multiple-directional scrolling,
  163. hmm?  Well, I can implement these things and more if folks like you respond
  164. favourably.
  165.  
  166.       Consider it.
  167.       Do it.
  168.       Live it.
  169.       Send it.
  170.  
  171. ----------------------
  172.       TitleGen 1.6 was written with the best darn prgramming environment in
  173. the known Amiga universe:
  174.  
  175.       Avante-Garde's
  176.       Benchmark Modula-2!   Thanks, Leon!
  177.  
  178.  
  179.       Enjoy!
  180.  
  181.          Kevin
  182.  
  183.