dfe(1)
also allows the user to define a variety of
overlay objects
which are used by the
DAISY
system in order to extract sub-objects from the image to be classified and then to transform
them to a standard pose. Overlay objects are saved in a manner which permits
dfe(1)
to load them with their associated image at a later date. The tool also supports fully interactive
geometric transformation of the image. For example, images may be clear rotated by an arbitrary angle
(via Paethe rotation), shifted and cropped. Some image operations (for example rotation) are accomplished
via a slaved
ImageMagik
convert(1)
filter. These options will not be available if the
dfe(1)
application has no access to
convert(1).
dfe(1)
also supports a number of options to modify the colourmap and histograms of captured imagery. Although
some of these options are native to
dfe(1)
(e.g. builtin), many require access to tools such as
convert(1),
xv(1),
or
TINA(1)
to perform the image processing operations (and are implemented as EPS scripts). This scheme is very
flexible, as the user is free to define their own bespoke image processing operations.
dfe(1)
supports many interactive options. These are documented in via the on-line help system which
is accessed by pressing the [help] button on the top panel of
dfe(1).
-verbose
Tells
dfe(1)
to report what it is doing via
stderr.
-id
sets the image I.D. which is to be used by the DAISY system when classifying
unknown images captured by this instance of
dfe(1)
-image_browser
tells
dfe(1)
to start a slaved instance of the
(image) viewer application
to provide desktop access to the (unknown) image directory. Images can be loaded
into
dfe(1)
using the sensitive directory invoked by
-dfe_sdir.
Note this process is homeostatically protected. If it is killed,
dfe(1)
will start a fresh instance of it.
-dfe_sdir
panner delay
tells
dfe(1)
to scan a sensitive input directory and to start a slaved instance of the
(image) viewer application
to provide desktop access to it. Images copied to the
sensitive directory are detected by
dfe(1)
and loaded. If an overlay file is present in the sensitive directory
(it must be dragged in first) it is also loaded. Note this process is homeostatically
protected. If it is killed,
dfe(1)
will start a fresh instance of it.
panner delay
sets the delay (in seconds) before an image dragged into the mouth directory is read
by
dfe(1).
-auto_raise
tells
dfe(1)
to move to the top of the window hierarchy when it recieves image data from the
panner subsystem. This option is only valid if
-dfe_sdir
is also specified.
-key
set the image which is to be used by the DAISY system when classifying
unknown images captured by this instance of
dfe(1)
-tdir
specifies the direcrtory in which
dfe(1)
is to place training images.
-sdir
specifies the directory in which
dfe(1)
is to place unknown images.
-hdir
specifies the directory in which
dfe(1)
may find HTML pages which provide help information on the
dfe(1)
system.
-browser
tells
dfe(1)
which browser application to use to display pages of HTML. Defaults to
mozilla(1).
-viewer
tells
dfe(1)
which viewer application to use to display (image) files. Defaults to
gthumb(1).
-darwin_url
specifies the URL for the UK Darwin Initiative Web Site. Defaults to
http://www.research.detr.gov.uk
-daisy_url
specifies the URL for the DAISY Web Site. Defaults to http://www.daisy.net/daisy.html
-pups_url
specifies the URL for the PUPS Web Site. Defaults to http://www.daisy.net/pups.html
-compress_image
tells
dfe(1)
to apply JPEG compression to (output) imagery.
-squash_units
suppress metric (if any) supplied in the relevant fields of the input image TIFF header.
-squash_vport
do not force image to be processed so a best fit to the drawing area of the
dfe(1)
tool (4:3) is computed.
-continous
tells
dfe(1)
to set overlay input mode to
continous.
This mode is designed for use with styluses and graphic tablets. Click to enter (
point
) mode (the alternative mode to
continuous
) is designed for standard mouse input.
-fd_float
tells
dfe(1)
to make file dialogues floating.
-vd_float
tells
dfe(1)
to make vector dialogues floating.
-pix_to_units
scale factor
specifies a scaling factor between image pixels and a metric (cm, mm or inches).
cob_size
size
specifies the size of a calibration object (visible in the image) in an appropriate metric
(cm, mm or inches).
-odir
output directory name
specifies the output directory (to which images are written).
-tset_basename
basename
specifies the basename for training set images. When
dfe(1)
saves training set image (in the training set directory) the file names are of the form:
basename._crc_.tset.tiff
where
crc
is a cyclic redundancy checksum computed using the image body.
-idir
working directory
specifies the working directory (for unknown images).
-image_name
name
specifies the name of a TIFF image to be loaded by the
dfe(1)
application. If an additional filename argument is supplied it is assumed to
be an
overlay object file
associated with the image.
-lifetime
seconds
specifies lifetime (in seconds) of
dfe(1)
output imagery.
-key
key list
specifies image key (for floret etc.).
-id
uid
specifies the location of the user (e.g. terminal) to which information is to be sent.
Defaults to user i.d. of the owner of this invocation of
dfe(1).
-state
specifies (unknown) image state tag.
-otag
tag
specifies computational output tag. Defaults dfe.out.
-save_warning
enables alert which appears when user tries to save an image.
-load_warning
enables alert which appears when user tries to load an image (without saving
previous image).
-save_warning
enables alert which appears when user tries to save an image.
-load_warning
enables alert which appears when user tries to load an image (without saving
previous image).
-f
button index, DLL name, DLL function
tells
dfe(1)
to attach (PUPS Orifice format)
DLL function
which is exported by DLL
DLL name.
This dynamic function is bound to
dfe(1)
raster function button
button index.
-f
button index, EPS script name, EPS script type
tells
dfe(1)
to bind an EPS (embedded pipestream script) stored in file
EPS script name
to
dfe(1)
raster function button
button index.
The
EPS script type
specifies whether the script is an image processing script or a service script.