ReadMe for Select 3 features supporting files
=============================================

This document explains some of the supporting files provided with the
release of the Select 3 features. These images and associated files may be
distributed without limitation, but must not be misrepresented.

These support files were created using pre-release software and may not
represent the functionality present in the release version of Select 3.


AlphaSprite/png
---------------
This is a screenshot for !Draw, showing the effect of an overlayed
alpha-channel sprite on top of an example Drawfile. The 'icicles'
demonstration image can be found on the PNG website at
http://www.libpng.org/.


ExampleButtons0/png
-------------------
The example chosen to use for the button effects is the Display manager
dialogue box. This is a small window which has the main action button and
two information fields and therefore demonstrates the two major types of
buttons. In this example, all the options are off and the standard
rectangular buttons are present.


ExampleButtons1/png
-------------------
In this example, the rounded borders have been enabled and affect both
the information fields and the buttons themselves. The information fields
can be left as rectangular if desired. The curve type has been left at
'Normal' although there are four levels of curve which can be used which
increase or reduce the size of the curve on such buttons.


ExampleButtons2/png
-------------------
In this example, the rounded buttons are disabled, but the action buttons
have been coloured lilac and the 'fade' and 'rim' options enabled. The
'fade' option causes the buttons to be given a fade from the 'light-side'
colour at the top to the 'dark-side' colour at the bottom. The 'rim' places
a border around the icons which makes them stand out more.


ExampleButtons3/png
-------------------
In this example, the background of the buttons has been made a dark blue
and the text colour into a white-cream. This effect is not ideal for most
users but may look more effective with other customised effects. The
information fields have the same 'fade' effect enabled, making them look
a little more metallic. Again, this may not be to many users tastes.


FilerConfiguration/png
----------------------
As with the changes in Select 2 which brought in the Window configuration
tool using independant sections to configure the options, the re-write of
the Filer configuration tool has used the same base. This example shows
some of the options for the thumbnailing display.


Info/png
--------
The obligatory OS information window. It's not much different from normal,
except for the OS name and version number.


IFCList/txt
-----------
This text file lists the 'ImageFileConvert' modules present on the system
being used for these examples. These modules provide conversion services
which are used by thumbnailing, by Paint and Draw, and are available for
use by other clients. Some of the conversions are registered implicitly
by the ConvertSprite module, allowing any ImageFileRender handler to be
converted to a sprite.


IFRList/txt
-----------
This text file lists the 'ImageFileRender' modules present on the system
being used for these examples. These modules provide the rendering services
for the ImageFileConvert modules, for the Image Viewer application and are
available for use by other clients. In a similar way to the ImageFileRender
modules being made available for conversion to Sprite in ImageFileConvert,
conversion modules which generate types which are renderable through native
methods are registered implicitly by the ImageFileConvert module. That is...
Type &132 (.ico) files can be converted to type &FF9 (sprite) which is
renderable through ImageFileRender; as a result, the ImageFileConvert module
implicitly registers a renderer for type &132 (.ico) files, thus allowing
such files to be rendered through the normal ImageFileRender interfaces.

ImageFileRender is usually shortened to 'IFR'. ImageFileConvert is usually
shortended to 'IFC'. There is a toolbox gadget which renders files through
ImageFileRender (which is used by the Image viewer application), called
ImageFileGadget. This is usully shortened to 'IFG'.


ImgViewer/png
-------------
The Image Viewer application is a new tool which is used to view images
which are renderable through ImageFileRender. Because these images can
be colourmapped (a Select 2 feature) it is possible to change the gamma,
brightness and contrast of such images when they are rendered.


ListOfModules/txt and ListOfDisc/txt
------------------------------------
These example files show the modules present in the ROM, and the components
used to construct the disc build on the machine being used to generate these
examples. It is supplied for the terminally curious. As with Select 2, a
summary of the changes for each individual component will be supplied.


Paint/png
---------
This example show the new version of Paint, editing its own icon. In
particular, the tool pane is now attached to the image window in a similar
manner to Draw, and the tool operations are a separate pane beneath the
image window. The 'dropper' tool can be used to select colours from the
image in a similar manner to the menu entry. The currently in use colour
is shown beneath the image, making it simpler to edit the image.


Recyclone/png
-------------
This example shows the contents of the recycle bin. Strictly it's just a
filer window like any other. The bin itself appears on the iconbar.


ResolverConfiguration/png
-------------------------
This example shows the new Resolver configuration, together with a menu of
the 'local' servers. The tool can identify DNS servers on the local network
and present them in a menu for selection.


TextSelections/png
------------------
This example shows the effect of selecting text in a writeable icon. The
selection colours here have been set to blue and white, but are user
configurable, defaulting to 'invert the current text colours'. Text may be
selected using either the mouse or the keyboard.


ThumbnailTypes1/png
-------------------
This example shows a directory of images files in Large icon mode. As can
be seen, the files are different formats and most of them are non-native
types.


ThumbnailTypes2/png
-------------------
This example shows the same files as the previous window, but in Thumbnails
display mode. The GIF image has been processed but the current conversion
module will always generate a standard GIF icon. Licensing restrictions
prevent us from distributing the full GIF decoder.
