Tele SubTitle  Information.
^^^^^^^^^^^^^^^^^^^^^^^^^^^

Before I tell you about Tele SubTitle I must mention that I will be on 
Holiday between Now and 30.9.94. I mention this because about 2 functions in
the program (See Below) need more work doing to them and I won't be able to
do this work until 1.10.94.


=================
 Introduction...
=================

Tele SubTitle (TS) was a program I thought I'd write to follow on from my 
TELE series of Video Titlers. It was written with Amos V1.35 on a 2Mb A600.

It uses Bobs instead of Fonts so that you can use "Cut 'N' Paste" DPaint type 
Characters with your SubTitle Sequence. Your Bobs can have upto 16 colours in
them, I chose 16 because I thought this was plenty for SubTitling. Most Good
Anti-Aliased Characters only usually have 8 or 16 colours in them anyway.

TS was supposed to be a Hires Overscan version but I found that my version of
Amos didn't support this format (Probly because EuroPress or Someone limited
the Magazine Coverdisk versions?) so I decided to make TS Lowres Overscan
with Overscan Interlace support aswell. The Overscan in this version is
352 X 283 (Standard Overscan in accordance with DPaint III) or 352 X 566 with
Interlace.  

This is the Last TELE program. I will be writing Games and Utilities only in
the future. 'Tele Title 2 Lowres' might be converted into an OVERSCAN version
but this would be Shareware and not P.D as before if I were to convert it.

Tele SubTitle is Shareware. The Registration Fee is just £2.50. This version
allows you to have upto 20 SubTitles in your Sequence whereas the Registered
version allows you to have upto 108 SubTitles in your Sequence, so Register!
The Registered version will probly have Maximum Overscan and a few more 
Methods (See Below) aswell as better Code (more checks, etc in the program).

You will find the Extension programs in the `Progs' drawer. Bob Entry allows
you to Grab characters from an IFF Picture and then store them as Bobs in the
Bob-Bank. Entry allows you to Edit/Load/Save your C.W Sizes (Explained Below)
and Defined SubTitles (Also Explained Below).


In these instructions (and the program) I've used the following terms as
follows...


   Defined - These are the SubTitles Defined by me that you can change using
             the M option in the program (or the Entry program).
 
  SubTitle - This is used to mean 2 Lines of Text.

     Items - I've used this word to mean any/all of the above.


=========
 Bobs...
=========

You can use the following Characters for your Bobs...

 A to Z  Space - . ' ! &  a to z  " # $ % ( ) * + , /  0 to 9  : ; < = > ? @

I usually leave:  A to Z  Space - . ' ! &  a to z  as they are - I.e. Cut out
an `A' and put it into Bob position A of the Bob Bank and so on - and then
use the other 27 Bobs as I want them. This is one advantage of using Bobs,
you can have other Graphics besides Letters and Numbers in your sequence.

Besides these Character Bobs you are allowed 8 BackGround Bobs. These can be
used for Logos, BackGrounds or whatever you want. The nice thing about these
Bobs is that you can turn them Off/On whenever you like (except when
displaying an IFF Picture).


================
 The program...
================

When the program starts you will see the Main Menu with nine Icons at the
bottom of the screen and in the middle of the screen are some of the 
SubTitles.

You simply select a SubTitle by pressing the P key. To Cancel a SubTitle you
simply press the C key, Pressing the M key will allow you to alter a SubTitle
Each SubTitle can have upto 2 Lines in it with upto 38 Characters per line
(See below for more details). Your Sequence can have upto 108 SubTitles in it
However, this version only allows you to have upto 20 SubTitles in your 
Sequence...so get Registered if you want the full 108!


==============
 The Icons...
==============

Icon 1:  Show the Keys to be used.

Icon 2:  ME...this is my Address, etc.

Icon 3:  The Edit menu. Allows you to alter such things as: Fade Speed,
         Screen Display Position, SubTitle Position, Pause Rate, etc.

Icon 4:  Quit 

Icon 5:  The Post-Production menu. Allows you to: Load/Save your Sequence,
         Load/Save your Defined SubTitles, Load/Save your Characters (Bobs),
         Load a Packed Picture, Switch the Packed Picture Off/On, etc.

Icon 6:  Test and Play. This will Test for errors and then Play your Sequence
         if no errors were detected.

ICON 7:  Cols menu. Allows you to change the Palette Colours.

ICON 8:  BGD (BackGround Display) menu. Allows you to Choose/Edit your BGD.
         I.e  Do you want a BackGround with Bobs in it, with Bars and/or
         Boxes in it or Do you simply want your SubTitles to be displayed?

ICON 9:  Not in Use yet. This will probly be a Timer menu of some sort.


=============================
 The Post Production Menu...
=============================

  Erase Memory:  If you use the Erase Memory function you will not be able to
                 Save your items because the memory banks your items use will
                 be erased. You will still be able to use your items though. 

 Load Bob-Bank:  This allows you to load your Character set (your Bobs). 

         Space:  This lets you change the space setting between each
                 Character. You should always set this function, if need be,
                 before you load in some new Defined SubTitles (see below).

         C.W.S:  Character Width Sizes are the Widths of your characters.

       Defined:  As said above, these are the SubTitles that are Defined. If
                 you ever need to load some new Defined SubTitles (DS) you
                 should always do the following...

                 1) Set your Space setting, if need be.

                 2) Load your C.W.S, if need be.

                 3) Load your Defined SubTitles.

                 DS works by looking at the Space setting and the C.W.S to
                 calculate their positions on the screen. If you only loaded
                 some new DS then the new DS would look at the Space setting
                 and the old (Current) C.W.S.

                 If you only want to change the Space setting in your DS you
                 will have to load your DS again - after changing the space
                 setting. This is so that the DS screen positions can be
                 re-calculated. 

                 The DS aren't checked everytime you change the Space setting
                 or load a C.W.S simply because it slows the program down too
                 much to always be doing checks. I could of stored the old
                 settings whilst checking the new DS, etc but this would mean
                 using more memory and the program would be even slower. You
                 should find that once you've got your settings, DS, etc to
                 your liking you won't need to use the Space setting, etc all
                 the time. 

   Save Config:  This saves all the values (Configuration) from the Edit and
                 BGD menus, aswell as your Palette Colours. The file is saved
                 as: BGD.E.Config. The program will look for this file upon
                 loading. The program will also look for the following files
                 upon loading...

                 B.A.Config  - your Bob Bank file (your Character set).

                 CWS.Config  - your Character Width Sizes.

                 D.Config    - your Defined SubTitles.

                 BGD.E.Config goes in the `Progs' drawer, the rest of the 
                 Config files go into their proper drawers. The program
                 Default is used when a Config file is not found.

       Execute:  There are 2 Execute commands in this program - Execute Run
                 and Execute. 

                 Execute Run will try and run programs such as Amos programs,
                 programs that can't be executed with the Execute command,
                 etc. These programs have to go into the 'Progs' drawer.

                 Execute will try and run programs such as PPMore, C commands
                 Games, etc. This command looks at DF0: only - So if you
                 wanted to execute PPMore for example, you would simply type
                 the following at the prompt...

                 PPMore DF0:Text

                 ...this would run PPMore which would then show a file called
                 Text from DF0:

                 Note: You're better off putting your Execute DF0: programs
                       in DF0: rather than a Drawer as the prompt only allows
                       you to enter 15 characters.

    Grab a Bob:  This allows you to Grab a Bob from an IFF Picture and place
                 it in any one of the 8 BackGround Bob positions. This
                 version only allows you to grab bobs that have a Width of
                 320 pixels or less and a Height of 255 pixels or less. This
                 means to cover the Overscan of 352 pixels wide you will need
                 to use 2 bobs of course. This will probly get changed to 
                 except the full width and height of the Overscan. These
                 current limits are only in place because I ran out of time
                 to finish this function properly - I will be on Holiday you
                 see. By the way, when you Grab a Bob from an IFF Picture
                 make sure the IFF Picture is Lowres 320 X 256 or the program
                 may get nasty! 

    X: Y: W: H:  These are the co-ordinates for the above (See `Bar' and the
                 end of Edit/BGD menus Below for the Co-ordinates lay-out).

        Bob No:  This is the number of the BackGround Bob Position where the
                 Grabbed Bob will go.

                 Note: The Bob order of appearance is 1 to 8, therefore, Bob
                       6 for example will always go in front of Bob 3 when it
                       appears on the Screen. This is Important to remember
                       when organising your BackGround Bob Positions.


If you Load a Sequence (whilst still on the Main Menu part of the program)
you can go to the Main Menu and add other SubTitles to the END of the
sequence you've just loaded. Don't type in your sequence and then Load a
sequence because you will overwrite the sequence you`ve just typed in.


===========================
 The Edit and BGD Menus...
===========================

   Start:  This sets up the Starting Position function. If you don't want
           your SubTitles to be Auto-Centered they will positioned at this
           STARTing point instead.

Scr.X: Y:  You can move the screen display around in the X and Y positions.
           This function doesn't highlight the screen so you will need to
           know what co-ords your Television (or Monitor) uses.

Gap Keys:  The Gap Keys are there to cut down on key pressing. For example
           with the Gap Total set to 1, if you wanted to change a Pause rate
           from 100 to 150 then you would simply set the Gap Total to 50 and
           press the Pause rate button once to reach 150, rather than
           pressing it 50 times to reach 150 when the Gap Total is set to 1.

    Wait:  Allows you to specify the time you wait before your SubTitle 
           disappears from the screen. This affects every SubTitle in your 
           Sequence. This function is best described as a Timed Pause Rate.

 No.Cols:  Use this function to tell the program how many Colours you have in
           your Character set.

 Cls Col:  This is the colour your GenLock will use to make the screen
           Transparent.

 Box Col:  In method 1 (See 'Methods' below) you can have a Box (a rectangle
           outline) in the BackGround, this function lets you alter the
           colour of that Box.

 Bar Col:  In method 1 you can also have a Bar (a filled/solid rectangle) in
           the BackGround, this function lets you alter the colour of that
           Bar.

 P.Pause:  Same as the Wait function except its used for your Picture.


You will find the Co-Ordinates for the Bar and Box in the BGD menu. X and Y
are the Top-Left hand corner (Start Position) co-ordinates. X is across and
Y is down. W and H are the Bottom-Right hand corner (End Position) co-ords.
W is the Width and H is the Hieght.


============
 Methods...
============

Method 1:  No Bobs required. You will use the Bar and Box, if need be, as
           your BackGround. You can display the 2 Lines of your SubTitle or
           you can display the first line only (See 'Sequence Keys' below).
           This method simply displays each SubTitle and then clears the 
           screen.

Method 2:  Use Bobs. Display 2 lines or first line only, as above. This
           method has a 3 key option (See 'Sequence Keys' below).

Method 3:  Use Bobs. Display each line of your SubTitle, one at a time. This
           gives a possible 216 line display sequence. This method as a 3 key
           option (See 'Sequence Keys' below).

There will probly be more methods if this program progresses. Perhaps a
mixture of the current 3, above.

Note: Method 2 is unfortunately limited to the number of Bobs it can have on
the screen at any one time. Because of this I have put a routine in the Test/
Play Icon that will tell you to shorten your SubTitle if its more than 58
characters in length when using Method 2.


==================
 Sequence Keys...
==================

When you press Test/Play and everythings O.K you go to the Total Control part
of the program. This does exactly this, it puts the program in manual so that
you have Total Control. The Sequence Keys are as follows...


 j:  Fade In Picture (16 Colours only) - Pause - Fade Out.

 v:  Show Picture (Suddenly Appear) - Pause - Fade Out.

 b:  Fade In Picture - Freeze the program (leaving the Picture as it is).

 l:  UnFreeze the program - Fade Out Picture.

 h:  Go into Single Line Mode (Your Sequence will only show Line 1 of your
     SubTitle - This does nothing if you're using Method 3).

 i:  Cancel Single Line Mode (Your Sequence will start showing the 2 Lines of
     your SubTitle again).

 s:  Let your SubTitle's Starting Position equal the Start function in the
     Edit menu. This function switches off the Auto-Centering. You cannot
     toggle this function Off/On at the moment - I will do something about 
     this after my Holiday. At the moment you have to press this button each
     time you want a SubTitle to use the Start position.


1-8:  Switch On Bob number X (X is the 1-8).

  9:  Switch On `Box' function (Method 1 only).

  0:  Switch On `Bar' function (Method 1 only).


F1-F8:  Switch Off Bob number X (X is the F1-F8).

   F9:  Switch Off `Box' function (Method 1 only).

  F10:  Switch Off `Bar' function (Method 1 only).


 c:  Bring up the Colour Menu (The Palette).

 a:  Display SubTitle - Wait - Clear the Screen (Method 1 only).

 m:  Change `Box' Colour - Bell rings from colour 1, onwards. Shoot sound
     tells you you're back to colour 0.

 n:  Same as above, but Change `Bar' Colour.

 o:  Same as above, but Change `Clear the Screen' Colour.

 r:  Reset the Sequence to SubTitle 1.

 e:  Exit to Menu-List option.

 q:  Re-Start the program.

 d:  Display Bobs and SubTitle - Wait - Clear SubTitle only
     (Methods 2 and 3 only).

 f:  Display SubTitle - Wait - Clear the Screen of Bobs and SubTitle. On the
     second time and thereafter No Bobs will be shown as they were cleared
     the first time. This key press is really meant for clearing the screen 
     on your last SubTitle, thus, a nice exit of the sequence.
     (Methods 2 and 3 only).

 g:  Display Bobs and SubTitle - Wait - Clear the Screen of Bobs and SubTitle
     This acts the same as Method 1, but the advantage is that you can use
     Bobs, of course. (Methods 2 and 3 only).


========================
 Testing the program...
========================

 1)  Simply Load a Sequence (or Make one by selecting a few SubTitles from
     the Main menu) and then press Test/Play.

 2)  Now simply press one of the relevant Sequence Keys.

Thats all there is to it, easy isn't it!


======================================
 Please take note of the following...
======================================

I have not disabled the Break key so if you need to exit the program you can
use the program's Quit option or press CTRL and C.

To make a new disk up just put 6 Drawers on your new disk and name them the
same as mine. I.e. Defined, Seq, Size, etc. You can call the Disk whatever
you like because TS always looks at 'DF0:'.


==============
 Filenames...
==============

I've only given you 15 characters for your filename because it's a bit naff
for example, having to type in a filename of 20 characters or more everytime
you need to load/save something...isn't it?!!

I advice you to set your filename something like the following...

 7Wed6John

Where 7 is the number of SubTitles, etc in your sequence - Wed means your 
film is a Wedding - 6 is the Space setting - and 'John' is the name of your 
filename or the name of your Wedding Video person, etc.


============
 Finally...
============

If you have any Questions, Comments, Ideas, etc, feel free to write anytime. 
You will find my address in the 'ME' Icon.

Note: Because I cannot trap every error, I will not take any responsibility
      for the loss or damage of SubTitles, Sizes and any other data, etc
      caused by any of the programs on this disk.

Note: I will not take any responsibility for any damage of GenLocks, Monitors
      Televisions and any other Hardware, etc caused by any of the programs
      on this disk.

=============================================================================