[вернуться к оглавлению]
LibRaw: C API
LibRaw C API является "оберткой" (wrapper) вокруг С++ API, поэтому практически вся документация к функциям C
API является набором гиперссылок на соответствующие места описания C++ API.
Инициализация: libraw_data_t *libraw_init(unsigned int flags);
Функция возвращает указатель на экземпляр структуры
libraw_data_t.
Полученный указатель нужно передавать в качестве первого аргумента во все функции C API (кроме libraw_strerror).
Возвращает: NULL при ошибке, указатель на структуру во всех остальных случаях.
Возвращаемые значения
Функции C API возвращают EINVAL (см. errno.h) если им передан нулевой указатель в качестве первого
аргумента. Во всех прочих случаях транслируется код возврата C++ API.
Загрузка данных из файла
- int libraw_open_file(libraw_data_t*, const char *)
-
См. LibRaw::open_file()
- int libraw_unpack(libraw_data_t*);
-
См. LibRaw::unpack()
- int libraw_unpack_thumb(libraw_data_t*);
-
См. LibRaw::unpack_thumb()
Вспомогательные функции
- void libraw_recycle(libraw_data_t*);
-
См. LibRaw::recycle()
- void libraw_close(libraw_data_t*);
-
См. LibRaw::~LibRaw()
- const char *libraw_strerror(int errorcode);
-
См. libraw_strerror
- void libraw_set_memerror_handler(libraw_data_t*, memory_callback cb);
-
См. LibRaw::set_memerror_handler()
- void libraw_set_dataerror_handler(libraw_data_t*,data_callback func);
-
См. LibRaw::set_dataerror_handler()
Постобработка данных, эмуляция поведения dcraw
Установка параметров
Параметры постобработки для описанных ниже вызовов ставятся, как и для С++ API, модификацией полей структуры
libraw_output_params_t:
libraw_data_t *ptr = libraw_init(0);
ptr->params.output_tiff = 1; // выводить в TIFF
Поля структуры описаны в документации на
libraw_output_params_t, замечания по их использованию указаны в API notes.
Эмуляция поведения dcraw
- int libraw_adjust_sizes_info_only(libraw_data_t*);
-
См. LibRaw::adjust_sizes_info_only()
- int libraw_dcraw_document_mode_processing(libraw_data_t*);
-
См. LibRaw::dcraw_document_mode_processing()
- int libraw_dcraw_process(libraw_data_t* lr);
-
См. LibRaw::dcraw_process()
Запись выходных файлов
- int libraw_dcraw_ppm_tiff_writer(libraw_data_t* lr,const char *filename);
-
См. LibRaw::dcraw_ppm_tiff_writer()
- int libraw_dcraw_thumb_writer(libraw_data_t* lr,const char *fname);
-
См. LibRaw::dcraw_thumb_writer()
[вернуться к оглавлению]
Alex Tutubalin
Last modified: Sun Mar 23 19:20:07 MSK 2008