GnomeScanAcquisitionDialog

GnomeScanAcquisitionDialog — Give the user the acquisition control

Synopsis




                    GnomeScanAcquisitionDialog;
GtkWidget*          gnome_scan_acquisition_dialog_new   (GtkWindow *parent,
                                                         GnomeScanJob *job);
void                gnome_scan_acquisition_dialog_run   (GnomeScanAcquisitionDialog *dialog);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----GnomeScanAcquisitionDialog

Implemented Interfaces

GnomeScanAcquisitionDialog implements AtkImplementorIface and GtkBuildable.

Properties


  "job"                      GnomeScanJob          : Read / Write / Construct Only

Description

The acquisition process might be long, the GnomeScanAcquisitionDialog primarily shows a progress bar and of course, allow user to cancel the job.

The GnomeScanAcquisitionDialog also has nice UI to handle mass acquisition. This is done through a simple UI in order to make it very quick. The dialog shows a stop button which either cancel a running acquisition or end the mass acquisition process. Ideally, the scanner has automatic document feeder and the user just puts its photos/document page and trigger acquisition. However, since most scanner does not have such feature (e.g. flatbed scanner or sheetfed scanner), GnomeScanAcquisitionDialog shows a Next button that redo the scan with the same configuration. The idea is to allow the user to put page, configure, trigger, put next page, press Enter, and loop until there is not other page.

The acquisition and processing is done in a work thread. See GnomeScanJob and gnome_scan_job_run().

Details

GnomeScanAcquisitionDialog

typedef struct _GnomeScanAcquisitionDialog GnomeScanAcquisitionDialog;

A struct with a looonnnng name.


gnome_scan_acquisition_dialog_new ()

GtkWidget*          gnome_scan_acquisition_dialog_new   (GtkWindow *parent,
                                                         GnomeScanJob *job);

Create a new dialog ready to run job

parent : the parent GtkWindow
job : the GnomeScanJob to run
Returns : a new GnomeScanAcquisitionDialog

gnome_scan_acquisition_dialog_run ()

void                gnome_scan_acquisition_dialog_run   (GnomeScanAcquisitionDialog *dialog);

Start a GMainLoop, run GnomeScanAcquisitionDialog:job in a worker thread, monitor progress and allow user to control the execution of the job. Note that the progressbar is updated about 24 times per seconds.

Property Details

The "job" property

  "job"                      GnomeScanJob          : Read / Write / Construct Only

The job being monitored by the GnomeScanAcquisitionDialog.