home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / graphics / genlock / videotitler / videotitler.doc < prev    next >
Text File  |  1995-02-27  |  19KB  |  402 lines
  1. ##############################################################################
  2. #                                                                            #
  3. #  V         V III DDDD   EEEEE   OO      TTTTT III TTTTT L     EEEEE RRRR   #
  4. #   V       V   I  D   D  E      O  O       T    I    T   L     E     R   R  #
  5. #    V     V    I  D    D E     O    O      T    I    T   L     E     R   R  #
  6. #     V   V     I  D    D EEE   O    O III  T    I    T   L     EEE   RRRR   #
  7. #      V V      I  D   D  E      O  O       T    I    T   L     E     R  R   #
  8. #       V      III DDDD   EEEEE   OO        T   III   T   LLLLL EEEEE R   R  #
  9. #                                                                            #
  10. #                        V         V     11     11                           #
  11. #                         V       V     1 1    1 1                           #
  12. #                          V     V     1  1   1  1                           #
  13. #                           V   V     1   1  1   1                           #
  14. #                            V V          1      1                           #
  15. #                             V           1 o    1                           #
  16. #                                                                            #
  17. #                         © 1993 by Andreas Ackermann                        #
  18. #                                                                            #
  19. ##############################################################################
  20.  
  21.  o for those who are in a hurry: changes since 1.0c are to be found at the end
  22.    of this file !
  23.  o Copyright:
  24.  
  25.    VideoTitler V1.1 is SHAREWARE.
  26.    THE UNLIMITED VERSION MAY NOT BE DISTRIBUTED IN ANY RESPECT. IF IT SHOULD
  27.    APPEAR ON ANY PD-SERIES OR IN A MAILBOX I'LL TAKE JURIDICAL STEPS.
  28.    Only this limited Demoversion may be distributed in public domain series
  29.    or in mailboxes, as long as no fee is charged. The maximum price per disk
  30.    that is still tolerated as public domain is DM 5 ($3) or a correspnding
  31.    amount of any other currency !!!
  32.  
  33. !!!  The companys SoftwareOase, Peter Ossowski, Pawlowski,and 'Logo Verlag !!!
  34. !!!  und Software' even may not distribute the demoversion of Videotitler. !!!
  35.  
  36.    Demoversion and full version are identical, with one single restriction:
  37.    Every second line that is scrolled is 'DEMOVERSION'.
  38.  
  39.  o How may I get the full version ?
  40.  
  41.    Simply send 30 DM or 20 $ to :
  42.  
  43.                             Andreas Ackermann
  44.                             Lorenz-Summa-Str. 10
  45.                             95145  Oberkotzau          Tel.: 09286/6399
  46.                             Germany
  47.  
  48.    If you prefer to remit the money, here is my bank connection:
  49.  
  50.    Sparkasse Oberkotzau/Schwarzenbach a.d.Saale
  51.    BLZ:     78053040
  52.    Kto.Nr.: 240802272
  53.  
  54.    You'll get a bootable disk containing the full version of Videotitler.
  55.    There is NO printed documentation included.
  56.    If there should be a new version, you'll of course get at least one update.
  57.    ( NOTE: outside Europe there will only be one update, as postage cost is
  58.            twice as much as inside Europe. However, you'll get future versions
  59.            at my cost price which is about 10 DM or 7 $ )
  60.    When ordering, please tell me your system-configuration ( processor type
  61.    [680x0], Kickstart version, and if you're already using AA chips ) as
  62.    future versions might require at least an A1200.
  63.  
  64.    I DONT'T TAKE ANY WARRANTY FOR ANY LOSS OF DATA RESULTING FROM USING THIS
  65.    PROGRAMM. I CANNOT GUARANTEE THAT THIS PROGRAMM IS ENTIRELY BUG-FREE.
  66.    ANY USAGE IS AT YOUR OWN RISK !!! NO EXCHANGE !!!
  67.  
  68.  o What is VideoTitler V1.1 ?
  69.  
  70.    VideoTitler V1.1 ( from now on referred as Vtt ) is a simple program to
  71.    generate professional looking TV end titles and credits.
  72.    Vtt allows you to scroll ANY font you like ( even colorfonts are suppor-
  73.    ted !) from the bottom to the top of a 736*560 pixels sized screen.
  74.    You may choose between four speeds.
  75.    Unfortunately scrolling of brushes is not supported yet.
  76.  
  77.  o How are the titles defined ?
  78.  
  79.    In the ScriptEditor you enter your text to be scrolled line per line.
  80.    Besides you may define the centering for each line ( left, middle, right ).
  81.    In the StyleEditor you define your font, font attributes ( outline, shadow,
  82.    normal ) and the color palette.
  83.    Having defined such a 'style' you may assign it to any number of textlines
  84.    you like.
  85.  
  86.  o Which system configuration is required ?
  87.  
  88.    Vtt runs on ANY Amiga, equipped at least with Kickstart 1.2. If you won't
  89.    use colorfonts even 512k of memory will do.
  90.    The more chip-ram you have the more fonts you may use within a script.
  91.    ( With 1 MB you shouldn't have any problems ! )
  92.  
  93.  After this quick survey, here is the complete reference:
  94.  
  95.  o any numbers that have to be typed in are taken as pixels. The display has
  96.    got a width of 736 and a height of 560 pixels ( approximately 450 on NTSC-
  97.    Amigas); as the overscan-mode is used, the 20 leftmost and rightmost and
  98.    5 pixels on the top and at the bottom are invisible, so if a textline
  99.    should just fit onto the screen this won't necessarily mean that it will
  100.    be entirely visible on the TV-screen.
  101.  
  102.  I. Loading, saving and executing scripts
  103.  
  104.    With the menu item 'Load...' you may load one of the provided  scripts,
  105.    ( located in the drawer 'scripts' ) and with 'Save...' you may save your
  106.    scripts.
  107.    Already when loading your script, Vtt tries to load the fonts used within
  108.    it, so this will take some time ( especially with floppy drives ).
  109.    If Vtt should fail to load a font, a requester will inform you about this.
  110.    Klicking on the 'Play' gadget pops up a requester that allows you to
  111.    specify the scrolling speed ( 50, 100, 200 and 300 pixels per second.
  112.    After that your screen will show the background color defined in your
  113.    script. All you have to do is to press the left mouse button and your
  114.    text will be scrolled in. Another mouse klick will abort the script.
  115.    'Play current' works similar to 'Play'; however scrolling starts at the
  116.    current textline and your script will be scrolled in an endless loop.
  117.  
  118.    If your Amiga shouldn't be fast enough to generate a line of text , Vtt
  119.    automatically inserts some free lines ( happens mainly when you scroll
  120.    at a speed of more than 100 pixels/sec, with outlined fonts or with
  121.    colorfonts )
  122.  
  123.    If there's not enough memory Vtt will inform you about this. In this case
  124.    you only can try to make it with less fonts, as especially colorfonts eat
  125.    very much memory.
  126.  
  127.  II. Editing scripts
  128.  
  129.    On the left of Vtt's window you've got a box where you may select each line
  130.    of your title.
  131.    When starting Vtt there aren't any lines yet. You may change this by
  132.    klicking on 'Add Text'.
  133.    On the right, there will appear additional gadgets:
  134.  
  135.    curr. line: here you may edit your line of text at pleasure
  136.  o x-position: Centering is |    LEFT     |    RIGHT     |   MIDDLE
  137.                distance of  | left border | right border |  ignored
  138.  
  139.  o y-Distance: specifies the number of blank lines to be scrolled, before
  140.                the next text line appears
  141.  
  142.  o cur. Style: defines the 'Style' of this line; may be changed by selecting
  143.                'Edit Style'.
  144.  
  145.    Beyond the stringgadget there is some information about the dimensions of
  146.    the textline; if it is printed blue, there either is no font loaded
  147.    or this line won't fit onto the screen.
  148.    [Values for YPos etc. don't have any meaning in his version.]
  149.  
  150.    Beyond the select box there is another number of gadgets, that allow you
  151.    to modify the sequence of the textlines:
  152.  
  153.  o Copy   after activating 'Copy' Vtt waits for another line to be chosen.
  154.           The current line will be copied BEHIND this line, but still will
  155.           be preserved at its former position. The copy will become the
  156.           new current line.
  157.  o Move behind
  158.           works the same as 'Copy', but the original line will be deleted
  159.  o Move front
  160.           works the same as 'Move behind', but the copy will be inserted
  161.           IN FRONT of its destination.
  162.  
  163.    Selecting any of these gadgets a second time after activating it will
  164.    abort the action.
  165.  
  166.  o Delete deletes the current textline; the next line becomes current line
  167.  o Add Text
  168.           inserts a new line of text AFTER the current line
  169.  
  170.    Some words about the menus:
  171.  
  172.  o Bubble        (de)activates wavy scrolling mode
  173.  o Add Text      does the same as 'Add Text' Gadget
  174.  o Select next   selects the following line
  175.  o Select back   selects the previous line
  176.  
  177.  
  178.  III. The Style-Editor
  179.  
  180.    To enter the style-editor simply click on 'Edit-Style'. In the select-box
  181.    the styles already defined will appear ( when no script is loaded, there
  182.    won't be any styles ! )
  183.  
  184.  o Stylename    here you may enter a name for your style ( it's unsignificant
  185.                 for Vtt; it's just for better survey; its first character will
  186.                 be displayed in the script-editor right after the textline )
  187.  
  188.  o Style        the font's style is defined by this gadget:
  189.  
  190.    - 'Normal':   neither outline nor shadow
  191.                  the following three gadgets are meaningless in this case
  192.    - 'Shadow':   the textline appears with a shadow (bottom-right)
  193.                  'X-OFFSET' defines displacement to the right in pixels
  194.                  'Y-OFFSET' defines displacement downwards in pixels
  195.                  'DEPTH OF SHADOW' defines how often this action has to be
  196.                  repeated
  197.  
  198.       Example:   D.o.S.: 1, x-O: 12, y-O: 12
  199.                  Result: cast shadow, its displacements down and right are
  200.                  equal ( one pixel in y-direction is nearly as much as one
  201.                  pixel in x-direction )
  202.                  D.o.S.: 5, x-O: 2, y-O: 2 3-D-effect
  203.                  D.o.S.: 5, x-O: 0, y-O: 2 shadow only towards the bottom
  204.                  The best thing to get a feeling how these values work is to
  205.                  try out !!! ( negative inputs are unfotunately ignored !!! )
  206.    - 'Outline'   the font appears outlined
  207.                  'X-OFFSET' once more defines the displacement to the right
  208.                  [ however only 2 makes sense !]
  209.                  'Y-OFFSET' the same, just to the bottom  [ mainly set to 2]]
  210.                  'FATNESS OF OUTLINE' tells Vtt how often this action should
  211.                  be repeated [ values from 1 to 3 make sense; IMPORTANT:
  212.                  a 68000er Amiga isn't fast enough for values > 1 ; with
  213.                  scrolling speed set at more than 100pix/sec you even might
  214.                  get problems with 1 ! ]
  215.                  Hint: If you desire the outline, but the font itself should
  216.                        be transparent, simply choose the first colour of the
  217.                        palette as textcolor.
  218.  o Character Space:
  219.                  space between two characters; mainly 0 but especially with
  220.                  'Outline' and 'Shadow' bigger values make sense.
  221.  
  222.  o Pattern:      activating this gadget causes Vtt to use a pattern for the
  223.                  font, so that the original video will shine right through
  224.                  the font. However this switch won't affect shadows, outlines
  225.                  and color-fonts.
  226.  
  227.  o Font:         that's the name of the font used in this style. When printed
  228.                  blue, there's either no font selected or no font loaded.
  229.  
  230.  o Load Font:    used to select a font
  231.  
  232.  o Color-Editor: makes you enter into the palette-editor, allowing you to
  233.                  define a 8-colour palette JUST FOR THIS STYLE !
  234.  
  235.  o With 'Ok' you return to the script-editor. The current style will be
  236.    attributed to the current textline.
  237.  
  238.  
  239.  IV. The Color-Editor
  240.  
  241.   You edit an 8 color palette as usual by modifying the rgb portions of the
  242.   color.
  243.   The first color of the palette represents the background; changing it will
  244.   affect this color in each other style. Since V1.1 it's even possible to de-
  245.   fine a slide for this color.
  246.   If the style attached to this palette shouldn't include a colorfont, please
  247.   use ONLY THE FIRST FOUR colors of the palette, as the other ones are
  248.   ignored and the textline won't be shown correctly.
  249.   Foreground color and background color are defined by first clicking on the
  250.   desired color and then clicking on the gadget on the left of 'Textfarbe'.
  251.  
  252.  o Slade:        allows you to define a color as slide from one color to
  253.                  another.
  254.                  Activating it, a new gadget will appear allowing you to
  255.                  switch between start and endcolor.
  256.                  [ Slades from red to blue or red to yellow look best ! ]
  257.                  With your font being higher than 30 pixels you'll notice
  258.                  some stripes in the result, as the old graphic-chips don't
  259.                  provide enough colors.
  260.             NEW: This 'stripyness' won't appear when you're one of the proud
  261.                  owners of an Amiga 1200 or 4000 which is equipped with the
  262.                  new AGA-Chipset.
  263.  
  264.  o ColorFonts-Colors:
  265.                  If the font defined for this style should be a colorfont,
  266.                  you'll get its palette by clicking on this gadget.
  267.  
  268.  o With 'Ok' you return to the Style-Editor.
  269.  
  270.  
  271.  Some words about the fonts:
  272.  
  273.     I included some fonts from the workbench diskette.
  274.     Additionally there is:
  275.  
  276.     Chisel Serif.font a freeely distributable colorfont
  277.     PenPal.font       of Burton Ogden, Fish 73
  278.  
  279.  Known BUGS:
  280.  
  281.  o  Select next/back won't scroll the viewable textlist
  282.  o  with some colorfonts, outlines and shadows won't be displayed correctly
  283.     Help: simply type in one or two spaces at the end and in front of this
  284.           textline ( required when using ChiselScript.font )
  285.  o  using a font in several styles will cause the font to be loaded in memory
  286.     several times. This is waste !
  287. !o! sometimes inexplicable system crashes
  288.  o  when scrolling at 100 pix/sec, Vtt probably will insert additional lines
  289.     of space, as a normal Amiga is too slow.
  290. !o! if you run out of memory while loading a script your system might crash
  291. !o! NEVER use more than 120 lines of text or more than 20 styles !
  292.     Otherwise: Crash ( don't tell me I didn't warn you ! )
  293.  o  *any* music replay will be stopped, while Vtt is playing as it requires
  294.     *all* the power of an MC68000. Maybe I'll include my own replay for
  295.     MED and SoundtrackerModules one day.
  296.  o  While Vtt is playing a script it takes over the whole machine. Any trans-
  297.     action with peripheral devices ( Modem, Printer, etc.) will stop.
  298.  
  299.  
  300.  
  301.  Ideas for future versions:
  302.  
  303.  o  16 colors or more
  304.  o  New styleguide-like user interface
  305.  o  scrolling of brushes
  306.  o  TV-station logo support
  307.  
  308.  -  The new version will require Kickstart 2.0 or higher, no matter whether
  309.     you use AA-Chips or not !
  310.  
  311.  About the program:
  312.  
  313.  I focussed on the result of this programm - a great looking result - and I
  314.  belive I achieved this goal. However this piece of software isn't free of
  315.  bugs and the user interface is not one of the best, I know.
  316.  
  317. ****************************** IMPORTANT *************************************
  318. *                                                                            *
  319. ************************* Changes since V1.0c ********************************
  320.  
  321.  o Vtt now uses a 736*560 pixels large hires-interlace screen, to get the best
  322.    quality possible for genlocking on an Amiga. The flickering of the image
  323.    on your monitor doesn't affect the result finally saved on your video tape.
  324.  o Vtt now supports the new color palette of the AGA-Amigas, which means that
  325.    *any* color slide may be shown without stripes as Vtt uses the full 24Bit
  326.    palette.
  327.  o You now may define color slides even for the background color. However this
  328.    only makes sense with AGA-Amigas.
  329.  o Vektor fonts are now supported.
  330.  o a bug in the fontmanagement has been removed: font-files larger than 65535
  331.    bytes now are handled correctly.
  332.  o the problem with the 'fast' mouseclicks to start a script on turbo-Amigas
  333.    now has been fixed once and forever.
  334.  o an english user-interface to make Vtt available for ALL users. ( Later I
  335.    intend  to lokalize the whole package.)
  336.  o the 'Bubble' menu item. Provides some kind of wavy scrolling, which does
  337.    look fine when being used with large fonts at a scrolling speed of 100
  338.    Pixels/sec.
  339.  
  340.  New bugs and things that aren't the way they should be :
  341.  
  342.  o occasionally Vtt happend to crash on my old A500 when returning from the
  343.    scrolling routine. However I haven't had *any* crash when using Vtt on my
  344.    new A4000.
  345.  o Memory management now is done dynamically. Memory won't be allocated until
  346.    the textline really is to be shown. For this reason it's not easy to cal-
  347.    culate the maximum amount of memory needed, so Vtt only makes a guess
  348.    whether there is enough memory or not.
  349.    If Vtt should run out of memory while running, it simply tries to generate
  350.    the line after the line making trouble. Unfortunatly there isn't a way
  351.    (yet) to inform the user which line hasn't been displayed.
  352.  o When using non-color-fonts you may edit 8 colors in the color editor,
  353.    although only the first 4 colors are taken into account by the scroll-
  354.    routine. So be careful to define only the first 4 colors as text or shadow
  355.    color.
  356.  o Vtt *must* be run on an PAL or NTSC screen. However it's only the Color-
  357.    Editor which is making trouble, so if you won't use it you won't meet
  358.    any problems. Note: The Color-Editor doesn't even support Superhires !
  359.  o The rgb components of the colors only may take values from 0 to 15;
  360.    AGA support does 'only' comprise the generating of 24-bit colorslides.
  361.  o Colorslides only are possible for the first three colors; a specification
  362.    of a slide for any other color will be ignored.
  363.  
  364.  o The screenmode under which your script is played depends on a flag set
  365.    by the graphics system on bootup.( Power frequency: 60 Hz = USA => NTSC;
  366.    50 Hz = Europa => PAL) OS3.0 users may change this flag in the bootup
  367.    menu. All the others can use Nico François' NTSC-PAL ( Fish 387 ).
  368.    Having an NTSC-screen opened on an PAL-Amiga or vice versa won't keep
  369.    Vtt from taking the correct mode ( i.e. the one specified on bootup or
  370.    or by NTSC-PAL ).
  371.  
  372. ******************************************************************************
  373.  
  374.  Vtt is (still) written in Assembler at 100% ( Devpac 2.0 ) on an A500 1.2
  375.  with 1 MB ram. ( Latest parts on A4000/EC 030)
  376.  
  377.  And now greetings to some people who made it possible to create Vtt:
  378.  
  379.  Franz Langheinrich of AmiTech Systems Hof/Bavaria (Testruns on A1200,
  380.                      technical and material support )
  381.  J.M. Forgeas      ( Editor AZ 1.5 )
  382.  Joe Siebenmann    ( EZAsm 1.7 ) ( Where is V1.8 you promised me long ago ?! )
  383.  Nico François     ( reqtools.library, NTSC-PAL )
  384.  Jan van den Baard ( PowerSource )
  385.  Uwe Colditz       ( Ironmaster of Attack; ideas for fixing a major bug )
  386.  
  387.  History:
  388.  
  389.  V1.0b    7.4.'93
  390.           first release as limited demoversion
  391.  V1.0c    14.4.'93
  392.           Fontrequest: the palette won't be changed any more
  393.           on turbo-Amigas Vtt sometimes refused to start the script;
  394.           this bug has been solved ( at least I hope !!! )
  395.  V1.1     AGA-Amiga-support and usage of an interlaced display for better
  396.           output quality; Bubble-Effect.
  397.  
  398.  
  399.                                                 Oberkotzau, 13.7.93
  400.  
  401.  
  402.