![]() |
![]() |
![]() |
Gnome Scan Reference Manual | ![]() |
---|---|---|---|---|
GnomeScanAcquisitionDialog; GtkWidget* gnome_scan_acquisition_dialog_new (GtkWindow *parent, GnomeScanJob *job); void gnome_scan_acquisition_dialog_run (GnomeScanAcquisitionDialog *dialog);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GnomeScanAcquisitionDialog
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()
.
typedef struct _GnomeScanAcquisitionDialog GnomeScanAcquisitionDialog;
A struct with a looonnnng name.
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 |
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.
dialog : |
a GnomeScanAcquisitionDialog |
job
" property"job" GnomeScanJob : Read / Write / Construct Only
The job being monitored by the GnomeScanAcquisitionDialog.