## Description
This project, `pdf-to-image-python`, is a high-performance utility designed to convert PDF documents into high-quality images while perfectly preserving native page proportions. It leverages the PyMuPDF (fitz) engine to handle complex PDF layouts and provides both batch processing for entire documents and single-page extraction (specifically for cover pages). The system dynamically calculates resolution scaling based on target DPI, ensuring crisp output for any source page size.

## System Overview

```mermaid
graph TD
    A[PDF Input] --> B{Process Type}
    B -->|Single| C[single_page.py]
    B -->|Batch| D[all_page.py]
    C --> E[First Page Export]
    D --> F[Full Document Export]
    E --> G[Output Folder]
    F --> G
```

## Project Structure

```text
pdf-to-image-python/
├── .gitignore          # Git ignore rules
├── PDF/                # Input PDF directory
├── output/             # Generated images directory (auto-created)
├── LICENSE             # Project license
├── README.md           # Main documentation
├── STACKS.md           # Technical stack audit
├── all_page.py         # Full PDF conversion script
├── requirements.txt    # Dependency list
└── single_page.py      # First page conversion script
```

## Techstack
Audit of project files (excluding environment and cache):

| File Type | Count | Size (KB) |
| :--- | :--- | :--- |
| PDF (.pdf) | 16 | 15152 |
| PNG (.png) | 17 | 1952 |
| Python (.py) | 3 | 9.8 |
| Markdown (.md) | 3 | 4.3 |
| Text (.txt) | 2 | 0.1 |
| License | 1 | 1.1 |

**Total Files**: 42

## Dependencies
- **Python**: 
  - `PyMuPDF` (fitz): Core PDF rendering and processing.
  - `argparse`: Command-line argument parsing.
  - `os`: File system operations.
  - `glob`: Filename pattern matching.

## Applications
- Google Antigravity
- Google Gemini Pro
- Visual Studio Code
- Windows PowerShell