PsiFS: File Format Converters

The !PsiFSRes file is loaded by PsiFS immediately after processing the associated !PsiFS file. The templates within the file are merged with those belonging to PsiFS itself, as well as those belonging to other file format converters, so it is essential that unique names are used for all templates. Hence, the converter part of the PsiFSConverter$converter variable should be used as a prefix for all template names.

Any number of toolbox templates may be included within the resource file, and any template may be used for any combination of file format converters. However, there are some restrictions; these are described in the following sections.

The Other window properties should also be set as follows:

Property	Type	Setting
Pane	Required	Off
Hot keys	Required	Off
Moveable	Recommended	On
Auto-redraw	Required	On
Backdrop	Required	Off
Real colours	Recommended	Off
Allow off-screen	Recommended	Off
Force on-screen	Recommended	Off
Button type	Required	0
Extendable X	Recommended	Off
Extendable Y	Recommended	Off
User scroll	Required	Off
Sprite area	Recommended	Wimp
Pointer	Recommended	Off

The Window colours should be set at the defaults as follows:

Property		Type	Colour
Title bar	Foreground	Recommended	7
	Background	Recommended	2
	Input focus	Recommended	12
Work area	Foreground	Recommended	7
	Background	Recommended	1
Scroll bars	Foreground	Recommended	1
	Background	Recommended	3

The Minimum size and Work area should normally both be set to the normal size of the window. No toolbars should be attached to the window.

All gadgets types other than Label and Labelled Box should have appropriate help text specified. Also, all gadget types other than Action Button should have delivery of events disabled; they are not required by PsiFS. The initial values specified for each gadget within the resource file are used as a defaults if no previously used options are available.

There are no specific requirements concerning component IDs, other than that they need to agree with the values specified in the !PsiFS file.

The second is used by the user to discard the selected options:

Property	Type	Setting
Component ID	Recommended	&1
Text	Recommended	"Cancel"
Show object	Required	Off
Deliver event	Required	Default
Default	Required	Off
Cancel	Required	On
Local	Required	On
Help text	Recommended	"Click SELECT (or press ESCAPE) to close the box without applying any changes.|MClick ADJUST to reset the contents of the box."
Faded	Required	Off

Additional Action Button gadgets are not supported.

The "N" specification is used for Number Range options. The value returned is an unscaled interger in the range 0 to 2,147,483,647; any Precision specification is ignored. If a fractional value is required then it must be post-processed to scale the value as appropriate.

The "O" specification is used for Option Button options. No value is returned; the state of the gadget is indicated by the presence of the specified switch.

The "R" specification is used for Radio Button options. No value is returned; the state of the gadget is indicated by the presence of the specified switch. Note that exactly one switch will be returned for a particular radio group.

The "S" specification is used for String Set options. The value returned is the selected string. Note that the value will be quoted if it contains " " (space) or """ (quotation mark) characters, or if it starts with a "-" (hyphen-minus) character. If values different from the displayed strings are required then post-processing must be used to map the value as appropriate.

The "W" specification is used for Writable Field options. The value returned is the entered string. Note that the value will be quoted if it contains " " (space) or """ (quotation mark) characters, or if it starts with a "-" (hyphen-minus) character.