AppGuru templates
A template is a save file from WorkShop Visual, combined
with a set of resources in the WorkShop Visual resource file. The save file
specifies what is in the template, and the resources specify what can
be done to the template within AppGuru.
In the WorkShop Visual resource file, there is a section devoted to AppGuru
templates. This specifies which tempaltes are available, the files in
which they are contained, and what components within these templates
are removable.
To create your own template, create a file which contains everything
you will want to put into it, and then change a resource file which
will be available to WorkShop Visual at startup so that it kmows about the
template. So, for example, if you wanted to make a tempalte available
to all users or your WorkShop Visual installation, you might change the
resource file for WorkShop Visual in the installation itself, whereas if
you only wanted to use the template yourself, you would change your
~/.Xdefaults file.
The AppGuru resources
The visu.templates resource lists the available templates in a
comma-separated list. Each template has a name here, which is used as
a key to look up other resources relevant to that template.
These resources are as follows (replace template with
the name of a template or component with the name of a
component to get what you would see in the resource file):
- visu.tm_appguru_menu*template.labelString
- This resource defines the name of the template as it will appear
in the AppGuru menu, which is accessed from the Tools menu in the
WorkShop Visual main window.
- visu.template.saveFile
- This resource tells AppGuru where to find the save file which
contains the save file on which the template is based
- visu.template.template
- This specifies the list of components in the
template. A component is a part of the template which can be
included or elided depending on the setting of its associated
toggle. Each component is represented by a pixmap (in the pictorial
representation of the template) and a toggle button for specifying
whether the component should be included or elided.
- visu.template.pixmapDirectory
- This tells AppGuru where to look for the pixmap files which are
used in creating the pictorial representation of the design. It is
a standard path, and can include environment variables.
- visu.template.component.toggleLabel
- This specifies the name of a particular component; it is use to
provide a text label for the toggle which controls the
inclusion/omission of the component.
- visu.template.component.pixmap
- This specifies the pixmap which is used within the template to
represent the component; it takes the form x, y, width, height,
filename, where filename is relative to the pixmap
directory described above.
- visu.template.component.widgets
- This specifies the list of widgets which make up this component
- it takes the form of a comma-separated list.
- visu.template.extraPixmaps
- Most templates are composed of a design in which not all widgets
are components that the user might want to filter out. For example,
the default template has a main window, a number of components
which can be used within it, and a number of utility dialogs. The
main window is always present in any design generated from this
template. The extraPixmaps resource specifies the pixmap(s) which
are to be used to represent the non-filterable components. The
format is x, y, width, height, filename, x, y, width, height,
filename, ...
See also: