# Дополнение NVDA AI Image Generator

## Обзор

**AI Image Generator** — это дополнение для NVDA, позволяющее пользователям генерировать изображения с помощью искусственного интеллекта на основе текстовых запросов. Оно полностью интегрируется с NVDA, предоставляя доступный интерфейс для слабовидящих пользователей для создания и загрузки изображений, созданных ИИ.

**Разработчик**: Sujan Rai, Team of Tech Visionary  
**Версия**: 0.23

* * *

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

  * 🎧 **Доступный интерфейс**: Полная совместимость с экранным диктором NVDA.
  * 🖼️ **Генерация изображений из текста**: Создание изображений по текстовым описаниям.
  * 💾 **Загрузка изображений**: Сохранение сгенерированных изображений в форматах PNG, JPEG или BMP.
  * 🛠️ **Настраиваемый интерфейс**: Включает кнопку очистки, диалоговое окно "О программе" и горячие клавиши для удобной навигации.
  * ⚙️ **Многопоточная обработка**: Предотвращает зависание интерфейса за счёт генерации изображений в фоновом режиме.
  * 🎨 **Поддержка тем**: Настраиваемая цветовая схема для улучшения видимости.
  * 🌐 **Интеграция с социальными сетями**: Ссылки на Telegram-канал и веб-сайт для дополнительных ресурсов.

* * *

## Установка

  1. Загрузите файл `.nvda-addon` со страницы релизов.
  2. Откройте NVDA и перейдите: `Меню NVDA > Сервис > Магазин дополнений`.
  3. Нажмите **Установить из стороннего источника**, выберите загруженный файл `.nvda-addon` и следуйте инструкциям.
  4. Перезапустите NVDA для активации дополнения.

* * *

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

### 🔓 Открытие дополнения:

  * **Горячая клавиша**: `NVDA+Shift+A`
  * Или через `Меню NVDA > Сервис > Генератор изображений с искусственным интеллектом`

### 🎨 Генерация изображения:

  1. Введите текстовый запрос (например, _"Спокойный горный пейзаж на закате"_).
  2. Нажмите `Alt+G` или кнопку **Генерировать изображение**.
  3. Дождитесь завершения генерации (появится диалоговое окно процесса).

### 💾 Просмотр и сохранение изображения:

  * После генерации изображение отобразится в диалоговом окне предпросмотра.
  * Нажмите `Alt+D` или кнопку **Скачать изображение** для сохранения.

### ℹ️ Диалоговое окно "О программе":

  * Нажмите `Alt+A` или кнопку **О** для просмотра информации о версии и ссылок на социальные сети.

### 🧹 Очистка ввода:

  * Нажмите `Alt+R` или кнопку **Очистить** для сброса ввода и очистки предпросмотра.

### ❌ Закрытие:

  * Нажмите `Alt+C` или кнопку **Закрыть** для выхода из диалогового окна.

* * *

## Горячие клавиши

| Действие                | Горячая клавиша   |
|-------------------------|-------------------|
| Открыть генератор       | `NVDA+Shift+A`    |
| Сгенерировать изображение | `Alt+G`         |
| Очистить ввод           | `Alt+R`          |
| Диалог "О программе"    | `Alt+A`          |
| Закрыть диалог          | `Alt+C`          |
| Скачать изображение   | `Alt+D`          |
| Присоединиться к Telegram | `Alt+J` _(About)_ |
| Посетить веб-сайт       | `Alt+W` _(About)_ |

* * *

## Зависимости

  * **NVDA**: Версия 2023.1 или новее.

### 🐍 Библиотеки Python:

  * `wx` — Компоненты графического интерфейса.
  * `requests` — Общение с API.
  * `threading`, `json`, `io`, `webbrowser` — Стандартные библиотеки.
  * `concurrent.futures` — Для многопоточной обработки.

### 🧩 Модули NVDA:

  * `gui`, `ui`, `globalPluginHandler`, `addonHandler`, `inputCore`, `scriptHandler`.

* * *

## Использование API

Дополнение использует **Pollinations AI API**:  
👉 [`https://image.pollinations.ai/prompt/`](https://image.pollinations.ai/prompt/)

> **Примечание**: Для генерации изображений требуется активное интернет-подключение.

* * *

## Разработка

  * 👨‍💻 **Разработчик**: Sujan Rai, Team of Tech Visionary.
  * 📦 **Версия**: 0.23.
  * 📝 **Лицензия**: GNU General Public License v3.0.
  * 🧑‍💻 **Исходный код**: [Репозиторий GitHub](https://github.com/techvisionaryteam/ai-image-generator-nvda-addon/).

* * *

## Участие в разработке

Мы приветствуем ваши contributions!

  * Отправляйте issues или pull requests через GitHub.
  * Для значительных изменений свяжитесь с разработчиком через Telegram-канал.

* * *

## Поддержка

  * 💬 **Telegram**: Присоединяйтесь к Telegram-каналу **Tech Visionary** для помощи и обновлений.
  * 🌐 **Веб-сайт**: Посетите **Tech Visionary Tutorials** для дополнительных инструментов и руководств.
  * 🐞 **Проблемы**: Используйте вкладку **Issues** на GitHub для сообщения об ошибках или запроса функций.

* * *

## Известные проблемы

  * Генерация изображений может завершиться ошибкой, если:
    * API недоступен.
    * Некорректный запрос.
  * Поддерживаются только форматы PNG, JPEG и BMP.
  * Требуется интернет-подключение.

* * *

## История изменений

### v0.23 (Первоначальный релиз)

  * Первоначальный релиз с основной функциональностью.
  * Добавлена многопоточная генерация изображений.
  * Реализованы доступные диалоговые окна и горячие клавиши.
  * Поддержка тем для улучшения интерфейса.

* * *

## Благодарности

  * 🙏 Спасибо **сообществу NVDA** за отзывы и поддержку.
  * 💡 Отдельная благодарность **Team of Tech Visionary** за идеи и ресурсы.

* * *