📄 Document Clean - Обновления и улучшения

🔄 Основные изменения в версии 1.2

1. Переход на Tkinter GUI

• Было: Использование OpenCV окон (cv2.namedWindow, cv2.imshow)
• Стало: Современный GUI на Tkinter с окнами верхнего уровня
• Преимущества:
  • Кроссплатформенная совместимость
  • Более современный интерфейс
  • Лучшая интеграция с выбором файлов
  • Устранение проблем с отображением на разных системах

2. Улучшенный интерфейс ручной коррекции

• Добавлена магнификация области (200% увеличение) при выборе точки
• Два окна: основное изображение + панель управления с увеличением
• Интерактивные элементы:
  • Четкие кнопки управления
  • Инструкции в интерфейсе
  • Визуальная обратная связь при выборе точек

3. Улучшенная обработка изображений

• Автоматическое определение ориентации текста перед ручной настройкой
• Умный выбор начального угла (ближайший из 0°, 90°, 180°, 270°)
• Более точные вычисления при автоматическом повороте

4. Управление ресурсами

• Временные файлы: Автоматическое создание и удаление временных изображений
• Сборка мусора: Корректное хранение ссылок на PhotoImage
• Масштабирование изображений: Автоматическая адаптация под размер экрана

5. Улучшения UX/UI

• Горячие клавиши: A/D для поворота, R для сброса, Enter/Esc для подтверждения/отмены
• Визуальные подсказки: Цветовое выделение выбранной точки
• Маркировка точек: Номера точек (1-4) для удобной навигации
• Отступы от краев: Автоматические отступы 20px при инициализации точек

6. Технические улучшения

• PPM формат: Прямое преобразование numpy → PhotoImage без сохранения на диск
• Адаптивное масштабирование: Автоматическое изменение размера под окно
• Более стабильная работа: Устранены проблемы с закрытием окон

🎯 Ключевые преимущества новой версии

✅ Устойчивость

• Не зависит от бэкенда OpenCV для отображения
• Работает на системах без GUI-бэкенда OpenCV
• Предсказуемое поведение на всех платформах

✅ Производительность

• Эффективное использование памяти
• Быстрое обновление интерфейса
• Оптимизированное масштабирование

✅ Удобство использования

• Интуитивный интерфейс
• Визуальная обратная связь
• Подсказки и инструкции
• Горячие клавиши для быстрой работы

✅ Качество обработки

• Улучшенное автоматическое определение ориентации
• Точная коррекция с увеличением
• Сохранение качества при преобразованиях

🚀 Для пользователей

• Более плавный рабочий процесс
• Профессиональный интерфейс
• Точный контроль над коррекцией
• Кроссплатформенная совместимость

🔧 Для разработчиков

• Чистый, модульный код
• Легкость поддержки
• Расширяемость
• Современные зависимости

---

Версия 1.2 представляет собой значительный шаг вперед в удобстве использования, стабильности и качестве обработки документов! 📈

---

Document Scanner & Processor

Проект для автоматического выравнивания, улучшения и преобразования сканов документов в PDF с удалением теней и коррекцией цветового баланса.

📌 Возможности

• Автоматическое определение ориентации текста (0°, 90°, 180°, 270°)
• Ручная коррекция поворота (интерактивный режим)
• Точное выравнивание документа по 4 точкам (авто/ручной режим)
• Удаление теней с адаптивным алгоритмом
• Баланс белого по среднему серому
• Экспорт в PDF с настройкой DPI

🖥️ Использование

1. Запустите программу:

./doc_clean.bin

2. Выберите изображения через диалоговое окно

3. Для каждого документа:

   • Откорректируйте поворот (клавиши A/D, Enter для подтверждения)
   • Отрегулируйте углы выравнивания (перетаскивайте точки)
   • Нажмите Enter для обработки

4. Результаты сохранятся:

   • Для одного файла: [имя_файла]_processed.pdf
   • Для нескольких: processed_documents.pdf в папке с исходниками

🛠 Технологии

• OpenCV (выравнивание, обработка изображений)
• Алгоритм Sauvola (бинаризация)
• Matplotlib (экспорт в PDF)
• Tkinter (GUI интерфейс)

Примеры в файлах

1 - оригинальный файл 1_procecced - скриншот обработанного файла 1_processed.pdf - получившийся обработанный файл

📜 Лицензия

MIT License.