GetPages 1.20 - Download Teletext Pages
                   =======================================
                   Author: J.G.Harston - Date: 31-Jul-1998

Even though BBC TV no longer transmits telesoftware programs, a teletext
adapter isn't completely useless. Lots of pages are transmitted by the BBC
and ITV services, many of them being carousels made up of sub-pages. 

Usually, the sub-page number and the total number of pages is displayed in
the top right-hand corner.

This program lets you download these carousels, so you can use it in a
teletext editor and perhaps including it in your own carousels.

When run, the program asks you for the channel, the start and end page
numbers and the filename under which to save the carousel. To just download
one page press RETURN on its own when asked for the end page, and that page
will be saved as the entered filename. When downloading a series of pages,
each page will be saved as the filename prefix followed by the page number,
ie if you enter 'P', they will be saved as, for example, P100, P101, P102,
etc.

Once you have entered these details, the program waits for each subpage of
the carousel to be transmitted and saves it to disk.

As the program is waiting, it shows its progress so far with white blocks
indicating the sub-pages not yet captured and green blocks for those saved.
The sub-pages don't have to be transmitted in the correct order - the
program slots them into the file in the correct place. Once all the
sub-pages of each page requested have been captured, the program stops.

How it works

The program first assembles a short piece as machine code that wipes the
top bit from all the characters on screen, except for the teletext control
characters and the #, ` and _ characters.

It then turns the header on, and asks for the channel, start and end pages
and name to save the pages under. After setting the page and channel, the
program waits for a page to arrive. This is then examined for an index and
the total number of sub-pages. The program looks at the end of each line
for the index. If it can't find an index, the program stops.

The program then attempts to save a dummy file long enough for all the
pages to check that there's enough disk space. The file is opened and the
captured subpage is output to it. The program then enters a loop waiting
until all the rest of the subpages have been captured. Within this loop,
while waiting the coloured blocks are show to track progress. Once a
sub-page has been captured the program checks the sub-page number and
checks if it has already been saved. If not, it saves it.

pf%() holds flags indicating which sub-pages have been saved. If at least
one of the entries of pf%() is zero, then there are still more sub-pages to
capture, and the loop is repeated. Otherwise, the output file is closed and
the program ends loops back for all the selected pages.

PROCsave() sends the captured sub-page into the file. First, the characters
on the screen are converted by calling the machine code assembled earlier.

OSGBPB is then used to send 920 bytes from the screen into the file, and
then 104 padding bytes after. Using OSGBPB is much faster and efficient
than using multiple BPUTs.

Each sub-page captured is stored as 1024 bytes in the file. The first 920
contain the 23 lines of text, and the final 104 bytes are padding.

This is the format most commonly used in the teletext editing programs that
I have come across, with the padding bytes being used for extra data
specific to the program.

The routines were originally writen for use with the Acorn teletext adapter
with the ATS rom, but it can be very easily changed for other adapters.

The critical commands are *TRANSFER and *DISPLAY. These wait for the next
sub-page of the page set with *PAGE on the channel set with *CH to arrive
and then display it on the screen. Any replacement would have to do the
same.


GetPages - J.G.Harston, 70 Camm Street, Walkley, Sheffield, S6 3TR
Climb aboard the carousel - Micro User, August 1991 

History:
About '1986 v0.10 Initial version at Myers Grove School
  -Aug-1991 v1.00 Tidied up for Micro User
20-Apr-1997 v1.10 Select magazine, looks on every line for subpage
21-Jun-1998 v1.20 Can do a range of pages
30-Jul-1998 v1.21 Better index match, doesn't miss final page
09-Mar-2000 v1.22 Display TAB corrected