XCUECAT(1)XCUECAT(1)NAMExcuecat - GUI X interface to the :Cue:Cat™ wand scanner.
SYNOPSISxcuecat [ file ]
DESCRIPTION
The xcuecat script opens an X dialog to allow the user to interact with
the :Cue:Cat™ wand scanner. The file argument, if present, is used
for the initial configuration file. If it is not present, then .xcuecat
in the users home directory will be used.
The top part of the dialog - labeled Bar code - has an entry area
labeled Scan. To start a scan, activate this area, and then scan a bar
code with the :Cue:Cat™ scanner. After a successful scan, the bar code
proper is displayed in the area labeled Code, and the type of the bar
code in the area labeled Type. The Code area is selected, and may be
pasted into another application immediately after the scan.
The second part of the dialog - labeled Filter - is a radio selection
controlling the translation of the scan. If None is selected, the scan
will be translated into an EAN13 type code. If ISBN is selected, then
the scan will be translated into an International Serial Book Number
type code if that is possible. If any other type of bar code is
scanned, the scan will not be considered successful. If UPC is
selected, than the scan will be translated into a Universal Product
code if that is possible. Any other type of bar code scanned will fail.
The third section - labeled State - controls the behavior of the Gui.
The checkbox labeled Beep after scan will cause a successful scan to
generate audible feedback if it is checked . The checkbox labeled Bal‐
loon help will enable balloon help if it is checked. Finally, the
entry area labeled Command can be used to enter a shell command to be
executed after a successful scan. It should have a single “%s” which
will be replaced by the code resulting from the scan before being
passed to the shell. To get a single “%” in the command, use “%%”. See
the cuecat(1) manual page for example commands.
The next to last part of the dialog has three buttons, Load, Save, and
Exit. Load and Save open dialogs to load and save the configuration
file, defaulting to the current configuration file. After the file is
loaded or saved, it becomes the current configuration file. The Exit
button will save the current configuration to the current configuration
file and then exit. If the window manager is used to close the window,
the application will exit without saving the current configuration.
If the operating system cooperates, the saved configuration files will
be executable. Running them will run xcuecat using that configuration
file. For this to work, the operating system must support #! executa‐
bles, must have a env(1) command, and the envName attribute of the
Scanner class in xcuecat must match. This may need to be edited for
your operating system.
The last part of the dialog is an unlabeled message area where longer
help messages and the results of various actions are displayed.
SEE ALSOcuecat(1)env(1)XCUECAT(1)
