DragonFly On-Line Manual Pages

XCUECAT(1)             DragonFly General Commands Manual            XCUECAT(1)

NAME
       xcuecat - GUI X interface to the :Cue:Cat(Tm) wand scanner.

SYNOPSIS
       xcuecat [ file ]

DESCRIPTION
       The xcuecat script opens an X dialog to allow the user to interact with
       the :Cue:Cat(Tm)  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(Tm) 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
       Balloon 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 #!
       executables, 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 ALSO
       cuecat(1) env(1)

                                                                    XCUECAT(1)