Редактирование и просмотр изображений в JES

JES — это программное обеспечение для программного редактирования фотографий, видео и звуков. В нём используется язык Jython, синтаксис которого очень близок к Python. В этом руководстве показано, как с помощью встроенных функций JES выбрать изображение, отобразить его в окне, получить информацию о размере, создать копию и исследовать пиксели.

Важные термины в одной строке:

• Jython — реализация Python, работающая на Java-платформе; синтаксис похож на Python 2.
• picture / pic — объект изображения в JES.

Что вы узнаете

• Как открыть и отобразить изображение пользователю через диалог выбора файла.
• Как получить ширину, высоту и путь файла изображения.
• Как клонировать изображение и работать с копией.
• Как открыть режим исследования пикселей и узнать координаты и RGB‑значения.

Важно: JES использует отступы для структуры кода, как и Python. Следите за пробелами и используйте одинаковый стиль отступов во всём файле.

Как отобразить существующее изображение в JES

Jython следует правилам отступов Python — форматирование важно. Ниже — пошаговая инструкция и пример функции, которая открывает диалог выбора файла и отображает выбранное изображение.

Шаги:

1. Откройте программу JES на компьютере.
2. В окне программирования в верхней части интерфейса создайте функцию displayPic():

def displayPic():

3. Внутри функции используйте встроенную функцию pickAFile(), чтобы открыть проводник и выбрать файл. Сохраните путь в переменную file:

file = pickAFile()

4. Создайте объект изображения через makePicture():

pic = makePicture(file)

5. Отобразите изображение с помощью show():

show(pic)

6. Нажмите кнопку Загрузить программу (в оригинале: Load Program) между строкой команд и областью кода. При запросе сохранения нажмите Да (в оригинале: Yes). После загрузки выполните функцию через строку команд:

displayPic()

7. В появившемся диалоге выберите изображение и нажмите Открыть (в оригинале: Open).

8. Подтвердите, что изображение отобразилось в новом окне.

Как вывести информацию об изображении (ширина, высота, путь)

JES предоставляет функции getWidth() и getHeight(), которые возвращают размеры изображения в пикселях. Пример функции ниже показывает, как вывести эту информацию в строку команд.

Шаги:

1. В окне программирования создайте функцию printHeightAndWidth():

def printHeightAndWidth():

2. Внутри функции откройте диалог выбора файла и создайте объект изображения:

file = pickAFile()
pic = makePicture(file)

3. Получите ширину и выведите её:

width = getWidth(pic)
print "Width of the photo: " + str(width)

4. Получите высоту и выведите её:

height = getHeight(pic)
print "Height of the photo: " + str(height)

5. Выведите путь к файлу:

print "File Location: " + file

6. Нажмите Загрузить программу, подтвердите сохранение, затем выполните функцию через строку команд:

printHeightAndWidth()

7. Выберите изображение и нажмите Открыть.

8. Размеры и путь файла появятся в строке команд.

Как клонировать изображение

Функция duplicatePicture() создаёт полную копию изображения. Это полезно, если вы хотите экспериментировать с редактированием, не меняя оригинал.

Шаги:

1. Создайте функцию duplicateImage():

def duplicateImage():

2. Откройте диалог выбора файла и создайте оригинальный объект:

file = pickAFile()
originalPic = makePicture(file)

3. Клонируйте изображение:

pic2 = duplicatePicture(originalPic)

4. Отобразите оба изображения:

show(originalPic)
show(pic2)

5. Загрузите программу и выполните duplicateImage() через строку команд:

duplicateImage()

6. Выберите файл и нажмите Открыть. Оригинал и копия откроются в отдельных окнах.

Как исследовать пиксели изображения

Режим исследования позволяет кликнуть по любому пикселю и увидеть его координаты и RGB‑компоненты. Для этого используется explore() или openPictureTool().

Шаги:

1. Создайте функцию exploreImage():

def exploreImage():

2. Выберите файл и создайте объект изображения:

file = pickAFile()
pic = makePicture(file)

3. Откройте режим исследования:

explore(pic)

4. Альтернативный вариант: используйте openPictureTool(pic) для расширенных инструментов.

openPictureTool(pic)

5. Загрузите программу и выполните exploreImage().

6. В режиме исследования кликайте по пикселям, чтобы увидеть их координаты и RGB‑значения.

Быстрый набор команд (cheat sheet)

file = pickAFile()         # открыть диалог выбора файла
pic = makePicture(file)    # создать объект изображения
show(pic)                  # отобразить изображение
explore(pic)               # открыть режим исследования пикселей
openPictureTool(pic)       # альтернативный инструмент исследования
width = getWidth(pic)      # получить ширину
height = getHeight(pic)    # получить высоту
pic2 = duplicatePicture(pic)# клонировать изображение

Альтернативные подходы и когда они больше подходят

• OpenCV (cv2) — если вам нужны производительные операции с изображениями, фильтры и преобразования в реальном времени, лучше использовать OpenCV на Python. Он быстрее и имеет богатую экосистему.
• Pillow (PIL) — простая библиотека для быстрой обработки изображений и сохранения в разных форматах; удобна для скриптов вне JES.
• Графические редакторы (GIMP, Photoshop) — для интерактивной сложной ретуши GUI-инструменты удобнее.

Когда JES не подойдёт:

• Нужно обрабатывать тысячи изображений в пакетном режиме — лучше OpenCV или скрипты с Pillow.
• Требуется поддержка современных Python 3‑фич — Jython чаще использует синтаксис Python 2.

Метод отладки: если изображение не открывается

1. Проверьте, что файл существует и имеет поддерживаемый формат (JPEG, PNG, BMP).
2. Убедитесь, что путь (file) — строка и не пустой.
3. Если makePicture(file) вызывает ошибку, попробуйте открыть изображение в другом приложении, чтобы исключить повреждённый файл.
4. Проверьте права доступа к файлу и папке.
5. Для пошаговой отладки вставляйте print(file) и print(getWidth(pic)) после создания объекта.

Роль‑направленные чек‑листы

• Для ученика / новичка:

  • Убедиться, что JES установлен и запускается.
  • Создать простую функцию displayPic() и отобразить изображение.
  • Попрактиковаться в getWidth() и getHeight().

• Для учителя / преподавателя:

  • Подготовить набор упражнений: отображение изображения, клонирование, чтение пикселей.
  • Дать задания на изменение отдельных пикселей и фильтры.

• Для разработчика / автоматизатора:

  • Сравнить производительность сделанных скриптов с OpenCV.
  • Организовать обработку ошибок и логирование.

Критерии приёмки

• Функция displayPic() успешно открывает диалог и отображает выбранное изображение.
• Функция printHeightAndWidth() выводит корректные числовые значения ширины и высоты и правильный путь файла.
• duplicateImage() создаёт визуально идентичную копию в отдельном окне.
• exploreImage() позволяет узнать координаты и RGB‑значения пикселя по клику.

Короткий глоссарий

• pickAFile — диалог выбора файла.
• makePicture — создание объекта изображения из файла.
• show — отображение изображения в окне.
• explore / openPictureTool — режимы исследования пикселей.
• duplicatePicture — создание клона изображения.

Примеры ошибок и советы по их предотвращению

• Ошибка: пустой путь file — проверьте, не отменён ли диалог выбора файла.
• Ошибка: неподдерживаемый формат — конвертируйте файл в JPEG/PNG.
• Проблема: отступы — используйте 4 пробела или табы последовательно.

Заключение

JES даёт простой и визуальный способ изучать обработку изображений с помощью Jython. Вы можете быстро загружать и отображать файлы, изучать размеры и содержимое пикселей, клонировать изображения и экспериментировать с редактированием без риска повредить оригинал. Для более сложной обработки имеет смысл рассмотреть OpenCV или Pillow, но для обучения и простых задач JES остаётся удобным инструментом.

Короткие советы на будущее: начните с небольших функций, проверяйте значения через print(), клонируйте изображение перед экспериментами и документируйте шаги для повторяемости.