RISC OS 3 - New 3D-style Icons
------------------------------

Written by Neil Spellings at Five Star Software based on information contained
in the RISC OS 3 style-guide.

(Note:  sizes are in OS units,pixels. 8 OS units should be left between icons)
(       Positioning key : V = vertically aligned, H = horizontally aligned)


Display Fields
--------------
Used to show information the user can't change by typing in the field.

x-size                  : as needed,width of text+3 either side
y-size                  : 52,13
Button type             : Never
Background colour       : 1
Foreground colour       : 7
Positioning             : Normally V + H
Type                    : Indirected + Border
Validation string       : R2

Action buttons
--------------
A button that the user clicks on to cause an action to occur.

x-size                  : as needed,width of text+3 either side
y-size                  : 52,13
Button type             : Click
Background colour       : 1
Foreground colour       : 7
Positioning             : V + H
Type                    : Text(Indirected) + Border
Validation string       : R5,3

Default action buttons 
----------------------   
A button that shows what action will take place if Return is pressed. There
must be only one per dialogue box.

x-size                  : as needed,width of text + 9 either side
y-size                  : 68, 17
Button type             : Click
Background colour       : 7
Foreground colour       : 1
Positioning             : V + H
Type                    : Text(Indirected) + Border
Validation string       : R6,3

Writable field
--------------
Used when the user has to type text to give a value or name.

x-size                  : as needed,width of text + 3 either side
y-size                  : 52,13
Button type             : Writable
Background colour       : 0
Foreground colour       : 7
Positioning             : V + H
Type                    : Text(Indirected) + Border
Validation string       : Ktar;Pptr_write


Option buttons
--------------
Can either be on or off. May have associated text to the right of it.

x-size                  : as needed
y-size                  : 44
Button type             : Radio
Background colour       : -
Foreground colour       : 7
Positioning             : V
Type                    : Text(Indirected) + Sprite, Not filled
Validation string       : soptoff,opton


Radio buttons
-------------
One of a group of mutually exclusive icons. May have associated text to the
right of it.

x-size                  : as needed
y-size                  : 44
Button type             : Action
Background colour       : -
Foreground colour       : 7
Positioning             : V
Type                    : Text(Indirected) + Sprite,Not filled
Validation string       : sradiooff,radioon


Adjuster arrows
---------------
Used to increase or decrease a numeric value. May be used in conjunction with
a slider.

x-size                  : 32
y-size                  : 32
Button type             : Auto-repeat
Background colour       : -
Foreground colour       : -
Positioning             :
Type                    : Text(Indirected) + Sprite, Not filled
Validation string       : Up arrow   : R5;sup,pup
                          Down arrow : R5;sdown,pdown
                          etc...
                          
Popup-menu button
-----------------
Used to activate a icon-specific menu.

x-size                  : 44
y-size                  : 44
Button type             : Click
Background colour       : -
Foreground colour       : -
Positioning             : V
Type                    : Text(Indirected) + Sprite, Both filled
Validation string       : R5;sgright,pgright

Label or Comment
----------------
Used to add a comment or label to other icons

x-size                  : as needed,width of text
y-size                  : 40,9
Button type             : Never
Background colour       : -
Foreground colour       : 7
Positioning             : V (+H)
Type                    : Text

Group box or frame
------------------
Used to enclose a group of icons relating to a similar subject.

x-size                  : as needed
y-size                  : as needed
Button type             : Never
Background colour       : -
Foreground colour       : -
Positioning             : -
Type                    : Text(Indirected)
Validation string       : R4
                        : May have a label attached to it.
