[comp.sys.acorn] Postings to Newcastle/c.b.a

maumg@warwick.ac.uk (Pop Mobility Freak) (05/21/91)

Dear Arc owner,
     Here is a brief overview of the applications I have sent to
comp.binary.acorn and the newcastle info server.
     Each utility contains the source as I believe one of the nest ways to
learn to program is to look at someone else's code. If you plan to do this
I would recomend that you look at PlaceIt as it uses the most features.
Unless of course you are into module applications upon which IconClock is
the best to study.

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

FreeMem

This utility displays the amount of free application space on the iconbar.

This is a module application and so will start up every time the desktop does
and takes very little memory.

----------------------------------------------------------------------------

IconClock

This program displays a clock on the iconbar. The clock may be either a
twelve or twenty four hour clock. The clock also has three types of clockface
available. These are raised, lowered and border. The time format and
clockface type can be selected from the iconbar menu and its submenus.

This is a module application and so will start up every time the desktop does
and takes very little memory.

----------------------------------------------------------------------------

UUDecode

This program decodes uuencoded files.

I have extended the syntax of uuencoded files to allow filetypes to be
preserved. A line Filetype: <filetype> may appear before the table line (or
the begin line if there is no table). Filetypes may be either text or
numerical (with the optional & infront). So, for example, the following are
all equivalent

Filetype: &FFF
Filetype: fff
Filetype: Text

Although the later is the most understandable form I recomend that it is only
used with filetypes which are always known (text, data, obey, etcetera). For
example if you use Filetype: DrawFile and !Draw has not been sent then the
filetype will be unable to be recognised and the filetype of the last
uudecode (or Text if this the first uudecode) will be used. My uuencoder
adds this line automatically.

Credit must go to Phil Colmer (Fil, at Acorn) for his help in fixing some
minor bugs and making one minor alteration to the operation of the program.
These are documented in the source.

The final I thing I have to say about this program is sorry for the really
corny sprite (two sheep - think about it). If you can't work it out there are
rams and .... ?

Note as Fil has modified this I cannot solely grant people permission to use
this program (or parts of it) in their own programs. If you mail me and I
will ask him (I doubt he will mind).

----------------------------------------------------------------------------

UUEncode

This program uuencodes files. To uuencode a file drag it onto the iconbar.
Awindow will be openned prompting you for the name to insert in the line
begin 664 <filename>
The default is the leafname of the file dragged onto the iconbar. After this
a save window is openned (in a fairly random place due to the way the
RiscOsLib works) allowing you to save the uuencoded file. The default
filename is uuencode with filetype uuencode. I use this filetype because it
enables me to use PCDir to add an automatic .UUE to the file when transfering
onto a MSDOS disc.

Files may be split in either number of lines (the usual way for uuencoded
files) or in size in K (which I find a lot more useful). All parts are stored
in the same directory (the one where the first part was dragged into).

A line
Filetype: <filetype in hex>
is automatcally added for use with my uudecoder.

----------------------------------------------------------------------------

SetType

This allows the filetype of files to be changed under the desktop. From it's
icon on the iconbar (which shows the current selected filetype) a menu may be
brought up which has a submenu filetype. This submenu contains a list of all
the filetypes known (via the File$Type_xxx variables) and a writeable entry.

This is a module application and so will start up every time the desktop does
and takes very little memory.

----------------------------------------------------------------------------

TurboFontLister

This module makes the reading of the fontlist, for a given path, virtually
instantaneous. Any calls to read the fontlist (such as when applications
start up) are intercepted and if the fontpath being read is the one "known"
to the module then the fontlist is returned from memory as opposed to being
read from disc. If the fontpath being read is not the one recognised by the
module then the call is passed onto the fontmanager.

----------------------------------------------------------------------------

PlaceIt

For those of you who do not know what PlaceIt is here is a brief description.
It allows files,directories and applications to be stuck to the background.
From here they can be handled in exactly the same way as if they were in a
filer window.

A change directory icon may put on the background which allows the directory
to be changed by dragging it into a filer window.

A recent addition in 1.10 was the ability to display a sprite behind the
background. The sprite can either be tiled or centred on the background.

The menu structure has been radically changed in this release and a new
feature added. See the !Help, History and ReadMe files for info.

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

For each application see the !Help or ReadMe for full details and
disclaimers.

If you like !PlaceIt (and the other applications) and want to show your
appreciation, I'd like to enlist your support for the charity "BreakOut
Children's Holidays".

They run holidays for children who are really in need of a break. Seeing the
difference it makes to the children's lives makes the time and effort put in
by all the dedicated volunteers worthwhile. Like all charities they are
constantly in need of funding.

Please send donations to "Breakout Children's Holidays" to the appropriate
address below:

        Until 28th June 1991
        Ian Ashley,
        55C Redfern,
        University of Warwick,
        Coventry
        CV4 7AL

        after 28th June 1991
        Ian Ashley,
        14 Whitelands Avenue,
        Chorleywood,
        HERTS.
        WD3 5RD

I will place you on a list of appreciative PlaceIt users and would be more
than willing to implement any additions to PlaceIt for you which I think
would be beneficial to its users in general.

GO ON MAKE A CHILD'S DAY.

PMF