https://github.com/haroonhsa007/operating_scanner_with_py
https://github.com/haroonhsa007/operating_scanner_with_py
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/haroonhsa007/operating_scanner_with_py
- Owner: Haroonhsa007
- License: gpl-3.0
- Created: 2023-09-29T13:28:17.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-27T14:52:37.000Z (over 1 year ago)
- Last Synced: 2023-12-27T15:49:38.552Z (over 1 year ago)
- Language: Python
- Size: 78.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Operating Scanner with Python (A5 Scanner)
# Report on the Scanner Program
## Introduction
The provided program is a Python script that interfaces with a scanner device
to perform scanning operations. It utilizes the `pyinsane2` library,
which is a Python wrapper for the Sane scanner access library. The program
is designed to scan a document with specific settings, save it as a
JPEG image, and handle potential multiple output files with distinct names.
## Program Workflow
The program follows a sequential workflow, as described below:
### 1. Importing Libraries
The program starts by importing necessary libraries:
- `os`: Provides a way to interact with the operating system, used for file operations.
- `PIL`: Stands for Python Imaging Library, used for handling images.
- `pyinsane2`: The main library used to interact with the scanner device.
### 2. Setting Scan Area for A5
The function `set_scan_area_A5` is defined to set the scan area to A5 size.
It calculates the pixel dimensions corresponding to A5 dimensions in
millimeters and adjusts the scan area accordingly.
### 3. Main Function
The `main` function is where the core functionality of the program resides.
#### a. Detecting Scanners
The program first attempts to discover available scanners
using `pyinsane2.get_devices()`. If no scanner is detected,
it prints a message and terminates.
#### b. Selecting Scanner
If a scanner is detected, the first available scanner is selected.
#### c. Setting Scanner Options
Several scanner options are configured:
- `source`: Specifies the source of the scan (Auto or FlatBed).
- `resolution`: Sets the scanning resolution to 600 dpi.
- `set_scan_area_A5`: Calls the function to set the scan area to A5.
- `mode`: Specifies the scan mode (Color).
#### d. Scanning
The program initiates the scanning process using
`device.scan(multiple=False)`. It then enters a loop to continuously
read scan data until an End of File (EOF) error is raised.
$$ The below code can be changed for any Size depending on your Scanner
$$ Either A5 or A4 or any other size
```
def set_scan_area_A5(device):
options = device.options
# Define A5 dimensions in millimeters
a5_width_mm = 148
a5_height_mm = 210
# Convert A5 dimensions to pixels at 600dpi (1 inch = 25.4mm)
a5_width_pixels = int(a5_width_mm / 25.4 * 600)
a5_height_pixels = int(a5_height_mm / 25.4 * 600)
# Set the top-left corner coordinates (0, 0)
pyinsane2.set_scan_area_pos(options,'tl-x', lambda min_val, max_val: 0, {'tl-x': 0} )
pyinsane2.set_scan_area_pos(options, 'tl-y', lambda min_val, max_val: 0, {'tl-y': 0} )
# Set the bottom-right corner coordinates (a5_width_pixels, a5_height_pixels)
pyinsane2.set_scan_area_pos(options, 'br-x', lambda min_val, max_val: a5_width_pixels, {'br-x': a5_width_pixels} )
pyinsane2.set_scan_area_pos(options, 'br-y', lambda min_val, max_val: a5_height_pixels, {'br-y': a5_height_pixels} )
device.options = options
```
#### e. Saving Output File
The output file is named "output.jpg" initially.
If a file with that name already exists, the program iterates
through numbered names (e.g., "output_1.jpg", "output_2.jpg", etc.)
until a unique name is found. The scanned image is then saved in JPEG format.
#### f. Cleanup
After the scanning process is complete, the program prints a
success message and exits gracefully.
### 4. Executing the Program
The `if __name__ == "__main__":` block ensures that the program is
executed only if it is run directly (not imported as a module).
It initializes the `pyinsane2` library, executes the `main` function,
and then ensures that `pyinsane2` is properly exited
even if an error occurs during execution.
## Conclusion
This program demonstrates a practical use case of
interfacing with a scanner device in Python. It sets
specific scan parameters, performs the scan, and
handles the output in an organized manner. The resulting scanned
image is saved in JPEG format for further use.
## The Project was created on Anaconda keep that in mind.
First Create Venv Using
`conda create -n your_Env_Name`
It will ask for some permissions say yes then
To activate the virtual envirements use
`conda activate your_Env_Name`
$$ To DeActivate the envirements
`conda deactivate`
$$ Then to Download and install the packages use
```
git clone https://github.com/Haroonhsa007/Operating_Scanner_with_Py.git
# or
https://github.com/Haroonhsa007/Operating_Scanner_with_Py/archive/refs/heads/main.zip
# Then
pip install -r requirements
# Finally
python Scan-5.py
# Make sure that your Scanner's Connected
```