SpecialFX 1.01
==============

by David Pilling

with SpecialFX Setup by Richard Hallas

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


************************************************************
***                                                      ***
*** THIS IS AN ABRIDGED HELP FILE PROVIDING INSTALLATION ***
***  INSTRUCTIONS. FOR FULL INFORMATION, REFER TO THE    ***
***    !HELP FILE WITHIN THE !SPECIALFX APPLICATION      ***
***                                                      ***
************************************************************


SpecialFX is a desktop enhancement module which provides three
basic functions:

1. SpecialFX causes calls to the Draw module to be redirected
   to Computer Concepts' GDraw module, thus providing an
   anti-aliased display.

2. SpecialFX causes outline font painting operations to be
   performed with background blending.

3. SpecialFX can cause all printing to occur from low memory
   in applications which use dynamic areas. This provides a
   work-around for a problem in certain printer drivers, such
   as those for Calligraph direct drive laser printers, which
   do not work correctly with particular applications.

Installation
============

IMPORTANT: be sure to read the note below concerning
additional support modules.

If you have been using version 1.00 of SpecialFX, it is
recommended that you delete it from your system to avoid
problems, as the way in which SpecialFX is structured has
changed significantly. However, if you have edited the
SpecialFX choices, you may retain your changes. To do so,
simply run SFXSetup (it will tell you that your version 1.00
choices have been imported) and click Save. Then delete your
old copy of SpecialFX.

SpecialFX 1.01 consists of two components: the module itself
and a configuration tool. These should be installed as
follows:

- !SpecialFX

  This is the resource application containing the SpecialFX
  module. It should be kept in the !Boot.Resources directory.

- !SFXSetup

  SpecialFX Setup is compatible with RISC OS 4 Configure, so
  on a RISC OS 4+ machine it is recommended that it should be
  kept within the Configure application. However, it may be
  used independently of Configure and hence may be stored
  anywhere convenient.

If you are using the latest version of RISC OS (as supplied on
a RISC OS Select CD, for example), the SpecialFX components
should have been pre-installed correctly on your system. If
not, simply drag !SFXSetup into the Configure>Extensions
window to install it into that group.

If you are using RISC OS version 4.0x, you will need to copy
!SFXSetup into the !Boot.RO400Hook.Res.Configure directory in
order to install it into Configure.

If you are using the initial Web-download version of Select
(RISC OS 4.24), you will need to copy the supplied !ExtnSetup
application into !Boot.RO420Hook.Res.Configure, and then copy
!SFXSetup into the newly-installed !ExtnSetup.

Once the two applications have been placed into appropriate
locations, run the SpecialFX Setup tool and ensure that the
'Always load SpecialFX' switch has been turned on. This will
cause the SpecialFX module to be loaded whenever the computer
is booted up.

Note on additional support modules
==================================

For anti-aliasing to work, both the GDraw and DitherExtend
modules must be loaded. It is also beneficial for a third
module, GSpriteExtend, to be loaded, though this is not an
essential requirement. These support modules are provided
within various Computer Concepts products, such as the
Impression DTP family and ArtWorks.

When SpecialFX is run, the computer attempts to load these
modules (if they're not present already) from inside either
the !CCShared directory within !System or the ArtWorks Viewer
application.

Most RISC OS computers will have at least one Computer
Concepts product installed, and are therefore likely to have a
CCShared directory inside !System already. To check, issue the
command "*Filer_OpenDir <System$Dir>"; the resulting window
should contain a !CCShared application.

If your system does not include CCShared, then you should
ensure that the ArtWorks Viewer application is booted (not
run!) by the filer as part of your boot sequence. If you are
using RISC OS 4.2+, the ArtWorks Viewer application is already
present in the !Boot.Resources directory (where you should
have installed !SpecialFX) so you need take no further action.
