NAME

       engauge-digitizer - interactively convert a bitmap graph or map into numbers

SYNOPSIS

       engauge [options]

DESCRIPTION

       This manual page documents briefly the engauge command from the engauge-digitizer package.

Startup

       -import FILE
              Automatically  import  the specified image file at startup. Image files may also be
              imported manually using the menu

       -open FILE
              Automatically open the  specified  Engauge  Digitizer  document  file  at  startup.
              Document files may also be opened manually using the menu

       -help  Display  a  list of command line options similar to this manpage in an X window and
              exit

       -manual DIRECTORY
              Look for the HTML user guide in the specified directory. For Debian it is installed
              in /usr/share/doc/engauge-digitizer/usermanual and should need no configuration.

       -axes XMIN XMAX YMIN YMAX
              Scan  the imported file at startup, and locate the X and Y axes. Then digitize axis
              points assuming the X axis ranges from XMIN to XMAX, and the  Y  axis  ranges  from
              YMIN  to  YMAX. The X axis is assumed to be near the bottom of the image, and the Y
              axis is assumed to be on the left side of the  image.  For  speed,  no  attempt  to
              rotate the image if it is sideways, so the digitized points may require adjustment.
              This feature should be useful when using Perl or other  scripts  to  digitize  many
              images with known axes ranges. The axis points may also be digitized manually using
              the Digitize Axis Points mode

       -lazysegments
              Postpone scanning for segments that is normally  performed  during  startup,  until
              either the Segments dialog is used, or the Segment Fill button is selected.

Shutdown

       -export FILE
              Automatically  export  the  active  document  at  shutdown.  Documents  may also be
              exported manually using the menu.

Settings

       -reset Reset all settings to the factory defaults. This option is a fast and easy  way  to
              restore  all settings to a useful configuration, especially when there are problems
              with  one  or  more  settings.   Settings  are  stored  in  a  text  file  such  as
              $HOME/.qt/engaugerc.

Debugging

       -pixels
              Show cursor location in pixel coordinates rather than graph coordinates

       -ctor  Trace constructor calls

       -dtor  Trace destructor calls

       -curvecmb
              Trace curve combobox operations

       -measurecmb
              Trace measure combobox operations

       -refresh
              Trace screen refreshes

       -scanning
              Trace image scanning

Environment variables

       ENGAUGE_BROWSER
              To start up the date/time converter from within Engauge Digitizer, this environment
              variable must be set to the shell command that runs a  javascript-capable  browser.
              Examples are 'firefox', 'konqueror', ...

       ENGAUGE_USERMANUAL
              If  set, this specifies the directory containing the user manual. This option, like
              the '-manual' command line option, should not be needed on a Debian installation.

SEE ALSO

       The program is documented quite nicely in the HTML  user  guide  and  tutorial,  available
       under /usr/share/doc/engauge-digitzer/usermanual or from Help within the running program.

AUTHOR

       engauge-digitizer was written by Mark Mitchell <mmdigitizer@earthlink.net>.

       This  manual  page  was  written  by  Tobias Stefan Richter <tsr-debian@achos.com> for the
       Debian project (but may be used by others).

                                        December 14, 2006                    ENGAUGE-DIGITIZER(1)