README.md

# S7

This is a simple scanning application with these goals:

 - full page scan
 - known number of pages to scan
 - double-sided handling
 - multiple output file format: PNG, JPEG, TIFF, PNM and PDF
 - apply an optional stamp on each page.

It is based on [libinsane](https://gitlab.gnome.org/World/OpenPaperwork/libinsane) and [wxWidgets](https://wxwidgets.org).

![S7_01](S7_01.png)

### Usage

Inputs:

 - a target directory
 - the basename of the output file(s)
 - the number of faces to scan
 - double-sided or not
 - the scanner and its minimal parameters (source, mode, resolution)
 - page size
 - output file format.
 - an optional stamp text

Right click on the 'New' label to specify the number of faces and whether double-sided scanning is needed.

'Shift + left click' on the 'New' label to update the output path.

Right click on the 'Scan' button to set the device properties.

'Ctrl - right' click on the 'Scan' button to define stamps.

Press 'Esc' to cancel and reset a scan project.

Outputs:

 - a single PDF file with the number of requested pages
 - multiple PNG files with a padded index as suffix.

### Double-sided scanning

This has meaning if an automatic document feeder (ADF) is used to scan multiple pages on both sides.

Feed in all the pages on the front face, then turn the whole pile of pages even if an odd number of pages is requested and continue scanning.

If only front faces are needed with an ADF, uncheck the 'Double-sided' option.

### Notes

The project targets Linux only using wxGTK3.

When running under Wayland, set the 'GDK_BACKEND=x11' environment variable to avoid unexpected results.

### Disclaimer

Use at your own risks.
Initial commit. 2025-06-28 17:40:42 +02:00			`# S7`

			`This is a simple scanning application with these goals:`

			`- full page scan`
			`- known number of pages to scan`
			`- double-sided handling`
Add a 'Stamp' widget. Place one or multiple stamps on scanned pages in defined locations. A stamp is understood here as - a transparent text in a transparent frame with no borders - an opaque text on an opaque background with no borders. Stamp parameters: - text - font - foreground colour - background colour - angle of rotation - transparency. Locations: - centre - cardinal directions - inter-cardinal directions. 2025-07-01 22:38:07 +02:00			`- multiple output file format: PNG, JPEG, TIFF, PNM and PDF`
			`- apply an optional stamp on each page.`
Initial commit. 2025-06-28 17:40:42 +02:00
Add a 'Stamp' widget. Place one or multiple stamps on scanned pages in defined locations. A stamp is understood here as - a transparent text in a transparent frame with no borders - an opaque text on an opaque background with no borders. Stamp parameters: - text - font - foreground colour - background colour - angle of rotation - transparency. Locations: - centre - cardinal directions - inter-cardinal directions. 2025-07-01 22:38:07 +02:00			`It is based on [libinsane](https://gitlab.gnome.org/World/OpenPaperwork/libinsane) and [wxWidgets](https://wxwidgets.org).`
Initial commit. 2025-06-28 17:40:42 +02:00
			`![S7_01](S7_01.png)`

			`### Usage`

			`Inputs:`

			`- a target directory`
			`- the basename of the output file(s)`
			`- the number of faces to scan`
			`- double-sided or not`
			`- the scanner and its minimal parameters (source, mode, resolution)`
			`- page size`
			`- output file format.`
Add a 'Stamp' widget. Place one or multiple stamps on scanned pages in defined locations. A stamp is understood here as - a transparent text in a transparent frame with no borders - an opaque text on an opaque background with no borders. Stamp parameters: - text - font - foreground colour - background colour - angle of rotation - transparency. Locations: - centre - cardinal directions - inter-cardinal directions. 2025-07-01 22:38:07 +02:00			`- an optional stamp text`
Initial commit. 2025-06-28 17:40:42 +02:00
			`Right click on the 'New' label to specify the number of faces and whether double-sided scanning is needed.`

			`'Shift + left click' on the 'New' label to update the output path.`

			`Right click on the 'Scan' button to set the device properties.`

Allow cancelling a scan session. - perform scanning in a thread - change the label of the scan button - trigger cancel with the same button and with the ESC key - process all GUI updates in asynchronous mode. Do not use a top window as parent of popups: - If a top window goes away in an application with multiple instances of XInsaneWidget, any call to a scanner widget leads to a crash. Minor changes. 2025-07-11 21:10:59 +02:00			`'Ctrl - right' click on the 'Scan' button to define stamps.`

			`Press 'Esc' to cancel and reset a scan project.`

Initial commit. 2025-06-28 17:40:42 +02:00			`Outputs:`

			`- a single PDF file with the number of requested pages`
			`- multiple PNG files with a padded index as suffix.`

			`### Double-sided scanning`

			`This has meaning if an automatic document feeder (ADF) is used to scan multiple pages on both sides.`

			`Feed in all the pages on the front face, then turn the whole pile of pages even if an odd number of pages is requested and continue scanning.`

			`If only front faces are needed with an ADF, uncheck the 'Double-sided' option.`

			`### Notes`

			`The project targets Linux only using wxGTK3.`

			`When running under Wayland, set the 'GDK_BACKEND=x11' environment variable to avoid unexpected results.`

			`### Disclaimer`

			`Use at your own risks.`