Обзор LibRaw: как устроена библиотека RAW-декодирования, её API, форматы и ограничения

LibRaw — не фоторедактор и не программа с окном предпросмотра, а открытая библиотека LibRaw LLC для чтения RAW-файлов цифровых камер, извлечения метаданных и получения распакованных сенсорных данных для дальнейшей обработки в другом ПО. На дату подготовки обзора стабильным релизом является LibRaw 0.22.2, опубликованный 16 июля 2026 года; для Windows доступна готовая 64-битная сборка, для macOS — 64-битные сборки для Intel и Apple Silicon с требованием macOS 11 или новее, а исходный код предназначен также для Linux, FreeBSD и самостоятельной сборки под Windows. Главная ценность LibRaw заключается не в готовом визуальном результате, а в унифицированном программном интерфейсе: разработчик получает доступ к сведениям о камере, размерам кадра, цветовым данным, миниатюрам, распакованным RAW-значениям и базовому dcraw-совместимому постпроцессингу, не реализуя заново десятки проприетарных контейнеров и схем сжатия.

Задать вопрос фотографу

Андрей Фёдоров

Как вы могли заметить, здесь есть ТОП-ы на все случаи жизни, причём, их список постоянно пополняется. Кроме того, каждый год они обновляются, ведь я включаю в рейтинги реально лучшие аппараты из всех имеющихся в текущий момент на рынке. Именно мой опыт и знания помогли создать ресурс ТОП Фотограф, который, я надеюсь, приносит вам что-то полезное.

Задать вопрос

Основные параметры LibRaw

Что такое LibRaw и для каких задач она нужна

LibRaw решает задачу, которая возникает между чтением файла с камеры и собственно проявкой фотографии. RAW нельзя рассматривать как единый графический формат наподобие JPEG: производители используют разные контейнеры, схемы упаковки сенсорных значений, структуры метаданных, варианты миниатюр и внутренние особенности конкретных камер. LibRaw берёт на себя распознавание такого файла, извлечение описательной информации и декодирование исходных значений сенсора в унифицированные структуры, с которыми дальше работает программа пользователя.

Целевая аудитория продукта — разработчики RAW-конвертеров, просмотрщиков, анализаторов сенсорных данных, каталогизаторов, программ для панорам и стекинга, а также другого ПО, где RAW служит входным материалом. Сам проект отдельно подчёркивает, что базовый модуль преобразования RAW в RGB сохранился прежде всего для совместимости с dcraw и для сценариев, где высококлассный рендеринг не является основной функцией приложения. Поэтому LibRaw разумно оценивать как слой доступа к RAW и метаданным, а не как замену полноценному движку цветокоррекции, локальной ретуши или современному RAW-редактору.

Проект появился в 2008 году и исторически вырос из исходного кода dcraw Дэйва Коффина. После прекращения развития dcraw поддержка новых камер и новых вариантов RAW стала развиваться непосредственно командой LibRaw. Это важное отличие от старых приложений, которые продолжают использовать зафиксированную копию dcraw и поэтому не получают поддержку современных камер автоматически.

Название также важно не перепутать с другими проектами. LibRaw в данном обзоре — библиотека обработки файлов фотокамер от LibRaw LLC. Она не имеет отношения к libraw1394 из Linux FireWire subsystem, который предоставляет низкоуровневый API для IEEE 1394. Пакет rawpy тоже не является другой редакцией LibRaw: это отдельная Python-обёртка, использующая LibRaw как движок.

Текущий статус, версия и распространение

LibRaw активно поддерживается. Стабильная ветка 0.22 получила релиз 0.22.0 в январе 2026 года, затем исправления 0.22.1, а 16 июля 2026 года — 0.22.2. Текущая 0.22.2 является bugfix-релизом: в ней продолжена проверка размеров и границ входных данных, исправлены проблемы с отдельными декодерами и усилена обработка ошибочных или специально сформированных файлов.

Официальный комплект 0.22.2 включает исходные архивы для Unix-подобных систем и Windows, отдельную готовую Win64-сборку, а также macOS-пакет для 64-битных Intel и ARM-систем. На macOS готовая сборка рассчитана на macOS 11 и новее. Win64-пакет собран MSVC 2022. Отдельного инсталлятора как у настольного приложения нет: библиотека либо собирается из исходников, либо поставляется внутри продукта разработчика вместе с DLL, статической библиотекой, заголовками и нужными зависимостями.

У LibRaw есть стабильные релизы и публичные snapshot-сборки. Snapshot предназначен для более раннего доступа к поддержке новых камер и другим изменениям, но API/ABI такого среза не считается замороженным. Для приложений, которые принимают произвольные файлы из внешнего источника, проект рекомендует не использовать snapshots как замену стабильному релизу. Это особенно актуально для веб-сервисов и серверных конвертеров, где пользователь загружает неизвестный бинарный файл.

Платформы, сборка и системные требования

LibRaw распространяется прежде всего как исходный код C++, поэтому «системные требования» здесь определяются не объёмом свободного диска или моделью видеокарты, а компилятором, ABI и набором зависимостей. Официальная документация описывает сборку для FreeBSD, Linux и macOS через configure/make, а для Windows — нативную сборку Visual C++ и вариант через Cygwin. В готовой поставке 0.22.2 основными предварительно собранными пакетами являются Win64 и macOS 11+.

Для Unix-сборки нужен C++-компилятор и make. В документации перечислены дополнительные библиотеки, которые расширяют поддержку отдельных вариантов файлов: zlib используется для deflate-сжатых DNG, libjpeg — для некоторых lossy-DNG и старых камер Kodak, а Jasper исторически применялся для RED. Через конфигурацию можно включать OpenMP и LCMS. В современных ветках также существуют опциональные интеграции с Adobe DNG SDK, GoPro GPR SDK и RawSpeed; наличие конкретной возможности следует проверять у фактически собранной библиотеки, а не только по номеру версии.

Это принципиальная особенность LibRaw: два приложения с одинаковой строкой «LibRaw 0.22» получают разный набор декодеров из-за флагов сборки и подключённых SDK. Для диагностики предусмотрена информация о runtime capabilities. Например, приложение определяет, собрана ли библиотека с Adobe DNG SDK, GPR SDK, RawSpeed или поддержкой Unicode-путей Windows. Для RAW, требующего отсутствующего опционального компонента, контейнер распознаётся, но decoder info сообщает, что конкретный способ декодирования недоступен.

Минимальная версия Windows на странице текущего релиза отдельно не заявлена, поэтому её нельзя подменять догадкой. Для готовой сборки точно известно другое: это 64-битный пакет, созданный MSVC 2022. Разработчику нужно учитывать разрядность, используемый runtime и способ линковки. Для macOS нижняя граница у готового пакета указана прямо — macOS 11.

Интерфейс LibRaw: вместо окон — API и структуры данных

У LibRaw нет панели инструментов, каталога, гистограммы или окна «Экспорт». Рабочий интерфейс состоит из программных объектов, функций, структур данных, кодов ошибок и примерных консольных приложений. Поэтому привычный вопрос «где находится инструмент» здесь заменяется вопросом «на каком этапе API становится доступно нужное состояние файла».

Главный объект и структура imgdata

В C++ API вся обработка организована вокруг экземпляра класса LibRaw. Главная доступная пользователю структура называется imgdata; в C API ей соответствует libraw_data_t. После открытия RAW в ней появляются распознанные параметры, а после последующих вызовов — распакованные пиксельные данные и подготовленное изображение.

Логически imgdata можно разделить на несколько зон. idata хранит основные идентификационные сведения: производителя, модель, нормализованные название производителя и модели, число RAW-кадров, тип матрицы и данные XMP. sizes описывает размеры полного RAW, видимой области, поля, ориентацию и выходные размеры. color содержит цветовую информацию, lens — сведения об объективе, makernotes — разобранные vendor-specific данные, other — параметры снимка, не необходимые для дальнейшего декодирования. thumbnail и thumbs_list отвечают за превью, rawdata — за распакованные RAW-значения, image — за рабочий многоканальный буфер после raw2image или dcraw_process, а params управляет dcraw-совместимым постпроцессингом.

Слой входных данных

Для обычного файла используется open_file. Когда RAW уже находится в памяти, доступен open_buffer. C++ API дополнительно позволяет передать собственный объект, производный от LibRaw_abstract_datastream, через open_datastream. Такой слой полезен, если данные поступают из нестандартного хранилища, собственного контейнера или устройства и разработчик не хочет сначала создавать временный файл.

Стандартные реализации datastream включают файловый поток, поток для больших файлов и поток из буфера памяти. C API предоставляет более простой путь через libraw_open_file и libraw_open_buffer; объектно-ориентированное создание собственного datastream относится к C++ API.

Параметры постпроцессинга

Структура params предназначена для функций, унаследованных от логики dcraw. В ней задаются разрядность выхода, выбор TIFF или PPM, баланс белого, режим половинного размера, качество демозаики, поворот, работа со светами, цветовое пространство выхода, автоматическая яркость и другие параметры. Смысл этой зоны отличается от настроек современного RAW-редактора: она нужна для программной совместимости и базового получения RGB, а не для построения полноценного неразрушающего фотопроцесса с историей правок.

Состояние, предупреждения и callbacks

progress_flags показывает, какие стадии уже прошёл объект: открытие, идентификацию, загрузку RAW, перенос в image, баланс белого, интерполяцию, преобразование RGB и другие этапы. process_warnings фиксирует нефатальные проблемы: отсутствие подходящего баланса белого камеры, проблемы профиля, ошибки карты плохих пикселей, откат с RawSpeed на собственный декодер и другие состояния. Вместо проверки результата только «на глаз» приложение анализирует эти флаги и выдаёт пользователю точное предупреждение.

Callbacks позволяют подключить пользовательские обработчики прогресса, данных EXIF и части makernotes. В ветке 0.22 расширена работа с callback для makernotes и CR3-метаданных. Это делает LibRaw удобной не только как декодер пикселей, но и как компонент анализатора файлов камеры.

Как устроен рабочий процесс внутри LibRaw

Типичная цепочка состоит из нескольких чётко разделённых стадий. Сначала open_file, open_buffer или open_datastream открывает источник, распознаёт формат и извлекает доступные метаданные. Затем unpack декодирует собственно RAW и размещает распакованные значения в rawdata. После этого приложение выбирает один из двух путей: работает с сенсорными данными само либо запускает базовый dcraw-совместимый конвейер.

При самостоятельной обработке разработчик читает rawdata, размеры, Bayer/X-Trans-разметку, чёрные и белые уровни, коэффициенты баланса белого и другие сведения, после чего использует собственные алгоритмы демозаики, цветового управления и тонального преобразования. Именно этот путь соответствует основной философии LibRaw: библиотека снимает задачу распаковки многочисленных RAW-контейнеров, но не навязывает готовый художественный рендеринг.

Во втором варианте вызывается dcraw_process. В упрощённой схеме он переносит данные из rawdata в рабочий image, выполняет масштабирование цветов и баланс белого, интерполяцию сенсорной мозаики, выбранную обработку светов, преобразование в выходное цветовое пространство и другие dcraw-совместимые этапы. Затем результат можно получить как RGB-буфер через dcraw_make_mem_image либо передать writer для записи PPM/TIFF.

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

Основные функции LibRaw

Распознавание камеры и извлечение метаданных

После открытия файла становятся доступны производитель и модель камеры, нормализованные названия, размеры, ориентация, данные объектива, часть EXIF, XMP и vendor-specific makernotes. Нормализованные поля полезны при каталогизации: для региональных и ребрендированных вариантов одной аппаратной платформы встречаются разные названия, а приложение получает единое представление производителя и модели.

LibRaw не является универсальным редактором метаданных. Её публичная модель построена вокруг чтения и использования информации, нужной для декодирования и анализа RAW. Если задача заключается в массовом изменении EXIF/XMP и обратной записи в исходный файл, требуется специализированный инструмент работы с метаданными, а не попытка использовать LibRaw как редактор контейнера.

Декодирование сенсорных значений

unpack — ключевой этап для программ, которым нужны исходные значения сенсора. После него rawdata содержит распакованный RAW-буфер. Для Bayer-кадров положение цветового канала определяется по CFA-разметке; Fuji X-Trans использует собственные 6×6 матрицы.

Смысл «RAW» здесь не сводится к расширению файла. Камеры одного производителя используют разные схемы сжатия и внутренние варианты контейнера. Поэтому корректная проверка совместимости выполняется по конкретной модели, режиму записи и фактическому декодеру. Одно только наличие поддержки расширения NEF, CR3 или DNG не гарантирует обработку каждого возможного варианта.

Миниатюры и встроенные превью

Многие RAW содержат готовые миниатюры или полноразмерные превью. LibRaw умеет извлекать их отдельно от декодирования сенсорного кадра. В ветке 0.21 появился список нескольких миниатюр для TIFF-подобных и CR3-файлов, а unpack_thumb_ex позволяет выбрать конкретный элемент. Старый unpack_thumb ориентирован на наиболее крупное доступное превью.

Формат превью определяется самим RAW. Библиотека различает JPEG, 8- и 16-битные bitmap-превью и другие варианты. В 0.22 добавлена работа с H.265 и JPEG XL превью в соответствующих сценариях. Это не означает, что LibRaw превращается в универсальный JPEG XL или H.265-декодер: задача состоит в извлечении или передаче уже вложенного превью, а часть возможностей зависит от сборки.

Базовая демозаика и преобразование в RGB

В dcraw-совместимом блоке доступны несколько вариантов интерполяции, включая линейную, VNG, PPG, AHD, DCB и дополнительные режимы, перечисленные в параметре user_qual. Можно выбрать 8- или 16-битный выход, управлять автоматической яркостью, балансом белого, поворотом, восстановлением светов и выходным цветовым пространством. Эти инструменты полезны для превью, служебного преобразования и приложений, где RAW — один из многих поддерживаемых типов изображений.

Однако сам проект не рассматривает развитие этой части как основное направление. Производственный RAW-конвертер обычно использует LibRaw для чтения и распаковки, а затем применяет собственный современный pipeline. Это объясняет, почему сравнивать LibRaw по количеству художественных фильтров, локальных масок или инструментов ретуши бессмысленно: таких функций у библиотеки нет и быть не должно в её текущем назначении.

Работа с несколькими изображениями и сложными RAW

Некоторые RAW-контейнеры содержат несколько изображений или кадров. LibRaw хранит raw_count и предоставляет выбор конкретного RAW-изображения через параметры. В новых ветках расширена работа с Canon RawBurst/filmroll, многокадровыми DNG и другими контейнерами. Для Pentax 4-shot предусмотрен режим объединения кадров, а в 0.22 добавлено распознавание Nikon NEFX, полученных после объединения Pixel Shift средствами Nikon.

Не все многокадровые и сжатые режимы одинаково поддерживаются. Например, для ряда Nikon Z в текущем списке поддержки отдельно отмечено ограничение: HE/HE* не поддерживаются, тогда как стандартные режимы сжатия доступны. Это тот случай, когда номер модели камеры сам по себе недостаточен для решения о совместимости.

Пакетная и параллельная обработка

Готовой панели Batch в LibRaw нет. Пакетная обработка строится на уровне приложения: создаётся цикл по файлам, для каждого источника выполняется открытие, распаковка, обработка и recycle. API допускает несколько одновременно работающих процессоров, поэтому многопоточность организуется через несколько экземпляров LibRaw. В комплектных примерах есть half_mt, демонстрирующий параллельную обработку нескольких файлов.

Форматы RAW и реальная совместимость

Документация LibRaw перечисляет широкий спектр RAW-семейств: Canon CRW/CR2 и современные CR3, Nikon NEF, Fujifilm RAF, Adobe DNG, Sony ARW, Kodak KDC/DCR, Leaf/Phase One и другие форматы. В ветке 0.22 добавлены Panasonic encoding 8, Sony YCC для Medium/Small compression, DNG 1.7 с JPEG XL при интеграции Adobe DNG SDK, извлечение встроенного RAW из Canon CRN, обновлённый Samsung V3 decoder и 14-битные high-resolution файлы OM System.

Поддержка DNG заслуживает отдельного пояснения. DNG — спецификация с несколькими поколениями, вариантами сжатия и opcode-операциями. LibRaw 0.22 умеет работать с DNG 1.7 и JPEG XL через интеграцию Adobe DNG SDK 1.7.x. Без соответствующей SDK-интеграции open_file не отвергает часть DNG 1.7/GoPro-файлов только по контейнеру, но decoder info помечает нужный способ декодирования как недоступный. Для кода, который должен работать одинаково на разных машинах, нужно проверять capabilities и decoder info в рантайме.

Поддержка камеры также не равна поддержке всех её режимов. В актуальном списке LibRaw 0.22 для Nikon Z6 III, Z8, Z9 и Z f отдельно отмечено отсутствие HE/HE* вариантов. Из 0.22 исключена старая группа видеокамер OLD_VIDEOCAMS, в которую входили старые RED Cine, Canon C500 и некоторые ARRI. Поэтому для архивного киноRAW или новейшего специального режима камеры нужно смотреть не только бренд и расширение, но и примечание к формату.

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

Импорт и экспорт: что именно читает и что отдаёт библиотека

Импортом в контексте LibRaw является открытие источника. open_file получает путь к RAW, open_buffer — адрес и размер памяти, а open_datastream в C++ позволяет подключить собственную реализацию чтения. После открытия метаданные доступны без полной демозаики, что удобно для каталогизатора или быстрого анализатора.

После unpack приложение получает RAW-буфер; dcraw_process для собственного pipeline не требуется. Это принципиальное отличие от настольного конвертера: результатом работы LibRaw после остановки на этапе unpack служит не готовая фотография, а массив исходных значений, CFA-разметка, границы видимой области, уровни чёрного, коэффициенты баланса белого и другие данные, переданные в собственный pipeline.

Если нужен базовый визуальный результат, dcraw_process формирует рабочий RGB-образ. dcraw_make_mem_image отдаёт его в память как libraw_processed_image_t. Встроенный dcraw_ppm_tiff_writer записывает PPM или TIFF; output_bps поддерживает 8- и 16-битный выход. Прямого универсального JPEG-экспорта обработанного RAW через этот writer нет: для JPEG, PNG, WebP или другого формата приложение получает RGB-данные и использует внешний encoder.

Отдельная история — встроенные превью. Если RAW уже содержит JPEG, H.265 или JPEG XL preview, LibRaw извлекает такие данные в поддерживаемом режиме. Это не следует путать с кодированием результата проявки в эти форматы.

Воспроизводимый рабочий сценарий

Ниже — практический сценарий, который показывает место LibRaw в приложении без превращения обзора в руководство по программированию. Задача: прочитать RAW, убедиться, что камера распознана, получить 16-битный TIFF для служебного сравнения и одновременно сохранить возможность перейти на собственный pipeline.

1. Приложение создаёт отдельный экземпляр LibRaw для входного файла.
2. Файл передаётся в open_file. После успешного открытия приложение читает make, model, размеры, raw_count и доступные сведения о превью.
3. До тяжёлой обработки проверяются код возврата, decoder info и runtime capabilities. Так выявляется ситуация, когда контейнер понятен, но нужный опциональный decoder отсутствует в конкретной сборке.
4. Вызывается unpack. На этом шаге появляется распакованный RAW в rawdata; для собственного алгоритма демозаики стандартный pipeline завершается на этой стадии.
5. Для служебного TIFF устанавливается output_tiff, output_bps равный 16 и нужные параметры баланса белого/яркости. После этого запускается dcraw_process.
6. Размер готового изображения берётся после dcraw_process, потому что итоговые width/height в ряде документированных режимов отличаются от значений, прочитанных сразу после открытия, например из-за half-size, ориентации или особенностей конкретного сенсора.
7. process_warnings проверяется до записи результата. Предупреждение о некорректном балансе белого, проблеме профиля или откате декодера не следует игнорировать только потому, что функция вернула изображение.
8. Результат записывается встроенным TIFF writer либо получается через dcraw_make_mem_image и передаётся другому encoder.
9. После завершения вызывается recycle, затем тот же объект можно использовать для следующего файла.

Этот сценарий воспроизводим на уровне API и одновременно показывает главное ограничение: «проявка» LibRaw — только один из возможных этапов. Для приложения, которое требует собственного качества цвета и демозаики, стандартный процесс заменяется чтением rawdata и собственными алгоритмами после unpack.

Автоматизация, облако, мобильные функции и ИИ

Автоматизация у LibRaw программная. Нет макросов пользовательского интерфейса, но есть последовательный API, callbacks, возможность нескольких экземпляров и примеры массовой обработки. Такой уровень удобен для серверного конвертера, настольного приложения, плагина или фоновой службы, потому что разработчик сам определяет, что считать задачей, как журналировать ошибки и сколько файлов обрабатывать параллельно.

Облачного сервиса LibRaw не предоставляет. Описанный API работает с локальным файлом, буфером или datastream, поэтому загрузка фотографии на сервер LibRaw не требуется. Если программа, использующая библиотеку, отправляет RAW в сеть, это поведение самой программы, а не стандартной функции LibRaw.

Мобильного приложения LibRaw также нет. Официальная страница загрузки предоставляет исходники и настольные/Unix-сборки, но не Android- или iOS-приложение для фотографа. Встраивание исходного кода в сторонний мобильный проект — отдельная инженерная задача и не равно наличию готовой мобильной редакции.

ИИ-инструментов в LibRaw нет. Библиотека не выполняет генеративное редактирование, AI-denoise, распознавание объектов, замену неба или нейросетевое увеличение. Её автоматические операции относятся к традиционному RAW-процессингу: декодирование, выбор баланса белого, интерполяция, расчёт яркости, обработка светов и другие алгоритмы dcraw-совместимого блока.

Ограничения качества рендеринга

Главное ограничение LibRaw часто возникает из-за неверного ожидания. Наличие dcraw_process создаёт впечатление, что библиотека должна выдавать такой же визуальный результат, как современный Capture One, Lightroom, RawTherapee или фирменный конвертер камеры. Это неверное сравнение. Команда LibRaw прямо отделяет задачи декодирования и извлечения метаданных от production-quality rendering; дальнейшее развитие унаследованного dcraw-постпроцессинга не является приоритетом.

Из этого следует практический вывод: результат базового TIFF нельзя использовать как эталон того, «как должна выглядеть» камера. Разные конвертеры применяют разные профили, тональные кривые, матрицы, шумоподавление, демозаику, коррекцию оптики и интерпретацию maker notes. LibRaw обеспечивает доступ к данным, но не обещает совпадение с камерным JPEG или фирменным ПО.

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

Приватность, интернет и безопасность

В стандартном рабочем процессе LibRaw получает байты RAW непосредственно от вызывающего приложения и обрабатывает их локально. Аккаунт, активация, облачное хранилище и постоянное подключение к интернету для декодирования не нужны. С точки зрения приватности это удобная архитектура: библиотека сама по себе не требует передавать исходные фотографии внешнему сервису. Но окончательная политика приватности определяется приложением-хостом, а наличие синхронизации, телеметрии и сетевой обработки определяется самим приложением.

Вопрос безопасности важен, потому что RAW — сложный бинарный вход. В 0.22.1 и 0.22.2 исправлялись проверки размеров, переполнения при расчёте буферов, чтение повреждённых структур и другие ошибки разбора входных файлов. Для продукта, принимающего неизвестные RAW, логично фиксировать актуальную стабильную ветку, обновлять bugfix-релизы, ограничивать память и не использовать экспериментальный snapshot там, где сервис принимает произвольные пользовательские файлы.

Сам LibRaw предоставляет лимиты и предупреждения для ряда операций, а 0.22 добавляет дополнительные ограничения размеров для CR3 и цветовых профилей. Это не заменяет общую модель безопасности приложения: серверный сервис всё равно должен ограничивать размер входа, время выполнения, память, число параллельных декодирований и доступ к файловой системе.

Лицензирование, цена и расширенная поддержка

LibRaw распространяется бесплатно с открытым исходным кодом. Разработчик выбирает один из двух режимов лицензирования библиотеки: GNU Lesser General Public License 2.1 или Common Development and Distribution License 1.0. Это не «Free» и «Pro» редакции с разным набором функций: одна и та же библиотека доступна без платы, а выбор лицензии относится к юридическим условиям использования и распространения.

Пробного периода нет, потому что нет платной функциональной версии, которую нужно разблокировать. Лицензионный ключ, аккаунт или регистрация для работы исходного кода не требуются. При включении LibRaw в коммерческий продукт нужно соблюдать условия выбранной лицензии; конкретная юридическая модель собственного приложения должна оцениваться разработчиком или юристом проекта, а не выводиться из слова «бесплатно».

Отдельно предлагается Extended Support. Это платная техническая поддержка, а не расширенная редакция декодера. Планы Basic, Intermediate и Advanced включают приоритетную обработку bug report; Intermediate и Advanced добавляют ограниченное консультирование, а Advanced — ранний доступ к репозиторию. Публичного прайс-листа для этих планов нет: стоимость сообщается после обращения в LibRaw LLC. Для обычного использования открытой библиотеки такой договор поддержки не обязателен.

Плюсы и минусы

Кому подойдёт

• Разработчикам RAW-просмотрщиков. Можно быстро получить метаданные, превью и базовый RGB без собственной поддержки десятков камер.
• Создателям профессионального RAW-конвертера. LibRaw удобна как слой распаковки, после которого применяется собственная демозаика и цветовой движок.
• Разработчикам каталогизаторов и DAM. Доступ к размерам, модели камеры, объективу, XMP и встроенным превью позволяет строить быстрый импорт без полной проявки каждого кадра.
• Научным и техническим проектам. Распакованные сенсорные значения и CFA-разметка подходят для анализа RAW до художественного рендеринга.
• Серверным конвертерам с контролируемой средой. Локальная библиотека позволяет обрабатывать данные без обязательного внешнего API, если приложение самостоятельно реализует ограничения ресурсов и безопасность.
• C/C++ проектам с собственным pipeline. Нативный API даёт доступ к промежуточным данным без лишнего слоя графического интерфейса.

Кому не подойдёт

• Фотографу, которому нужен готовый редактор. В LibRaw нет каталогов, пресетов, масок, кистей, истории правок и визуального экспорта.
• Пользователю без навыков разработки. Готовые примеры командной строки не превращают библиотеку в самостоятельный рабочий RAW-конвертер общего назначения.
• Проекту, которому нужен только DNG. При строго DNG-ориентированной задаче специализированный Adobe DNG SDK даёт более прямой доступ к DNG-специфичным функциям.
• Проекту, где нужен только максимально быстрый первичный unpack без богатых метаданных и постпроцессинга. RawSpeed является более узким и целевым вариантом.
• Приложению, которое рассчитывает на одинаковый визуальный результат с фирменным конвертером камеры. LibRaw не обещает идентичную тональную и цветовую интерпретацию.

Альтернативы LibRaw

RawSpeed

RawSpeed — специализированная библиотека первичного RAW-декодирования, которая делает упор на скорость. Она отдаёт необработанные данные и CFA, но сама не выполняет демозаику, цветокоррекцию, полноценное чтение метаданных или создание viewable image. Это более узкий выбор, когда приложению нужен быстрый first-stage decoder и остальной pipeline уже реализован самостоятельно. LibRaw шире: кроме распаковки она предоставляет метаданные, превью и dcraw-совместимый базовый postprocessing.

Adobe DNG SDK

Adobe DNG SDK ориентирован на экосистему Digital Negative. В 2026 году актуальна ветка 1.7, для которой Adobe публикует отдельные security updates. Такой SDK уместен, когда центральная задача — DNG, opcode-обработка и строгое следование возможностям формата. LibRaw полезнее, если нужно единым API закрыть множество проприетарных RAW разных производителей; при этом сама LibRaw 0.22 поддерживает интеграцию Adobe DNG SDK для некоторых DNG 1.7/JPEG XL сценариев.

dcraw

dcraw — историческая утилита и кодовая база, из которой вырос LibRaw. Её развитие прекращено, а поддержка новых камер после этого перешла к LibRaw. Для изучения старого RAW pipeline или совместимости с наследуемым кодом dcraw остаётся важным ориентиром, но как основа нового продукта с современными камерами он значительно менее практичен, чем активно обновляемая LibRaw.

RawTherapee

RawTherapee — не библиотека, а готовый кроссплатформенный RAW-редактор с графическим интерфейсом. Он подходит фотографу, которому нужны проявка, локальные инструменты, управление цветом, коррекция объектива и экспорт без написания кода. Поэтому это альтернатива не API LibRaw, а сценарию «мне нужно открыть RAW и получить готовую фотографию». Для разработчика собственного приложения RawTherapee не заменяет библиотечный слой так же напрямую.

Частые проблемы и диагностика

RAW не открывается, хотя расширение поддерживается

Первым шагом нужно проверить точную модель камеры и режим записи, а не расширение. NEF и DNG различаются по compression mode, битности и внутренним тегам. Для новых Nikon Z особенно важно исключить HE/HE* режим, который в текущем списке LibRaw остаётся ограничением для ряда моделей.

Далее проверяется версия библиотеки, реально встроенная в приложение. Если на сайте LibRaw камера уже есть, это не означает, что сторонний просмотрщик автоматически использует свежую 0.22.2. Статически собранная программа продолжит работать со своей копией до обновления разработчиком.

Формат распознаётся, но unpack возвращает ошибку

Такое поведение характерно для сборки без требуемого дополнительного decoder. Проверяются runtime capabilities и get_decoder_info. В 0.22 для DNG 1.7 JPEG XL и GoPro предусмотрена ситуация, когда файл не отвергается на этапе open_file, но decoder info сообщает неподдерживаемый формат из-за отсутствия соответствующего SDK.

Второй вариант — повреждённый или обрезанный файл. Нужно сохранять код возврата каждой стадии, а не вызывать unpack и dcraw_process без проверки. 0.22.1/0.22.2 усилили валидацию размеров, чтения и выделения памяти, поэтому ошибка на новом релизе иногда означает, что старый код раньше молча принимал некорректный вход.

Размер изображения меняется после обработки

Поля width/height и iwidth/iheight имеют разный смысл на разных стадиях и зависят от half_size, Fuji rotation, ориентации и pixel aspect. Для готового RGB документация рекомендует использовать width/height после dcraw_process. Для собственного postprocessing можно вызвать adjust_sizes_info_only и ориентироваться на рассчитанные iwidth/iheight.

TIFF выглядит темнее или светлее другого конвертера

Нужно сравнить настройки auto brightness, баланс белого, выходное цветовое пространство, gamma и профиль, а не считать различие ошибкой декодирования. dcraw_process выполняет собственную цепочку преобразований, которая не обязана совпадать с камерным JPEG или фирменным RAW-конвертером. Если требуется линейный технический результат, параметры гаммы и автоматической яркости должны задаваться осознанно.

Цвета выглядят вымытыми

Одной из частых причин является отключение преобразования в стандартное выходное цветовое пространство. Параметры output_color, camera WB и matrix влияют на то, как RGB интерпретируется после демозаики. Для диагностики полезно сначала получить результат с настройками по умолчанию, затем менять один параметр за раз и контролировать process_warnings.

Нужен JPEG, но writer создаёт только PPM/TIFF

Это не ошибка. Встроенный writer ориентирован на dcraw-совместимый PPM/TIFF. Для JPEG приложение получает RGB через dcraw_make_mem_image и передаёт массив внешней библиотеке кодирования. Встроенный JPEG thumbnail — другое: он уже содержится внутри RAW и извлекается без повторного JPEG-кодирования.

Параллельная обработка резко увеличила расход памяти

Каждый экземпляр LibRaw держит собственное состояние и крупные буферы. Если одновременно распаковать несколько RAW высокого разрешения, память растёт приблизительно вместе с числом активных процессоров и дополнительными буферами собственного pipeline. Практическая диагностика — ограничить число параллельных задач, освобождать объект через recycle и не держать одновременно rawdata, image и дополнительные копии без необходимости.

Новая камера есть в LibRaw, но приложение её не видит

Проверяется версия библиотеки внутри конкретного приложения, а не версия установленного в системе пакета. Также важен список enabled capabilities. Если программа распространяет собственную статическую копию LibRaw, замена системной DLL ничего не изменит. Обновление должно выпустить само приложение или его разработчик.

Как проверять результат обработки

Проверка начинается ещё до RGB. raw-identify из набора примеров выводит данные, прочитанные после open_file, а дополнительные ключи позволяют увидеть подробный metadata dump, имя unpack-функции и таблицы баланса белого. Это помогает быстро понять, распознана ли камера и какой decoder выбран.

После unpack проверяются размеры RAW и видимой области, raw_count, CFA, уровни и предупреждения. Если цель — собственная обработка, здесь полезно строить статистику сенсорных значений и убеждаться, что каналы расположены ожидаемо. После dcraw_process контролируются финальные width/height, разрядность, цветовое пространство и process_warnings.

Для регрессионного тестирования лучше хранить набор RAW от поддерживаемых камер и сравнивать не только итоговый JPEG, но и промежуточные параметры: распознанную модель, размеры, тип decoder, предупреждения, значения black/white level и checksum распакованных данных там, где это применимо. Такой тест быстрее показывает, на каком уровне изменилась обработка после обновления библиотеки.

Если приложение принимает чужие файлы, в тестовый набор нужно включать усечённые и повреждённые образцы из легитимного собственного тестирования, чтобы код корректно обрабатывал ошибки LibRaw и не продолжал pipeline после неуспешного open/unpack. Важен именно контроль возвратов и освобождение ресурсов, а не попытка заставить каждый повреждённый RAW выдать картинку.

FAQ

LibRaw — это программа для просмотра RAW?

Нет. Это библиотека для встраивания. В комплекте есть консольные примеры, но самостоятельного графического просмотрщика LibRaw не предоставляет.

Можно ли использовать LibRaw бесплатно в коммерческом проекте?

Библиотека распространяется бесплатно и предлагает выбор между LGPL 2.1 и CDDL 1.0. Коммерческий проект должен соблюдать условия выбранной лицензии. Отдельная платная Extended Support не требуется для самого права использовать библиотеку.

Нужна ли регистрация или активация?

Нет. Для публичной библиотеки нет лицензионного ключа, обязательного аккаунта или пробного периода. Регистрация на внешних площадках проекта не относится к выполнению декодирования.

LibRaw отправляет фотографии в облако?

Нет. Документированный API читает файл, память или datastream локально. Сетевое поведение определяется приложением-хостом и не является функцией LibRaw.

Есть ли у LibRaw русский интерфейс?

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

Поддерживает ли LibRaw JPEG, PNG и TIFF как обычные входные изображения?

Основное назначение библиотеки — RAW цифровых камер. TIFF участвует в некоторых RAW-контейнерах и в выходном dcraw-совместимом writer, а JPEG встречается как embedded preview. Для универсального чтения обычных JPEG/PNG/TIFF лучше использовать библиотеку общего назначения.

Можно ли получить RAW без демозаики?

Да. После unpack распакованные сенсорные данные доступны через rawdata, поэтому собственная обработка выполняется без dcraw_process.

Можно ли получить готовое RGB в памяти?

Да. Стандартная последовательность open, unpack, dcraw_process и dcraw_make_mem_image возвращает processed image в памяти. Это удобно, когда кодирование в конечный формат выполняет другая библиотека.

Извлекает ли LibRaw встроенное превью без полной проявки RAW?

Да. Для этого используются функции unpack_thumb и, для файлов с несколькими превью, unpack_thumb_ex. Формат и наличие превью зависят от конкретного RAW.

Почему поддерживаемая камера иногда даёт ошибку?

При такой ошибке проверяют четыре причины: неподдерживаемый compression mode, отсутствие опционального SDK в сборке, повреждение файла и старую версию LibRaw внутри конкретного приложения. Диагностика начинается с версии, decoder info, capabilities и кода возврата open/unpack.

Поддерживает ли LibRaw Nikon HE/HE*?

Для ряда современных Nikon Z в текущем списке 0.22 HE/HE* прямо отмечены как неподдерживаемые, тогда как стандартное сжатие поддерживается. Поэтому при проблеме нужно проверить режим записи конкретного файла.

Есть ли пакетный режим?

Готового GUI Batch нет, но API рассчитан на последовательную обработку любого количества файлов и допускает несколько независимых процессоров. Программа сама строит очередь и ограничивает число потоков.

Заменяет ли LibRaw Lightroom или Capture One?

Нет. LibRaw предоставляет слой чтения и декодирования RAW. Каталогизация, визуальная коррекция, локальные маски, пресеты, полноценный цветовой pipeline и удобный экспорт относятся к приложениям более высокого уровня.

Нужно ли обновлять LibRaw после покупки новой камеры?

Новая камера требует версии, в которой добавлена соответствующая поддержка. Если LibRaw встроена в стороннюю программу, обновить должен разработчик этой программы; установка отдельной новой библиотеки в систему не гарантирует, что приложение начнёт её использовать.

Какая версия актуальна сейчас?

На дату подготовки материала актуальный стабильный релиз — LibRaw 0.22.2 от 16 июля 2026 года.

Итог по сценариям использования

LibRaw имеет смысл выбирать, когда главная задача — надёжно открыть множество камерных RAW и передать их содержимое в собственную архитектуру. Для RAW-просмотрщика достаточно metadata, thumbnail и базового RGB; для DAM особенно ценны быстрый доступ к параметрам кадра и встроенным превью; для профессионального конвертера важнее rawdata, CFA и возможность полностью заменить стандартный postprocessing собственным движком.

Если разработка ведётся на C или C++, прямой API LibRaw даёт максимальный контроль. Для Python-проекта практичнее рассмотреть rawpy, поскольку оно уже оборачивает тот же движок. Если требуется только максимально быстрый первичный unpack и богатые метаданные не нужны, RawSpeed представляет более узкий вариант. При строго DNG-ориентированном продукте Adobe DNG SDK заслуживает отдельной оценки.

Фотографу, который хочет просто открыть RAW, настроить экспозицию и получить JPEG, LibRaw как самостоятельный продукт не подходит: у неё нет GUI и современного законченного workflow проявки. В этом сценарии нужен готовый RAW-редактор вроде RawTherapee или другого настольного конвертера. Сильная сторона LibRaw находится уровнем ниже — в стабильном программном доступе к RAW-файлам и их внутренним данным.

Для нового проекта в 2026 году разумной отправной точкой является стабильная 0.22.2, а не snapshot: она содержит актуальные исправления разбора входных данных и готовые пакеты для Win64 и macOS 11+. Перед выпуском приложения нужно фиксировать состав сборки, проверять capabilities, тестировать требуемые камеры и режимы сжатия, а для публичной загрузки неизвестных RAW — дополнительно ограничивать ресурсы и своевременно ставить bugfix-обновления. При таком использовании LibRaw выполняет именно ту роль, для которой создана: снимает сложность проприетарных RAW-контейнеров, не подменяя собой весь фотопроцесс.