WWWadmin.ru

UImageOCR: библиотека оптического распознавания символов для Python

unicross — Sun, 03 May 2026 20:02:57 GMT

UImageOCR: библиотека оптического распознавания символов для Python

Библиотека UImageOCR для Python 3.8+ (только для Windows) является надстройкой над библиотеками UImageC и UImageCV. Она позволяет преобразовать текст на изображении в редактируемый машиночитаемый текст, т. е. является библиотекой оптического распознавания символов (OCR — Optical Character Recognition).

Библиотека UImageOCR не зависит от других OCR-библиотек, ни от Tesseract, ни от EasyOCR, ни от FineReader, ни от OpenCV. Перечень распознаваемых языков зависит от используемой базы шаблонов. OCR dataset UNumbers36 позволяет распознавать только цифры. OCR dataset USymbols36 предназначен для распознавания текста из русских и английских букв. Распознавать можно не только по шаблонам, но и по ключевым точкам. Для проверки правильности распознаваемого слова предназначены словари.

UImageOCR: библиотека оптического распознавания символов для Python
    Класс UStack: стек
    Класс UQueue: очередь

    Класс UBlock: прямоугольный блок
        Создание иерархии блоков
        Обводка границ блоков на изображении
        Добавление объектов строк

    Класс URow: строка внутри блока
        Добавление объектов слов
        Гистограммы для строки

    Класс UWord: слово внутри строки
        Добавление объектов букв
        Список с токенами
        Список со статистикой по столбцам

    Класс ULetter: буква внутри слова
        Обводка минимальных границ букв на изображении
        Вспомогательные атрибуты

    Класс UToken: токен с результатом распознавания слова

    Класс USymb36: шаблон символа
        Создание объекта с описанием шаблона
        Получение информации о характеристиках символа
        Преобразование объекта в строку специального формата
        Создание объекта на основе строки специального формата
        Создание черно-белого изображения
        Создание скелетона символа
        Ключевые точки символа
            Описание ключевых точек шаблона символа
            Получение описания ключевых точек
            Создание объекта с результатами поиска по ключевым точкам
            Преобразование объекта с ключевыми точками в строку специального формата
            Создание объекта на основе строки специального формата
            Изменение информации о ключевых точках
        Создание объекта на основе черно-белого изображения
        Добавление характеристик символа
        Создание объекта с результатами поиска символа
        Сравнение строк в формате BWSTR. Вычисление расстояния Хэмминга
        Получение расшифровки результата

    Класс UPage: сегментация страницы с изображением текста
        Разделение страницы с изображением текста на прямоугольные блоки
        Разделение блока с изображением текста на строки
        Вычисление гистограмм для всех строк и выполнение их анализа
        Создание черно-белого изображения из текстовых строк
        Разделение строк с изображением текста на слова
        Представление нескольких столбцов как одного столбца
        Разделение слов на буквы
        Поиск базовых линий на изображениях строк
            Отрисовка базовых линий всех строк
        Сегментация страницы
        Создание шаблонов для всех букв или одной буквы
        Сохранение шаблонов для всех букв в файл

    Класс UDBSymb: база данных с шаблонами символов
        Создание объекта
        Распознавание символа по базе шаблонов
        OCR dataset USymbols36 с черно-белыми изображениями символов
        UNumbers36: OCR dataset с черно-белыми цифрами
        Распознавание символа по ключевым точкам
        Поиск шаблона в памяти
        Сохранение данных из памяти в файлы
        Загрузка данных из файла в память
        Распознавание символа по всем базам

    Программа для просмотра и редактирования шаблонов символов
        Системные требования
        Установка и запуск программы
        Загрузка списка шаблонов из файла
        Сохранение списка шаблонов в файл
        Управление просмотром шаблонов
        Изменение масштаба просмотра символа
        Отображение сетки
        Разделение списка на три части
        Отображение скелетона и списка ключевых точек
        Редактирование описания символа
        Обучение системы незнакомым символам
        Завершение работы программы
        FAQ. Вопрос — ответ

    Класс UDBDict: база данных со словами
        Создание объекта
        Загрузка словаря из файла в память
        Проверка наличия слова в словаре
        Получение информации о регистре слова
        Подбор вариантов слова по маске
        Словарь с кодами символов
        Словарь с похожими символами
        Словарь с позициями символов внутри строки

    Класс UReader: оптическое распознавание текста
        Создание объекта
        Разделение перекрывающихся букв

Описание библиотеки для работы с изображениями UImageC

Описание библиотеки компьютерного зрения UImageCV

Sobel, Sharr, Prewitt, Laplacian: сравнение операторов поиска границ

unicross — Thu, 19 Mar 2026 19:56:44 GMT

Sobel, Sharr, Prewitt, Laplacian: сравнение операторов поиска границ

При работе с изображением в градациях серого мы имеем дело с матрицей чисел, описывающих яркость пикселя в определенной точке. В каждой точке изображения вектор градиента показывает направление наибольшего увеличения яркости, а его длина — величину изменения яркости. Для точки внутри области с постоянной яркостью вектор будет нулевым. Для вычисления градиента наиболее часто используется фильтр Собеля. Сравним операторы поиска границ Sobel, Sharr, Prewitt и Laplacian.

import math
import numpy as np

def test_sobel(k):
    sum_x = -1 * k[0] + -2 * k[1] + -1 * k[2]
    sum_x += k[6] + 2 * k[7] + k[8]
    sum_y = -1 * k[0] + k[2] + -2 * k[3]
    sum_y += 2 * k[5] + -1 * k[6] + k[8]
    sum_xy = sum_x * sum_x + sum_y * sum_y
    magn = int(math.sqrt(sum_xy))
    print("Sobel: {0} {1} = {2}".format(sum_x, sum_y, magn))

def test_sharr(k):
    sum_x = -3 * k[0] + -10 * k[1] + -3 * k[2]
    sum_x += 3 * k[6] + 10 * k[7] + 3 * k[8]
    sum_y = -3 * k[0] + 3 * k[2] + -10 * k[3]
    sum_y += 10 * k[5] + -3 * k[6] + 3 * k[8]
    sum_xy = sum_x * sum_x + sum_y * sum_y
    magn = int(math.sqrt(sum_xy))
    print("Sharr: {0} {1} = {2}".format(sum_x, sum_y, magn))

def test_prewitt(k):
    sum_x = -1 * k[0] + -1 * k[1] + -1 * k[2]
    sum_x += k[6] + k[7] + k[8]
    sum_y = -1 * k[0] + k[2] + -1 * k[3]
    sum_y += k[5] + -1 * k[6] + k[8]
    sum_xy = sum_x * sum_x + sum_y * sum_y
    magn = int(math.sqrt(sum_xy))
    print("Prewitt: {0} {1} = {2}".format(sum_x, sum_y, magn))

def test_laplacian(k):
    sum_x = k[1] + k[3] + -4 * k[4] + k[5] + k[7]
    print("Laplacian: = {0}".format(sum_x))

def test_edges(k):
    sum_x = -1 * k[0] + -1 * k[1] + -1 * k[2] + -1 * k[3] + 8 * k[4]
    sum_x += -1 * k[5] + -1 * k[6] + -1 * k[7] + -1 * k[8]
    print("Edges: = {0}".format(sum_x))

arr = [
0, 255, 0,
0, 255, 0,
0, 255, 0
]

arr_np = np.array(arr).reshape(3, 3)
print(arr_np)

test_sobel(arr)
test_sharr(arr)
test_prewitt(arr)
test_laplacian(arr)
test_edges(arr)

Одноцветная область:

[[255 255 255]
 [255 255 255]
 [255 255 255]]
Sobel: 0 0 = 0
Sharr: 0 0 = 0
Prewitt: 0 0 = 0
Laplacian: = 0
Edges: = 0

[[128 128 128]
 [128 128 128]
 [128 128 128]]
Sobel: 0 0 = 0
Sharr: 0 0 = 0
Prewitt: 0 0 = 0
Laplacian: = 0
Edges: = 0

[[0 0 0]
 [0 0 0]
 [0 0 0]]
Sobel: 0 0 = 0
Sharr: 0 0 = 0
Prewitt: 0 0 = 0
Laplacian: = 0
Edges: = 0

Граница по вертикали:

[[  0 255 255]
 [  0 255 255]
 [  0 255 255]]
Sobel: 0 1020 = 1020
Sharr: 0 4080 = 4080
Prewitt: 0 765 = 765
Laplacian: = -255
Edges: = 765

[[255 255   0]
 [255 255   0]
 [255 255   0]]
Sobel: 0 -1020 = 1020
Sharr: 0 -4080 = 4080
Prewitt: 0 -765 = 765
Laplacian: = -255
Edges: = 765

[[  0 128 128]
 [  0 128 128]
 [  0 128 128]]
Sobel: 0 512 = 512
Sharr: 0 2048 = 2048
Prewitt: 0 384 = 384
Laplacian: = -128
Edges: = 384

[[128 128   0]
 [128 128   0]
 [128 128   0]]
Sobel: 0 -512 = 512
Sharr: 0 -2048 = 2048
Prewitt: 0 -384 = 384
Laplacian: = -128
Edges: = 384

[[ 0 50 50]
 [ 0 50 50]
 [ 0 50 50]]
Sobel: 0 200 = 200
Sharr: 0 800 = 800
Prewitt: 0 150 = 150
Laplacian: = -50
Edges: = 150

[[ 0 10 10]
 [ 0 10 10]
 [ 0 10 10]]
Sobel: 0 40 = 40
Sharr: 0 160 = 160
Prewitt: 0 30 = 30
Laplacian: = -10
Edges: = 30

[[ 0 15 15]
 [ 0 15 15]
 [ 0 15 15]]
Sobel: 0 60 = 60
Sharr: 0 240 = 240
Prewitt: 0 45 = 45
Laplacian: = -15
Edges: = 45

[[15 30 30]
 [15 30 30]
 [15 30 30]]
Sobel: 0 60 = 60
Sharr: 0 240 = 240
Prewitt: 0 45 = 45
Laplacian: = -15
Edges: = 45

[[15 35 35]
 [15 35 35]
 [15 35 35]]
Sobel: 0 80 = 80
Sharr: 0 320 = 320
Prewitt: 0 60 = 60
Laplacian: = -20
Edges: = 60

Граница по горизонтали:

[[  0   0   0]
 [255 255 255]
 [255 255 255]]
Sobel: 1020 0 = 1020
Sharr: 4080 0 = 4080
Prewitt: 765 0 = 765
Laplacian: = -255
Edges: = 765

[[255 255 255]
 [255 255 255]
 [  0   0   0]]
Sobel: -1020 0 = 1020
Sharr: -4080 0 = 4080
Prewitt: -765 0 = 765
Laplacian: = -255
Edges: = 765

Диагональ:

[[  0   0 255]
 [  0 255 255]
 [255 255 255]]
Sobel: 765 765 = 1081
Sharr: 3315 3315 = 4688
Prewitt: 510 510 = 721
Laplacian: = -510
Edges: = 765

[[255 255 255]
 [255 255   0]
 [255   0   0]]
Sobel: -765 -765 = 1081
Sharr: -3315 -3315 = 4688
Prewitt: -510 -510 = 721
Laplacian: = -510
Edges: = 765

[[255   0   0]
 [255 255   0]
 [255 255 255]]
Sobel: 765 -765 = 1081
Sharr: 3315 -3315 = 4688
Prewitt: 510 -510 = 721
Laplacian: = -510
Edges: = 765

[[255 255 255]
 [  0 255 255]
 [  0   0 255]]
Sobel: -765 765 = 1081
Sharr: -3315 3315 = 4688
Prewitt: -510 510 = 721
Laplacian: = -510
Edges: = 765

Угловые точки:

[[255 255 255]
 [255 255 255]
 [  0 255 255]]
Sobel: -255 255 = 360
Sharr: -765 765 = 1081
Prewitt: -255 255 = 360
Laplacian: = 0
Edges: = 255

[[255 255 255]
 [255 255 255]
 [255   0 255]]
Sobel: -510 0 = 510
Sharr: -2550 0 = 2550
Prewitt: -255 0 = 255
Laplacian: = -255
Edges: = 255

[[255 255 255]
 [255 255 255]
 [255 255   0]]
Sobel: -255 -255 = 360
Sharr: -765 -765 = 1081
Prewitt: -255 -255 = 360
Laplacian: = 0
Edges: = 255

[[30 30 30]
 [30 30 30]
 [30 30  0]]
Sobel: -30 -30 = 42
Sharr: -90 -90 = 127
Prewitt: -30 -30 = 42
Laplacian: = 0
Edges: = 30

Значение 0 не всегда означает одноцветную область!

[[  0 255   0]
 [  0 255   0]
 [  0 255   0]]
Sobel: 0 0 = 0
Sharr: 0 0 = 0
Prewitt: 0 0 = 0
Laplacian: = -510
Edges: = 1530

[[  0   0   0]
 [  0 255   0]
 [  0   0   0]]
Sobel: 0 0 = 0
Sharr: 0 0 = 0
Prewitt: 0 0 = 0
Laplacian: = -1020
Edges: = 2040

[[  0   0   0]
 [255 255 255]
 [  0   0   0]]
Sobel: 0 0 = 0
Sharr: 0 0 = 0
Prewitt: 0 0 = 0
Laplacian: = -510
Edges: = 1530

Концы:

[[  0 255   0]
 [  0 255   0]
 [  0   0   0]]
Sobel: -510 0 = 510
Sharr: -2550 0 = 2550
Prewitt: -255 0 = 255
Laplacian: = -765
Edges: = 1785

UImageCV C API. Руководство разработчика

unicross — Mon, 16 Mar 2026 19:23:10 GMT

UImageCV C API. Руководство разработчика

UImageCV C API
    UImageBGR C API: изображение BGR
        Заливка изображения цветом
        Инверсия цвета
        Преобразование целочисленного диапазона в вещественный и наоборот
        Сравнение изображений
        Вычисление гистограммы
        Разделение на каналы
        Сборка из каналов
        Преобразование объекта UImageBGR в объект другого класса
            Преобразование объекта UImageBGR в объект UImageRGB и наоборот
            Преобразование объекта UImageBGR в объект UImageGray и наоборот
            Преобразование объекта UImage в объект UImageBGR и наоборот

    UImageHSV C API: изображение HSV
        Заливка изображения цветом
        Нормализация диапазона значений
        Сравнение изображений
        Разделение на каналы
        Сборка из каналов
        Изменение значений компонентов цвета
        Преобразование объекта UImageHSV в объект другого класса
            Преобразование RGB в HSV и наоборот (тип unsigned char)
            Преобразование RGB в HSV и наоборот (тип float)
            Преобразование объекта UImageRGB в объект UImageHSV и наоборот
            Преобразование объекта UImageBGR в объект UImageHSV и наоборот

    UImageHSL C API: изображение HSL
        Заливка изображения цветом
        Нормализация диапазона значений
        Сравнение изображений
        Разделение на каналы
        Сборка из каналов
        Изменение значений компонентов цвета
        Преобразование объекта HSL в объект HLS и наоборот

    UImageLab C API: изображение Lab
        Заливка изображения цветом
        Сравнение изображений
        Разделение на каналы
        Сборка из каналов
        Изменение значений компонентов цвета

    UCvGray C API: алгоритмы компьютерного зрения для изображений в оттенках серого
        Заливка изображения цветом
        Инверсия цвета
        Сравнение изображений
        Вычисление гистограммы
        Преобразование в черно-белое изображение
        Преобразование в строку в формате BWSTR и наоборот
        Поиск минимального и максимального значений
        Абсолютные значения
        Объединение изображений
        Нормализация диапазона значений
        Приведение к диапазону от 0 до 255
        Вычисление разницы двух изображений
        Обрезка изображения
            Обрезка лишних одноцветных границ
        Прибавление значения ко всем пикселям
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
        Добавление рамки сверху или снизу изображения
        Объединение двух изображений
        Вставка одного изображения в другое
        Замена цвета

        Выделение контуров объектов
            Фильтр Собеля 3x3
            Фильтр Собеля 5x5
            Фильтр Щарра
            Фильтр Прюитта
            Выделение контуров
            Лапласиан изображения

        Свертка с ядром 3x3
            Добавление паддинга для свертки
            Удаление паддинга
            Свертка с ядром 3x3 (тип int)
            Вычисление градиента
            Определение направления градиента
            Свертка с ядром 3x3 (тип float)

        Свертка с ядром 5x5
            Свертка с ядром 5x5 (тип int)
            Свертка с ядром 5x5 (тип float)

        Размытие и подавление цифрового шума
            Однородное размытие
            Размытие по Гауссу (ядро 3x3)
            Размытие по Гауссу (ядро 5x5)
            Медианный фильтр
            Сглаживание изображения
        Повышение резкости
        Расширение темных областей
        Расширение светлых областей
        Тиснение

    UCvBW C API: алгоритмы компьютерного зрения для черно-белых изображений
        Преобразование в черно-белое изображение
        Заливка изображения цветом
        Инверсия цвета
        Сравнение изображений
        Вычисление гистограммы
        Обрезка изображения
            Обрезка лишних одноцветных границ
        Преобразование в строку в формате BWSTR и наоборот
        Преобразование в объект UMask и наоборот
        Логические операции
            Логическое И
            Логическое ИЛИ
            Исключающее ИЛИ
            Логическое РАВНО
            Импликация
        Изменение размеров изображения
        Вращение изображения на произвольный угол
        Сравнение со значением
            Равно
            Не равно
            Меньше
            Меньше или равно
            Больше
            Больше или равно
            Диапазон значений

    Класс UCvRGB C API: компьютерное зрение для UImageRGB
        Заливка изображения цветом
        Инверсия цвета
        Преобразование целочисленного диапазона в вещественный и наоборот
        Сравнение изображений
        Вычисление гистограммы
        Разделение на каналы
        Сборка из каналов
        Преобразование цвета
            Преобразование объекта UImageRGB в объект UImageGray и наоборот
            Преобразование объекта UImage в объект UImageRGB и наоборот
            Преобразование значения RGB в ARGB и наоборот
        Цветовая карта изображения
            Сравнение двух цветов
            Поиск цвета по диапазону значений
            Поиск цвета по расстоянию
            Поиск одноцветных областей
            Палитра из 21 цвета
            Поиск ближайшего цвета из цветовой карты
            Создание цветовой карты для изображения
            Гистограмма цветовой карты
            Статистика по цветам в изображении и палитра цветов
            Основные цвета изображения и число уникальных цветов
            Преобразование цветовой карты в цветное изображение
            Преобразование цветовой карты в строку в формате CMAPSTR
            Преобразование строки в формате CMAPSTR в цветовую карту
            Преобразование строки в формате CMAPSTR в цветное изображение
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
            Вращение изображения на произвольный угол
        Изменение размера изображения
        Обрезка изображения
            Обрезка лишних одноцветных границ
        Добавление рамки вокруг изображения или с одной стороны
        Объединение двух изображений
        Вставка одного изображения в другое
        Замена цвета
        Выделение границ объектов
        Карта границ объектов для изображения RGB
        Карта границ объектов для изображения в оттенках серого

    UCvRGBA C API: компьютерное зрение для UImage
        Заливка изображения цветом
        Инверсия цвета
        Преобразование целочисленного диапазона в вещественный и наоборот
        Сравнение изображений
        Проверка наличия прозрачных пикселей
        Разделение на каналы
        Сборка из каналов
        Преобразование цвета
            Преобразование объекта UImage в объект UImageGray и наоборот
            Преобразование объекта UImage в объект UImageRGB и наоборот
            Преобразование значения RGB в ARGB и наоборот
            Преобразование значения RGBA в ARGB и наоборот
            Сравнение двух цветов
        Поиск цвета по диапазону значений
        Поиск цвета по расстоянию
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
            Вращение изображения на произвольный угол
        Изменение размера изображения
        Обрезка изображения
            Обрезка лишних одноцветных границ
        Добавление рамки вокруг изображения или с одной стороны
        Объединение двух изображений
        Вставка одного изображения в другое
        Замена цвета

    Класс UCvArea C++ API: работа с контурами и областями изображения
        Заливка произвольной области цветом
        Нумерация контуров и областей на черно-белом изображении
        Нумерация областей на изображении в оттенках серого
        Создание маски по идентификатору области
        Создание маски по идентификатору области в учетом вложенных областей
        Заливка области с учетом идентификатора области
        Обрезка изображения с учетом идентификатора области
        Обрезка изображения с учетом маски
        Выделение контуров объектов на черно-белом изображении
        Преобразование карты областей в черно-белое изображение
        Расширение черных областей на карте областей
        Создание скелетона
        Освобождение динамической памяти для строки
        Создание ключевых точек

    Класс UOcrBlock C++ API: работа с текстовыми блоками для OCR
        Поиск слов внутри столбца
            Выделение слов на изображении текста
        Обрезка блоков по вертикали или горизонтали
            Выделение букв в словах
        Поиск границ блоков
            Выделение блоков
        Размазывающие фильтры
            Расширение белых областей
            Создание карты расширения белых областей
            Расширение черных областей
        Освобождение динамической памяти
        Поиск линий на карте границ
            Поиск горизонтальных линий на карте границ
            Поиск вертикальных линий на карте границ
            Поиск произвольных линий на карте границ
            Линия по двум точкам. Вычисление угла поворота линии
            Вычисление расстояния между точкой и прямой
            Вычисление расстояния между двумя точками
            Вычисление характеристик прямой по точке и углу поворота
        Поиск лишних границ на карте границ
        Сегментация страницы на прямоугольные блоки
        Удаление рамки с прямыми углами на карте границ
        Удаление рамки со скругленными углами на карте границ
        Вычисление гистограммы для области
        Преобразование области в черно-белое изображение
        Разделение изображения слова на буквы
        Поиск базовой линии строки

Описание библиотеки UImageCV

Создание цветовой карты изображения (Python, C, C++)

unicross — Mon, 09 Mar 2026 18:42:01 GMT

Создание цветовой карты изображения (Python, C, C++)

В большинстве случаев для нужд компьютерного зрения достаточно изображения в градациях серого. Однако не следует забывать, что цвет также содержит большой объем информации. Эта информация позволяет отслеживать перемещение объекта по его цвету, а также разделять объекты при их перекрытии.

Проблема работы с цветом заключается в огромном количестве оттенков цвета. Причем один и тот же цвет при разном освещении и на разных мониторах будет выглядеть несколько иначе. Если разместить два цвета рядом, то можно заметить, что некоторые цвета кажутся человеку более светлыми или более темными. Кроме того, разные люди могут по-разному видеть один и тот же цвет при одинаковых условиях освещения. При этом я даже не имею в виду дальтоников. Это касается и здоровых людей.

Чтобы упростить работу с цветом в библиотеке UImageCV предусмотрена кластеризация всех цветов и их оттенков на 21 цвет. Первые 7 цветов являются оттенками серого. Остальные 14 цветов — это основные цвета в цветовой модели HSV и радуге, а также их более светлые оттенки.

Изображение с цветами из цветовой карты (слева) и цветовая карта в оттенках серого (справа):

Обратите внимание на то, что светлые цвета отличаются по значению на 10 единиц от соответствующих основных цветов. Этот может быть важно для последующей выборке по диапазону.

Все значения констант находятся в диапазоне от 0 до 255, что делает цветовую карту изображением в оттенках серого. Если посмотреть на значение константы белого цвета, то можно заметить, что оно не равно значению 255. Это значение зарезервировано для выделения краев объектов на цветовой карте. Например, можно наложить результат работы фильтра Собеля на цветовую карту и разделить объекты с разными оттенками одного основного цвета.

Раскрасим палитру основных цветов HSV в цвета цветовой карты (карта разделена белыми полосами):

Светлые оттенки:

Оттенки серого:

Цветовую карту можно преобразовать в строку в формате CMAPSTR. Эта строка содержит специальные символы.

UImageCV. Руководство разработчика

    Класс UCMap: цветовая карта
        Сравнение двух цветов
        Поиск цвета по диапазону значений
        Поиск цвета по расстоянию
        Палитра из 21 цвета
        Поиск ближайшего цвета из цветовой карты
        Создание цветовой карты для изображения
        Гистограмма цветовой карты
        Более быстрый способ создания цветовой карты
        Статистика по цветам в изображении и палитра цветов
        Преобразование цветовой карты в цветное изображение
        Преобразование цветовой карты в строку в формате CMAPSTR
        Преобразование строки в формате CMAPSTR в цветовую карту
        Преобразование строки в формате CMAPSTR в цветное изображение

UImageCV C API. Руководство разработчика

        Цветовая карта изображения
            Сравнение двух цветов
            Поиск цвета по диапазону значений
            Поиск цвета по расстоянию
            Палитра из 21 цвета
            Поиск ближайшего цвета из цветовой карты
            Создание цветовой карты для изображения
            Гистограмма цветовой карты
            Статистика по цветам в изображении и палитра цветов
            Основные цвета изображения и число уникальных цветов
            Преобразование цветовой карты в цветное изображение
            Преобразование цветовой карты в строку в формате CMAPSTR
            Преобразование строки в формате CMAPSTR в цветовую карту
            Преобразование строки в формате CMAPSTR в цветное изображение

Описание библиотеки UImageCV

UImageCV. Руководство разработчика

unicross — Mon, 23 Feb 2026 15:55:05 GMT

UImageCV. Руководство разработчика

    Класс UImageBGR: изображение BGR
        Создание нового изображения
            Изменение пути к каталогу с временными файлами
            Просмотр изображения в окне
        Загрузка изображения из файла
            Загрузка изображения с помощью Pillow
            Загрузка изображения с помощью ImageMagick
            Загрузка изображения из файла в формате RAW RGB
        Сохранение изображения в файл
            Сохранение изображения с помощью Pillow
            Сохранение изображения с помощью ImageMagick
            Сохранение изображения в файл в формате RAW RGB
            Сохранение изображения в файл в формате RAW RGBA
        Получение информации об объекте изображения
        Получение и изменение пикселей изображения
        Нормализация диапазона значений
        Инверсия цвета
        Создание копии изображения
        Сравнение изображений
        Вычисление гистограммы
        Преобразование объекта UImageBGR в объект другого класса
            Преобразование объекта UImageBGR в объект UImageRGB и наоборот
            Преобразование объекта UImageBGR в объект UImageGray и наоборот
            Преобразование объекта UImageBGR в объект UMat и наоборот
            Преобразование объекта UImageBGR в объект Image из Pillow и наоборот
            Преобразование объекта UImageBGR в массив байтов и наоборот
            Преобразование объекта UImageBGR в список
            Преобразование объекта изображения в массив NumPy
        Выполнение манипуляций с объектом UImageBGR

    Класс UImageBGRChange: преобразование изображений UImageBGR
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
        Вращение изображения на произвольный угол
        Изменение размера изображения
        Обрезка изображения
        Обрезка лишних одноцветных границ
        Вставка одного изображения в другое
        Наложение одного изображения на другое
        Заливка прямоугольной области цветом
        Разделение изображения на каналы и объединение каналов
        Объединение двух изображений
        Добавление рамки вокруг изображения или с одной стороны
        Добавление внешней или внутренней тени
        Сепия
        Негатив
        Преобразование изображения в оттенки серого
        Тиснение
        Размытие изображения
        Повышение резкости
        Удаление шума с изображения
        Добавление шума на изображение
        Изменение яркости, контраста и цветового тона изображения
        Нормализация изображения
        Замена цвета
        Поиск границ объектов на изображении
        Создание скриншота экрана

    Класс UImageBGRDrawPIL: рисование на UImageBGR
        Создание контекста рисования и получение результата
        Изменение характеристик заливки и обводки
        Рисование с помощью методов из библиотеки Pillow
        Рисование точки
        Рисование линии
        Рисование прямоугольника
        Рисование прямоугольной рамки
        Рисование прямоугольника со скругленными углами
        Рисование многоугольника
        Рисование эллипса
        Рисование круга
        Рисование дуги
        Рисование замкнутой дуги
        Рисование сектора
        Вывод текста на изображение
        Вывод многострочного текста на изображение

    Класс UImageBGRDrawCv2: рисование на UImageBGR
        Создание контекста рисования и получение результата
        Изменение характеристик заливки и обводки
        Рисование с помощью методов из библиотеки OpenCV
        Рисование линии
        Рисование линии со стрелкой
        Рисование прямоугольника
        Рисование прямоугольной рамки
        Рисование многоугольника
        Рисование нескольких линий
        Рисование эллипса
        Рисование круга
        Вывод текста на изображение

    Класс UHelperCv2: взаимодействие с библиотекой OpenCV
        Загрузка изображения из файла
        Сохранение изображения в файл
        Преобразование цветового пространства
            Преобразование RGB в оттенки серого и наоборот
            Преобразование RGB в HSV и наоборот
            Преобразование RGB в HLS и наоборот
            Преобразование RGB в Lab и наоборот
            Преобразование RGB в YCrCb и наоборот

    Класс UImageHSV: изображение HSV
        Создание нового изображения
            Изменение пути к каталогу с временными файлами
            Просмотр изображения в окне
        Загрузка изображения из файла
            Загрузка изображения с помощью Pillow
            Загрузка изображения с помощью ImageMagick
            Загрузка изображения из файла в формате RAW RGB
        Сохранение изображения в файл
            Сохранение изображения с помощью Pillow
            Сохранение изображения с помощью ImageMagick
            Сохранение изображения в файл в формате RAW RGB
        Получение информации об объекте изображения
        Получение и изменение пикселей изображения
            Изменение значений компонентов цвета
        Нормализация диапазона значений
        Создание копии изображения
        Сравнение изображений
        Разделение изображения на каналы и объединение каналов
        Преобразование объекта UImageHSV в объект другого класса
            Преобразование объекта UImageHSV в объект UImageRGB и наоборот
            Преобразование объекта UImageHSV в объект UImageBGR и наоборот
            Преобразование объекта UImageHSV в объект Image из Pillow и наоборот
            Преобразование объекта UImageHSV в массив байтов и наоборот
            Преобразование объекта UImageHSV в список
            Преобразование объекта изображения в массив NumPy
        Преобразование RGB в HSV и наоборот (тип c_ubyte)
        Преобразование RGB в HSV и наоборот (тип float)

    Класс UImageHSL: изображение HSL
        Создание нового изображения
            Изменение пути к каталогу с временными файлами
            Просмотр изображения в окне
        Загрузка изображения из файла
            Загрузка изображения с помощью Pillow
            Загрузка изображения с помощью ImageMagick
            Загрузка изображения из файла в формате RAW RGB
        Сохранение изображения в файл
            Сохранение изображения с помощью Pillow
            Сохранение изображения с помощью ImageMagick
            Сохранение изображения в файл в формате RAW RGB
        Получение информации об объекте изображения
        Получение и изменение пикселей изображения
            Изменение значений компонентов цвета
        Нормализация диапазона значений
        Создание копии изображения
        Сравнение изображений
        Разделение изображения на каналы и объединение каналов
        Преобразование объекта UImageHSL в объект другого класса
            Преобразование объекта UImageHSL в объект UImageRGB и наоборот
            Преобразование объекта UImageHSL в объект UImageBGR и наоборот
            Преобразование объекта UImageHSL в объект Image из Pillow и наоборот
            Преобразование объекта UImageHSL в массив байтов и наоборот
            Преобразование объекта UImageHSL в список
            Преобразование объекта изображения в массив NumPy

    Класс UImageLab: изображение Lab
        Создание нового изображения
            Изменение пути к каталогу с временными файлами
            Просмотр изображения в окне
        Загрузка изображения из файла
            Загрузка изображения с помощью Pillow
            Загрузка изображения с помощью ImageMagick
            Загрузка изображения из файла в формате RAW RGB
        Сохранение изображения в файл
            Сохранение изображения с помощью Pillow
            Сохранение изображения с помощью ImageMagick
            Сохранение изображения в файл в формате RAW RGB
        Получение информации об объекте изображения
        Получение и изменение пикселей изображения
            Изменение значений компонентов цвета
        Нормализация диапазона значений
        Создание копии изображения
        Сравнение изображений
        Разделение изображения на каналы и объединение каналов
        Преобразование объекта UImageLab в объект другого класса
            Преобразование объекта UImageLab в объект UImageRGB и наоборот
            Преобразование объекта UImageLab в объект UImageBGR и наоборот
            Преобразование объекта UImageLab в объект Image из Pillow и наоборот
            Преобразование объекта UImageLab в массив байтов и наоборот
            Преобразование объекта UImageLab в список
            Преобразование объекта изображения в массив NumPy

    Класс UCvRGBA: компьютерное зрение для UImage
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
            Вращение изображения на произвольный угол
        Обрезка изображения
            Обрезка изображения с учетом маски
        Обрезка лишних одноцветных границ
        Вставка одного изображения в другое
        Заливка прямоугольной области цветом
            Заливка изображения цветом с учетом маски
        Объединение двух изображений
        Замена цвета
        Добавление рамки вокруг изображения или с одной стороны
        Изменение размера изображения
        Сравнение двух цветов
        Поиск цвета по диапазону значений
        Поиск цвета по расстоянию

    Класс UCvRGB: компьютерное зрение для UImageRGB
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
            Вращение изображения на произвольный угол
        Обрезка изображения
            Обрезка изображения с учетом маски
        Обрезка лишних одноцветных границ
        Вставка одного изображения в другое
        Заливка прямоугольной области цветом
            Заливка изображения цветом с учетом маски
        Объединение двух изображений
        Замена цвета
        Добавление рамки вокруг изображения или с одной стороны
        Изменение размера изображения
        Преобразование изображения в оттенки серого
        Выделение границ объектов
        Карта границ объектов на изображении

    Класс UCMap: цветовая карта
        Сравнение двух цветов
        Поиск цвета по диапазону значений
        Поиск цвета по расстоянию
        Палитра из 21 цвета
        Поиск ближайшего цвета из цветовой карты
        Создание цветовой карты для изображения
        Гистограмма цветовой карты
        Более быстрый способ создания цветовой карты
        Статистика по цветам в изображении и палитра цветов
        Преобразование цветовой карты в цветное изображение
        Преобразование цветовой карты в строку в формате CMAPSTR
        Преобразование строки в формате CMAPSTR в цветовую карту
        Преобразование строки в формате CMAPSTR в цветное изображение

    Класс UCvGray: компьютерное зрение для UImageGray
        Зеркальное отражение изображения по вертикали или горизонтали
        Вращение изображения на угол кратный 90 градусам
        Обрезка изображения
            Обрезка изображения с учетом маски
        Обрезка лишних одноцветных границ
        Вставка одного изображения в другое
        Заливка прямоугольной области цветом
            Заливка изображения цветом с учетом маски
        Объединение двух изображений
        Вычисление разницы двух изображений
        Преобразование в черно-белое изображение
        Замена цвета
        Прибавление значения ко всем пикселям
        Добавление рамки вокруг изображения или с одной стороны

    Класс UCvGrayFilter: применение фильтров к UImageGray
        Работа с массивами типа c_int (c_long)
            Поиск минимального и максимального значений
            Абсолютные значения
            Объединение массивов
            Нормализация диапазона значений
            Приведение к диапазону от 0 до 255
        Свертка с ядром 3x3
            Добавление паддинга для свертки
            Удаление паддинга
            Свертка с ядром 3x3 (тип int)
            Вычисление градиента
            Определение направления градиента
            Свертка с ядром 3x3 (тип float)
        Свертка с ядром 5x5
            Свертка с ядром 5x5 (тип int)
            Свертка с ядром 5x5 (тип float)
        Расширение темных областей
        Расширение светлых областей
        Тиснение

    Класс UCvGrayEdges: выделение контуров объектов для UImageGray
        Фильтр Собеля
            Выделение горизонтальных границ
            Выделение вертикальных границ
            Вычисление градиента и его направления
            Выделение горизонтальных и вертикальных границ
            Фильтр Собеля 5x5
        Фильтр Щарра
        Фильтр Прюитта
        Выделение контуров
        Лапласиан изображения

    Класс UCvGrayBlur: изменение резкости для UImageGray
        Однородное размытие
        Размытие по Гауссу (ядро 3x3)
        Размытие по Гауссу (ядро 5x5)
        Медианный фильтр
        Сглаживание изображения
        Повышение резкости

    Класс UCvBW: компьютерное зрение для черно-белых изображений
        Преобразование в черно-белое изображение
            Преобразование объекта UImageGray в объект UMask и наоборот
            Преобразование объекта UImageGray в строку в формате BWSTR и наоборот
            Преобразование объекта UMask в строку в формате BWSTR и наоборот
        Инверсия цвета
        Сравнение изображений
        Логические операции
            Логическое И
            Логическое ИЛИ
            Исключающее ИЛИ
            Логическое РАВНО
            Импликация
        Сравнение со значением
            Равно
            Не равно
            Меньше
            Меньше или равно
            Больше
            Больше или равно
            Диапазон значений
            Как получить значения, соответствующие маске?

    Класс UCvArea: работа с контурами и областями изображения
        Заливка произвольной области цветом
        Нумерация контуров и областей на черно-белом изображении
        Нумерация областей на изображении в оттенках серого
        Создание маски по идентификатору области
        Заливка области с учетом идентификатора области
        Обрезка изображения с учетом идентификатора области
        Обрезка изображения с учетом маски
        Обводка областей рамкой
        Выделение контуров объектов на черно-белом изображении
        Преобразование карты областей в черно-белое изображение
        Расширение черных областей на карте областей
        Создание скелетона
        Создание ключевых точек

    Класс UOcrBlock: работа с текстовыми блоками для OCR
        Поиск строк и слов внутри столбца
            Выделение слов на изображении текста
        Обрезка блоков по вертикали или горизонтали
            Выделение строк на изображении текста
            Выделение букв в словах на изображении текста
        Поиск границ блоков
            Поиск горизонтальных границ
            Поиск вертикальных границ
            Удаление границ
            Выделение блоков
        Размазывающие фильтры
            Расширение белых областей
            Создание карты расширения белых областей
            Расширение черных областей
        Поиск линий на карте границ
            Поиск горизонтальных линий на карте границ
            Поиск вертикальных линий на карте границ
            Поиск произвольных линий на карте границ
            Линия по двум точкам. Вычисление угла поворота линии
            Вычисление расстояния между точкой и прямой
            Вычисление расстояния между двумя точками
            Вычисление характеристик прямой по точке и углу поворота
        Поиск лишних границ на карте границ
        Сегментация страницы на прямоугольные блоки
        Удаление рамки с прямыми углами на карте границ
        Удаление рамки со скругленными углами на карте границ
        Вычисление гистограммы для области
        Преобразование области в черно-белое изображение
        Разделение изображения слова на буквы
        Поиск базовой линии на изображении строки

    Класс UCvBGR: компьютерное зрение для UImageBGR
        Преобразование цветового пространства
            Преобразование BGR в оттенки серого и наоборот
            Преобразование BGR в RGB и наоборот
            Преобразование BGR в RGBA и наоборот
            Преобразование BGR в BGRA и наоборот
            Преобразование BGR в HSV и наоборот
            Преобразование BGR в HLS и наоборот
            Преобразование BGR в Lab и наоборот
            Преобразование BGR в YCrCb и наоборот

Описание библиотеки UImageCV

Лицензия библиотек семейства UImage

unicross — Sun, 22 Feb 2026 20:06:43 GMT

Лицензия библиотек семейства UImage

Лицензия на использование библиотек UImage, UImage C API, UImageC, UImageCV и UImageCV C API (далее просто "Программа").

Прежде чем загружать, устанавливать или использовать Программу, прочтите настоящую Лицензию. Автор согласен предоставить лицензию на данную Программу вам или юридическому лицу, которое вы представляете и которое будет владеть лицензией на использование данной Программы (в совокупности «Вы» или «Вам») только в том случае, если вы примете ВСЕ условия настоящей Лицензии. Запуск Программы означает ПОЛНОЕ СОГЛАСИЕ СО ВСЕМИ УСЛОВИЯМИ настоящей Лицензии.

Использование Программы подразумевает также безусловное согласие со всеми условиями лицензий на библиотеки, используемые Программой, такие как Python, Pillow, ImageMagick, NumPy и др.

Данная Программа распространяется в надежде, что она будет полезна, но БЕЗ ЛЮБЫХ ГАРАНТИЙ. Даже без подразумеваемой гарантии КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ.

Вы не будете иметь права устанавливать или использовать данную Программу, если данная Программа не будет получена от автора (https://wwwadmin.ru/) или уполномоченного автором посредника и вы не примете все условия настоящей Лицензии.

Если Вы не согласны со всеми условиями настоящей Лицензии или если Вы заказали данную Программу у кого-то, не являющегося одобренным источником, то:

- не загружайте, не устанавливайте и не используйте данную Программу;
- уничтожьте все экземпляры данной Программы со своего компьютера.

Программа не продается. Программа лицензируется одной из трех типов лицензий: User, Company или Public. Доказательством легального получения Программы и типа Лицензии является кассовый чек или письменный договор. При их отсутствии Лицензия недействительна.

Лицензия User — предоставляется на одного пользователя. Программа может использоваться только в личных целях. Любое распространение Программы запрещено. Лицензия User предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование Программы в течение срока действия настоящей Лицензии. Срок действия Лицензии не ограничен. Число единиц ПО, использующих Программу, не ограничено. Лицензия User доступна только физическим лицам.

Лицензия Company — предоставляется на одну фирму и одно наименование ПО. Программа может использоваться сотрудниками внутри фирмы. Использование Программы клиентами фирмы возможно, но только удаленно, например, предоставление сервиса на сайте (с размещением Программы на сервере) без непосредственного доступа клиента к коду Программы. Любое распространение Программы запрещено. Лицензия Company предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование Программы в течение срока действия настоящей Лицензии. Срок действия Лицензии не ограничен. Лицензия Company доступна только юридическим лицам.

Лицензия Public — предоставляется на одно наименование ПО. Программа может использоваться только в составе ПО, распространяемого публично (платно или бесплатно). Учитывая, что исходные коды динамических библиотек (DLL), входящих в состав Программы, не предоставляются, запрещено использовать Программу в составе ПО, распространяемого по лицензии GPL и аналогичным, требующим обязательное публичное предоставление всех исходных кодов. Лицензия Public предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование Программы в течение срока действия настоящей Лицензии. Срок действия Лицензии не ограничен. Лицензия Public доступна физическим и юридическим лицам.

Пользователь, получивший ваше ПО, включающее Программу по лицензии Public, автоматически получает лицензию User или Company на Программу в зависимости от юридического статуса пользователя. Если пользователь решил создать свое ПО, распространяемое публично, включающее Программу, то он обязан приобрести лицензию Public на Программу. Если пользователь, автоматически получивший лицензию Company, решил создать второе, третье и т. д. ПО, используемое внутри фирмы, включающее Программу, то он обязан приобрести лицензию Company на каждое наименование ПО (за исключением первого), включающее Программу.

Вы не должны, непосредственно или опосредованно, осуществлять декомпиляцию, дизассемблирование, реконструирование Программы, вносить в Программу изменения, разделять Программу на части, отсоединять или отделять какую-либо часть, составляющую или содержащуюся в ней.

Вы не имеете права удалять какие-либо файлы сведений, уведомления, заявления об ограничении ответственности, знаки или этикетки, включенные в состав Программы.

Запрещено выкладывать Программу отдельно, не в составе другого ПО, для свободного скачивания на любом ресурсе в Интернете или другой сети.

Запрещено использовать любые товарные знаки, принадлежащие автору, любым способом, который может указывать или подразумевать, что автор одобряет ваше распространение. Имя автора не может быть использовано для одобрения или продвижения ПО, созданного на основе этой Программы, без специального предварительного письменного разрешения.

Запрещено использовать любые товарные знаки, принадлежащие автору, любым способом, который может указывать или подразумевать, что вы создали данную Программу.

Исходные коды динамических библиотек (DLL) не предоставляются и их распространение запрещено.

Заголовочные файлы (с расширением .h) в состав Программы не входят и их распространение запрещено. Заголовочные файлы могут быть получены отдельно, исключительно в целях динамической линковки вашего ПО с Программой при сборке и компиляции на вашем компьютере.

НЕТ ГАРАНТИИ

НА ПРОГРАММУ НЕ ПРЕДОСТАВЛЯЕТСЯ НИКАКИХ ГАРАНТИЙ. ОБЛАДАТЕЛИ АВТОРСКИХ ПРАВ ПРЕДОСТАВЛЯЮТ ПРОГРАММУ "КАК ЕСТЬ" БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, ПОМИМО ПРОЧЕГО, ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ КОММЕРЧЕСКОЙ ПРИГОДНОСТИ И ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ. ВЕСЬ РИСК, КАСАЮЩИЙСЯ КАЧЕСТВА И ПРОИЗВОДИТЕЛЬНОСТИ ПРОГРАММЫ, ЛЕЖИТ НА ВАС. В СЛУЧАЕ ДЕФЕКТА ПРОГРАММЫ ВЫ ПРИНИМАЕТЕ НА СЕБЯ СТОИМОСТЬ ВСЕХ НЕОБХОДИМЫХ ОБСЛУЖИВАНИЙ, РЕМОНТА ИЛИ ИСПРАВЛЕНИЯ.

ОБЛАДАТЕЛИ АВТОРСКИХ ПРАВ НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ПЕРЕД ВАМИ ЗА УЩЕРБ, ВКЛЮЧАЯ ЛЮБОЙ ОБЩИЙ, СПЕЦИАЛЬНЫЙ, СЛУЧАЙНЫЕ ИЛИ КОСВЕННЫЕ УБЫТКИ, СВЯЗАННЫЕ С ИСПОЛЬЗОВАНИЕМ ИЛИ НЕВОЗМОЖНОСТЬЮ ИСПОЛЬЗОВАНИЯ ПРОГРАММЫ (ВКЛЮЧАЯ, ПОМИМО ПРОЧЕГО, ПОТЕРЮ ДАННЫХ ИЛИ НЕТОЧНУЮ ПЕРЕДАЧУ ДАННЫХ ИЛИ УБЫТКИ, ПРИЧИНЕННЫЕ ВАМИ ИЛИ ТРЕТЬИМИ ЛИЦАМИ, ИЛИ НЕВОЗМОЖНОСТЬ ПРОГРАММЫ РАБОТАТЬ С ДРУГИМИ ПРОГРАММАМИ), ДАЖЕ ЕСЛИ ТАКОЙ ВЛАДЕЛЕЦ ИЛИ ДРУГАЯ СТОРОНА БЫЛИ УВЕДОМЛЕНЫ О ВОЗМОЖНОСТИ ТАКОГО УЩЕРБА.

ОТКАЗ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ

АВТОР, КОМПАНИЯ, ЕЕ ДИРЕКТОРА, РУКОВОДИТЕЛИ, РАБОТНИКИ, АФФИЛИРОВАННЫЕ ЛИЦА, ОДОБРЕННЫЕ ИСТОЧНИКИ, ТОРГОВЫЕ ПОСРЕДНИКИ, ДИСТРИБЬЮТОРЫ, ПОСТАВЩИКИ, СУБЛИЦЕНЗИАТЫ И ПРЕДСТАВИТЕЛИ (ДАЛЕЕ «ОТКАЗЫВАЮЩИЕСЯ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ ЛИЦА») НАСТОЯЩИМ ОТКАЗЫВАЮТСЯ ОТ ЛЮБЫХ ГАРАНТИЙ, ЗАЯВЛЕНИЙ И ЗАВЕРЕНИЙ, ЧТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ИЛИ ЛЮБОЕ ДРУГОЕ ОБОРУДОВАНИЕ ИЛИ СЕТЬ, ИСПОЛЬЗУЕМЫЕ ДЛЯ ВЫПОЛНЕНИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ, БУДУТ РАБОТАТЬ БЕЗ ОШИБОК ИЛИ ПЕРЕБОЕВ ИЛИ НЕ БУДУТ ИМЕТЬ УЯЗВИМОСТЕЙ ДЛЯ ПРОНИКНОВЕНИЯ ИЛИ АТАКИ. ЗА ИСКЛЮЧЕНИЕМ ПРЯМО ЗАЯВЛЕННЫХ ГАРАНТИЙ И СРЕДСТВ ЗАЩИТЫ ПРАВ, ПРИВЕДЕННЫХ В ПОЛИТИКЕ ПРЕДОСТАВЛЕНИЯ ГАРАНТИИ НА ПРОДУКТЫ, НАСКОЛЬКО ЭТО ДОПУСТИМО СОГЛАСНО ЗАКОНОДАТЕЛЬСТВУ, ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПОСТАВЛЯЕТСЯ И ЛЮБЫЕ ПРЕДОСТАВЛЯЕМЫЕ В СВЯЗИ С НИМИ УСЛУГИ ОСУЩЕСТВЛЯЮТСЯ НА УСЛОВИЯХ «КАК ЕСТЬ» И СО ВСЕМИ НЕДОСТАТКАМИ.

АВТОР НЕ БУДЕТ НЕСТИ ОТВЕТСТВЕННОСТИ ЗА ОСУЩЕСТВЛЕННЫЕ ЛЮБЫМИ ТРЕТЬИМИ ЛИЦАМИ НЕСАНКЦИОНИРОВАННЫЙ ДОСТУП ИЛИ ВНЕСЕНИЕ ИЗМЕНЕНИЙ В ЛЮБЫЕ ПЕРЕДАЧИ ВАМИ ДАННЫХ ИЛИ ДАННЫЕ, ЛЮБЫЕ МАТЕРИАЛЫ ИЛИ ДАННЫЕ, ОТПРАВЛЯЕМЫЕ ИЛИ ПОЛУЧАЕМЫЕ С ИСПОЛЬЗОВАНИЕМ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ, ЛЮБЫЕ ПЕРЕБОИ, ДЕФЕКТЫ ИЛИ ЗАДЕРЖКИ В РАБОТЕ ИЛИ ПЕРЕДАЧЕ ДАННЫХ, КОМПЬЮТЕРНЫЕ ВИРУСЫ, ОТКАЗЫ ЛИНИЙ СВЯЗИ, РАЗРУШЕНИЕ ИЛИ ИСПОЛЬЗОВАНИЕ ЗАПИСЕЙ. АВТОР НЕ ГАРАНТИРУЕТ, ЧТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ НЕ ИМЕЮТ НЕТОЧНОСТЕЙ, ОШИБОК, НЕИСПРАВНОСТЕЙ, ВИРУСОВ, СРЕДСТВ ВЗЛОМА, СБОЕВ, ИЛИ ИНЫХ ВРЕДНЫХ КОМПОНЕНТОВ ИЛИ ПРОГРАММНЫХ ОГРАНИЧЕНИЙ. В РАМКАХ ОТНОШЕНИЙ МЕЖДУ ВАМИ И АВТОРОМ ВСЕ РИСКИ, ВОЗНИКАЮЩИЕ В РЕЗУЛЬТАТЕ ИСПОЛЬЗОВАНИЯ ИЛИ ДЕЙСТВИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ И ЛЮБЫХ СВЯЗАННЫХ С НИМИ СЛУЖБ, НЕСЕТЕ ВЫ, ПРИНИМАЯ НА СЕБЯ ВСЕ РАСХОДЫ НА ВСЕ НЕОБХОДИМОЕ ОБСЛУЖИВАНИЕ, РЕМОНТ ИЛИ УСТРАНЕНИЕ ПРОБЛЕМ В РЕЗУЛЬТАТЕ ВСЕГО ВЫШЕИЗЛОЖЕННОГО, В СЛУЧАЕ ЛЮБЫХ СТИХИЙНЫХ БЕДСТВИЙ, ПОЛНЫХ ИЛИ ЧАСТИЧНЫХ ОТКЛЮЧЕНИЙ ИНТЕРНЕТА, НЕПРАВИЛЬНОЙ АРХИТЕКТУРЫ ИЛИ НЕВЕРНОГО РАЗВЕРТЫВАНИЯ ВАШИХ ПРИЛОЖЕНИЙ, ВНЕСЕНИЯ ИЗМЕНЕНИЙ В ПЕРЕДАЧУ ДАННЫХ ИЛИ ДАННЫЕ, ПЕРЕДАЧИ И ПРИЕМА ИЛИ НЕПЕРЕДАЧИ И НЕПРИЕМА ЛЮБЫХ МАТЕРИАЛОВ ИЛИ ДАННЫХ ЛИБО ПЕРЕДАЧИ, ПРОИЗОШЕДШЕЙ ЧЕРЕЗ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ.

ЗА ИСКЛЮЧЕНИЕМ ПРЯМО НАЗВАННЫХ В ПОЛИТИКЕ ПРЕДОСТАВЛЕНИЯ ГАРАНТИИ НА ПРОДУКТЫ ГАРАНТИЙ И СРЕДСТВ ЗАЩИТЫ ПРАВ, АВТОР ОТКАЗЫВАЕТСЯ ОТ ЛЮБЫХ УСЛОВИЙ, СРЕДСТВ ЗАЩИТЫ И ГАРАНТИЙ, КАСАЮЩИХСЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ (КАК ПРЯМО ВЫРАЖЕННЫХ, ТАК И ПОДРАЗУМЕВАЮЩИХСЯ, ПРЕДУСМОТРЕННЫХ ЗАКОНОМ ИЛИ КАКИХ-ТО ДРУГИХ), В ТОМ ЧИСЛЕ, НЕ ОГРАНИЧИВАЯСЬ ЭТИМ, ОТ ЛЮБЫХ ПОДРАЗУМЕВАЕМЫХ ГАРАНТИЙ ТОВАРНОЙ ПРИГОДНОСТИ, СООТВЕТСТВИЯ ОПРЕДЕЛЕННОМУ НАЗНАЧЕНИЮ, ОТСУТСТВИЯ НАРУШЕНИЯ ЧЬИХ-ЛИБО АВТОРСКИХ ПРАВ, ТОЧНОСТИ ИНФОРМАЦИОННОГО СОДЕРЖИМОГО И ГАРАНТИЙ, ВОЗНИКАЮЩИХ ИЗ ОБЫЧНОЙ ДЕЛОВОЙ ПРАКТИКИ, ЗАКОНОДАТЕЛЬСТВА, ИСПОЛЬЗОВАНИЯ ИЛИ ОТРАСЛЕВОЙ ПРАКТИКИ. В ТОЙ МЕРЕ, В КАКОЙ ПОДРАЗУМЕВАЮЩУЮСЯ ГАРАНТИЮ НЕЛЬЗЯ ИСКЛЮЧИТЬ, ДЕЙСТВИЕ ТАКОЙ ГАРАНТИИ ОГРАНИЧИВАЕТСЯ СРОКОМ ДЕЙСТВИЯ ЯВНО ВЫРАЖЕННЫХ ГАРАНТИЙ. ДАННЫЕ ОТКАЗ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ И ИХ ИСКЛЮЧЕНИЕ ДЕЙСТВУЮТ ДАЖЕ В ТОМ СЛУЧАЕ, ЕСЛИ ЯВНАЯ ГАРАНТИЯ НЕ МОЖЕТ ПРИМЕНЕНА ПО ОСНОВНОМУ НАЗНАЧЕНИЮ.

ОГРАНИЧЕНИЕ ОТВЕТСТВЕННОСТИ

В САМОМ ПОЛНОМ ОБЪЕМЕ, НАСКОЛЬКО ЭТО НЕ ЗАПРЕЩЕНО ЗАКОНОДАТЕЛЬСТВОМ, НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ НИ ОДНО ИЗ ОТКАЗЫВАЮЩИХСЯ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ ЛИЦ НЕ БУДЕТ НЕСТИ ОТВЕТСТВЕННОСТИ ПО ЛЮБОЙ ПРИЧИНЕ, В СВЯЗИ С ЛЮБЫМ ИСКОМ ИЛИ ПРЕТЕНЗИЕЙ, НЕЗАВИСИМО ОТ ИХ ОСНОВАНИЙ, В ТОМ ЧИСЛЕ, НЕ ОГРАНИЧИВАЯСЬ ЭТИМ, СОГЛАСНО УСЛОВИЯМ КОНТРАКТА, В РЕЗУЛЬТАТЕ НАРУШЕНИЯ ЗАКОННЫХ ПРАВ, В СООТВЕТСТВИИ С ГАРАНТИЙНЫМИ ОБЯЗАТЕЛЬСТВАМИ ИЛИ ПОЧЕМУ-ТО ЕЩЕ, ЗА УЩЕРБ В РЕЗУЛЬТАТЕ ПОТЕРИ КОММЕРЧЕСКОЙ ПРИБЫЛИ, НАРУШЕНИЯ КОММЕРЧЕСКОЙ ДЕЯТЕЛЬНОСТИ, УТРАТЫ ИЛИ ПОВРЕЖДЕНИЯ КОММЕРЧЕСКОЙ ИНФОРМАЦИИ ИЛИ ИНЫХ ДАННЫХ, ЗАТРАТ НА ОПЛАТУ ИЛИ ИНОЕ ОБЕСПЕЧЕНИЕ ЗАМЕНЫ, ЛЮБОЙ ДРУГОЙ МАТЕРИАЛЬНЫЙ УЩЕРБ ИЛИ ОСОБЫЙ, СЛУЧАЙНЫЙ, ОПОСРЕДОВАННЫЙ, ШТРАФНОЙ, ГИБРИДНЫЙ ИЛИ КОСВЕННЫЙ УЩЕРБ В СВЯЗИ С НАСТОЯЩИМ СОГЛАШЕНИЕМ, В РЕЗУЛЬТАТЕ ИЛИ ВСЛЕДСТВИЕ НАСТОЯЩЕГО СОГЛАШЕНИЯ, В ТОМ ЧИСЛЕ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ, ЛЮБЫМИ ЕГО ОБНОВЛЕНИЯМИ ИЛИ ЛЮБЫМИ СВЯЗАННЫМИ С НИМИ СЛУЖБАМИ, ИЛИ В СВЯЗИ С НЕОСУЩЕСТВЛЕНИЕМ В ПОЛНОМ ИЛИ ДОСТАТОЧНОМ ОБЪЕМЕ ПОДДЕРЖКИ ИЛИ ТЕХНИЧЕСКОГО ОБСЛУЖИВАНИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ, ДАЖЕ ЕСЛИ КАКОЕ-ТО ИЗ ОТКАЗЫВАЮЩИХСЯ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ ЛИЦ БЫЛО УВЕДОМЛЕНО О ВОЗМОЖНОСТИ ТАКОГО УЩЕРБА.

ВЫ ПРЯМО ПРИЗНАЕТЕ, ЧТО СОВОКУПНАЯ ОТВЕТСТВЕННОСТЬ ОТКАЗЫВАЮЩИХСЯ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ ЛИЦ В СВЯЗИ С ЛЮБЫМИ И ВСЕМИ ОСНОВАНИЯМИ ДЛЯ ИСКОВ И ВСЕМИ ТЕОРИЯМИ ОТВЕТСТВЕННОСТИ, БУДЬ ТО НА ОСНОВАНИИ ДОГОВОРА, ЗАКОНА ИЛИ НАРУШЕНИЯ ЗАКОННЫХ ПРАВ (В ТОМ ЧИСЛЕ, НЕ ОГРАНИЧИВАЯСЬ ЭТИМ, В РЕЗУЛЬТАТЕ ОТВЕТСТВЕННОСТИ ЗА ПРОДУКТ) ИЛИ ЧЕГО-ТО ЕЩЕ, НЕ ДОЛЖНА ПРЕВЫШАТЬ

(I) 100 (СТО) ДОЛЛАРОВ США ЗА ВСЕ ПРЕДОСТАВЛЕННОЕ ВАМ ПО ЛИЦЕНЗИИ ПРОГРАММНОЕОБЕСПЕЧЕНИЕ АВТОРОМ ИЛИ
(II) ЦЕНУ, ЗАПЛАЧЕННУЮ АВТОРУ ЗА ЛИЦЕНЗИОННЫЕ ПРАВА НА ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ, КОТОРОЕ СТАЛО ПРИЧИНОЙ ИСКА.

ВЫ ДОЛЖНЫ ЗАЩИЩАТЬ АВТОРА, ОГРАЖДАТЬ ЕГО ОТ ОТВЕТСТВЕННОСТИ И ОБЕСПЕЧИВАТЬ НЕПРИВЛЕЧЕНИЕ ЕГО К ЛЮБОЙ ОТВЕТСТВЕННОСТИ, ИСКЛЮЧАТЬ ВОЗНИКНОВЕНИЕ ДЛЯ НЕГО УЩЕРБА, УБЫТКОВ ИЛИ ЗАТРАТ (В ТОМ ЧИСЛЕ, В ВИДЕ ГОНОРАРОВ ЮРИСТОВ) В СВЯЗИ С ЛЮБЫМИ СПОРАМИ, СУДЕБНЫМИ РАЗБИРАТЕЛЬСТВАМИ, АДМИНИСТРАТИВНЫМИ СЛУШАНИЯМИ, АРБИТРАЖНЫМИ РАЗБИРАТЕЛЬСТВАМИ ИЛИ УРЕГУЛИРОВАНИЯМИ СПОРОВ НА ОСНОВАНИИ ЛЮБЫХ ИСКОВ ЛЮБЫХ СТОРОН, КРОМЕ ВАС, КАСАЮЩИХСЯ НАРУШЕНИЯ ВАМИ УСЛОВИЙ НАСТОЯЩЕГО СОГЛАШЕНИЯ ИЛИ ИСПОЛЬЗОВАНИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ (В ТОМ ЧИСЛЕ ЛЮБЫХ ЕГО ОБНОВЛЕНИЙ) ИЛИ ПЛАТФОРМЫ, А ТАКЖЕ В РЕЗУЛЬТАТЕ ТАКИХ СПОРОВ, СУДЕБНЫХ РАЗБИРАТЕЛЬСТВ, АДМИНИСТРАТИВНЫХ СЛУШАНИЙ, АРБИТРАЖНЫХ РАЗБИРАТЕЛЬСТВ ИЛИ УРЕГУЛИРОВАНИЙ СПОРОВ.

АВТОР ОПРЕДЕЛИЛ СВОИ ЦЕНЫ, ПОЛАГАЯСЬ НА ПРИВЕДЕННЫЕ ВЫШЕ ЗАЯВЛЕНИЯ ОБ ОТКАЗЕ ОТ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ И ОГРАНИЧЕНИЯ ОТВЕТСТВЕННОСТИ. ЭТИ ЗАЯВЛЕНИЯ ОБ ОТКАЗЕ ОТ ОТВЕТСТВЕННОСТИ И ОГРАНИЧЕНИЯ ОТРАЖАЮТ РАСПРЕДЕЛЕНИЕ РИСКОВ МЕЖДУ СТОРОНАМИ И СОСТАВЛЯЮТ СУЩЕСТВЕННУЮ ОСНОВУ СДЕЛКИ МЕЖДУ СТОРОНАМИ.

UImageCV: библиотека алгоритмов компьютерного зрения для Python

unicross — Fri, 20 Feb 2026 20:12:51 GMT

UImageCV: библиотека компьютерного зрения для Python, C и C++

Библиотека UImageCV для Python 3.8+ (только для Windows) содержит алгоритмы компьютерного зрения. Она является надстройкой над библиотекой UImageC (пакет unicross_img), которая позволяет загрузить, сохранить и обработать изображение. В свою очередь библиотека UImageC является надстройкой над библиотеками Pillow и ImageMagick. При этом базовый функционал библиотеки реализован на языке C.

Для тесного взаимодействия с библиотекой OpenCV имеется класс UImageBGR. Массивы ctypes, используемые классом UImageBGR, можно обернуть в массивы NumPy, используемые библиотекой OpenCV, без копирования данных:

from unicross_cv.uimagebgr import UImageBGR
from unicross_img.uhelper_np import UHelperNP
import cv2

img = UImageBGR.load("foto.jpg")
print(img)           # UImageBGR(width=500, height=333)
# Преобразование в массив NumPy без копирования
np_gray = cv2.cvtColor(img.get_buffer(), cv2.COLOR_BGR2GRAY)
print(type(np_gray)) #



Большинство алгоритмов в библиотеке UImageCV реализованы на языке C и не зависят от библиотеки OpenCV или любой другой библиотеки компьютерного зрения. Поэтому предыдущий пример можно записать проще и без всяких лишних преобразований в BGR:


from unicross_img.uimagergb import UImageRGB

img = UImageRGB.load("foto.jpg")
print(img)           # UImageRGB(width=500, height=333)
# Преобразование в UImageGray
img_gray = img.get_uimagegray()
print(img_gray)      # UImageGray(width=500, height=333)


Благодаря использованию массивов ctypes, которые доступны напрямую через атрибут arr, имеется возможность непосредственной обработки изображения с помощью компилируемых языков C, C++, Go и др. с максимальной скоростью без копирования. Переделаем предыдущий пример и используем C API напрямую:


from unicross_img.uimagergb import UImageRGB
from unicross_img.uimagegray import UImageGray
import os.path
import ctypes

# Использование UImage C API
dll_path = r"D:\UImageC\unicross_img\bin"
_ulibpath = os.path.abspath(os.path.join(dll_path, "libuimagergb.dll"))
_ulibc = ctypes.CDLL(_ulibpath)

_uimagergb_to_gray = _ulibc.uimagergb_to_gray
_uimagergb_to_gray.argtypes = [
   ctypes.POINTER(ctypes.c_ubyte), ctypes.c_int,
   ctypes.POINTER(ctypes.c_ubyte), ctypes.c_int]
_uimagergb_to_gray.restype = ctypes.c_int

img = UImageRGB.load("foto.jpg")
print(img)           # UImageRGB(width=500, height=333)
# Преобразование в UImageGray. Подготовка буфера
img_gray = UImageGray(img.get_width(), img.get_height())
# Вызываем код на языке C (arr не копируется!)
res = _uimagergb_to_gray(img.arr, img.arr._length_,
                         img_gray.arr, img_gray.arr._length_)
if res == 1:
    print(img_gray)  # UImageGray(width=500, height=333)
    img_gray.save("test.png")
else:
    print("Ошибка при выполнении операции")


Библиотека компьютерного зрения UImageCV помимо кода на Python содержит также код на языке C, который можно вызвать из программ на Python, C или C++. Код компилируется в динамические библиотеки (dll) под Windows x64. Подключить библиотеку в программе на Python позволяет модуль ctypes, входящий в состав стандартной библиотеки. В предыдущем примере мы использовали код на языке C, расположенный в libuimagergb.dll. Точно также можно подключить любую другую динамическую библиотеку и выполнять обработку изображения на компилируемых языках.

Динамические библиотеки, входящие в состав UImageCV C API, не имеют зависимостей от кода сторонних библиотек! Все названия функций внутри dll находятся в своих собственных пространствах имен (в коде выше это префикс "uimagergb_" перед названием функции), поэтому конфликтов имен с кодом сторонних разработчиков быть не должно!

Обратите внимание: исходные коды динамических библиотек (DLL) не предоставляются и их распространение запрещено. Заголовочные файлы (с расширением .h) в состав библиотеки не входят и их распространение запрещено. Заголовочные файлы могут быть получены отдельно, исключительно в целях динамической линковки вашего ПО с DLL при сборке и компиляции на вашем компьютере.

Системные требования и ограничения

Для корректной работы библиотеки нужно соблюсти следующие условия:


 операционная система Windows 8, 8.1, 10 или 11. Разрядность x64;
 процессор чем мощнее, тем лучше;
 наличие библиотеки Python 3.8+;
 для использования всех возможностей требуются библиотеки Pillow, ImageMagick, OpenCV, NumPy и Matplotlib. При отсутствии какой-либо библиотеки некоторые возможности станут недоступны;
 минимум 1 ГБайт свободного места в оперативной памяти;
 минимум 100 МБайт свободного места на жестком диске.


Библиотека имеет следующие основные ограничения:


 максимальная ширина изображения — 8000 px;
 максимальная высота изображения — 8000 px.


Библиотека работает только в Windows x64. Библиотеки Python, Pillow, ImageMagick, OpenCV, NumPy и Matplotlib в комплект не входят. Установка Python 3.8 под Windows подробно описана в документации (см. каталог docs\test_python\setup_python). Процесс установки Pillow, OpenCV, NumPy и Matplotlib предельно прост:


pip install Pillow
pip install opencv-python
pip install numpy
pip install matplotlib


Версии этих библиотек, использованные при тестировании:


>>> import PIL
>>> PIL.__version__
'9.3.0'
>>> import cv2
>>> cv2.__version__
'4.6.0'
>>> import numpy
>>> numpy.__version__
'1.23.4'
>>> import matplotlib
>>> matplotlib.__version__
'3.6.2'


Архив с библиотекой ImageMagick нужно  загрузить со страницы:


https://imagemagick.org/script/download.php


Для Windows x64 загрузить можно такой архив:


ImageMagick-7.1.2-8-portable-Q16-x64.7z


Версия библиотеки ImageMagick, используемая при тестировании:


C:\Users\Unicross>C:\ImageMagick\magick -version
Version: ImageMagick 7.0.11-13 Q16 x64 2021-05-17 https://imagemagick.org
Copyright: (C) 1999-2021 ImageMagick Studio LLC
License: https://imagemagick.org/script/license.php
Visual C++: 192829914
Features: Cipher DPC OpenCL
Delegates (built-in): bzlib cairo flif freetype gslib heic jng jp2 jpeg
 jxl lcms lqr lzma openexr pangocairo png ps raw rsvg tiff webp xml
 zip zlib


Подключение библиотеки и импорт классов из модулей

Библиотека UImageCV включает два пакета:


 пакет unicross_img — содержит код библиотеки UImageC ;
 пакет unicross_cv — содержит  собственно код библиотеки UImageCV.


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


from unicross_img.uimagergb import UImageRGB
from unicross_cv.uimagebgr import UImageBGR


Если программа расположена в другом месте, то предварительно нужно прописать путь к библиотекам в пути поиска модулей:


import sys
sys.path.append(r"D:\UImageC")
from unicross_img.uimagergb import UImageRGB
from unicross_cv.uimagebgr import UImageBGR


Проверим установку путем вывода версий библиотек:


import unicross_img
import unicross_cv

print(unicross_img.__version__) # 1.1.0
print(unicross_img.VERSION)     # ('1', '1', '0')
print(unicross_cv.__version__)  # 1.0.0
print(unicross_cv.VERSION)      # ('1', '0', '0')


Модули библиотеки UImageCV

Внутри пакета  unicross_cv расположены следующие модули:


 uimagebgr.py — содержит класс UImageBGR, предназначенный для хранения цветного изображения с 3-я каналами BGR (c_ubyte от 0 до 255);
 uimagebgrchange.py — содержит класс UImageBGRChange, предназначенный для выполнения преобразований UImageBGR (средствами Pillow или ImageMagick и без). Почти все методы принимают объект UImageBGR и возвращают копию преобразованного объекта UImageBGR или None;
 uimagedraw.py — модуль для рисования. Содержит следующие идентификаторы:



 класс UImageBGRDrawPIL, предназначенный для рисования на UImageBGR средствами Pillow;
 класс UImageBGRDrawCv2, предназначенный для рисования на UImageBGR средствами OpenCV;



 uimagehsv.py — содержит класс UImageHSV, предназначенный для хранения цветного изображения с 3-я каналами HSV (c_ubyte от 0 до 255);
 uimagehsl.py — содержит класс UImageHSL, предназначенный для хранения цветного изображения с 3-я каналами HSL (c_ubyte от 0 до 255). Преобразование цветовых моделей выполняется средствами OpenCV;
 uimagelab.py — содержит класс UImageLab, предназначенный для хранения цветного изображения с 3-я каналами Lab (c_ubyte от 0 до 255). Преобразование цветовых моделей выполняется средствами OpenCV;
 uhelper_cv2.py — вспомогательный модуль для взаимодействия с OpenCV. Содержит класс UHelperCv2 с помощью которого можно загрузить изображение из файла или сохранить изображение в файл;
 ucvbgr.py — содержит класс UCvBGR, предназначенный для выполнения алгоритмов компьютерного зрения с изображением UImageBGR. Преобразование цветовых моделей выполняется средствами OpenCV;
 ucvrgb.py — содержит класс UCvRGB, предназначенный для выполнения алгоритмов компьютерного зрения с изображением UImageRGB. Преобразование цветовых моделей выполняется средствами OpenCV;
 ucvgray.py — содержит класс UCvGray, предназначенный для выполнения алгоритмов компьютерного зрения с изображением UImageGray;
 ucvgrayfilter.py — содержит класс UCvGrayFilter, предназначенный для выполнения алгоритмов компьютерного зрения с изображением UImageGray (свертка, морфологические операции и др.);
 ucvgrayedges.py — содержит класс UCvGrayEdges, предназначенный для выполнения алгоритмов компьютерного зрения с изображением UImageGray (выделение границ объектов);
 ucvgrayblur.py — содержит класс UCvGrayBlur, предназначенный для выполнения алгоритмов компьютерного зрения с изображением UImageGray (размытие и усиление резкости).


Как заказать библиотеки UImageCV и UImageCV C API

Библиотеки не продаются. Библиотеки лицензируются одной из трех типов лицензий: User, Company или Public.


 Лицензия User — предоставляется на одного пользователя. Библиотека может использоваться только в личных целях. Любое распространение библиотеки запрещено. Лицензия User предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Число единиц ПО, использующих библиотеку, не ограничено. Лицензия User доступна только физическим лицам. Стоимость лицензии на UImageCV — 5 000 руб., на UImageCV C API (только DLL) — 4 000 руб.
 Лицензия Company — предоставляется на одну фирму и одно наименование ПО. Программа с библиотекой может использоваться сотрудниками внутри фирмы. Использование программы с библиотекой клиентами фирмы возможно, но только удаленно, например, предоставление сервиса на сайте (с размещением библиотеки на сервере) без непосредственного доступа клиента к коду библиотеки. Любое распространение библиотеки и программы с библиотекой запрещено. Лицензия Company предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Лицензия Company доступна только юридическим лицам.  Стоимость лицензии на UImageCV — 25 000 руб., на UImageCV C API (только DLL) — 20 000 руб.
 Лицензия Public — предоставляется на одно наименование ПО. Библиотека может использоваться только в составе ПО, распространяемого публично (платно или бесплатно). Учитывая, что исходные коды динамических библиотек (DLL), входящих в состав библиотеки, не предоставляются, запрещено использовать библиотеку в составе ПО, распространяемого по лицензии GPL и аналогичным, требующим обязательное публичное предоставление всех исходных кодов. Лицензия Public предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Лицензия Public доступна физическим и юридическим лицам. Стоимость лицензии на UImageCV — 100 000 руб., на UImageCV C API (только DLL) — 80 000 руб.


Пользователь, получивший ваше ПО, включающее библиотеку по лицензии Public, автоматически получает лицензию User или Company на библиотеку в зависимости от юридического статуса пользователя. Если пользователь решил создать свое ПО, распространяемое публично, включающее библиотеку, то он обязан приобрести лицензию Public на библиотеку. Если пользователь, автоматически получивший лицензию Company, решил создать второе, третье и т. д. ПО, используемое внутри фирмы, включающее библиотеку, то он обязан приобрести лицензию Company на каждое наименование ПО (за исключением первого), включающее библиотеку.

Лицензия, выданная на библиотеку UImageCV (или UImageCV C API), распространяется и на библиотеку UImageC (или UImage C API), входящую в состав дистрибутива, при условии неделимого совместного использования библиотек. Если вы решили использовать библиотеку UImageC отдельно от UImageCV, то нужно приобрести отдельную лицензию на использование библиотеки UImageC.

Исходные коды динамических библиотек (DLL) не предоставляются и их распространение запрещено.

Заголовочные файлы (с расширением .h) в состав библиотеки не входят и их распространение запрещено. Заголовочные файлы могут быть получены отдельно (входят в состав руководства пользователя), исключительно в целях динамической линковки вашего ПО с DLL при сборке и компиляции на вашем компьютере.

Документация содержится в строках документирования. Для получения списка методов нужно использовать функцию dir(), а для получения описания метода — функцию help(). Специализированные текстовые редакторы автоматически предоставят список методов при наборе букв и описание метода из строки документирования при выборе метода из списка. Расширенная документация по C API доступна только в руководстве разработчика, которое в состав библиотеки не входит и приобретается отдельно.

Чтобы иметь полное представление о возможностях библиотеки, нужно приобрести руководство разработчика в формате HTML. В его состав входит расширенная документация и множество примеров, которые можно запустить на выполнение и наглядно увидеть результат. Дополнительно доступны заголовочные файлы (с расширением .h), которые могут быть использованы исключительно в целях динамической линковки вашего ПО с DLL при сборке и компиляции на вашем компьютере. Распространение руководства разработчика и заголовочных файлов запрещено.

Доступны для заказа следующие руководства разработчика в формате HTML (можно открыть любым Web-браузером; оглавление в файле index.html):


 "UImageC и UImage C API. Руководство разработчика". Включает заголовочные файлы для UImage C API. Оглавление руководства. Стоимость 250 руб.
 "UImageCV. Руководство разработчика". Включает заголовочные файлы для  UImageCV C API. Оглавление руководства. Стоимость 300 руб.
 "UImageCV C API. Руководство разработчика". Включает заголовочные файлы для  UImageCV C API. Оглавление руководства. Стоимость 300 руб.


Прежде чем заказывать библиотеку:


 прочтите текст Лицензии. Только если она вас полностью устраивает переходите к следующему шагу;
 выберите библиотеку и тип лицензии, подходящий под вашу программу или задачу. Учитывайте, что изменять что-либо в дистрибутиве библиотеки нельзя. Это означает, что просто скопировать  DLL в каталог bin вашей программы при заказе UImageC или UImageCV не получится. Нужно будет целиком копировать каталог с библиотекой или прописывать путь. Если библиотеку планируется использовать только в C или C++, то правильнее будет заказать UImage C API или UImageCV C API. В комплект этих библиотек входят только DLL и лицензия, которые можно скопировать в  каталог bin вашей программы;
 закажите соответствующее руководство разработчика, чтобы полностью понимать возможности выбранной библиотеки;
 закажите лицензию User, чтобы попробовать на практике и убедиться, что библиотека вам подходит. Вы всегда можете повысить лицензию до Company или Public с зачетом уже оплаченной суммы. В обратную сторону это не действует;
 закажите повышение лицензии с зачетом, если лицензия User вас не устраивает.


Если есть вопросы, то задавайте. Контакты и форма для заказа

Описание библиотеки UImageC



UImageC и UImage C API. Руководство разработчика
unicross — Mon, 19 Jan 2026 16:19:00 GMT

UImageC и UImage C API. Руководство разработчика

UImageC 1.0.0: библиотека для работы с изображениями в Python, C и C++

      Обзор возможностей библиотеки

            Подключение библиотеки и импорт классов из модулей

            Примеры использования библиотеки

            Использование Pillow в программе на Python

            Использование ImageMagick в программе на Python

            Форматы файлов UImage и PPM

            Взаимодействие с Tkinter и объектом PhotoImage

            Взаимодействие с библиотекой NumPy

            Взаимодействие с библиотекой Matplotlib

            Настройка пути к каталогу для временных файлов

            Модули библиотеки UImageC

       

      Класс UColor: цвет в формате RGBA

            Объекты URGBA и URGB

            Создание экземпляра класса UColor

            Сравнение объектов

            Основные методы

            Изменение яркости и насыщенности цвета

            Нормализация значений

            Преобразование между диапазонами

            Статические методы для работы с кортежами

       

      Класс UPoint: координаты точки (тип int)

      Класс UPointF: координаты точки (тип float)

      Класс USize: размеры прямоугольной области (тип int)

      Класс USizeF: размеры прямоугольной области (тип float)

      Класс URect: координаты и размеры прямоугольной области

       

      Чтение и запись графических файлов .uimage

            Формат файла .uimage

            Сохранение изображения Pillow в файл .uimage

            Загрузка изображения из файла .uimage

       

      Класс UHelperTk: взаимодействие с библиотекой Tkinter

            Преобразование объекта UImage в объект PhotoImage

            Преобразование объекта PhotoImage в объект UImage

            Загрузка и сохранение файлов в формате PNG

            Просмотр изображения в окне

       

      Класс UMat: матрица с произвольными значениями

       

      Класс UImage: изображение RGBA

            Создание нового изображения

                  Изменение пути к каталогу с временными файлами

            Загрузка изображения из файла

                  Загрузка изображения с помощью Pillow

                  Загрузка изображения с помощью ImageMagick

                  Загрузка изображения из файла в формате RAW RGBA

            Сохранение изображения в файл

                  Сохранение изображения с помощью Pillow

                  Сохранение изображения с помощью ImageMagick

                  Сохранение изображения в файл в формате RAW RGBA

            Получение информации об объекте изображения

            Получение и изменение пикселей изображения

            Нормализация диапазона значений

            Инверсия цвета

            Создание копии изображения

            Сравнение изображений

            Преобразование объекта UImage в объект другого класса

                  Преобразование объекта UImage в объект UImageRGB и наоборот

                  Преобразование объекта UImage в объект UImageGray и наоборот

                  Преобразование объекта UImage в объект UMat и наоборот

                  Преобразование объекта UImage в объект Image из Pillow и наоборот

                  Преобразование объекта UImage в массив байтов и наоборот

                  Преобразование объекта UImage в список

            Выполнение манипуляций с объектом UImage

       

      Класс UImageChange: преобразование изображений UImage

            Зеркальное отражение изображения по вертикали или горизонтали

            Вращение изображения на угол кратный 90 градусам

            Вращение изображения на произвольный угол

            Изменение размера изображения

            Обрезка изображения

            Обрезка лишних одноцветных границ

            Вставка одного изображения в другое

            Наложение одного изображения на другое

            Заливка прямоугольной области цветом

            Разделение изображения на каналы и объединение каналов

            Объединение двух изображений

            Добавление рамки вокруг изображения или с одной стороны

            Добавление внешней или внутренней тени

            Сепия

            Негатив

            Преобразование изображения в оттенки серого

            Тиснение

            Размытие изображения

            Повышение резкости

            Удаление шума с изображения

            Добавление шума на изображение

            Изменение яркости, контраста и цветового тона изображения

            Нормализация изображения

            Удаление прозрачности и альфа-канала

            Замена цвета

            Поиск границ объектов на изображении

            Создание скриншота экрана

       

      Класс UImageRGB: изображение RGB

            Создание нового изображения

                  Изменение пути к каталогу с временными файлами

            Загрузка изображения из файла

                  Загрузка изображения с помощью Pillow

                  Загрузка изображения с помощью ImageMagick

                  Загрузка изображения из файла в формате RAW RGB

            Сохранение изображения в файл

                  Сохранение изображения с помощью Pillow

                  Сохранение изображения с помощью ImageMagick

                  Сохранение изображения в файл в формате RAW RGB

                  Сохранение изображения в файл в формате RAW RGBA

            Получение информации об объекте изображения

            Получение и изменение пикселей изображения

            Нормализация диапазона значений

            Инверсия цвета

            Создание копии изображения

            Сравнение изображений

            Вычисление гистограммы

            Преобразование объекта UImageRGB в объект другого класса

                  Преобразование объекта UImageRGB в объект UImage и наоборот

                  Преобразование объекта UImageRGB в объект UImageGray и наоборот

                  Преобразование объекта UImageRGB в объект UMat и наоборот

                  Преобразование объекта UImageRGB в объект Image из Pillow и наоборот

                  Преобразование объекта UImageRGB в массив байтов и наоборот

                  Преобразование объекта UImageRGB в список

            Выполнение манипуляций с объектом UImageRGB

       

      Класс UImageRGBChange: преобразование изображений UImageRGB

            Зеркальное отражение изображения по вертикали или горизонтали

            Вращение изображения на угол кратный 90 градусам

            Вращение изображения на произвольный угол

            Изменение размера изображения

            Обрезка изображения

            Обрезка лишних одноцветных границ

            Вставка одного изображения в другое

            Наложение одного изображения на другое

            Заливка прямоугольной области цветом

            Разделение изображения на каналы и объединение каналов

            Объединение двух изображений

            Добавление рамки вокруг изображения или с одной стороны

            Добавление внешней или внутренней тени

            Сепия

            Негатив

            Преобразование изображения в оттенки серого

            Тиснение

            Размытие изображения

            Повышение резкости

            Удаление шума с изображения

            Добавление шума на изображение

            Изменение яркости, контраста и цветового тона изображения

            Нормализация изображения

            Замена цвета

            Поиск границ объектов на изображении

            Создание скриншота экрана

       

      Класс UImageGray: изображение в оттенках серого

            Создание нового изображения

                  Изменение пути к каталогу с временными файлами

            Загрузка изображения из файла

                  Загрузка изображения с помощью Pillow

                  Загрузка изображения с помощью ImageMagick

                  Загрузка изображения из файла в формате RAW GRAY

            Сохранение изображения в файл

                  Сохранение изображения с помощью Pillow

                  Сохранение изображения с помощью ImageMagick

                  Сохранение изображения в файл в формате RAW GRAY

                  Сохранение изображения в файл в формате RAW RGB

                  Сохранение изображения в файл в формате RAW RGBA

            Получение информации об объекте изображения

            Получение и изменение пикселей изображения

            Нормализация диапазона значений

            Работа с черно-белым изображением

            Инверсия цвета

            Создание копии изображения

            Сравнение изображений

            Вычисление гистограммы

            Преобразование объекта UImageGray в объект другого класса

                  Преобразование объекта UImageRGB в объект UImageGray и наоборот

                  Преобразование объекта UImageGray в объект UMat и наоборот

                  Преобразование объекта UImageGray в объект Image из Pillow и наоборот

                  Преобразование объекта UImageGray в массив байтов

                  Преобразование объекта UImageGray в список

                  Преобразование объекта UImageGray в объект UMask и наоборот

                  Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

            Выполнение манипуляций с объектом UImageGray

       

      Класс UImageGrayChange: преобразование изображений UImageGray

            Зеркальное отражение изображения по вертикали или горизонтали

            Вращение изображения на угол кратный 90 градусам

            Вращение изображения на произвольный угол

            Изменение размера изображения

            Обрезка изображения

            Обрезка лишних одноцветных границ

            Вставка одного изображения в другое

            Заливка прямоугольной области цветом

            Объединение двух изображений

            Преобразование в черно-белое изображение

            Тиснение

            Размытие изображения

            Повышение резкости

            Удаление шума с изображения

            Добавление шума на изображение

            Изменение яркости изображения

            Нормализация изображения

            Замена цвета

            Поиск границ объектов на изображении

            Создание скриншота экрана

       

      Класс UMask: маска или черно-белое изображение

            Создание объекта

            Преобразование объекта UImageGray в объект UMask и наоборот

            Сохранение изображения в файл

            Загрузка изображения из файла

            Получение информации об объекте

            Получение и изменение пикселей изображения

            Инверсия цвета

            Создание копии объекта

            Сравнение объектов

            Строка в формате BWSTR

                  Преобразование объекта UMask в строку в формате BWSTR и наоборот

                  Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

            Преобразование объекта UMask в список

       

      Класс UFont: характеристики шрифта

       

      Класс UImageDrawPIL: рисование на UImage

            Создание контекста рисования и получение результата

            Изменение характеристик заливки и обводки

            Рисование с помощью методов из библиотеки Pillow

            Рисование точки

            Рисование линии

            Рисование прямоугольника

            Рисование прямоугольной рамки

            Рисование прямоугольника со скругленными углами

            Рисование многоугольника

            Рисование эллипса

            Рисование круга

            Рисование дуги

            Рисование замкнутой дуги

            Рисование сектора

            Вывод текста на изображение

            Вывод многострочного текста на изображение

       

      Класс UImageRGBDrawPIL: рисование на UImageRGB

            Создание контекста рисования и получение результата

            Изменение характеристик заливки и обводки

            Рисование с помощью методов из библиотеки Pillow

            Рисование точки

            Рисование линии

            Рисование прямоугольника

            Рисование прямоугольной рамки

            Рисование прямоугольника со скругленными углами

            Рисование многоугольника

            Рисование эллипса

            Рисование круга

            Рисование дуги

            Рисование замкнутой дуги

            Рисование сектора

            Вывод текста на изображение

            Вывод многострочного текста на изображение

       

      Класс UImageGrayDrawPIL: рисование на UImageGray

            Создание контекста рисования и получение результата

            Изменение характеристик заливки и обводки

            Рисование с помощью методов из библиотеки Pillow

            Рисование точки

            Рисование линии

            Рисование прямоугольника

            Рисование прямоугольной рамки

            Рисование прямоугольника со скругленными углами

            Рисование многоугольника

            Рисование эллипса

            Рисование круга

            Рисование дуги

            Рисование замкнутой дуги

            Рисование сектора

            Вывод текста на изображение

            Вывод многострочного текста на изображение

       

      Класс UHelperNP: взаимодействие с библиотекой NumPy

            Преобразование объекта изображения в массив NumPy

                  Создание буфера (диапазон значений от 0 до 255)

                  Тип uint8 (диапазон значений от 0 до 255)

                  Тип int32 (диапазон значений от 0 до 255)

                  Тип uint16 (диапазон значений от 0 до 65 535)

                  Тип float32 (диапазон значений от 0.0 до 1.0)

                  Тип float64 (диапазон значений от 0.0 до 1.0)

            Преобразование массива NumPy в объект изображения

                  Тип uint8 (диапазон значений от 0 до 255)

                  Тип int32 (диапазон значений от 0 до 255)

                  Тип uint16 (диапазон значений от 0 до 65 535)

                  Типы float32 и float64 (диапазон значений от 0.0 до 1.0)

            Преобразование объекта изображения в объект UMat и наоборот

            Преобразование цветного изображения в оттенки серого

            Преобразование изображения в оттенках серого в черно-белое

            Преобразование объекта UImageGray в объект UMask и наоборот

            Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

            Преобразование объекта UMask в строку в формате BWSTR и наоборот

            Нормализация диапазона значений

            Разделение изображения на каналы

            UImageGray: зеркальное отражение изображения по вертикали или горизонтали

            UImageGray: вращение изображения на угол кратный 90 градусам

            UImageGray: заливка прямоугольной области цветом

            UImageGray: обрезка изображения

            UImageGray: обрезка лишних одноцветных границ

            UImageGray: вставка одного изображения в другое

            UImageGray: объединение двух изображений

            UImageGray: добавление рамки вокруг изображения или с одной стороны

                  Добавление паддинга для свертки

            UImageGray: сравнение двух изображений

            UImageGray: вычисление гистограммы

            Сравнение двух строк в формате BWSTR

      Класс UHelperPlt: взаимодействие с библиотекой Matplotlib

            Просмотр изображения в диалоговом окне

            UImageRGB: просмотр гистограмм всех каналов

            UImageGray: вычисление и просмотр гистограммы

       

      Класс UHelperPlt: взаимодействие с библиотекой Matplotlib

       

      C API

      Знакомство с массивами ctypes

      Класс UCArray: работа с массивами ctypes

            Создание массива ctypes

            Создание массива ctypes на основе списка

            Создание массива ctypes на основе объекта типа bytes

            Создание копии массива ctypes

       

      UImage C API: изображение RGBA

            Заливка изображения цветом

            Инверсия цвета

            Преобразование целочисленного диапазона в вещественный и наоборот

            Сравнение изображений

            Проверка наличия прозрачных пикселей

            Разделение на каналы

            Сборка из каналов

            Преобразование объекта UImageRGB в объект другого класса

                  Преобразование объекта UImage в объект UImageGray и наоборот

                  Преобразование объекта UImage в объект UImageRGB и наоборот

       

      UImageRGB C API: изображение RGB

            Заливка изображения цветом

            Инверсия цвета

            Преобразование целочисленного диапазона в вещественный и наоборот

            Сравнение изображений

            Вычисление гистограммы

            Разделение на каналы

            Сборка из каналов

            Преобразование объекта UImageRGB в объект другого класса

                  Преобразование объекта UImageRGB в объект UImageGray и наоборот

                  Преобразование объекта UImage в объект UImageRGB и наоборот

       

      UImageGray C API: изображение в оттенках серого

            Заливка изображения цветом

            Инверсия цвета

            Преобразование целочисленного диапазона в вещественный и наоборот

            Сравнение изображений

            Вычисление гистограммы

            Преобразование объекта UImageGray в объект другого класса

                  Преобразование объекта UImageRGB в объект UImageGray и наоборот

                  Преобразование объекта UImage в объект UImageGray и наоборот

                  Преобразование объекта UImageGray в черно-белое изображение

                  Преобразование объекта UImageGray в объект UMask и наоборот

                  Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

       

      UMask C API: маска или черно-белое изображение

            Преобразование объекта UImageGray в объект UMask и наоборот

            Инверсия цвета

            Сравнение изображений

            Преобразование объекта UMask в строку в формате BWSTR и наоборот

Описание библиотеки UImageC

Как заказать библиотеки UImageC и UImage C API

Библиотеки не продаются. Библиотеки лицензируются одной из трех типов лицензий: User, Company или Public.


 Лицензия User — предоставляется на одного пользователя. Библиотека может использоваться только в личных целях. Любое распространение библиотеки запрещено. Лицензия User предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Число единиц ПО, использующих библиотеку, не ограничено. Лицензия User доступна только физическим лицам. Стоимость лицензии на UImageC — 3 000 руб., на UImage C API (только DLL) — 2 000 руб.
 Лицензия Company — предоставляется на одну фирму и одно наименование ПО. Программа с библиотекой может использоваться сотрудниками внутри фирмы. Использование программы с библиотекой клиентами фирмы возможно, но только удаленно, например, предоставление сервиса на сайте (с размещением библиотеки на сервере) без непосредственного доступа клиента к коду библиотеки. Любое распространение библиотеки и программы с библиотекой запрещено. Лицензия Company предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Лицензия Company доступна только юридическим лицам. Стоимость лицензии на UImageC — 15 000 руб., на UImage C API (только DLL) — 10 000 руб.
 Лицензия Public — предоставляется на одно наименование ПО. Библиотека может использоваться только в составе ПО, распространяемого публично (платно или бесплатно). Учитывая, что исходные коды динамических библиотек (DLL), входящих в состав библиотеки, не предоставляются, запрещено использовать библиотеку в составе ПО, распространяемого по лицензии GPL и аналогичным, требующим обязательное публичное предоставление всех исходных кодов. Лицензия Public предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Лицензия Public доступна физическим и юридическим лицам. Стоимость лицензии на UImageC — 50 000 руб., на UImage C API (только DLL) — 30 000 руб.


Пользователь, получивший ваше ПО, включающее библиотеку по лицензии Public, автоматически получает лицензию User или Company на библиотеку в зависимости от юридического статуса пользователя. Если пользователь решил создать свое ПО, распространяемое публично, включающее библиотеку, то он обязан приобрести лицензию Public на библиотеку. Если пользователь, автоматически получивший лицензию Company, решил создать второе, третье и т. д. ПО, используемое внутри фирмы, включающее библиотеку, то он обязан приобрести лицензию Company на каждое наименование ПО (за исключением первого), включающее библиотеку.

Исходные коды динамических библиотек (DLL) не предоставляются и их распространение запрещено.

Заголовочные файлы (с расширением .h) в состав библиотеки не входят и их распространение запрещено. Заголовочные файлы могут быть получены отдельно (входят в состав руководства пользователя), исключительно в целях динамической линковки вашего ПО с DLL при сборке и компиляции на вашем компьютере.

Документация содержится в строках документирования. Для получения списка методов нужно использовать функцию dir(), а для получения описания метода — функцию help(). Специализированные текстовые редакторы автоматически предоставят список методов при наборе букв и описание метода из строки документирования при выборе метода из списка. Документация по C API доступна только в руководстве разработчика, которое в состав библиотеки не входит и приобретается отдельно.

Чтобы иметь полное представление о возможностях библиотеки, нужно приобрести руководство разработчика в формате HTML. В его состав входит расширенная документация и множество примеров, которые можно запустить на выполнение и наглядно увидеть результат. Дополнительно доступны заголовочные файлы (с расширением .h), которые могут быть использованы исключительно в целях динамической линковки вашего ПО с DLL при сборке и компиляции на вашем компьютере. Распространение руководства разработчика и заголовочных файлов запрещено.

Доступны для заказа следующие руководства разработчика в формате HTML (можно открыть любым Web-браузером; оглавление в файле index.html):


 "UImageC и UImage C API. Руководство разработчика". Включает заголовочные файлы для UImage C API. Оглавление руководства. Стоимость 250 руб.
 "UImageCV. Руководство разработчика". Включает заголовочные файлы для  UImageCV C API. Оглавление руководства. Стоимость 300 руб.
 "UImageCV C API. Руководство разработчика". Включает заголовочные файлы для  UImageCV C API. Оглавление руководства. Стоимость 300 руб.


Прежде чем заказывать библиотеку:


 прочтите текст Лицензии. Только если она вас полностью устраивает переходите к следующему шагу;
 выберите библиотеку и тип лицензии, подходящий под вашу программу или задачу. Учитывайте, что изменять что-либо в дистрибутиве библиотеки нельзя. Это означает, что просто скопировать  DLL в каталог bin вашей программы при заказе UImageC или UImageCV не получится. Нужно будет целиком копировать каталог с библиотекой или прописывать путь. Если библиотеку планируется использовать только в C или C++, то правильнее будет заказать UImage C API или UImageCV C API. В комплект этих библиотек входят только DLL и лицензия, которые можно скопировать в  каталог bin вашей программы;
 закажите соответствующее руководство разработчика, чтобы полностью понимать возможности выбранной библиотеки;
 закажите лицензию User, чтобы попробовать на практике и убедиться, что библиотека вам подходит. Вы всегда можете повысить лицензию до Company или Public с зачетом уже оплаченной суммы. В обратную сторону это не действует;
 закажите повышение лицензии с зачетом, если лицензия User вас не устраивает.


Если есть вопросы, то задавайте. Контакты и форма для заказа



UImage. Руководство разработчика
unicross — Thu, 08 Jan 2026 16:14:03 GMT

UImage. Руководство разработчика

UImage 1.2.0: библиотека для работы с изображениями в Python 3

      Обзор возможностей библиотеки

            Подключение библиотеки и импорт классов из модулей

            Примеры использования библиотеки

            Использование Pillow в программе на Python

            Использование ImageMagick в программе на Python

            Форматы файлов UImage и PPM

            Взаимодействие с Tkinter и объектом PhotoImage

            Взаимодействие с библиотекой NumPy

            Взаимодействие с библиотекой Matplotlib

            Настройка пути к каталогу для временных файлов

            Модули библиотеки UImage

       

      Класс UColor: цвет в формате RGBA

            Объекты URGBA и URGB

            Создание экземпляра класса UColor

            Сравнение объектов

            Основные методы

            Изменение яркости и насыщенности цвета

            Нормализация значений

            Преобразование между диапазонами

            Статические методы для работы с кортежами

       

      Класс UPoint: координаты точки (тип int)

      Класс UPointF: координаты точки (тип float)

      Класс USize: размеры прямоугольной области (тип int)

      Класс USizeF: размеры прямоугольной области (тип float)

      Класс URect: координаты и размеры прямоугольной области

       

      Чтение и запись графических файлов .uimage

            Формат файла .uimage

            Сохранение изображения PIL в файл .uimage

            Загрузка изображения из файла .uimage

       

      Класс UHelperTk: взаимодействие с библиотекой Tkinter

            Преобразование объекта UImage в объект PhotoImage

            Преобразование объекта PhotoImage в объект UImage

            Загрузка и сохранение файлов в формате PNG

       

      Класс UMat: матрица с произвольными значениями

       

      Класс UImage: изображение RGBA

            Создание нового изображения

                  Изменение пути к каталогу с временными файлами

            Загрузка изображения из файла

                  Загрузка изображения с помощью PIL (PILLOW)

                  Загрузка изображения с помощью ImageMagick

                  Загрузка изображения из файла в формате RAW RGBA

            Сохранение изображения в файл

                  Сохранение изображения с помощью PIL (PILLOW)

                  Сохранение изображения с помощью ImageMagick

                  Сохранение изображения в файл в формате RAW RGBA

            Получение информации об объекте изображения

            Получение и изменение пикселей изображения

            Нормализация диапазона значений

            Создание копии изображения

            Сравнение изображений

            Преобразование объекта UImage в объект другого класса

                  Преобразование объекта UImage в объект UImageRGB и наоборот

                  Преобразование объекта UImage в объект UImageGray и наоборот

                  Преобразование объекта UImage в объект UMat и наоборот

                  Преобразование объекта UImage в объект Image из PIL (PILLOW) и наоборот

                  Преобразование объекта UImage в массив байтов и наоборот

            Выполнение манипуляций с объектом UImage

       

      Класс UImageChange: преобразование изображений UImage

            Зеркальное отражение изображения по вертикали или горизонтали

            Вращение изображения на угол кратный 90 градусам

            Вращение изображения на произвольный угол

            Изменение размера изображения

            Обрезка изображения

            Обрезка лишних одноцветных границ

            Вставка одного изображения в другое

            Наложение одного изображения на другое

            Заливка прямоугольной области цветом

            Разделение изображения на каналы и объединение каналов

            Объединение двух изображений

            Добавление рамки вокруг изображения или с одной стороны

            Добавление внешней или внутренней тени

            Сепия

            Негатив

            Преобразование изображения в оттенки серого

            Тиснение

            Размытие изображения

            Повышение резкости

            Удаление шума с изображения

            Добавление шума на изображение

            Изменение яркости, контраста и цветового тона изображения

            Нормализация изображения

            Удаление прозрачности и альфа-канала

            Замена цвета

            Поиск границ объектов на изображении

            Создание скриншота экрана

       

      Класс UImageRGB: изображение RGB

            Создание нового изображения

                  Изменение пути к каталогу с временными файлами

            Загрузка изображения из файла

                  Загрузка изображения с помощью PIL (PILLOW)

                  Загрузка изображения с помощью ImageMagick

                  Загрузка изображения из файла в формате RAW RGB

            Сохранение изображения в файл

                  Сохранение изображения с помощью PIL (PILLOW)

                  Сохранение изображения с помощью ImageMagick

                  Сохранение изображения в файл в формате RAW RGB

                  Сохранение изображения в файл в формате RAW RGBA

            Получение информации об объекте изображения

            Получение и изменение пикселей изображения

            Нормализация диапазона значений

            Создание копии изображения

            Сравнение изображений

            Преобразование объекта UImageRGB в объект другого класса

                  Преобразование объекта UImageRGB в объект UImage и наоборот

                  Преобразование объекта UImageRGB в объект UImageGray и наоборот

                  Преобразование объекта UImageRGB в объект UMat и наоборот

                  Преобразование объекта UImageRGB в объект Image из PIL (PILLOW) и наоборот

                  Преобразование объекта UImageRGB в массив байтов и наоборот

            Выполнение манипуляций с объектом UImageRGB

       

      Класс UImageRGBChange: преобразование изображений UImageRGB

            Зеркальное отражение изображения по вертикали или горизонтали

            Вращение изображения на угол кратный 90 градусам

            Вращение изображения на произвольный угол

            Изменение размера изображения

            Обрезка изображения

            Обрезка лишних одноцветных границ

            Вставка одного изображения в другое

            Наложение одного изображения на другое

            Заливка прямоугольной области цветом

            Разделение изображения на каналы и объединение каналов

            Объединение двух изображений

            Добавление рамки вокруг изображения или с одной стороны

            Добавление внешней или внутренней тени

            Сепия

            Негатив

            Преобразование изображения в оттенки серого

            Тиснение

            Размытие изображения

            Повышение резкости

            Удаление шума с изображения

            Добавление шума на изображение

            Изменение яркости, контраста и цветового тона изображения

            Нормализация изображения

            Замена цвета

            Поиск границ объектов на изображении

            Создание скриншота экрана

       

      Класс UImageGray: изображение в оттенках серого

            Создание нового изображения

                  Изменение пути к каталогу с временными файлами

            Загрузка изображения из файла

                  Загрузка изображения с помощью PIL (PILLOW)

                  Загрузка изображения с помощью ImageMagick

                  Загрузка изображения из файла в формате RAW GRAY

            Сохранение изображения в файл

                  Сохранение изображения с помощью PIL (PILLOW)

                  Сохранение изображения с помощью ImageMagick

                  Сохранение изображения в файл в формате RAW GRAY

                  Сохранение изображения в файл в формате RAW RGB

                  Сохранение изображения в файл в формате RAW RGBA

            Получение информации об объекте изображения

            Получение и изменение пикселей изображения

            Нормализация диапазона значений

            Работа с черно-белым изображением

            Инверсия цвета

            Создание копии изображения

            Сравнение изображений

            Вычисление гистограммы

            Преобразование объекта UImageGray в объект другого класса

                  Преобразование объекта UImageRGB в объект UImageGray и наоборот

                  Преобразование объекта UImageGray в объект UMat и наоборот

                  Преобразование объекта UImageGray в объект Image из PIL (PILLOW) и наоборот

                  Преобразование объекта UImageGray в массив байтов и наоборот

                  Преобразование объекта UImageGray в объект UMask и наоборот

                  Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

            Выполнение манипуляций с объектом UImageGray

       

      Класс UMask: маска или черно-белое изображение

            Создание объекта

            Преобразование объекта UImageGray в объект UMask и наоборот

            Сохранение изображения в файл

            Загрузка изображения из файла

            Получение информации об объекте

            Получение и изменение пикселей изображения

            Инверсия цвета

            Создание копии объекта

            Сравнение объектов

            Строка в формате BWSTR

                  Преобразование объекта UMask в строку в формате BWSTR и наоборот

                  Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

       

      Класс UImageGrayChange: преобразование изображений UImageGray

            Зеркальное отражение изображения по вертикали или горизонтали

            Вращение изображения на угол кратный 90 градусам

            Вращение изображения на произвольный угол

            Изменение размера изображения

            Обрезка изображения

            Обрезка лишних одноцветных границ

            Вставка одного изображения в другое

            Заливка прямоугольной области цветом

            Объединение двух изображений

            Преобразование в черно-белое изображение

            Тиснение

            Размытие изображения

            Повышение резкости

            Удаление шума с изображения

            Добавление шума на изображение

            Изменение яркости изображения

            Нормализация изображения

            Замена цвета

            Поиск границ объектов на изображении

            Создание скриншота экрана

       

      Класс UFont: характеристики шрифта

       

      Класс UImageDrawPIL: рисование на UImage

            Создание контекста рисования и получение результата

            Изменение характеристик заливки и обводки

            Рисование с помощью методов из библиотеки Pillow

            Рисование точки

            Рисование линии

            Рисование прямоугольника

            Рисование прямоугольной рамки

            Рисование прямоугольника со скругленными углами

            Рисование многоугольника

            Рисование эллипса

            Рисование круга

            Рисование дуги

            Рисование замкнутой дуги

            Рисование сектора

            Вывод текста на изображение

            Вывод многострочного текста на изображение

       

      Класс UImageRGBDrawPIL: рисование на UImageRGB

            Создание контекста рисования и получение результата

            Изменение характеристик заливки и обводки

            Рисование с помощью методов из библиотеки Pillow

            Рисование точки

            Рисование линии

            Рисование прямоугольника

            Рисование прямоугольной рамки

            Рисование прямоугольника со скругленными углами

            Рисование многоугольника

            Рисование эллипса

            Рисование круга

            Рисование дуги

            Рисование замкнутой дуги

            Рисование сектора

            Вывод текста на изображение

            Вывод многострочного текста на изображение

       

      Класс UImageGrayDrawPIL: рисование на UImageGray

            Создание контекста рисования и получение результата

            Изменение характеристик заливки и обводки

            Рисование с помощью методов из библиотеки Pillow

            Рисование точки

            Рисование линии

            Рисование прямоугольника

            Рисование прямоугольной рамки

            Рисование прямоугольника со скругленными углами

            Рисование многоугольника

            Рисование эллипса

            Рисование круга

            Рисование дуги

            Рисование замкнутой дуги

            Рисование сектора

            Вывод текста на изображение

            Вывод многострочного текста на изображение

       

      Класс UHelperNP: взаимодействие с библиотекой NumPy

            Преобразование объекта изображения в массив NumPy

                  Тип uint8 (диапазон значений от 0 до 255)

                  Тип int32 (диапазон значений от 0 до 255)

                  Тип uint16 (диапазон значений от 0 до 65 535)

                  Тип float32 (диапазон значений от 0.0 до 1.0)

                  Тип float64 (диапазон значений от 0.0 до 1.0)

            Преобразование массива NumPy в объект изображения

                  Тип uint8 (диапазон значений от 0 до 255)

                  Тип int32 (диапазон значений от 0 до 255)

                  Тип uint16 (диапазон значений от 0 до 65 535)

                  Типы float32 и float64 (диапазон значений от 0.0 до 1.0)

            Преобразование объекта изображения в объект UMat и наоборот

            Преобразование цветного изображения в оттенки серого

            Преобразование изображения в оттенках серого в черно-белое

            Преобразование объекта UImageGray в объект UMask и наоборот

            Преобразование объекта UImageGray в строку в формате BWSTR и наоборот

            Преобразование объекта UMask в строку в формате BWSTR и наоборот

            Нормализация диапазона значений

            Разделение изображения на каналы

            UImageGray: зеркальное отражение изображения по вертикали или горизонтали

            UImageGray: вращение изображения на угол кратный 90 градусам

            UImageGray: заливка прямоугольной области цветом

            UImageGray: обрезка изображения

            UImageGray: обрезка лишних одноцветных границ

            UImageGray: вставка одного изображения в другое

            UImageGray: объединение двух изображений

            UImageGray: добавление рамки вокруг изображения или с одной стороны

                  Добавление паддинга для свертки

            UImageGray: сравнение двух изображений

            UImageGray: вычисление гистограммы

            Сравнение двух строк в формате BWSTR

       

      Класс UHelperPlt: взаимодействие с библиотекой Matplotlib

            Просмотр изображения в диалоговом окне

            UImageRGB: просмотр гистограмм всех каналов

            UImageGray: вычисление и просмотр гистограммы

Описание библиотеки UImage

Как заказать библиотеку UImage

Библиотека не продается. Библиотека лицензируется одной из трех типов лицензий: User, Company или Public.


 Лицензия User — предоставляется на одного пользователя. Библиотека может использоваться только в личных целях. Любое распространение библиотеки запрещено. Лицензия User предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Число единиц ПО, использующих библиотеку, не ограничено. Лицензия User доступна только физическим лицам. Стоимость лицензии на UImage — 2 000 руб.
 Лицензия Company — предоставляется на одну фирму и одно наименование ПО. Программа с библиотекой может использоваться сотрудниками внутри фирмы. Использование программы с библиотекой клиентами фирмы возможно, но только удаленно, например, предоставление сервиса на сайте (с размещением библиотеки на сервере) без непосредственного доступа клиента к коду библиотеки. Любое распространение библиотеки и программы с библиотекой запрещено. Лицензия Company предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Лицензия Company доступна только юридическим лицам. Стоимость лицензии на UImage — 10 000 руб.
 Лицензия Public — предоставляется на одно наименование ПО. Библиотека может использоваться только в составе ПО, распространяемого публично (платно или бесплатно). Учитывая, что исходные коды динамических библиотек (DLL), входящих в состав библиотеки, не предоставляются, запрещено использовать библиотеку в составе ПО, распространяемого по лицензии GPL и аналогичным, требующим обязательное публичное предоставление всех исходных кодов. Лицензия Public предоставляет неисключительную и непередаваемую лицензию, не предполагающую права предоставления какой-либо сублицензии, на использование библиотеки в течение срока действия лицензии. Срок действия лицензии не ограничен. Лицензия Public доступна физическим и юридическим лицам. Стоимость лицензии на UImage — 30 000 руб.


Пользователь, получивший ваше ПО, включающее библиотеку по лицензии Public, автоматически получает лицензию User или Company на библиотеку в зависимости от юридического статуса пользователя. Если пользователь решил создать свое ПО, распространяемое публично, включающее библиотеку, то он обязан приобрести лицензию Public на библиотеку. Если пользователь, автоматически получивший лицензию Company, решил создать второе, третье и т. д. ПО, используемое внутри фирмы, включающее библиотеку, то он обязан приобрести лицензию Company на каждое наименование ПО (за исключением первого), включающее библиотеку.

Документация содержится в строках документирования. Для получения списка методов нужно использовать функцию dir(), а для получения описания метода — функцию help(). Специализированные текстовые редакторы автоматически предоставят список методов при наборе букв и описание метода из строки документирования при выборе метода из списка. Расширенная документация доступна только в руководстве разработчика, которое в состав библиотеки не входит и приобретается отдельно.

Чтобы иметь полное представление о возможностях библиотеки, нужно приобрести руководство разработчика в формате HTML. В его состав входит расширенная документация и множество примеров, которые можно запустить на выполнение и наглядно увидеть результат. Распространение руководства разработчика запрещено.

Доступны для заказа следующие руководства разработчика в формате HTML (можно открыть любым Web-браузером; оглавление в файле index.html):


 "UImage. Руководство разработчика".  Оглавление руководства. Стоимость 250 руб.
 "UImageC и UImage C API. Руководство разработчика". Включает заголовочные файлы для UImage C API. Оглавление руководства. Стоимость 250 руб.
 "UImageCV и UImageCV C API. Руководство разработчика". Включает заголовочные файлы для  UImageCV C API. Оглавление руководства. Стоимость 300 руб.


Прежде чем заказывать библиотеку:


 прочтите текст Лицензии. Только если она вас полностью устраивает переходите к следующему шагу;
 выберите библиотеку и тип лицензии, подходящий под вашу программу или задачу. Учитывайте, что изменять что-либо в дистрибутиве библиотеки нельзя;
 закажите соответствующее руководство разработчика, чтобы полностью понимать возможности выбранной библиотеки;
 закажите лицензию User, чтобы попробовать на практике и убедиться, что библиотека вам подходит. Вы всегда можете повысить лицензию до Company или Public с зачетом уже оплаченной суммы. В обратную сторону это не действует;
 закажите повышение лицензии с зачетом, если лицензия User вас не устраивает.


Если есть вопросы, то задавайте. Контакты и форма для заказа



UImage C API
unicross — Mon, 05 Jan 2026 15:26:43 GMT

UImage C API

Графическая библиотека UImageC содержит код на языке C, который можно вызвать из программ на Python, C или C++. Код компилируется в динамические библиотеки (dll) под Windows x64. Подключить библиотеку в программе на Python позволяет модуль ctypes, входящий в состав стандартной библиотеки. Пример подключения библиотеки libuimagegray.dll, расположенной в папке bin, относительно местоположения исполняемого файла:


import os.path
import ctypes

_ulibpath = os.path.abspath(
    os.path.join(os.path.dirname(__file__), "bin", "libuimagegray.dll"))
_ulibc = ctypes.CDLL(_ulibpath)


Следует учитывать, что при неправильном использовании функций из C API возможны непредвиденные последствия. Это касается всего языка C в целом. Например, функция принимает указатель на массив. Внутри функции нет никакой возможности определить число элементов массива. Оператор sizeof() вернет лишь размер указателя, а не размер всего массива. Число элементов массива обычно передается дополнительным параметром, но нет никакой гарантии, что это число соответствует реальному размеру массива. Поэтому контроль за правильностью передаваемых в функцию данных лежит на плечах программиста.

Знакомство с массивами ctypes

Пиксели изображения в библиотеке UImageC хранятся в массивах ctypes, что позволяет получить к ним доступ из программы на языке C без необходимости выполнения преобразований. В отличие от списков языка Python массивы ctypes являются строго типизированными и имеют фиксированный размер.

Типы данных в модуле ctypes соответствуют типам из языка C. Перечислим основные типы, которые часто встречаются в библиотеке UImageC:


>>> import ctypes
>>> b = ctypes.c_bool(True) # _Bool
>>> ctypes.sizeof(b)
1
>>> n = ctypes.c_ubyte(5) # unsigned char
>>> ctypes.sizeof(n)
1
>>> n = ctypes.c_int(5) # int или long
>>> ctypes.sizeof(n)
4
>>> n = ctypes.c_long(5) # long
>>> ctypes.sizeof(n)
4
>>> n = ctypes.c_float(5.2) # float
>>> ctypes.sizeof(n)
4
>>> n = ctypes.c_double(5.2) # double
>>> ctypes.sizeof(n)
8
>>> type(n)



Создать указатель позволяет функция pointer():


>>> n = ctypes.c_int(5)
>>> pn = ctypes.pointer(n)
>>> pn.contents
c_long(5)
>>> pn[0] = 10
>>> n
c_long(10)


Существует также функция POINTER(), которая используется для объявления типизированных указателей. Например, для прототипа:


int uimagergb_invert(unsigned char* parr, int arr_len);


код описания параметров выглядит так:


_uimagergb_invert = _ulibc.uimagergb_invert
_uimagergb_invert.argtypes = [
   ctypes.POINTER(ctypes.c_ubyte), ctypes.c_int]
_uimagergb_invert.restype = ctypes.c_int


Объявление указателя на C-строку (заканчивается нулевым символом) выполняется с помощью типа c_char_p. Например, для прототипа:


int uimagegray_to_bwstr(int* parr_int, int arr_len_int,
                        char* s, int s_len);


код описания параметров выглядит так:


_uimagegray_to_bwstr = _ulibc.uimagegray_to_bwstr
_uimagegray_to_bwstr.argtypes = [
   ctypes.POINTER(ctypes.c_int), ctypes.c_int,
   ctypes.c_char_p, ctypes.c_int]
_uimagegray_to_bwstr.restype = ctypes.c_int


Строки в языке Python неизменяемые. Для создания изменяемого строкового буфера предназначена функция create_string_buffer():


>>> s = b'Hello'
>>> ps = ctypes.create_string_buffer(s)
>>> ps.raw
b'Hello\x00'
>>> ps.value
b'Hello'
>>> type(ps)



Для создания типизированного массива нужно умножить тип на число элементов, а затем вызвать конструктор:


>>> arr = (ctypes.c_int * 5)()
>>> arr[:]
[0, 0, 0, 0, 0]
>>> arr = (ctypes.c_int * 5)(0, 1, 2, 3, 4)
>>> arr[:]
[0, 1, 2, 3, 4]
>>> arr[0]
0
>>> arr[0] = 55
>>> arr[:]
[55, 1, 2, 3, 4]


Создать массив на основе списка можно так:


>>> arr = [0, 1, 2, 3, 4]
>>> type(arr)



Массивы являются экземплярами класса ctypes.Array. Проверить тип и получить информацию о массиве позволяет следующий код:


>>> arr = (ctypes.c_int * 5)(0, 1, 2, 3, 4)
>>> isinstance(arr, ctypes.Array)
True
>>> arr._length_
5
>>> arr._type_



Для преобразования массива в список можно использовать операцию извлечения среза или функцию list():


>>> arr = (ctypes.c_int * 5)(0, 1, 2, 3, 4)
>>> arr2 = arr[:]
>>> type(arr2)



Класс UCArray: работа с массивами ctypes

Класс UCArray содержит методы для работы с массивами ctypes. Инструкция импорта:


from unicross_img.uhelper import UCArray


Создание массива ctypes

Создать массив ctypes с типом c_int (c_long) позволяет статический метод create_ctypes_array_int() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_int(width, height, num_channels)


В первом параметре указывается ширина изображения от 1 до 8000. Второй параметр задает высоту изображения от 1 до 8000. Параметр num_channels определяет число каналов изображения (1, 3 или 4). Метод возвращает массив ctypes заполненный нулями. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

arr = UCArray.create_ctypes_array_int(3, 2, 1)
print(arr._length_) # 6
print(arr._type_)   # 



Создать массив ctypes с типом c_ubyte (соответствует типу unsigned char в языке C) позволяет статический метод create_ctypes_array_ubyte() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_ubyte(width, height, num_channels)


В первом параметре указывается ширина изображения от 1 до 8000. Второй параметр задает высоту изображения от 1 до 8000. Параметр num_channels определяет число каналов изображения (1, 3 или 4). Метод возвращает массив ctypes заполненный нулями. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

arr = UCArray.create_ctypes_array_ubyte(3, 2, 1)
print(arr._length_) # 6
print(arr._type_)   # 



Создать массив ctypes с типом c_double позволяет статический метод create_ctypes_array_double() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_double(width, height, num_channels)


В первом параметре указывается ширина изображения от 1 до 8000. Второй параметр задает высоту изображения от 1 до 8000. Параметр num_channels определяет число каналов изображения (1, 3 или 4). Метод возвращает массив ctypes заполненный нулями. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

arr = UCArray.create_ctypes_array_double(3, 2, 1)
print(arr._length_) # 6
print(arr._type_)   # 



Создать массив ctypes с типом c_bool позволяет статический метод create_ctypes_array_bool() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_bool(width, height)


В первом параметре указывается ширина изображения от 1 до 8000. Второй параметр задает высоту изображения от 1 до 8000. Метод возвращает массив ctypes заполненный значениями False. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

arr = UCArray.create_ctypes_array_bool(3, 2)
print(arr._length_) # 6
print(arr._type_)   # 



Создание массива ctypes на основе списка

Создать массив ctypes с типом c_int (c_long) на основе списка с целыми числами позволяет статический метод create_ctypes_array_int_from_list() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_int_from_list(<Список>)


Метод возвращает массив ctypes. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

list_int = [0, 64, 128, 200, 255]
arr = UCArray.create_ctypes_array_int_from_list(list_int)
print(arr._length_) # 5
print(arr._type_)   # 



Создать массив ctypes с типом c_double на основе списка с вещественными числами позволяет статический метод create_ctypes_array_double_from_list() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_double_from_list(<Список>)


Метод возвращает массив ctypes. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

list_d = [0.0, 0.5, 1.0]
arr = UCArray.create_ctypes_array_double_from_list(list_d)
print(arr._length_) # 3
print(arr._type_)   # 



Создать массив ctypes с типом c_bool на основе списка с логическими значениями позволяет статический метод create_ctypes_array_bool_from_list() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_bool_from_list(<Список>)


Метод возвращает массив ctypes. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

list_b = [True, False, True]
arr = UCArray.create_ctypes_array_bool_from_list(list_b)
print(arr._length_) # 3
print(arr._type_)   # 



Создание массива ctypes на основе объекта типа bytes

Создать массив ctypes с типом c_ubyte на основе объекта типа bytes или bytearray позволяет статический метод create_ctypes_array_ubyte_from_bytes() из класса UCArray. Формат метода:


UCArray.create_ctypes_array_ubyte_from_bytes(



Метод возвращает массив ctypes. При ошибке генерируется исключение. Пример:


from unicross_img.uhelper import UCArray

b = bytes([0, 1, 2, 3, 4])
print(type(b))      # 



Создание копии массива ctypes

Создать копию массива ctypes с типом c_ubyte позволяет статический метод copy_ctypes_array_ubyte() из класса UCArray. Формат метода:


UCArray.copy_ctypes_array_ubyte(<Массив ctypes>)


Метод возвращает массив ctypes. При ошибке генерируется исключение. Пример:


import ctypes
from unicross_img.uhelper import UCArray

arr = (ctypes.c_ubyte * 5)(0, 1, 2, 3, 4)
arr2 = UCArray.copy_ctypes_array_ubyte(arr)
print(arr2._length_) # 5
print(arr2._type_)   # 



Создать копию массива ctypes произвольного типа позволяет статический метод copy_ctypes_array() из класса UCArray. Формат метода:


UCArray.copy_ctypes_array(<Массив ctypes>)


Метод возвращает массив ctypes. При ошибке генерируется исключение. Пример:


import ctypes
from unicross_img.uhelper import UCArray

arr = (ctypes.c_int * 5)(0, 1, 2, 3, 4)
arr2 = UCArray.copy_ctypes_array(arr)
print(arr2._length_) # 5
print(arr2._type_)   # 



Заказать библиотеку

Класс входит в состав графической библиотеки UImageC. Описание библиотеки UImageC